5.3. Propagator Settings: Termination Settings¶
PropagationTerminationSettings are a key parameter in the propagation of a body’s orbit, since these will determine the computational time and the size of the output file. Depending on the application, the user may want to end the body propagation according to different criteria. Currently, the following
PropagationTerminationSettings are offered in Tudat:
- Termination once a certain time has passed.
- Termination once a dependent variable meets a certain criterion.
- Termination once multiple criteria are met.
The different types of
PropagationTerminationSettings are implemented by means of derived classes and custom constructors, as detailed in this page.
Base class for the termination settings of the propagation. Different options are implemented in the derived classes below.
As the name suggests, these settings will cause the propagation to terminate after a certain time has passed. Please note that the simulator will finish the final time-step, which may cause the termination time to be slightly overpassed. The constructor is:
PropagationTerminationSettings( terminationTime )
doublethat dictates the time that must pass before the simulation is terminated.
A more powerful method is the use of a
DependentVariableto terminate a propagation. Using this class will terminate the propagation once the chosen dependent variable meets a certain criterion. To do so, the user needs to first create the dependent variable that will dictate the termination of the propagation:
boost::shared_ptr< SingleDependentVariableSaveSettings > terminationDependentVariable = boost::make_shared< SingleDependentVariableSaveSettings >( altitude_dependent_variable, "Vehicle", "Earth" );
where in this example the variable created is an
altitude_dependent_variablewhich provides the altitude of
Vehiclewith respect to
The versatility in the use of
PropagationDependentVariableTerminationSettingsto terminate a simulation lies in the large number of dependent variable types available in Tudat. The user is referred to Propagator Settings: Dependent Variables for a full list of the available dependent variables as well as their use.
The constructor for this derived class is:
PropagationDependentVariableTerminationSettings( terminationDependentVariable, limitValue, useAsLowerLimit )
boost::shared_ptr< SingleDependentVariableSaveSettings >contains the dependent variable used for termination, in this example:
altitude_dependent_variableas declared above.
doublethat provides the lower-limit (or higher-limit) that the
terminationDependentVariablecan take before terminating the propagation.
boolthat dictates whether the
limitValueis used as a lower-limit (true) or as a higher-limit (false).
It may be possible that the user desires to terminate a propagation according several criteria, where such criteria may or may not be fulfilled simulataneously. The constructor for this derived class is:
PropagationHybridTerminationSettings( terminationSettingsList, fulFillSingleCondition )
std::vector< boost::shared_ptr< PropagationTerminationSettings > >where each of its elements contains derived classes of
PropagationTerminationSettings. The desired
PropagationTerminationSettingscan be added by using the
std::vector, where the pushed elements are objects of the classes discussed above.
boolthat determines whether the propagation terminates once a single condition is met (true) or whether all conditions must be met (false).