Indoor Factory

Channel implementation of an indoor factory scenario. Refer to the Study on channel model for frequencies from 0.5 to 100 GHz[1] for detailed information.

The following minimal example outlines how to configure the channel model within the context of a Simulation:

# Initialize two devices to be linked by a channel
simulation = Simulation()
alpha_device = simulation.new_device(
    bandwidth=1e5,
    oversampling_factor=8,
    carrier_frequency=1e8,
    pose=Transformation.From_Translation(np.array([0., 0., 3.])),
)
beta_device = simulation.new_device(
    bandwidth=1e5,
    oversampling_factor=8,
    carrier_frequency=1e8,
    pose=Transformation.From_Translation(np.array([40., 40., 3.])),
)

# Create a channel between the two devices
channel = IndoorFactory(10000, 3000, FactoryType.HH, seed=42)
simulation.set_channel(alpha_device, beta_device, channel)

# Configure communication link between the two devices
link = SimplexLink()
alpha_device.transmitters.add(link)
beta_device.receivers.add(link)

# Specify the waveform and postprocessing to be used by the link
link.waveform = RRCWaveform(
    num_data_symbols=1000, num_preamble_symbols=10, pilot_rate=10,
)
link.waveform.channel_estimation = SCLeastSquaresChannelEstimation()

class IndoorFactory(volume, surface, factory_type, clutter_height=0.0, delay_normalization=DelayNormalization.ZERO, oxygen_absorption=True, expected_state=None, gain=1.0, seed=None)

Bases: ClusterDelayLineBase[IndoorFactoryRealization, LOSState]

3GPP cluster delay line preset modeling an indoor factory scenario.

Parameters:

• volume (float) – Hall volume in \(\mathrm{m}^3\).

• surfac – Total surface hall area in \(\mathrm{m}^2\). (walls/floor/ceiling).

• factory_type (FactoryType) – Type of the factory.

• clutter_height (float) – Height of the clutter in the factory hall in meters above the floor. Zero by default, meaning virtually no clutter.

• gain (float) – Linear channel energy gain factor. Initializes the gain property. \(1.0\) by default.

• seed (int | None) – Seed used to initialize the pseudo-random number generator.

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:

IndoorFactory

Returns:

The deserialized object.

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 clutter_height: float

Cluter height in m.

Denoted by \(h_c\) within the respective equations. Should be lower than ceiling height and in between zero and 10m.

property factory_type: FactoryType

Assumed type of factory.

property max_num_clusters: int

Maximum number of clusters a realization will generate.

property max_num_rays: int

Maximum number of rays a realization will generate per cluster.

property surface: float

Assumed factory hall surface in \(\mathrm{m}^2\).

Raises:

ValueError – For values smaller or equal to zero.

property volume: float

Assumed factory hall volume in \(\mathrm{m}^3\).

Raises:

ValueError – For values smaller or equal to zero.

class IndoorFactoryRealization(expected_state, state_realization, los_realization, nlos_realization, parameters, volume, surface, factory_type, clutter_height, sample_hooks, gain=1.0)

Bases: ClusterDelayLineRealization[LOSState]

Realization of the indoor factory channel model.

Parameters:

• expected_state (LOSState | None) – Expected large-scale state of the channel. If not specified, the large-scale state is randomly generated.

• state_realization (ConsistentRealization) – Realization of a spatially consistent random number generator for the large-scale state.

• los_realization (ConsistentRealization) – Realization of a spatially consistent random number generator for small-scale parameters in the LOS state.

• nlos_realization (ConsistentRealization) – Realization of a spatially consistent random number generator for small-scale parameters in the NLOS state.

• parameters (ClusterDelayLineRealizationParameters) – General parameters of the cluster delay line realization.

• volume (float) – Volume of the modeled factory hall in \(\mathrm{m}^3\).

• surface (float) – Surface area of the modeled factory hall in \(\mathrm{m}^2\).

• factory_type (FactoryType) – Type of the factory.

• clutter_height (float) – Height of the clutter in the factory hall in meters above the floor.

• gain (float) – Linear amplitude scaling factor if signals propagated over the channel.

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:

IndoorFactoryRealization

Returns:

The deserialized object.

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

class FactoryType(_, clutter_size, clutter_density)

Bases: SerializableEnum

Type of indoor factory.

Defined in TR 138.901 v17.0.0 Table 7.2-4.

DH = 3

DL = 2

HH = 4

SH = 1

SL = 0

property clutter_density: float

property clutter_size: float

[1]

Study on channel model for frequencies from 0.5 to 100 GHz. 3GPP TSG-RAN, 2020. version 17.0.0 Release 17. URL: https://www.etsi.org/deliver/etsi_tr/138900_138999/138901/17.00.00_60/tr_138901v170000p.pdf.