Analog Digital Converter

class AnalogDigitalConverter(num_quantization_bits=None, gain=None, quantizer_type=QuantizerType.MID_RISER)

Bases: Serializable

Implements an ADC (analog-to-digital converter)

Models the behaviour of an ADC, including: - Sampling Jitter (to be implemented) - Automatic Gain Control - Quantization. Currently only uniform and symmetric quantization is supported.

This class only implements the quantization noise, the output data is still in floating point representation with the same amplitude as the input.

Parameters:

• num_quantization_bits (int | None) – ADC resolution in bits. Default is infinite resolution (no quantization)

• gain (GainControlBase | None) – Amplitude gain control at ADC input. Default is Gain(1.0), i.e., no gain.

• quantizer_type (QuantizerType) – Determines quantizer behaviour at zero. Default is QuantizerType.MID_RISER.

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:

AnalogDigitalConverter

Returns:

The deserialized object.

convert(input_signal, frame_duration=0.0)

Converts an analog signal into a digitally quantized signal.

Parameters:

• input_signal (Signal) – Signal to be converted.

• frame_duration (float) – Duration of a signal frame frame in seconds. Each frame will get converted indepentedly. By default the whole signal is converted at once.

Return type:

Signal

Returns: Gain adjusted and quantized signal.

plot_quantizer(input_samples=None, label='', fig_axes=None)

Plot the quantizer characteristics.

Generates a matplotlib plot depicting the staircase amplitude response. Note that only the real part is plotted, as the quantizer is applied separately in the real and imaginary parts.

Parameters:

• input_samples (ndarray | None) – Sample points at which to evaluate the characteristics, i.e., the x-axis of the resulting characteristics plot. It should be a sorted number sequence.

• label (str) – A label describing the desired plot.

• fig_axes (Axes | None) – Axes to which to plot the charateristics. By default, a new figure is created.

Return type:

None

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

gain: GainControlBase

property num_quantization_bits: int | None

Quantization resolution in bits

Returns:

Bit resolution, None if no quantization is applied.

Raises:

ValueError – If resolution is less than zero.

property num_quantization_levels: float

Number of quantization levels

Returns: Number of levels.

property quantizer_type: QuantizerType

Type of quantizer

• QuantizationType.MID_TREAD: 0 can be the output of a quantization step. Since the number of quantization step

  must be even, negative values will have one step more than positive values

• QuantizerType.MID_RISE: input values around zero are quantized as either -delta/2 or delta/2, with delta the

  quantization step