Description
The Integrator object is a base type that provides tolerance, max tries, force model, and fixed step properties to the objects that derive from it. See the Stepping the Spacecraft Guide for more information.
Users cannot create instances of this type of object. However, users can access instances of this object type that have been created indirectly, for example as children of other objects. Users can also access any static properties and methods on this object type.
Inheritance Hierarchy: ObjectàPropagatoràIntegrator
Derived Types: BulStoer, BulStoerVOP, Cowell, RK45, RK78, RK78VOP, RK89
Available In Editions:
Engineer
Mission
Timing Precision Mode
This page describes functionality in millisecond timing precision mode.
Name
|
Description
|
AllowErrorViolation
|
Determines whether the error tolerance may be violated once the minimum step size is reached. If this property is set to true, and the integrator step error does not meet the tolerance at 1 ms step size, the state is automatically advanced 1 ms ahead and a warning is generated.
|
CalculateSTM
|
Flag indicating whether or not to calculate the state transition matrix at each integration step as part of the state integration. If the PropagateCovariance flag is set to TRUE on the SpacecraftODProperties object or if the Spacecraft is in an estimation process, the STM is always calculated. If the Spacecraft.Propagator is not an Integrator type then this property is ignored.
|
DeclaredName
|
The name of the object as declared.
|
FixedStep
|
Flag denoting whether the propagator is being run in fixed-step mode (i.e. constant StepSize) or in variable-step mode (i.e. variable StepSize).
|
ForceModel
|
A force model.
|
LargeCurvature
|
Flag that signifies whether the integration has failed due to a large curvature in the force field. (1 = Integration Failed, 0 = Integration Nominal, -1 = No Integration has been performed).
|
MaxTries
|
The maximum number of times to attempt to change the step size in the integration process in order to meet the specified error tolerance. If the specified error tolerance is not met after MaxTries attempts, an error is thrown.
|
Name
|
The name displayed for this object in output windows such as views, plots, and reports.
|
ObjectId
|
The unique identifier for the object.
|
ObjectType
|
The type of the object.
|
StepJustTaken
|
The size of the previous step taken by the integration process.
|
StepsAttempted
|
This represents the sum of the successful and failed steps. This property will closely reflect the performance of the integrator since it is a measure of the total number of steps executed by the integrator.
|
StepsFailed
|
This property is incremented once each time the integrator steps the spacecraft forward and the integrator tolerance is not met. A high ratio of the number of failed to successful steps may suggest that the integrator tolerance is too high.
|
StepSize
|
The number of seconds the propagated object is advanced when the Step command is executed.
|
StepsRequested
|
Represents the count of integration steps requested by the user. This property will be incremented once each time the FreeFlyer engine advances the spacecraft to a desired epoch. For the Step command, this property will be incremented once. For interval methods and Step-to commands, this property will be incremented each time bisection is performed unitl the condition is met. Abnormally high values on this property can indicate that the IntervalStopAccuracy may be too strict.
|
StepsSuccessful
|
This property is incremented for every successful step of the integrator. Since it may take several steps to reach the desired epoch at the specified tolerance, the number of successful steps may be greater than the number of requested steps.
|
StepToTake
|
The maximum possible size of the next step to take in the integration process based on the relative error tolerance. When the StepSize property is set, this property is initialized with the new StepSize value and is updated after the next step is taken.
|
STM
|
Returns the State Transition Matrix. The matrix is always a square where the length of each side is determined by the total number of properties being estimated or considered.
|
STMCalculationMethod
|
A flag indicating the method to be used to calculate the state transition matrix. Note that even if the CalculateSTM property is set to FALSE, this property still applies if the SpacecraftODProperties.PropagateCovariance flag is to TRUE or if the Spacecraft is included in an estimation process.
|
Tolerance
|
When the Step command is executed, intermediate integration steps are taken to ensure that the local error never exceeds this value.
|
|
Name
|
Description
|
ClearSavedStates
|
Clears previous saved states for this object.
|
GetFromFile
|
Load the object state from the specified FreeFlyer object file.
|
GetFromString
|
Load the object state from the specified string.
|
PutToFile
|
Convert the object state to FreeFlyer object xml and write to a file.
|
PutToString
|
Convert the object state to FreeFlyer object xml and return as a string.
|
ReferenceEquals
|
Returns 1 if the argument refers to the calling object and 0 otherwise.
|
ResetStepStatistics
|
Resets the Integrator step counters back to zero. The step counters will continue incrementing the next time the spacecraft is stepped.
|
Restore
|
Restore an object's state from a previously saved state.
|
Save
|
Save the object's state so that it can be restored later.
|
|
See also
Choosing an Integrator
Setting up an Integrator
|