Pilot Section

class PilotSection(pilot_elements=None, wave=None)

Bases: Generic[OWT], GridSection[OWT], Serializable

Pilot symbol section within an resource grid.

Parameters:

• pilot_elements (Symbols | None) – Symbols with which the subcarriers within the pilot will be modulated. By default, a pseudo-random sequence from the frame mapping will be generated.

• wave (TypeVar(OWT, bound= OrthogonalWaveform) | None) – The waveform configuration this pilot section is associated with.

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:

PilotSection

Returns:

The deserialized object.

generate(oversampling_factor)

Generate the pilot section in time domain.

Return type:

ndarray

num_samples(bandwidth, oversampling_factor)

Number of samples within this OFDM time-section.

Parameters:

• bandwidth (float) – Bandwidth of the OFDM waveform.

• oversampling_factor (int) – Oversampling factor of resulting time-domain signal.

Return type:

int

Returns: Number of samples within this section.

pick_samples(signal, bandwidth, oversampling_factor)

Pick this section’s samples from the time-domain signal.

Parameters:

• signal (ndarray) – Time-domain signal to be picked from. Numpy vector of size num_samples.

• bandwidth (float) – Bandwidth of the OFDM waveform.

• oversampling_factor (int) – Oversampling factor of resulting time-domain signal.

Return type:

ndarray

Returns: Time-domain signal with the section’s samples picked.

place_samples(signal, bandwidth, oversampling_factor)

Place this section’s samples into the time-domain signal.

Parameters:

• signal (ndarray) – Time-domain signal to be placed. Numpy vector of size num_samples.

• bandwidth (float) – Bandwidth of the OFDM waveform.

• oversampling_factor (int) – Oversampling factor of resulting time-domain signal.

Return type:

ndarray

Returns: Time-domain signal with the section’s samples placed.

place_symbols(data_symbols, reference_symbols)

Place this section’s symbols into the resource grid.

Parameters:

• data_symbols (ndarray) – Data symbols to be placed. Numpy vector of size num_symbols.

• reference_symbols (ndarray) – Reference symbols to be placed. Numpy vector of size num_references.

Return type:

ndarray

Returns: Two dimensional numpy array of size num_words`x`num_subcarriers.

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 num_references: int

Number of data symbols this section can modulate.

property num_repetitions: int

Number of section repetitions in the time-domain of an OFDM grid.

property num_subcarriers: int

Number of subcarriers this section requires.

property num_symbols: int

Number of data symbols this section can modulate.

property num_words: int

Number of OFDM symbols, i.e. words of subcarrier symbols this section can modulate.

property pilot_elements: Symbols | None

Symbols with which the orthogonal subcarriers within the pilot will be modulated.

A stream of symbols. None, if no pilot symbols were specified.

Raises:

ValueError – If the configured symbols contains multiple streams.

property resource_mask: ndarray

property sample_offset: int

Offset in samples to the start of the section.

This can be used to explot cyclic prefixes and suffixes in order to be more robust against timing offsets.