Package org.orekit.estimation.sequential
Class KalmanModel
- java.lang.Object
-
- org.orekit.estimation.sequential.KalmanModel
-
- All Implemented Interfaces:
NonLinearProcess<MeasurementDecorator>
,KalmanEstimation
public class KalmanModel extends Object implements NonLinearProcess<MeasurementDecorator>
Class defining the process model dynamics to use with aKalmanEstimator
.- Since:
- 9.2
- Author:
- Romain Gerbaud, Maxime Journot
-
-
Constructor Summary
Constructors Constructor Description KalmanModel(List<PropagatorBuilder> propagatorBuilders, List<CovarianceMatrixProvider> covarianceMatricesProviders, ParameterDriversList estimatedMeasurementParameters, CovarianceMatrixProvider measurementProcessNoiseMatrix)
Kalman process model constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
finalizeEstimation(ObservedMeasurement<?> observedMeasurement, ProcessEstimate estimate)
Finalize estimation.List<PropagatorBuilder>
getBuilders()
Getter for the propagators.protected ProcessEstimate
getCorrectedEstimate()
EstimatedMeasurement<?>
getCorrectedMeasurement()
Get the estimated measurement.SpacecraftState[]
getCorrectedSpacecraftStates()
Get the corrected spacecraft states.protected int[][]
getCovarianceIndirection()
AbsoluteDate
getCurrentDate()
Get the current date.int
getCurrentMeasurementNumber()
Get the current measurement number.ProcessEstimate
getEstimate()
Get the current corrected estimate.ParameterDriversList
getEstimatedMeasurementsParameters()
Get the list of estimated measurements parameters.ParameterDriversList
getEstimatedOrbitalParameters()
Get the list of estimated orbital parameters.protected ParameterDriversList[]
getEstimatedOrbitalParametersArray()
ParameterDriversList
getEstimatedPropagationParameters()
Get the list of estimated propagation parameters.protected ParameterDriversList[]
getEstimatedPropagationParametersArray()
Propagator[]
getEstimatedPropagators()
Get the propagators estimated with the values set in the propagators builders.NonLinearEvolution
getEvolution(double previousTime, RealVector previousState, MeasurementDecorator measurement)
RealVector
getInnovation(MeasurementDecorator measurement, NonLinearEvolution evolution, RealMatrix innovationCovarianceMatrix)
protected Map<String,Integer>
getMeasurementParameterColumns()
protected RealMatrix
getNormalizedProcessNoise(int stateDimension)
protected int[]
getOrbitsStartColumns()
RealMatrix
getPhysicalEstimatedCovarianceMatrix()
Get the "physical" estimated covariance matrix (i.e.RealVector
getPhysicalEstimatedState()
Get the "physical" estimated state (i.e.RealMatrix
getPhysicalInnovationCovarianceMatrix()
Get the physical innovation covariance matrix.RealMatrix
getPhysicalKalmanGain()
Get the physical Kalman gain matrix.RealMatrix
getPhysicalMeasurementJacobian()
Get the physical Jacobian of the measurement with respect to the state (H matrix).RealMatrix
getPhysicalStateTransitionMatrix()
Get physical state transition matrix between previous state and estimated (but not yet corrected) state.EstimatedMeasurement<?>
getPredictedMeasurement()
Get the predicted measurement.SpacecraftState[]
getPredictedSpacecraftStates()
Get the predicted spacecraft states.protected Map<String,Integer>
getPropagationParameterColumns()
protected AbsoluteDate
getReferenceDate()
Propagator[]
getReferenceTrajectories()
Getter for the reference trajectories.protected double[]
getScale()
protected void
incrementCurrentMeasurementNumber()
protected void
setCorrectedEstimate(ProcessEstimate correctedEstimate)
protected void
setCorrectedMeasurement(EstimatedMeasurement<?> correctedMeasurement)
protected void
setCorrectedSpacecraftState(SpacecraftState correctedSpacecraftState, int index)
void
setCurrentDate(AbsoluteDate currentDate)
protected void
setPredictedMeasurement(EstimatedMeasurement<?> predictedMeasurement)
protected void
setPredictedSpacecraftState(SpacecraftState predictedSpacecraftState, int index)
void
setReferenceTrajectories(Propagator[] referenceTrajectories)
Setter for the reference trajectories.protected void
updateReferenceTrajectories(Propagator[] propagators)
Update the reference trajectories using the propagators as input.
-
-
-
Constructor Detail
-
KalmanModel
public KalmanModel(List<PropagatorBuilder> propagatorBuilders, List<CovarianceMatrixProvider> covarianceMatricesProviders, ParameterDriversList estimatedMeasurementParameters, CovarianceMatrixProvider measurementProcessNoiseMatrix)
Kalman process model constructor.- Parameters:
propagatorBuilders
- propagators builders used to evaluate the orbits.covarianceMatricesProviders
- providers for covariance matricesestimatedMeasurementParameters
- measurement parameters to estimatemeasurementProcessNoiseMatrix
- provider for measurement process noise matrix
-
-
Method Detail
-
updateReferenceTrajectories
protected void updateReferenceTrajectories(Propagator[] propagators)
Update the reference trajectories using the propagators as input.- Parameters:
propagators
- The new propagators to use
-
getEvolution
public NonLinearEvolution getEvolution(double previousTime, RealVector previousState, MeasurementDecorator measurement)
- Specified by:
getEvolution
in interfaceNonLinearProcess<MeasurementDecorator>
-
getInnovation
public RealVector getInnovation(MeasurementDecorator measurement, NonLinearEvolution evolution, RealMatrix innovationCovarianceMatrix)
- Specified by:
getInnovation
in interfaceNonLinearProcess<MeasurementDecorator>
-
finalizeEstimation
public void finalizeEstimation(ObservedMeasurement<?> observedMeasurement, ProcessEstimate estimate)
Finalize estimation.- Parameters:
observedMeasurement
- measurement that has just been processedestimate
- 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
-
getPhysicalStateTransitionMatrix
public RealMatrix getPhysicalStateTransitionMatrix()
Get physical state transition matrix between previous state and estimated (but not yet corrected) state.- Specified by:
getPhysicalStateTransitionMatrix
in interfaceKalmanEstimation
- 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 interfaceKalmanEstimation
- 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 interfaceKalmanEstimation
- 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 interfaceKalmanEstimation
- Returns:
- Kalman gain matrix (may be null for initial process estimate or if the measurement has been ignored)
-
getPredictedSpacecraftStates
public SpacecraftState[] getPredictedSpacecraftStates()
Get the predicted spacecraft states.- Specified by:
getPredictedSpacecraftStates
in interfaceKalmanEstimation
- Returns:
- predicted spacecraft states
-
getCorrectedSpacecraftStates
public SpacecraftState[] getCorrectedSpacecraftStates()
Get the corrected spacecraft states.- Specified by:
getCorrectedSpacecraftStates
in interfaceKalmanEstimation
- Returns:
- corrected spacecraft states
-
getCurrentMeasurementNumber
public int getCurrentMeasurementNumber()
Get the current measurement number.- Specified by:
getCurrentMeasurementNumber
in interfaceKalmanEstimation
- Returns:
- current measurement number
-
getCurrentDate
public AbsoluteDate getCurrentDate()
Get the current date.- Specified by:
getCurrentDate
in interfaceKalmanEstimation
- Returns:
- current date
-
getPredictedMeasurement
public EstimatedMeasurement<?> getPredictedMeasurement()
Get the predicted measurement.This estimation has been evaluated on the last predicted orbits
- Specified by:
getPredictedMeasurement
in interfaceKalmanEstimation
- Returns:
- predicted measurement
-
getCorrectedMeasurement
public EstimatedMeasurement<?> getCorrectedMeasurement()
Get the estimated measurement.This estimation has been evaluated on the last corrected orbits
- Specified by:
getCorrectedMeasurement
in interfaceKalmanEstimation
- Returns:
- corrected measurement
-
getPhysicalEstimatedState
public RealVector getPhysicalEstimatedState()
Get the "physical" estimated state (i.e. not normalized)- Specified by:
getPhysicalEstimatedState
in interfaceKalmanEstimation
- Returns:
- the "physical" estimated state
-
getPhysicalEstimatedCovarianceMatrix
public RealMatrix getPhysicalEstimatedCovarianceMatrix()
Get the "physical" estimated covariance matrix (i.e. not normalized)- Specified by:
getPhysicalEstimatedCovarianceMatrix
in interfaceKalmanEstimation
- Returns:
- the "physical" estimated covariance matrix
-
getEstimatedOrbitalParameters
public ParameterDriversList getEstimatedOrbitalParameters()
Get the list of estimated orbital parameters.- Specified by:
getEstimatedOrbitalParameters
in interfaceKalmanEstimation
- Returns:
- the list of estimated orbital parameters
-
getEstimatedPropagationParameters
public ParameterDriversList getEstimatedPropagationParameters()
Get the list of estimated propagation parameters.- Specified by:
getEstimatedPropagationParameters
in interfaceKalmanEstimation
- Returns:
- the list of estimated propagation parameters
-
getEstimatedMeasurementsParameters
public ParameterDriversList getEstimatedMeasurementsParameters()
Get the list of estimated measurements parameters.- Specified by:
getEstimatedMeasurementsParameters
in interfaceKalmanEstimation
- Returns:
- the list of estimated measurements parameters
-
getEstimate
public ProcessEstimate getEstimate()
Get the current corrected estimate.- Returns:
- current corrected estimate
-
getBuilders
public List<PropagatorBuilder> getBuilders()
Getter for the propagators.- Returns:
- the propagators
-
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
-
getNormalizedProcessNoise
protected RealMatrix getNormalizedProcessNoise(int stateDimension)
-
getOrbitsStartColumns
protected int[] getOrbitsStartColumns()
-
getEstimatedPropagationParametersArray
protected ParameterDriversList[] getEstimatedPropagationParametersArray()
-
getEstimatedOrbitalParametersArray
protected ParameterDriversList[] getEstimatedOrbitalParametersArray()
-
getCovarianceIndirection
protected int[][] getCovarianceIndirection()
-
getScale
protected double[] getScale()
-
getCorrectedEstimate
protected ProcessEstimate getCorrectedEstimate()
-
setCorrectedEstimate
protected void setCorrectedEstimate(ProcessEstimate correctedEstimate)
-
getReferenceDate
protected AbsoluteDate getReferenceDate()
-
incrementCurrentMeasurementNumber
protected void incrementCurrentMeasurementNumber()
-
setCurrentDate
public void setCurrentDate(AbsoluteDate currentDate)
-
setCorrectedSpacecraftState
protected void setCorrectedSpacecraftState(SpacecraftState correctedSpacecraftState, int index)
-
setPredictedSpacecraftState
protected void setPredictedSpacecraftState(SpacecraftState predictedSpacecraftState, int index)
-
setPredictedMeasurement
protected void setPredictedMeasurement(EstimatedMeasurement<?> predictedMeasurement)
-
setCorrectedMeasurement
protected void setCorrectedMeasurement(EstimatedMeasurement<?> correctedMeasurement)
-
-