Package org.orekit.estimation.measurements

Interface ObservedMeasurement<T extends ObservedMeasurement<T>>

Type Parameters:

T - the type of the measurement

All Superinterfaces:

Comparable<ComparableMeasurement>, ComparableMeasurement, ParameterDriversProvider, TimeStamped

All Known Implementing Classes:

AbstractInterSatellitesMeasurement, AbstractMeasurement, AbstractOnBoardMeasurement, AbstractOneWayGNSSMeasurement, AngularAzEl, AngularRaDec, BistaticRange, BistaticRangeRate, FDOA, GroundReceiverMeasurement, InterSatellitesOneWayRangeRate, InterSatellitesPhase, InterSatellitesRange, MultiplexedMeasurement, OneWayGNSSPhase, OneWayGNSSRange, OneWayGNSSRangeRate, Phase, Position, PV, Range, RangeRate, TDOA, TurnAroundRange

public interface ObservedMeasurement<T extends ObservedMeasurement<T>>
extends ComparableMeasurement, ParameterDriversProvider

Interface for measurements used for orbit determination.

The most important methods of this interface allow to:

• get the observed value,
• estimate the theoretical value of a measurement,
• compute the corresponding partial derivatives (with respect to state and parameters)

The estimated theoretical values can be modified by registering one or several EstimationModifier objects. These objects will manage notions like tropospheric delays, biases, ...

Since:

8.0

Author:

Luc Maisonobe

Method Summary

Modifier and Type	Method	Description
void	addModifier(EstimationModifier<T> modifier)	Add a modifier.
EstimatedMeasurement<T>	estimate(int iteration, int evaluation, SpacecraftState[] states)	Estimate the theoretical value of the measurement, with derivatives.
EstimatedMeasurementBase<T>	estimateWithoutDerivatives(int iteration, int evaluation, SpacecraftState[] states)	Estimate the theoretical value of the measurement, without derivatives.
default EstimatedMeasurementBase<T>	estimateWithoutDerivatives(SpacecraftState[] states)	Estimate the theoretical value of the measurement, without derivatives.
double[]	getBaseWeight()	Get the base weight associated with the measurement
int	getDimension()	Get the dimension of the measurement.
default String	getMeasurementType()	Get the type of measurement.
List<EstimationModifier<T>>	getModifiers()	Get the modifiers that apply to a measurement.
List<ObservableSatellite>	getSatellites()	Get the satellites related to this measurement.
double[]	getTheoreticalStandardDeviation()	Get the theoretical standard deviation.
boolean	isEnabled()	Check if a measurement is enabled.
void	setEnabled(boolean enabled)	Enable or disable a measurement.

Methods inherited from interface org.orekit.estimation.measurements.ComparableMeasurement

compareTo, getObservedValue

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, getParametersDrivers, isSupported

Methods inherited from interface org.orekit.time.TimeStamped

durationFrom, getDate

Method Detail

setEnabled

void setEnabled(boolean enabled)

Enable or disable a measurement.

Disabling a measurement allow to not consider it at one stage of the orbit determination (for example when it appears to be an outlier as per current estimated covariance).

Parameters:

enabled - if true the measurement will be enabled, otherwise it will be disabled

isEnabled

boolean isEnabled()

Check if a measurement is enabled.

Returns:

true if the measurement is enabled

getDimension

int getDimension()

Get the dimension of the measurement.

Dimension is the size of the array containing the value. It will be one for a scalar measurement like a range or range-rate, but 6 for a position-velocity measurement.

Returns:

dimension of the measurement

getTheoreticalStandardDeviation

double[] getTheoreticalStandardDeviation()

Get the theoretical standard deviation.

The theoretical standard deviation is a theoretical value used for normalizing the residuals. It acts as a weighting factor to mix appropriately measurements with different units and different accuracy. The value has the same dimension as the measurement itself (i.e. when a residual is divided by this value, it becomes dimensionless).

Returns:

expected standard deviation

See Also:

getBaseWeight()

getBaseWeight

double[] getBaseWeight()

Get the base weight associated with the measurement

The base weight is used on residuals already normalized thanks to getTheoreticalStandardDeviation() to increase or decrease relative effect of some measurements with respect to other measurements. It is a dimensionless value, typically between 0 and 1 (but it can really have any non-negative value).

Returns:

base weight

See Also:

getTheoreticalStandardDeviation()

addModifier

void addModifier(EstimationModifier<T> modifier)

Add a modifier.

The modifiers are applied in the order in which they are added in order to estimate the measurement.

Parameters:

modifier - modifier to add

See Also:

getModifiers()

getModifiers

List<EstimationModifier<T>> getModifiers()

Get the modifiers that apply to a measurement.

Returns:

modifiers that apply to a measurement

See Also:

addModifier(EstimationModifier)

getSatellites

List<ObservableSatellite> getSatellites()

Get the satellites related to this measurement.

Returns:

satellites related to this measurement

Since:

9.3

estimateWithoutDerivatives

default EstimatedMeasurementBase<T> estimateWithoutDerivatives(SpacecraftState[] states)

Estimate the theoretical value of the measurement, without derivatives.

The estimated value is the combination of the raw estimated value and all the modifiers that apply to the measurement.

Parameters:

states - orbital states corresponding to getSatellites() at measurement date

Returns:

estimated measurement

Since:

12.1

estimateWithoutDerivatives

EstimatedMeasurementBase<T> estimateWithoutDerivatives(int iteration,
                                                       int evaluation,
                                                       SpacecraftState[] states)

Estimate the theoretical value of the measurement, without derivatives. For use in orbit determination.

The estimated value is the combination of the raw estimated value and all the modifiers that apply to the measurement.

Parameters:

iteration - iteration number

evaluation - evaluations number

states - orbital states corresponding to getSatellites() at measurement date

Returns:

estimated measurement

Since:

12.0

estimate

EstimatedMeasurement<T> estimate(int iteration,
                                 int evaluation,
                                 SpacecraftState[] states)

Estimate the theoretical value of the measurement, with derivatives.

The estimated value is the combination of the raw estimated value and all the modifiers that apply to the measurement.

Parameters:

iteration - iteration number

evaluation - evaluations number

states - orbital states corresponding to getSatellites() at measurement date

Returns:

estimated measurement

getMeasurementType

default String getMeasurementType()

Get the type of measurement.

Default behavior is to return the class simple name as a String.

Returns:

type of measurement