Skip to content

Code-Symbol Mapping

This page is the engineering crosswalk from canonical code identifiers back to the mathematical symbols defined in Notation Registry.

Capture And Geometry Fields

Canonical code identifier Symbol English name Unit Semantics Implementation path Test path
SourceConfig.center_frequency_hz f_c center frequency Hz Requested capture center frequency for a source include/sdr_analyzer/config.hpp, src/core/session.cpp, src/sdr/rtltcp_source.cpp, src/sdr/uhd_source.cpp, src/sdr/soapy_source.cpp tests/test_session.cpp, tests/test_record_replay.cpp
SourceConfig.sample_rate_hz f_s sample rate Hz Requested complex sample rate for a source include/sdr_analyzer/config.hpp, src/core/session.cpp, src/sdr/simulator_source.cpp, src/sdr/rtltcp_source.cpp, src/sdr/uhd_source.cpp, src/sdr/soapy_source.cpp tests/test_session.cpp, tests/test_record_replay.cpp, tests/test_export_helper.py
ProcessingConfig.fft_size N_fft FFT size samples Number of complex samples transformed per frame include/sdr_analyzer/config.hpp, src/dsp/analyzer.cpp, src/cli/main.cpp, python/sdr_signal_analyzer/gui.py tests/test_pipeline.cpp, tests/test_session.cpp, tests/test_gui_validation.py

Derived Spectrum Fields

Canonical code identifier Symbol English name Unit Semantics Implementation path Test path
SpectrumFrame.bin_resolution_hz Δf bin resolution Hz/bin Frequency spacing between adjacent bins, computed from f_s / N_fft include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_export_helper.py
SpectrumFrame.power_dbfs P_k bin power dBFS/bin Current-frame power spectrum after windowing and FFT normalization include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
SpectrumFrame.average_dbfs \bar{P}_k averaged bin power dBFS/bin Exponentially smoothed display spectrum include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp
SpectrumFrame.peak_hold_dbfs H_k peak-hold bin power dBFS/bin Maximum retained per bin while peak hold is enabled include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp

Analysis Outputs

Canonical code identifier Symbol English name Unit Semantics Implementation path Test path
AnalysisReport.noise_floor_dbfs P_floor noise floor dBFS Low-quantile estimate used as the baseline for heuristics include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
AnalysisReport.strongest_peak_dbfs P_peak strongest peak dBFS Maximum bin power in the current frame include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
AnalysisReport.burst_score S_burst burst score unitless Ratio heuristic used to label short-duty-cycle activity include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp
ProcessingConfig.detection_threshold_db T_det detection threshold offset dB Prominence cutoff for candidate peaks include/sdr_analyzer/config.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
ProcessingConfig.bandwidth_threshold_db T_bw bandwidth threshold offset dB Lower bound used with the roll-off rule for occupied bandwidth include/sdr_analyzer/config.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp

Marker And Detection Outputs

Canonical code identifier Symbol English name Unit Semantics Implementation path Test path
Marker.center_frequency_hz f_m marker center frequency Hz User-defined center of a measurement region include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_export_helper.py
Marker.bandwidth_hz B_m marker bandwidth Hz Width of a measurement region include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_export_helper.py
DetectionResult.center_frequency_hz f_det detection center frequency Hz Estimated location of a detected signal peak include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, src/cli/main.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_record_replay.cpp, tests/test_cli_export.py
DetectionResult.offset_hz f_offset detection offset Hz Difference between f_det and f_c include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
DetectionResult.bandwidth_hz B_det detection bandwidth Hz Estimated occupied bandwidth for one detection include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_record_replay.cpp, tests/test_export_helper.py
DetectionResult.peak_power_dbfs P_det detection peak power dBFS Peak power at the detection bin include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp tests/test_pipeline.cpp, tests/test_record_replay.cpp
DetectionResult.labels L_det detection labels unitless Descriptive heuristic labels applied to a detection include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, src/cli/main.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_record_replay.cpp, tests/test_cli_export.py

Export And Session Surfaces

Canonical code identifier Symbol English name Unit Semantics Implementation path Test path
AnalyzerSnapshot.sequence n frame sequence count Monotonic snapshot counter within a session include/sdr_analyzer/results.hpp, src/core/session.cpp, python/sdr_signal_analyzer/export.py tests/test_session.cpp, tests/test_cli_export.py
MarkerMeasurement.peak_power_dbfs P_marker,peak marker peak power dBFS Peak power within a marker region in one frame include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_export_helper.py
MarkerMeasurement.average_power_dbfs P_marker,avg marker average power dBFS Mean power within a marker region in one frame include/sdr_analyzer/results.hpp, src/dsp/analyzer.cpp, python/sdr_signal_analyzer/export.py tests/test_pipeline.cpp, tests/test_export_helper.py