Interface FieldAdditionalDerivativesProvider<T extends CalculusFieldElement<T>>

    • Method Detail

      • getName

        String getName()
        Get the name of the additional derivatives (which will become state once integrated).
        Returns:
        name of the additional state (names containing "orekit" with any case are reserved for the library internal use)
      • getDimension

        int getDimension()
        Get the dimension of the generated derivative.
        Returns:
        dimension of the generated
      • init

        default void init​(FieldSpacecraftState<T> initialState,
                          FieldAbsoluteDate<T> target)
        Initialize the generator at the start of propagation.
        Parameters:
        initialState - initial state information at the start of propagation
        target - date of propagation
      • yields

        default boolean yields​(FieldSpacecraftState<T> state)
        Check if this provider should yield so another provider has an opportunity to add missing parts.

        Decision to yield is often based on an additional state being already available in the provided state (but it could theoretically also depend on an additional state derivative being already available, or any other criterion). If for example a provider needs the state transition matrix, it could implement this method as:

        
         public boolean yields(final FieldSpacecraftState<T> state) {
             return !state.getAdditionalStates().containsKey("STM");
         }
         

        The default implementation returns false, meaning that derivative data can be computed immediately.

        Parameters:
        state - state to handle
        Returns:
        true if this provider should yield so another provider has an opportunity to add missing parts as the state is incrementally built up
      • combinedDerivatives

        FieldCombinedDerivatives<T> combinedDerivatives​(FieldSpacecraftState<T> s)
        Compute the derivatives related to the additional state (and optionally main state increments).
        Parameters:
        s - current state information: date, kinematics, attitude, and additional states this equations depend on (according to the yields method)
        Returns:
        computed combined derivatives, which may include some incremental coupling effect to add to main state derivatives
        Since:
        11.2