MeasurementDataSet#

class MeasurementDataSet(set_name: str, measurements: list, names: list[str], instrument: Instrument, target: Body, epochs_t3: EpochArray, measurement_type: str = None, station_two: GroundStation = None, units=None, frame=None)#

Bases: object

Groups together measurement data from different measurement models. Used by the active filter.

Generates a list of packaged data from a given measurement. At each epoch at which the filter has a valid measurement, provides access to its computed and observed value, residual, numerical value of the partial, and the standard deviation of the measurement.

Parameters:
set_namestr

The name of the dataset.

measurementslist

List with AWU, np.array, and lists of measurements data (e.g. observed, computed, residuals, partials, sigmas).

nameslist[str]

List of values in the measurement list (["computed", "observed", "residuals", "partials", "sigma"]).

instrumentInstrument

Instrument used to generate these measurements (e.g. antenna, camera, etc.)

targetBody

Target body of the measurement model.

epochs_t3EpochArray

Epochs of the measurements.

measurement_typestr, optional

The type of measurements. Can be given as:

  • range

  • range real

  • rangerate

  • doppler

  • doppler real

  • opnav

  • dor

Defaults to None.

station_twoGroundStation, optional

Optional Ground station object for three-way and DOR measurements. Defaults to None.

Attributes:
data

The measurement data dictionary (computed, observed, residuals, partials, sigmas).

epochs_t3

The reception epochs linked to the measurements.

frame

Frame the measurements were generated in (a Frame object), or None.

instrument

The instrument that generated the measurements.

measurement_type

The measurement type string tag (e.g.

set_name

The name of the dataset.

station_two

The second ground station, for three-way and DOR measurement types.

target

Target body of the measurement model.

units

Units of the measurement values (an ArrayWUnits units object), or None.

Methods

add_data(data, name)

Adds data to an existing dataset.

See also

scarabaeus.Measurement

Abstract base class for all measurement models.

Notes

The dataset is populated by generate_measurement_dataset() and stores all quantities needed by a filter at each measurement epoch: computed value, observed value, prefit residual, measurement partials (\(H\) row), and measurement noise standard deviation (\(\sigma\)). The outlier_flag column (value 0/1) allows downstream editing without removing data permanently.

add_data(data: list, name: str)#

Adds data to an existing dataset.

Parameters:
datalist

Extra data to add to an existing MeasurementDataset object.

namestr

The name of the dataset.

property data: list[str]#

The measurement data dictionary (computed, observed, residuals, partials, sigmas).

property epochs_t3: EpochArray#

The reception epochs linked to the measurements.

property frame#

Frame the measurements were generated in (a Frame object), or None.

property instrument: Instrument#

The instrument that generated the measurements.

property measurement_type#

The measurement type string tag (e.g. "range", "doppler").

property set_name: str#

The name of the dataset.

property station_two: GroundStation#

The second ground station, for three-way and DOR measurement types.

property target: Body#

Target body of the measurement model.

property units#

Units of the measurement values (an ArrayWUnits units object), or None.