Transmit Power Evaluator¶
The transmit power evaluator collects information about the power of a signal emerging from 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(TransmitPowerEvaluator(modem_alpha))
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 TransmitPowerEvaluator(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 transmitted by transmitters.
- Parameters:
target (
Transmitter) – The device or transmitter to measure the received power of.confidence (
float) – Required confidence level for the given tolerance between zero and one.tolerance (
float) – Acceptable non-negative bound around the mean value of the estimated scalar performance indicator.min_num_samples (
int) – Minimum number of samples required to compute the confidence bound.plot_scale (
str) – Scale of the plot. Can be'linear'or'log'.tick_format (
ValueType) – Tick format of the plot.plot_surface (
bool) – Enable surface plotting for two-dimensional grids. Enabled by default.
- 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: