Mixers

Radio-Frequency (RF) mixers are components combining two input signals by multipling them, resulting in sum and difference frequency components at the output. In the process, they commonly introduce non-linear distortion, phase shifts, thermal noise and leakage of the local oscillator signal to the output.

This module provides various numerical models of RF mixers.

class Mixer(mixer_type, noise_model=None, noise_level=None, seed=None)

Bases: RFBlock

Customizable three-port mixer block model.

Parameters:

• mixer_type (MixerType) – Type of the mixer, either UP or DOWN.

• seed (int | None) – Seed with which to initialize the block’s random state.

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:

Mixer

Returns:

The deserialized object.

realize(bandwidth, oversampling_factor, carrier_frequency)

Return the current state of the radio-frequency block.

Parameters:

• bandwidth (float) – Bandwith of the proecessed signals in Hz.

• oversampling_factor (int) – Oversampling factor of the modeling.

• carrier_frequency (float) – Target carrier frequency of the modeled radio front-end in Hz.

Return type:

MixerRealization

Returns:

Current state of the radio-frequency block.

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

property i: RFBlockPort

Mixer input port.

property lo: RFBlockPort

Local oscillator port.

property mixer_type: MixerType

Type of the mixer.

property num_input_ports: int

Number of physical ports feeding into this radio-frequency block.

If the returned number is negative, the block can accept an arbitrary number of input ports.

property num_output_ports: int

Number of physical ports emerging from this radio-frequency block.

property o: RFBlockPort

Mixer output port.

class IdealMixer(mixer_type, lo_frequency=0.0, noise_model=None, noise_level=None, seed=None)

Bases: RFBlock

An ideal mixer moving the input signal to a different center frequency.

Parameters:

• mixer_type (MixerType) – Type of the mixer, either UP or DOWN.

• lo_frequency (float) – Center frequency of the mixer’s oscillator in Hz. If set to zero, the device’s configured carrier frequency will be assumed.

• noise_model (NoiseModel | None) – Noise model to use for the mixer.

• noise_level (NoiseLevel | None) – Noise level to use for the mixer.

• seed (int | None) – Seed with which to initialize the block’s random state.

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:

IdealMixer

Returns:

The deserialized object.

realize(bandwidth, oversampling_factor, carrier_frequency)

Return the current state of the radio-frequency block.

Parameters:

• bandwidth (float) – Bandwith of the proecessed signals in Hz.

• oversampling_factor (int) – Oversampling factor of the modeling.

• carrier_frequency (float) – Target carrier frequency of the modeled radio front-end in Hz.

Return type:

IdealMixerRealization

Returns:

Current state of the radio-frequency block.

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

property i: RFBlockPort[IdealMixer]

Input port of the mixer.

property lo_frequency: float

Center frequency of the local oscillator in Hz.

property mixer_type: MixerType

Type of the mixer.

property num_input_ports: int

Number of physical ports feeding into this radio-frequency block.

If the returned number is negative, the block can accept an arbitrary number of input ports.

property num_output_ports: int

Number of physical ports emerging from this radio-frequency block.

property o: RFBlockPort[IdealMixer]

Output port of the mixer.

class MixerType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: SerializableEnum

Type of the considered mixer.

DOWN = 1

Down-converting mixer, converting the input signal to a lower frequency.

UP = 0

Up-converting mixer, converting the input signal to a higher frequency.

class IdealMixerRealization(sampling_rate, oversampling_factor, noise_realization, type, lo_frequency)

Bases: MixerRealization

Parameters:

• sampling_rate (float) – Sampling rate of the block in Hz.

• oversampling_factor (int) – Oversampling factor of the modeling.

• noise_realization – Thermal noise realization applied to the mixer.

• type (MixerType) – Type of the mixer, either UP or DOWN.

• lo_frequency (float) – Center frequency of the mixer’s oscillator in Hz.

property lo_frequency: float

Center frequency of the local oscillator in Hz.

class MixerRealization(sampling_rate, oversampling_factor, noise_realization, mixer_type)

Bases: RFBlockRealization

Realization of a radio-frequency chain mixer block model.

Parameters:

• sampling_rate (float) – Sampling rate of the block in Hz.

• oversampling_factor (int) – Oversampling factor of the modeling.

• noise_realization – Thermal noise realization applied to the mixer.

• mixer_type (MixerType) – Type of the mixer, either UP or DOWN.

property mixer_type: MixerType

Type of the mixer.