Class AbstractKalmanModel

    • Constructor Detail

      • AbstractKalmanModel

        protected AbstractKalmanModel​(List<OrbitDeterminationPropagatorBuilder> propagatorBuilders,
                                      List<CovarianceMatrixProvider> covarianceMatricesProviders,
                                      ParameterDriversList estimatedMeasurementParameters,
                                      CovarianceMatrixProvider measurementProcessNoiseMatrix,
                                      MatricesHarvester[] harvesters)
        Kalman process model constructor (package private). This constructor is used whenever state type and propagation type do not matter. It is used for KalmanModel and TLEKalmanModel.
        Parameters:
        propagatorBuilders - propagators builders used to evaluate the orbits.
        covarianceMatricesProviders - providers for covariance matrices
        estimatedMeasurementParameters - measurement parameters to estimate
        measurementProcessNoiseMatrix - provider for measurement process noise matrix
        harvesters - harvesters for extracting Jacobians from integrated states
      • AbstractKalmanModel

        protected AbstractKalmanModel​(List<OrbitDeterminationPropagatorBuilder> propagatorBuilders,
                                      List<CovarianceMatrixProvider> covarianceMatricesProviders,
                                      ParameterDriversList estimatedMeasurementParameters,
                                      CovarianceMatrixProvider measurementProcessNoiseMatrix,
                                      MatricesHarvester[] harvesters,
                                      PropagationType propagationType,
                                      PropagationType stateType)
        Kalman process model constructor (package private). This constructor is used whenever propagation type and/or state type are to be specified. It is used for DSSTKalmanModel.
        Parameters:
        propagatorBuilders - propagators builders used to evaluate the orbits.
        covarianceMatricesProviders - providers for covariance matrices
        estimatedMeasurementParameters - measurement parameters to estimate
        measurementProcessNoiseMatrix - provider for measurement process noise matrix
        harvesters - harvesters for extracting Jacobians from integrated states
        propagationType - type of the orbit used for the propagation (mean or osculating), applicable only for DSST
        stateType - type of the elements used to define the orbital state (mean or osculating), applicable only for DSST
    • Method Detail

      • updateReferenceTrajectories

        protected abstract void updateReferenceTrajectories​(Propagator[] propagators,
                                                            PropagationType pType,
                                                            PropagationType sType)
        Update the reference trajectories using the propagators as input.
        Parameters:
        propagators - The new propagators to use
        pType - propagationType type of the orbit used for the propagation (mean or osculating)
        sType - type of the elements used to define the orbital state (mean or osculating)
      • analyticalDerivativeComputations

        protected void analyticalDerivativeComputations​(AbstractJacobiansMapper mapper,
                                                        SpacecraftState state)
        Deprecated.
        as of 11.1, not used anymore
        Not used anymore.
        Parameters:
        mapper - Jacobian mapper to calculate short period perturbations
        state - state used to calculate short period perturbations
      • getPhysicalStateTransitionMatrix

        public RealMatrix getPhysicalStateTransitionMatrix()
        Get physical state transition matrix between previous state and estimated (but not yet corrected) state.
        Specified by:
        getPhysicalStateTransitionMatrix in interface KalmanEstimation
        Returns:
        state transition matrix between previous state and estimated state (but not yet corrected) (may be null for initial process estimate)
      • getPhysicalMeasurementJacobian

        public RealMatrix getPhysicalMeasurementJacobian()
        Get the physical Jacobian of the measurement with respect to the state (H matrix).
        Specified by:
        getPhysicalMeasurementJacobian in interface KalmanEstimation
        Returns:
        physical Jacobian of the measurement with respect to the state (may be null for initial process estimate or if the measurement has been ignored)
      • getPhysicalInnovationCovarianceMatrix

        public RealMatrix getPhysicalInnovationCovarianceMatrix()
        Get the physical innovation covariance matrix.
        Specified by:
        getPhysicalInnovationCovarianceMatrix in interface KalmanEstimation
        Returns:
        physical innovation covariance matrix (may be null for initial process estimate or if the measurement has been ignored)
      • getPhysicalKalmanGain

        public RealMatrix getPhysicalKalmanGain()
        Get the physical Kalman gain matrix.
        Specified by:
        getPhysicalKalmanGain in interface KalmanEstimation
        Returns:
        Kalman gain matrix (may be null for initial process estimate or if the measurement has been ignored)
      • getCurrentMeasurementNumber

        public int getCurrentMeasurementNumber()
        Get the current measurement number.
        Specified by:
        getCurrentMeasurementNumber in interface KalmanEstimation
        Returns:
        current measurement number
      • getEstimate

        public ProcessEstimate getEstimate()
        Get the current corrected estimate.
        Returns:
        current corrected estimate
      • finalizeEstimation

        public void finalizeEstimation​(ObservedMeasurement<?> observedMeasurement,
                                       ProcessEstimate estimate)
        Finalize estimation.
        Parameters:
        observedMeasurement - measurement that has just been processed
        estimate - corrected estimate
      • getReferenceTrajectories

        public Propagator[] getReferenceTrajectories()
        Getter for the reference trajectories.
        Returns:
        the referencetrajectories
      • setReferenceTrajectories

        public void setReferenceTrajectories​(Propagator[] referenceTrajectories)
        Setter for the reference trajectories.
        Parameters:
        referenceTrajectories - the reference trajectories to be setted
      • getMappers

        @Deprecated
        public AbstractJacobiansMapper[] getMappers()
        Deprecated.
        as of 11.1, not used anymore
        Getter for the jacobian mappers.
        Returns:
        the jacobian mappers
      • setHarvesters

        public void setHarvesters​(MatricesHarvester[] harvesters)
        Setter for the jacobian harvesters.
        Parameters:
        harvesters - the jacobian harvesters to set
        Since:
        11.1
      • getEstimatedPropagators

        public Propagator[] getEstimatedPropagators()
        Get the propagators estimated with the values set in the propagators builders.
        Returns:
        propagators based on the current values in the builder