Power Amplifier

The power amplifier is usually the last stage in a transmitting device’s radio frequency chain before the antenna. This base model is HermesPy’s default power amplifier model, which is a linear amplifier with a constant gain and therfore no distortion

\[s'(t) = s(t) \text{,}\]

which may be overwritten by classes inheriting from this base.

class PowerAmplifier(saturation_amplitude=inf, adjust_power=False)

Bases: Serializable

Base class of a distorionless power-amplifier model.

Parameters:

• saturation_amplitude (float) – Cut-off point for the linear behaviour of the amplification in Volt.

• adjust_power (bool) – Power adjustment flag.

classmethod Deserialize(process)

Deserialize an object’s state.

Objects cannot be deserialized directly, instead a Factory must be instructed to carry out the deserialization process.

Parameters:

process (DeserializationProcess) – The current stage of the deserialization process. This object is generated by the Factory and provides an interface to deserialization methods supporting multiple backends.

Return type:

PowerAmplifier

Returns:

The deserialized object.

model(input_signal)

Model signal amplification characteristics.

Parameters:

input_signal (ndarray) – Sample vector of the signal feeding into the power amplifier.

Return type:

ndarray

Returns: Distorted signal after amplification modeling.

plot_characteristics(axes=None, *, title=None, samples=None)

Plot the power amplifier distortion characteristics.

Generates a matplotlib plot depicting the phase/amplitude.

Parameters:

• axes (ndarray[Tuple[int, int], dtype[Any]] | None) – The axis object into which the information should be plotted. If not specified, the routine will generate and return a new figure.

• title (str | None) – Title of the generated plot.

• samples (ndarray | None) – Sample points at which to evaluate the characteristics. In other words, the x-axis of the resulting characteristics plot.

Return type:

Figure

Returns: Handle to the generated figure.

send(input_signal)

Model signal amplification characteristics.

Internally calls the model subroutine of power-amplifier models implementing this prototype-class.

Parameters:

input_signal (ndarray) – Sample vector of the signal feeding into the power amplifier.

Return type:

ndarray

Returns: Distorted signal after amplification modeling.

serialize(process)

Serialize this object’s state.

Objects cannot be serialized directly, instead a Factory must be instructed to carry out the serialization process.

Parameters:

process (SerializationProcess) – The current stage of the serialization process. This object is generated by the Factory and provides an interface to serialization methods supporting multiple backends.

Return type:

None

adjust_power: bool

Power adjustment flag.

If enabled, the power amplifier will normalize the distorted signal after propagation modeling.

property saturation_amplitude: float

Cut-off point for the linear behaviour of the amplification.

Referred to as \(s_\mathrm{sat} \ \mathbb{R}_{+}\) in equations.

Returns: Saturation amplitude in Volt.

Raises:

ValueError – If amplitude is smaller than zero.

property title: str