Available Parameters#

The framework discussed in the previous section explains how the parameter_settings list is populated. The goal of this section is to list the available parameters that can be used in the variational equations (and which are therefore available for estimation in a state estimation problem), what syntax they use, and explain to which environment models they are linked.

Single Parameters#

  • gravitational_parameter(): Gravitational parameter of a body, linked to a GravityFieldModel object, which may be a point-mass or (time-dependent) spherical harmonic field. Parameter size: 1. Secondary identifier: None.

  • constant_drag_coefficient(): Drag coefficient of a body that is constant, linked to a CustomAerodynamicCoefficientInterface object derived from AerodynamicCoefficientInterface, which must have 0 independent variables for the coefficients. Parameter size: 1. Secondary identifier: None.

  • constant_rotation_rate(): Rotation rate of a body around a fixed axis, linked to a SimpleRotationalEphemeris object derived from RotationalEphemeris. Parameter size: 1. Secondary identifier: None.

  • radiation_pressure_coefficient(): Constant radiation pressure coefficient of a body, linked to a RadiationPressureInterface object. Parameter size: 1. Secondary identifier: None.

  • rotation_pole_position(): Fixed rotation axis about which a body rotates with a fixed rotation rate, linked to a SimpleRotationalEphemeris object. Parameter size: 2 (denoting pole right ascension and declination). Secondary identifier: None.

  • ground_station_position(): Fixed body-fixed position of a ground station on a body, linked to a GroundStationState object (requires a GroundStationState class). Parameter size: 3 (denoting body-fixed x, y and z Cartesian position). Secondary identifier: Ground station name.

  • ppn_parameter_gamma(): Parameter \(\gamma\) used in Parametric Post-Newtonian (PPN) framework, linked to a PPNParameterSet object (nominally the global relativity::ppnParameterSet variable). Parameter size: 1. Note that the name of the associated body should be "global_metric". Secondary identifier: None.

  • ppn_parameter_beta(): Parameter \(\beta\) used in Parametric Post-Newtonian (PPN) framework, linked to a PPNParameterSet object (nominally the global relativity::ppnParameterSet variable). Parameter size: 1. Note that the name of the associated body should be "global_metric". Secondary identifier: None.

  • equivalence_principle_lpi_violation_parameter(): Parameter used to compute influence of a gravitational potential on proper time rate, equals 0 in general relativity, not linked to any object, but instead the equivalencePrincipleLpiViolationParameter global variable (in namespace relativity). Parameter size: 1. Note that the name of the associated body should be "global_metric". Secondary identifier: None.

Initial State Parameters#

Warning

These functions return lists of parameters, which means that they can not be simply added in a list creation statement like [parameter_1, parameter_2, ...]. Instead, this list needs to be concatenated to a list of ‘simple’ parameters, e.g. by using the + operator: parameter_settings + estimation_setup.parameter.initial_states(...).

The factory function for initial states uses the propagator settings to determine which type is needed, e.g. if a translational propagator is defined, the function will automatically create the parameters for initial translational state.

  • initial_translational_state()

  • initial_translational_state_from_ephemeris()

  • arc_wise_initial_translational_state()

  • arc_wise_initial_translational_state_from_ephemeris()

  • initial_rotational_state()

estimation_setup.parameter.initial_states( propagator_settings, bodies )

Spherical Harmonic Parameters#

Tidal Love Number Parameters#

  • full_degree_tidal_love_number()

  • single_degree_variable_tidal_love_number()

Constant Observation Bias Parameters#

  • constant_additive_observation_bias()

  • arc_wise_constant_additive_observation_bias()

  • constant_relative_observation_bias()

  • arc_wise_constant_relative_observation_bias()

Empirical Acceleration Parameters#