Pilot Section¶

class PilotSection(pilot_elements=None, wave=None)[source]¶

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 (Optional[TypeVar(OWT, bound= OrthogonalWaveform)]) – The waveform configuration this pilot section is associated with.

classmethod Deserialize(process)[source]¶

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 the pilot section in time domain.

pick_samples(signal)[source]¶

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.
Return type:: ndarray

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

place_samples(signal)[source]¶

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.
Return type:: ndarray

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

place_symbols(data_symbols, reference_symbols)[source]¶

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)[source]¶

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_samples: int¶: Number of samples within this OFDM time-section.

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 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.