gnssrefl.gnss_frequencies module

Central registry of GNSS frequency and constellation metadata.

All frequency codes, wavelengths, satellite ranges, display labels, and SNR column mappings are defined here. Other modules should use the accessor functions rather than maintaining their own hardcoded lists.

This module has NO dependencies on other gnssrefl modules at import time, so it can be safely imported from anywhere without circular import issues.

gnssrefl.gnss_frequencies.all_default_frequencies()

All-constellation default frequency list for gnssir_input -allfreq.

GPS L2 P-code (code 2) is excluded; we prefer L2C (code 20).

gnssrefl.gnss_frequencies.all_frequencies()

Return sorted list of all valid frequency codes.

gnssrefl.gnss_frequencies.get_constellation(f)

Return constellation name for a frequency code.

gnssrefl.gnss_frequencies.get_display_label(f)

Return display label like ‘GPS L2C’ for plot titles.

gnssrefl.gnss_frequencies.get_file_suffix(f)

Return file naming suffix like ‘_G_L1’, ‘_E_L7’, ‘_C_L5’.

Format is ‘_<constellation_char>_<signal_label>’ using the RINEX 3 constellation chars (G/R/E/C) and band labels (L1/L2/L2C/L5/L6/L7/L8).

gnssrefl.gnss_frequencies.get_glonass_channel(prn)

Return the FDMA channel number for a GLONASS satellite, or None if unknown.

gnssrefl.gnss_frequencies.get_glonass_wavelength(f, prn)

Return GLONASS wavelength in meters for frequency code f and satellite prn.

GLONASS uses FDMA so each satellite transmits on a slightly different carrier determined by its channel number. f is 101 (G1) or 102 (G2). Raises ValueError if the satellite slot has no known channel assignment.

gnssrefl.gnss_frequencies.get_sat_list(f)

Return numpy array of satellite PRNs for a frequency’s constellation.

gnssrefl.gnss_frequencies.get_sat_range(f)

Return (start, stop) tuple for np.arange to build a satellite list.

gnssrefl.gnss_frequencies.get_scale_factor(f, sat=None)

Return wavelength/2 (the LSP scale factor cf).

gnssrefl.gnss_frequencies.get_signal_label(f)

Return signal label like ‘L1’, ‘L2C’, ‘L5’.

gnssrefl.gnss_frequencies.get_snr_column(f)

Return 1-based SNR file column index for a frequency code.

gnssrefl.gnss_frequencies.get_wavelength(f, sat=None)

Return wavelength in meters. For GLONASS, sat number is required.

gnssrefl.gnss_frequencies.gps_default_frequencies()

Default GPS-only frequency list for gnssir_input.

gnssrefl.gnss_frequencies.is_valid_frequency(f)

Check whether a frequency code is recognized.

gnssrefl.gnss_frequencies.signal_label_to_freq(constellation_char, signal_label)

Return the frequency code for a RINEX constellation char and signal label.

Parameters:

• constellation_char (str) – Single RINEX char: ‘G’ (GPS), ‘R’ (GLONASS), ‘E’ (Galileo), ‘C’ (BeiDou)

• signal_label (str) – Signal label like ‘L1’, ‘L2’, ‘L5’, ‘L6’, ‘L7’, ‘L8’, ‘L2C’

Returns:

Frequency code (e.g. 1, 20, 205, 302)

Return type:

int

Raises:

KeyError – If the (constellation_char, signal_label) pair is not recognized

gnssrefl.gnss_frequencies.wl(freq_mhz)

Wavelength in meters from frequency in MHz.