1# In this example we simulate a 5G signal.
2#
3# We model the DL of a frame with a TDD slot format 57, DDDDFFUDDDDFFU,
4# with 30kHz subcarrier spacing, using 2400 subcarriers with 4-PSK.
5#
6# In each drop, 2 time slots are transmitted.
7#
8# An LDPC code with rate R=1/2 and block length 256 is considered.
9#
10# MIMO (SM) with 2x2 antennas is considered.
11#
12# A 5G-TDL channel model type E, with 100 ns rms delay spread is considered.
13# Velocity is 10ms with carrier frequency 3GHz.
14
15!<Simulation>
16
17# Physical device models within the simulated scenario
18Devices:
19
20 # Representation of a single (virtual) device
21 - &device_alpha !<SimulatedDevice>
22
23 carrier_frequency: 865e6 # Center frequency of Rf-band emitted signal
24
25 antennas: !<UniformArray> # Uniform antenna array
26
27 antenna: !<IdealAntenna> # Assume ideal isotropic antennas
28 spacing: 10e-2 # Elements spaced 10cm apart
29 dimensions: [2, 1, 1] # 2 elements within the array
30
31
32# Specify channel models interconnecting devices
33Channels:
34
35 # 5G TDL model at the self-interference channel of device_alpha
36 - !<5GTDL>
37 devices: [*device_alpha, *device_alpha]
38 model_type: !<TDLType> E # Type of the TDL model. A-E are available
39 rms_delay: 1e-9 # root mean square delay in seconds
40
41
42# Operators transmitting or receiving signals over the devices
43Operators:
44
45 # A single modem operating the device #0
46 - &modem_alpha !<Modem>
47
48 device: *device_alpha # Device the modem is operating on
49 reference: *device_alpha # Reference device to which the channel is estimated
50
51 # Bit encoding configuration before mapping to modulation symbols
52 #Encoding:
53 #
54 # - !<LDPC>
55 # block_size: 256
56 # rate: [1, 2]
57
58 # MIMO configuration on the symbol level
59 precoding: !<SymbolCoding>
60
61 - !<SingleCarrier> # Spatial Multiplexing
62
63 # Configuration of the waveform emitted by this transmitter
64 waveform: !<OFDM>
65
66 # Symbol modulation settings
67 modulation_order: 2 # Modulation order, in other words 1 / subcarrier / subsymbol
68 subcarrier_spacing: 30e3 # Spacing between the individual subcarrier center frequencies in Hz
69 dc_suppression: False # Do not ignore the DC component during the DFT
70 num_subcarriers: 4096 # Number of subcarriers per communiction frame
71 channel_estimation: !<OFDM-Ideal> # Assume ideal channel state information at the receiver
72 channel_equalization: !<OFDM-ZF> # Least-squares channel equalization
73
74 # OFDM symbol resources, each resource represents one symbol's subcarrier configuration
75 resources:
76
77 - !<OFDM-Resource>
78 repetitions: 1
79 prefix_type: !<PrefixType> CYCLIC
80 prefix_ratio: 0.0703125
81 elements:
82 - !<FrameElement>
83 type: !<ElementType> NULL
84 repetitions: 600
85 - !<FrameElement>
86 type: !<ElementType> DATA
87 repetitions: 2100
88 - !<FrameElement>
89 type: !<ElementType> NULL
90 repetitions: 600
91
92 - !<OFDM-Resource>
93 repetitions: 1
94 prefix_type: !<PrefixType> CYCLIC
95 prefix_ratio: 0.078125
96 elements:
97 - !<FrameElement>
98 type: NULL
99 repetitions: 600
100 - !<FrameElement>
101 type: DATA
102 repetitions: 2100
103 - !<FrameElement>
104 type: NULL
105 repetitions: 600
106
107 # Frame configuration in time domain, i.e. the x-axis in the OFDM time-frequency grid
108 structure:
109
110 - !<Symbol>
111 num_repetitions: 1
112 pattern: [1, 0, 0, 0]
113
114 - !<Guard>
115 num_repetitions: 3
116 duration: 35.677083e-6
117
118 - !<Symbol>
119 num_repetitions: 1
120 pattern: [1, 0, 0, 0]
121
122 - !<Guard>
123 num_repetitions: 3
124 duration: 35.677083e-6
125
126
127# Performance indication evaluation configuration
128Evaluators:
129
130 # Evaluate the bit errors of `modem_alpha` communicating over `device_alpha`
131 - !<BitErrorEvaluator>
132
133 transmitting_modem: *modem_alpha
134 receiving_modem: *modem_alpha
135 confidence: .9
136 tolerance: .01
137 plot_scale: log
138
139
140# Simulation parameters
141num_samples: 20 # Number of samples per simulation grid section
142min_num_samples: 5 # Minimum number of samples per simulation grid section before premature stopping
143snr_type: EBN0 # SNR is defined as the ratio between bit energy and noise power
144plot_results: True # Visualize the evaluations after the simulation has finished
145num_actors: 12 # This simulation is quite memory demanding. It might be necessary to limit the number of actors.
146
147# Scenario parameters over which the Monte-Carlo simulation sweeps
148Dimensions:
149
150 snr: [24, 20, ..., -12] dB