rawrf

Each field contains metadata that determines how the field is written to file.

description

A description of the field.

dim_labels

If applicable, a brief descriptor for each dimension of the dataset. This could be different for different group values. If so, this metadata will be a dict, with the keys being the group name and the values the associated list of dimension labels.

dim_scales

If applicable, dimension scales will be associated to the field. These are datasets that match one of the dimensions of the data, such as timestamps to go along with an array of collected data. Note that some dimensions may be associated with multiple fields. If a dimension has no associated dataset, the list will have a None entry.

groups

The types of data file that need this field to be written.

level

The level within the file that the data will be stored at. Either file or record, indicating that the field is either written once per file, or once per record.

nickname

A nickname for the field, used for making Dimension Scale names.

units

Units for the data.

Fields

agc_status_word

32 bits, a 1 in bit position corresponds to an AGC fault on that transmitter

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

antenna_locations

Relative antenna locations

  • dim_labels: ['antenna', 'local_coord']

  • dim_scales: ['antennas', 'local_coord']

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: m

antennas

Labels for each antenna of the radar

  • dim_labels: ['antenna']

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

blanked_samples

Samples blanked during transmission of a pulse

  • dim_labels: ['time']

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

borealis_git_hash

Version and commit hash of Borealis at runtime

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

experiment_comment

Comment about the whole experiment

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

experiment_id

Number used to identify experiment

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

experiment_name

Name of the experiment class

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

freq

Frequency used for this experiment slice, in kHz

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: kHz

global_coord

Descriptors for global coordinates

  • dim_labels: ['global_coord']

  • level: file

  • nickname: global coord

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

gps_locked

True if the GPS was locked during the entire averaging period

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

gps_to_system_time_diff

Max time diff in seconds between GPS and system/NTP time during the averaging period

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: s

int_time

Integration time in seconds

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: s

local_coord

Descriptors for local coordinates

  • dim_labels: ['local_coord']

  • level: file

  • nickname: local coord

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

lp_status_word

32 bits, a 1 in bit position corresponds to a low power condition on that transmitter

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

num_sequences

Number of sampling periods in the averaging period

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

num_slices

Number of slices in the experiment for this averaging period

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

rawrf_data

I&Q complex voltage samples for each antenna

  • dim_labels: ['sequence', 'antenna', 'time']

  • dim_scales: ['sqn_timestamps', 'rx_antennas', 'sample_time']

  • level: record

  • required_for: ['rawrf']

  • units: a.u. ~ V

rx_antennas

Indices into antenna_locations of the antennas with recorded data

  • level: file

  • nickname: rx antenna

  • required_for: ['antennas_iq', 'rawrf']

rx_intf_antennas

Indices into antenna_locations of the interferometer array antennas used in this experiment

  • level: file

  • required_for: []

rx_main_antennas

Indices into antenna_locations of the main array antennas used in this experiment

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

rx_center_freq

Center frequency of the data in kHz

  • level: file

  • required_for: ['rawrf']

  • units: kHz

rx_sample_rate

Sampling rate of the samples being written to file in Hz

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: Hz

rx_main_excitations

Complex excitations of main array receive antennas for each antenna. Magnitude between 0 (off) and 1 (full power)

  • dim_labels: ['beam', 'antenna']

  • dim_scales: [['beam_azms', 'beam_nums'], 'rx_main_antennas']

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

rx_intf_excitations

Complex excitations of interferometer array receive antennas for each antenna. Magnitude between 0 (off) and 1 (full power)

  • dim_labels: ['beam', 'antenna']

  • dim_scales: [['beam_azms', 'beam_nums'], 'rx_intf_antennas']

  • level: record

  • required_for: []

samples_data_type

C data type of the samples

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

sample_time

Time of measurement relative to the first pulse in the sequence

  • dim_labels: ['time']

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawrf']

  • units: μs

scan_start_marker

Designates if the record is the first in a scan

  • level: record

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

scheduling_mode

Type of scheduling time at the time of this dataset

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

sqn_timestamps

GPS timestamps of start of first pulse for each sampling period in the averaging period

  • dim_labels: ['sequence']

  • level: record

  • nickname: timestamp

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

  • units: seconds since 1970-01-01 00:00:00 UTC

station

Three letter radar identifier

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

station_location

Location of the radar

  • dim_labels: ['global_coord']

  • dim_scales: ['global_coord']

  • level: file

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

tx_antennas

Indices into antenna_locations of the antennas used for transmitting in this experiment

  • level: file

  • nickname: tx antenna

  • required_for: ['antennas_iq', 'bfiq', 'rawacf', 'rawrf']

tx_excitations

Complex excitations of transmit signal for each antenna. Magnitude between 0 (off) and 1 (full power)

  • dim_labels: ['antenna']

  • dim_scales: ['tx_antennas']

  • level: record

  • required_for: []

  • units: a.u.