3.2.9. Monitor parameters¶

The monitor is the last module in the chain: it compares the decoded information bits with the initially generated ones from the source. Furthermore, it can also compute the mutual information (MI) from the demodulator output.

3.2.9.1. --mnt-max-fe, -e¶

Type: integer 100 --mnt-max-fe 25

Set the maximum number of frame errors to simulated for each noise point.

3.2.9.2. --mnt-err-hist¶

Type: integer --mnt-err-hist 0

Enable the construction of the errors per frame histogram. Set also the maximum number of bit errors per frame included in the histogram (0 means no limit).

The histogram is saved in CSV format:

"Number of error bits per wrong frame"; "Histogram (noise: 5.000000dB, on 10004 frames)"
0; 0
1; 7255
2; 2199
3; 454
4; 84
5; 11
6; 12


3.2.9.3. --mnt-err-hist-path¶

Type: file write only ./hist --mnt-err-hist-path my/histogram/root/path/name

Path to the output histogram. When the files are dumped, the current noise value is added to this name with the .txt extension.

An output filename example is hist_2.000000.txt for a noise value of 2 dB. For Gnuplot users you can then simply display the histogram with the following command:

gnuplot -e "set key autotitle columnhead; plot 'hist_2.000000.txt' with lines; pause -1"


3.2.9.4. --mnt-mutinfo¶

Enable the computation of the mutual information (MI).

Note

Only available on BFER simulation types (see the --sim-type parameter for more details).

3.2.9.5. --mnt-red-lazy¶

Enable the lazy synchronization between the various monitor threads.

Using this parameter can significantly reduce the simulation time, especially for short frame sizes when the monitor synchronizations happen very often.

Note

This parameter is not available if the code has been compiled with MPI.

Note

By default, if the --mnt-red-lazy-freq parameter is not specified, the interval/frequency is set to the same value than the --ter-freq parameter.

Warning

Be careful, this parameter is known to alter the behavior of the --sim-max-fra, -n parameter.

3.2.9.6. --mnt-red-lazy-freq¶

Type: integer 1000 --mnt-red-lazy-freq 200

Set the time interval (in milliseconds) between the synchronizations of the monitor threads.

Note

This parameter automatically enables the --mnt-red-lazy parameter.

Note

This parameter is not available if the code has been compiled with MPI.

3.2.9.7. --mnt-mpi-comm-freq¶

Type: integer 1000 --mnt-mpi-comm-freq 1

Set the time interval (in milliseconds) between the MPI communications. Increase this interval will reduce the MPI communications overhead.

Note

Available only when compiling with the MPI support CMake Options.

Note

When this parameter is specified, the --ter-freq parameter is automatically set to the same value except if the --ter-freq is explicitly defined.