Bit Error Rate¶
Considering two linked modems denoted by \((\alpha)\) and \((\beta)\), with modem \((\alpha)\) transmitting a bit stream
and modem \((\beta)\) receiving a bit stream
Hermes defines the bit error rate (BER) as the average number of bit errors between the streams
In practice, the number of bits \(B\) may differ between transmitter and receiver. In this case, the shorter bit stream is padded with zeros.
The following minimal examples outlines how to configure this evaluator within the context of a simulation campaign:
1# Create a new simulation featuring two devices
2simulation = Simulation()
3device_alpha = simulation.new_device()
4device_beta = simulation.new_device()
5
6# Create a transmitting and receiving modem for each device, respectively
7modem_alpha = TransmittingModem()
8device_alpha.transmitters.add(modem_alpha)
9modem_beta = ReceivingModem()
10device_beta.receivers.add(modem_beta)
11
12# Configure the modem's waveform
13waveform_configuration = {
14 'symbol_rate': 1e8,
15 'num_preamble_symbols': 10,
16 'num_data_symbols': 100,
17}
18modem_alpha.waveform = RootRaisedCosineWaveform(**waveform_configuration)
19modem_beta.waveform = RootRaisedCosineWaveform(**waveform_configuration)
20
21simulation.add_evaluator(BitErrorEvaluator(modem_alpha, modem_beta))
22simulation.new_dimension('noise_level', dB(0, 2, 4, 8, 10, 12, 14, 16, 18, 20), device_beta)
23simulation.num_samples = 1000
24result = simulation.run()
- class BitErrorEvaluator(transmitting_modem, receiving_modem, plot_surface=True)[source]¶
Bases:
CommunicationEvaluator
,Serializable
Evaluate bit errors between two modems exchanging information.
- Parameters:
transmitting_modem (TransmittingModem) – Modem transmitting information.
receiving_modem (ReceivingModem) – Modem receiving information.
plot_surface (bool, optional) – Plot the surface of the evaluation result in two-dimensional grids. Defaults to True.
- evaluate()[source]¶
Evaluate the state of an investigated object.
Implements the process of extracting an arbitrary performance indicator, represented by the returned
Artifact
\(X_m\).Returns: Artifact \(X_m\) resulting from the evaluation.
- Return type:
- class BitErrorArtifact(artifact)[source]¶
Bases:
ArtifactTemplate
[float64
]Artifact of a bit error evaluation between two modems exchanging information.
Generated by
artifact()
ofBitErrorEvaluation
.- Parameters:
artifact (AT) – Artifact value.
- class BitErrorEvaluation(evaluation)[source]¶
Bases:
ErrorEvaluation
Bit error evaluation between two modems exchanging information.
Generated by
evaluate()
ofBitErrorEvaluator
.- Parameters:
evaluation (ET) – The represented evaluation.