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 Default: 100 Examples: --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 Examples: --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 Rights: write only Default: ./hist
Examples: --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 Default: 1000 Examples: --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 Default: 1000 Examples: --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.