MPSK SNR Estimator Probe: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:Block Docs]]
[[Category:Block Docs]]
[[Category:Stub Docs]]
 
See [[MPSK SNR Estimator]], this block makes the same calculation but outputs the resulting SNR as a message instead of a tag, which can be outputted to the console using a [[Message Debug]] block.
See [[MPSK SNR Estimator]], this block makes the same calculation but outputs the resulting SNR as a message instead of a tag, which can be outputted to the console using a [[Message Debug]] block.


This is a probe block (a sink) that can be used to monitor and retrieve estimations of the signal SNR. This probe is designed for use with M-PSK signals especially. The type of estimator is specified as the  parameter in the constructor. The estimators tend to trade off performance for accuracy, although experimentation should be done to figure out the right approach for a given implementation. Further, the current set of estimators are designed and proven theoretically under AWGN conditions; some amount of error should be assumed and/or estimated for real channel conditions.


As this is a basic template, it's also in the [[:Category:Stub_Docs|"Stub Docs category"]]. Please improve it.
The block has three output message ports that will emit a message every msg_samples number of samples.  These message ports are:
* snr: the current SNR estimate (in dB)
* signal: the current signal power estimate (in dBx)
* noise: the current noise power estimate (in dBx)
 
Some calibration is required to convert dBx of the signal and noise power estimates to real measurements, such as dBm.


== Parameters ==
== Parameters ==
(''R''): <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls ''Run-time adjustable'']</span>
(''R''): <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls ''Run-time adjustable'']</span>


; Param 1 (''R'')
; Type (''R'')
: Description of parameter, provide any tips or recommended values. Note that the name of the parameter above should match the param's label that shows up in grc (e.g. Sample Rate).
: The type of estimator to use. See [[MPSK SNR Estimator]] for details about the types.
 
; Samples between SNR messages (''R'')
: [not implemented yet] after this many samples, a message containing the SNR (key='snr') will be sent


; Param 2
; Filter Alpha (''R'')
: blah blah blah
: The update rate of internal running average calculations.


== Example Flowgraph ==
== Example Flowgraph ==
Line 22: Line 31:


; C++ files
; C++ files
: [https://github.com/gnuradio/gnuradio TODO]
: [https://github.com/gnuradio/gnuradio/blob/master/gr-digital/lib/probe_mpsk_snr_est_c_impl.cc]


; Header files
; Header files
: [https://github.com/gnuradio/gnuradio TODO]
: [https://github.com/gnuradio/gnuradio/blob/master/gr-digital/lib/probe_mpsk_snr_est_c_impl.h]


; Public header files
; Public header files
: [https://github.com/gnuradio/gnuradio TODO]
: [https://github.com/gnuradio/gnuradio/blob/master/gr-digital/include/gnuradio/digital/probe_mpsk_snr_est_c.h]


; Block definition
; Block definition
: [https://github.com/gnuradio/gnuradio TODO]
: [https://github.com/gnuradio/gnuradio/blob/master/gr-digital/grc/digital_probe_mpsk_snr_est_c.block.yml]

Revision as of 15:01, 6 September 2019


See MPSK SNR Estimator, this block makes the same calculation but outputs the resulting SNR as a message instead of a tag, which can be outputted to the console using a Message Debug block.

This is a probe block (a sink) that can be used to monitor and retrieve estimations of the signal SNR. This probe is designed for use with M-PSK signals especially. The type of estimator is specified as the parameter in the constructor. The estimators tend to trade off performance for accuracy, although experimentation should be done to figure out the right approach for a given implementation. Further, the current set of estimators are designed and proven theoretically under AWGN conditions; some amount of error should be assumed and/or estimated for real channel conditions.

The block has three output message ports that will emit a message every msg_samples number of samples. These message ports are:

  • snr: the current SNR estimate (in dB)
  • signal: the current signal power estimate (in dBx)
  • noise: the current noise power estimate (in dBx)

Some calibration is required to convert dBx of the signal and noise power estimates to real measurements, such as dBm.

Parameters

(R): Run-time adjustable

Type (R)
The type of estimator to use. See MPSK SNR Estimator for details about the types.
Samples between SNR messages (R)
[not implemented yet] after this many samples, a message containing the SNR (key='snr') will be sent
Filter Alpha (R)
The update rate of internal running average calculations.

Example Flowgraph

Insert description of flowgraph here, then show a screenshot of the flowgraph and the output if there is an interesting GUI. Currently we have no standard method of uploading the actual flowgraph to the wiki or git repo, unfortunately. The plan is to have an example flowgraph showing how the block might be used, for every block, and the flowgraphs will live in the git repo.

Source Files

C++ files
[1]
Header files
[2]
Public header files
[3]
Block definition
[4]