Space-Time Block Codes#

Space-Time Block codes distribute communication symbols over multiple antennas and time slots. They can be configured by adding an instance to the SymbolPrecoding of a Modem exposed by the precoding attribute.

The following example shows how to configure a modem with a Alamouti precoder within a \(2\times 2\) MIMO communication link:

# Create a new simulation featuring a 2x2 MIMO link between two devices
simulation = Simulation()
tx_device = simulation.new_device(
    antennas=SimulatedUniformArray(SimulatedIdealAntenna(AntennaMode.TX), 0.1, (2,)),
)

rx_device = simulation.new_device(
    antennas=SimulatedUniformArray(SimulatedIdealAntenna(AntennaMode.RX), 0.1, (2,)),
)

# Create a link between the two devices
link = SimplexLink(tx_device, rx_device)

# Configure a single carrier waveform
waveform = RootRaisedCosineWaveform(
    oversampling_factor=4,
    symbol_rate=1e6,
    num_preamble_symbols=16,
    num_data_symbols=32,
    modulation_order=64,
    roll_off=.9,
    channel_estimation=SingleCarrierIdealChannelEstimation(tx_device, rx_device),
)
link.waveform = waveform

# Configure the precoding
link.precoding[0] = Alamouti()

Note that Alamouti precoding requires channel state information at the receiver, therefore waveform’s channel_estimation attribute must be configured.

The following example shows how to configure a modem with a Ganesan precoder within a \(4\times 4\) MIMO communication link:

# Create a new simulation featuring a 4x4 MIMO link between two devices
simulation = Simulation()
tx_device = simulation.new_device(
    antennas=SimulatedUniformArray(SimulatedIdealAntenna(AntennaMode.TX), 0.1, (4,)),
)

rx_device = simulation.new_device(
    antennas=SimulatedUniformArray(SimulatedIdealAntenna(AntennaMode.RX), 0.1, (4,)),
)

# Create a link between the two devices
link = SimplexLink(tx_device, rx_device)

# Configure a single carrier waveform
waveform = RootRaisedCosineWaveform(
    oversampling_factor=4,
    symbol_rate=1e6,
    num_preamble_symbols=16,
    num_data_symbols=32,
    modulation_order=64,
    roll_off=.9,
    channel_estimation=SingleCarrierIdealChannelEstimation(tx_device, rx_device),
)
link.waveform = waveform

# Configure the precoding
link.precoding[0] = Ganesan()

Note that Ganesan precoding requires channel state information at the receiver, therefore waveform’s channel_estimation attribute must be configured.

class Alamouti[source]#

Bases: SymbolPrecoder, Serializable

Alamouti precoder distributing symbols in space and time.

Support for 2 transmit antennas only. Refer to Alamouti[1] for further information.

decode(symbols)[source]#

Decode data for STBC with 2 antenna streams

Received signal with equal noise power is assumed, the decoded signal has same noise level as input.

Parameters:: symbols (StatedSymbols) – Input signal with \(N \times K\) symbol blocks.
Return type:: StatedSymbols

Returns: Decoded data with size \(N \times K\)

encode(symbols)[source]#

Encode data into multiple antennas with space-time/frequency block codes.

Parameters:: symbols (StatedSymbols) – Input signal featuring \(K\) blocks.
Return type:: StatedSymbols

Returns: Encoded data with size \(2 \times K\) symbols

Raises:

ValueError – If more than a single symbol stream is provided.
RuntimeError – If the number of transmit antennas is not two.
ValueError – If the number of data symbols is not even.

property num_input_streams: int#

Required number of input symbol streams for encoding / number of resulting output streams after decoding.

Returns:: The number of symbol streams.
Return type:: int

property num_output_streams: int#

Required number of input symbol streams for decoding / number of resulting output streams after encoding.

Returns:: The number of symbol streams.
Return type:: int

class Ganesan[source]#

Bases: SymbolPrecoder, Serializable

Girish Ganesan and Petre Stoica general precoder distributing symbols in space and time.

Supports 4 transmit antennas. Features a \(\frac{3}{4}\) symbol rate. Refer to Ganesan and Stoica[2] for further information.

decode(symbols)[source]#

Decode data for STBC with 4 antenna streams Note that Ganesan schema’s symbol rate is \(\frac{3}{4}\) so the decoding process decreases the number of blocks by \(\frac{3}{4}\).

Parameters:: symbols (StatedSymbols) – Input signal with \(4 \times N\) symbol blocks.
Return type:: StatedSymbols
Returns:: Decoded data with size \(3 \times N\) Returned channel states are initialized with ones (np.ones is used).

encode(symbols)[source]#

Encode data into multiple antennas with space-time/frequency block codes. Note that Ganesan schema’s symbol rate is \(\frac{3}{4}\) so the encoding process increases the number of blocks by \(\frac{4}{3}\).

Parameters:

symbols (StatedSymbols) – Input signal featuring \(K\) blocks.

Return type:

StatedSymbols

Returns:

Encoded data with size \(\frac{4}{3} \times K\) symbol blocks. Thus num_blocks is changed to num_blocks / 3 * 4. Returned channel states are initialized with ones (np.ones is used).

Raises:

ValueError – If more than a single symbol stream is provided.
RuntimeError – If the number of transmit antennas is not four.
ValueError – If the number of data symbols blocks is not divisable by three.

property num_input_streams: int#

Required number of input symbol streams for encoding / number of resulting output streams after decoding.

Returns:: The number of symbol streams.
Return type:: int

property num_output_streams: int#

Required number of input symbol streams for decoding / number of resulting output streams after encoding.

Returns:: The number of symbol streams.
Return type:: int

property rate: Fraction#

Rate between input symbol slots and output symbol slots.

For example, a rate of one indicates that no symbols are getting added or removed during precoding.

Returns:: The precoding rate.
Return type:: Fraction