Receive Power Evaluator¶
The receive power evaluator collects information about the power of a signal impinging onto a device. Within the context of a simulation, the evaluator can be configured like this:
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(waveform=RRCWaveform())
8device_alpha.transmitters.add(modem_alpha)
9modem_beta = ReceivingModem(waveform=RRCWaveform())
10device_beta.receivers.add(modem_beta)
11
12# Configure the simulation
13simulation.add_evaluator(ReceivePowerEvaluator(modem_beta))
14simulation.new_dimension('noise_level', dB(0, 2, 4, 8, 10, 12, 14, 16, 18, 20), device_beta)
15simulation.num_samples = 1000
16result = simulation.run()
- class ReceivePowerEvaluator(target, confidence=1.0, tolerance=0.0, min_num_samples=1024, plot_scale='linear', tick_format=ValueType.LIN, plot_surface=True)[source]¶
Bases:
ScalarEvaluatorEstimates the signal power received receivers.
- Parameters:
target (
Receiver) – The device or receiver to measure the received power of.accuracy – Acceptable bound around the mean value of the estimated scalar performance indicator.
tolerance (
float) – Required confidence level for the given accuracy.min_num_samples (
int) – Minimum number of samples required to compute the confidence bound.plot_surface (
bool) – Enable surface plotting for two-dimensional grids. Enabled by default.base_dimension_index – Index of the base dimension used for plotting.
- 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: