Class KnownBiasTurntableGyroscopeCalibrator
- All Implemented Interfaces:
AccelerometerDependentGyroscopeCalibrator,GyroscopeCalibrator,GyroscopeNonLinearCalibrator,KnownBiasGyroscopeCalibrator,UnorderedStandardDeviationBodyKinematicsGyroscopeCalibrator
This calibrator assumes that the IMU is placed flat on a turntable spinning at constant speed, but absolute orientation or position of IMU is unknown. Turntable must rotate fast enough so that Earth rotation effects can be neglected, bus slow enough so that gyroscope readings can be properly made.
To use this calibrator at least 7 measurements are needed when common z-axis is assumed and G-dependent cross biases are ignored, otherwise at least 10 measurements are required when common z-axis is not assumed. If G-dependent cross biases are being estimated, then at least 16 measurements are needed when common z-axis is assumed, otherwise at least 19 measurements are required when common z-axis is not assumed.
Measured gyroscope angular rates is assumed to follow the model shown below:
Ωmeas = bg + (I + Mg) * Ωtrue + Gg * ftrue + w
Where:
- Ωmeas is the measured gyroscope angular rates. This is a 3x1 vector.
- bg is the gyroscope bias. Ideally, on a perfect gyroscope, this should be a
3x1 zero vector.
- I is the 3x3 identity matrix.
- Mg is the 3x3 matrix containing cross-couplings and scaling factors. Ideally, on
a perfect gyroscope, this should be a 3x3 zero matrix.
- Ωtrue is ground-truth gyroscope angular rates.
- Gg is the G-dependent cross biases introduced by the specific forces sensed
by the accelerometer. Ideally, on a perfect gyroscope, this should be a 3x3
zero matrix.
- ftrue is ground-truth specific force. This is a 3x1 vector.
- w is measurement noise. This is a 3x1 vector.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final AccelerationFixerAcceleration fixer.private doubleKnown x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnow accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private doubleKnown accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private com.irurueta.algebra.MatrixInternally holds biases during calibration.private com.irurueta.algebra.MatrixInternally holds accelerometer bias during calibration.private doubleKnown x-coordinate of gyroscope bias.private doubleKnown y-coordinate of gyroscope bias.private doubleKnown z-coordinate of gyroscope bias.static final intNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope when G-dependent cross biases are not being estimated.static final intNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope when G-dependent cross biases are being estimated.private booleanThis flag indicates whether z-axis is assumed to be common for accelerometer and gyroscope.static final booleanIndicates that by default G-dependent cross biases introduced by the accelerometer on the gyroscope are estimated.static final doubleDefault time interval between measurements expressed in seconds (s).static final doubleDefault turntable rotation rate.static final booleanIndicates whether by default a common z-axis is assumed for both the accelerometer and gyroscope.private doubleEstimated chi square value.private intEstimated degrees of freedom of chi square value.private com.irurueta.algebra.MatrixEstimated covariance matrix for estimated parameters.private com.irurueta.algebra.MatrixEstimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.private com.irurueta.algebra.MatrixEstimated gyroscope scale factors and cross coupling errors.private doubleEstimated mean square error respect to provided measurements.private doubleEstimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0.private doubleEstimated measure of quality of estimated fit as a value between 0.0 and 1.0.private doubleEstimated reduced chi square value.private booleanThis flag indicates whether G-dependent cross biases are being estimated or not.private final com.irurueta.numerical.fitting.LevenbergMarquardtMultiDimensionFitterLevenberg-Marquardt fitter to find a non-linear solution.private com.irurueta.algebra.MatrixInternally holds measured specific force during calibration expressed as a column matrix.private doubleInternally holds x-coordinate of measured specific force during calibration.private doubleInternally holds y-coordinate of measured specific force during calibration.private doubleInternally holds z-coordinate of measured specific force during calibration.private com.irurueta.algebra.MatrixInternally holds computed true specific force during calibration.private com.irurueta.algebra.MatrixInternally hold g-dependent cross biases during calibration.static final intNumber of unknowns for the general case when G-dependent cross biases are not being estimated.static final intNumber of unknowns for the general case when G-dependent cross biases are being estimated.private com.irurueta.algebra.MatrixInitial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.private doubleInitial gyroscope x-y cross coupling error.private doubleInitial gyroscope x-z cross coupling error.private doubleInitial gyroscope y-x cross coupling error.private doubleInitial gyroscope y-z cross coupling error.private doubleInitial gyroscope z-x cross coupling error.private doubleInitial gyroscope z-y cross coupling error.private doubleInitial gyroscope x scaling factor.private doubleInitial gyroscope y scaling factor.private doubleInitial gyroscope z scaling factor.private com.irurueta.algebra.MatrixInternally holds inverse of cross-coupling errors during calibration.Listener to handle events raised by this calibrator.private com.irurueta.algebra.MatrixInternally holds cross-coupling errors during calibration.private com.irurueta.algebra.MatrixInternally holds accelerometer scaling and cross coupling errors during calibration.private com.irurueta.algebra.MatrixInternally holds measured angular rate during calibration expressed as a column matrix.private doubleInternally holds x-coordinate of measured angular rate during calibration.private doubleInternally holds y-coordinate of measured angular rate during calibration.private doubleInternally holds z-coordinate of measured angular rate during calibration.Contains a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements.static final intRequired minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being ignored.static final intRequired minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being estimated.static final intRequired minimum number of measurements for the general case and G-dependent cross biases are being ignored.static final intRequired minimum number of measurements for the general case and G-dependent cross biases are being estimated.private com.irurueta.navigation.frames.ECEFPositionPosition where body kinematics measures have been taken.private booleanIndicates whether calibrator is running.private doubleTime interval between measurements being captured expressed in second (s).private com.irurueta.algebra.MatrixInternally holds angular rate bias due to g-dependent cross biasesprivate com.irurueta.algebra.MatrixInternally holds computed true angular rate during calibration.private doubleConstant rotation rate at which the turntable is spinning. -
Constructor Summary
ConstructorsConstructorDescriptionConstructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.ECEFPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, boolean commonAxisUsed, boolean estimateGDependentCrossBiases, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, double[] accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, double[] bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, com.irurueta.algebra.Matrix accelerometerBias, com.irurueta.algebra.Matrix accelerometerMa, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor.KnownBiasTurntableGyroscopeCalibrator(com.irurueta.navigation.frames.NEDPosition position, double turntableRotationRate, double timeInterval, Collection<StandardDeviationBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMg, com.irurueta.algebra.Matrix initialGg, KnownBiasTurntableGyroscopeCalibratorListener listener) Constructor. -
Method Summary
Modifier and TypeMethodDescriptionvoidEstimates gyroscope calibration parameters containing bias, scale factors, cross-coupling errors and G-dependent coupling.private voidInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope and G-dependent cross biases are ignored.private voidInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope and when G-dependent cross biases are being estimated.private voidInternal method to perform general calibration when G-dependent cross biases are ignored.private voidInternal method to perform general calibration when G-dependent cross biases are being estimated.private static doubleconvertAcceleration(com.irurueta.units.Acceleration acceleration) Converts acceleration instance to meters per squared second.private static doubleconvertAngularSpeed(double value, com.irurueta.units.AngularSpeedUnit unit) Converts angular speed instance to radians per second (rad/s).private static doubleconvertAngularSpeed(com.irurueta.units.AngularSpeed angularSpeed) Converts angular speed instance to radians per second (rad/s).private static com.irurueta.navigation.frames.ECEFPositionconvertPosition(com.irurueta.navigation.frames.NEDPosition position) Converts provided NED position expressed in terms of latitude, longitude and height respect mean Earth surface, to position expressed in ECEF coordinates.private static doubleconvertTime(com.irurueta.units.Time time) Converts time instance to seconds.private doubleevaluate(double m11, double m21, double m31, double m12, double m22, double m32, double m13, double m23, double m33) Computes estimated true angular rate squared norm using current measured angular rate and provided parameters.private doubleevaluate(double m11, double m21, double m31, double m12, double m22, double m32, double m13, double m23, double m33, double g11, double g21, double g31, double g12, double g22, double g32, double g13, double g23, double g33) Computes estimated true angular rate squared norm using current measured angular rate and provided parameters.private doubleevaluateCommonAxis(double[] params) Computes estimated true angular rate squared norm using current measured angular rate and provided parameters when common z-axis is assumed and G-dependent cross biases are ignored.private doubleevaluateCommonAxisWitGDependentCrossBiases(double[] params) Computes estimated true angular rate squared norm using current measured angular rate and specific force along with provided parameters when common z-axis is assumed and G-dependent cross biases are taken into account.private doubleevaluateGeneral(double[] params) Computes estimated true angular rate squared norm using current measured angular rate and provided parameters for the general case when G-dependent cross biases are ignored.private doubleevaluateGeneralWitGDependentCrossBiases(double[] params) Computes estimated true angular rate squared norm using current measured angular rate and specific force along with provided parameters for the general case when G-dependent cross biases are taken into account.double[]Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidgetAccelerometerBias(double[] result) Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.com.irurueta.algebra.MatrixGets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidgetAccelerometerBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.com.irurueta.units.AccelerationGets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidgetAccelerometerBiasXAsAcceleration(com.irurueta.units.Acceleration result) Gets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.com.irurueta.units.AccelerationGets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidgetAccelerometerBiasYAsAcceleration(com.irurueta.units.Acceleration result) Gets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.com.irurueta.units.AccelerationGets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidgetAccelerometerBiasZAsAcceleration(com.irurueta.units.Acceleration result) Gets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.com.irurueta.algebra.MatrixGets known accelerometer scale factors and cross coupling errors matrix.voidgetAccelerometerMa(com.irurueta.algebra.Matrix result) Gets known accelerometer scale factors and cross coupling errors matrix.doubleGets known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.doubleGets known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.double[]getBias()Gets known gyroscope bias as an array.voidgetBias(double[] result) Gets known gyroscope bias as an array.com.irurueta.units.AngularSpeedGets known x-coordinate of gyroscope bias.voidgetBiasAngularSpeedX(com.irurueta.units.AngularSpeed result) Gets known x-coordinate of gyroscope bias.com.irurueta.units.AngularSpeedGets known y-coordinate of gyroscope bias.voidgetBiasAngularSpeedY(com.irurueta.units.AngularSpeed result) Gets known y-coordinate of gyroscope bias.com.irurueta.units.AngularSpeedGets known z-coordinate of gyroscope bias to be used to find a solution.voidgetBiasAngularSpeedZ(com.irurueta.units.AngularSpeed result) Gets known z-coordinate of gyroscope bias.com.irurueta.algebra.MatrixGets known gyroscope bias as a column matrix.voidgetBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known gyroscope bias as a column matrix.Gets known gyroscope bias.voidgetBiasAsTriad(AngularSpeedTriad result) Gets known gyroscope bias.doublegetBiasX()Gets known x-coordinate of gyroscope bias.doublegetBiasY()Gets known y-coordinate of gyroscope bias.doublegetBiasZ()Gets known z-coordinate of gyroscope bias.com.irurueta.navigation.frames.ECEFPositionGets position where body kinematics measures have been taken expressed in ECEF coordinates.doubleGets estimated chi square value.intGets estimated chi square degrees of freedom.com.irurueta.algebra.MatrixGets estimated covariance matrix for estimated parameters.com.irurueta.algebra.MatrixGets estimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.com.irurueta.algebra.MatrixGets estimated gyroscope scale factors and cross coupling errors.doubleGets estimated mean square error respect to provided measurements.Gets estimated gyroscope x-y cross-coupling error.Gets estimated gyroscope x-z cross-coupling error.Gets estimated gyroscope y-x cross-coupling error.Gets estimated gyroscope y-z cross-coupling error.Gets estimated gyroscope z-x cross-coupling error.Gets estimated gyroscope z-y cross-coupling error.doubleGets estimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0.doubleGets estimated measure of quality of estimated fit as a value between 0.0 and 1.0.doubleGets estimated reduced chi square value.Gets estimated gyroscope x-axis scale factor.Gets estimated gyroscope y-axis scale factor.Gets estimated gyroscope z-axis scale factor.com.irurueta.algebra.MatrixGets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.voidgetInitialGg(com.irurueta.algebra.Matrix result) Gets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.com.irurueta.algebra.MatrixGets initial gyroscope scale factors and cross coupling errors matrix.voidgetInitialMg(com.irurueta.algebra.Matrix result) Gets initial gyroscope scale factors and cross coupling errors matrix.doubleGets initial x-y cross coupling error of gyroscope.doubleGets initial x-z cross coupling error of gyroscope.doubleGets initial y-x cross coupling error of gyroscope.doubleGets initial y-z cross coupling error of gyroscope.doubleGets initial z-x cross coupling error of gyroscope.doubleGets initial z-y cross coupling error of gyroscope.doubleGets initial x scaling factor of gyroscope.doubleGets initial y scaling factor of gyroscope.doubleGets initial z scaling factor of gyroscope.Gets listener to handle events raised by this estimator.Indicates the type of measurement or sequence used by this calibrator.Gets a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements.intGets minimum number of required measurements.com.irurueta.navigation.frames.NEDPositionGets position where body kinematics measures have been taken expressed in NED coordinates.booleangetNedPosition(com.irurueta.navigation.frames.NEDPosition result) Gets position where body kinematics measures have been taken expressed in NED coordinates.doubleGets time interval between measurements being captured expressed in seconds (s).com.irurueta.units.TimeGets time interval between measurements being captured.voidgetTimeIntervalAsTime(com.irurueta.units.Time result) Gets time interval between measurements being captured.doubleGets constant rotation rate at which the turntable is spinning.com.irurueta.units.AngularSpeedGets constant rotation rate at which the turntable is spinning.voidgetTurntableRotationRateAsAngularSpeed(com.irurueta.units.AngularSpeed result) Gets constant rotation rate at which the turntable is spinning.booleanIndicates whether z-axis is assumed to be common for accelerometer and gyroscope.booleanIndicates whether G-dependent cross biases are being estimated or not.booleanIndicates whether this calibrator requires ordered measurements or sequences in a list or not.booleanIndicates whether this calibrator requires quality scores for each measurement/sequence or not.booleanisReady()Indicates whether calibrator is ready to start.booleanIndicates whether calibrator is currently running or not.voidsetAccelerometerBias(double[] accelerometerBias) Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBias(double accelerometerBiasX, double accelerometerBiasY, double accelerometerBiasZ) Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBias(com.irurueta.algebra.Matrix accelerometerBias) Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBias(com.irurueta.units.Acceleration accelerometerBiasX, com.irurueta.units.Acceleration accelerometerBiasY, com.irurueta.units.Acceleration accelerometerBiasZ) Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasX(double accelerometerBiasX) Sets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasX(com.irurueta.units.Acceleration accelerometerBiasX) Sets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasY(double accelerometerBiasY) Sets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasY(com.irurueta.units.Acceleration accelerometerBiasY) Sets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasZ(double accelerometerBiasZ) Sets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerBiasZ(com.irurueta.units.Acceleration accelerometerBiasZ) Sets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerCrossCouplingErrors(double accelerometerMxy, double accelerometerMxz, double accelerometerMyx, double accelerometerMyz, double accelerometerMzx, double accelerometerMzy) Sets known accelerometer cross coupling errors to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMa(com.irurueta.algebra.Matrix accelerometerMa) Sets known accelerometer scale factors and cross coupling errors matrix.voidsetAccelerometerMxy(double accelerometerMxy) Sets known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMxz(double accelerometerMxz) Sets known accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMyx(double accelerometerMyx) Sets known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMyz(double accelerometerMyz) Sets known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMzx(double accelerometerMzx) Sets known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerMzy(double accelerometerMzy) Sets known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerScalingFactors(double accelerometerSx, double accelerometerSy, double accelerometerSz) Sets known accelerometer scaling factors to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerScalingFactorsAndCrossCouplingErrors(double accelerometerSx, double accelerometerSy, double accelerometerSz, double accelerometerMxy, double accelerometerMxz, double accelerometerMyx, double accelerometerMyz, double accelerometerMzx, double accelerometerMzy) Sets known accelerometer scaling factors and cross coupling errors to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerSx(double accelerometerSx) Sets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerSy(double accelerometerSy) Sets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetAccelerometerSz(double accelerometerSz) Sets known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.voidsetBias(double[] bias) Sets known gyroscope bias as an array.voidsetBias(com.irurueta.algebra.Matrix bias) Sets known gyroscope bias as a column matrix.voidsetBias(AngularSpeedTriad bias) Sets known gyroscope bias.voidsetBiasCoordinates(double biasX, double biasY, double biasZ) Sets known bias coordinates of gyroscope expressed in radians per second (rad/s).voidsetBiasCoordinates(com.irurueta.units.AngularSpeed biasX, com.irurueta.units.AngularSpeed biasY, com.irurueta.units.AngularSpeed biasZ) Sets known bias coordinates of gyroscope.voidsetBiasX(double biasX) Sets known x-coordinate of gyroscope bias.voidsetBiasX(com.irurueta.units.AngularSpeed biasX) Sets known x-coordinate of gyroscope bias.voidsetBiasY(double biasY) Sets known y-coordinate of gyroscope bias.voidsetBiasY(com.irurueta.units.AngularSpeed biasY) Sets known y-coordinate of gyroscope bias to be used to find a solution.voidsetBiasZ(double biasZ) Sets known z-coordinate of gyroscope bias.voidsetBiasZ(com.irurueta.units.AngularSpeed biasZ) Sets known z-coordinate of gyroscope bias.voidsetCommonAxisUsed(boolean commonAxisUsed) Specifies whether z-axis is assumed to be common for accelerometer and gyroscope.voidsetGDependentCrossBiasesEstimated(boolean estimateGDependentCrossBiases) Specifies whether G-dependent cross biases are being estimated or not.voidsetInitialCrossCouplingErrors(double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Sets initial cross coupling errors of gyroscope.voidsetInitialGg(com.irurueta.algebra.Matrix initialGg) Sets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.voidsetInitialMg(com.irurueta.algebra.Matrix initialMg) Sets initial gyroscope scale factors and cross coupling errors matrix.voidsetInitialMxy(double initialMxy) Sets initial x-y cross coupling error of gyroscope.voidsetInitialMxz(double initialMxz) Sets initial x-z cross coupling error of gyroscope.voidsetInitialMyx(double initialMyx) Sets initial y-x cross coupling error of gyroscope.voidsetInitialMyz(double initialMyz) Sets initial y-z cross coupling error of gyroscope.voidsetInitialMzx(double initialMzx) Sets initial z-x cross coupling error of gyroscope.voidsetInitialMzy(double initialMzy) Sets initial z-y cross coupling error of gyroscope.voidsetInitialScalingFactors(double initialSx, double initialSy, double initialSz) Sets initial scaling factors of gyroscope.voidsetInitialScalingFactorsAndCrossCouplingErrors(double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Sets initial scaling factors and cross coupling errors of gyroscope.voidsetInitialSx(double initialSx) Sets initial x scaling factor of gyroscope.voidsetInitialSy(double initialSy) Sets initial y scaling factor of gyroscope.voidsetInitialSz(double initialSz) Sets initial z scaling factor of gyroscope.private voidSets input data into Levenberg-Marquardt fitter when G-dependent cross biases are ignored.private voidSets input data into Levenberg-Marquardt fitter when G-dependent cross biases are taken into account.voidSets listener to handle events raised by this estimator.voidsetMeasurements(Collection<StandardDeviationBodyKinematics> measurements) Sets a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements.voidsetPosition(com.irurueta.navigation.frames.ECEFPosition position) Gets position where body kinematics measures have been taken expressed in ECEF coordinates.voidsetPosition(com.irurueta.navigation.frames.NEDPosition position) Sets position where body kinematics measures have been taken expressed in NED coordinates.private voidsetResult(com.irurueta.algebra.Matrix m) Makes proper conversion of internal cross-coupling matrix.private voidsetResult(com.irurueta.algebra.Matrix m, com.irurueta.algebra.Matrix g) Makes proper conversion of internal cross-coupling and g-dependent cross bias matrices.voidsetTimeInterval(double timeInterval) Sets time interval between measurements being captured expressed in seconds (s).voidsetTimeInterval(com.irurueta.units.Time timeInterval) Sets time interval between measurements being captured.voidsetTurntableRotationRate(double turntableRotationRate) Sets constant rotation rate at which the turntable is spinning.voidsetTurntableRotationRate(com.irurueta.units.AngularSpeed turntableRotationRate) Sets constant rotation rate at which the turntable is spinning.
-
Field Details
-
DEFAULT_USE_COMMON_Z_AXIS
public static final boolean DEFAULT_USE_COMMON_Z_AXISIndicates whether by default a common z-axis is assumed for both the accelerometer and gyroscope.- See Also:
-
DEFAULT_ESTIMATE_G_DEPENDENT_CROSS_BIASES
public static final boolean DEFAULT_ESTIMATE_G_DEPENDENT_CROSS_BIASESIndicates that by default G-dependent cross biases introduced by the accelerometer on the gyroscope are estimated.- See Also:
-
COMMON_Z_AXIS_UNKNOWNS_AND_CROSS_BIASES
public static final int COMMON_Z_AXIS_UNKNOWNS_AND_CROSS_BIASESNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope when G-dependent cross biases are being estimated.- See Also:
-
GENERAL_UNKNOWNS_AND_CROSS_BIASES
public static final int GENERAL_UNKNOWNS_AND_CROSS_BIASESNumber of unknowns for the general case when G-dependent cross biases are being estimated.- See Also:
-
COMMON_Z_AXIS_UNKNOWNS
public static final int COMMON_Z_AXIS_UNKNOWNSNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope when G-dependent cross biases are not being estimated.- See Also:
-
GENERAL_UNKNOWNS
public static final int GENERAL_UNKNOWNSNumber of unknowns for the general case when G-dependent cross biases are not being estimated.- See Also:
-
MINIMUM_MEASUREMENTS_COMMON_Z_AXIS_AND_CROSS_BIASES
public static final int MINIMUM_MEASUREMENTS_COMMON_Z_AXIS_AND_CROSS_BIASESRequired minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being estimated.- See Also:
-
MINIMUM_MEASUREMENTS_GENERAL_AND_CROSS_BIASES
public static final int MINIMUM_MEASUREMENTS_GENERAL_AND_CROSS_BIASESRequired minimum number of measurements for the general case and G-dependent cross biases are being estimated.- See Also:
-
MINIMUM_MEASUREMENTS_COMMON_Z_AXIS
public static final int MINIMUM_MEASUREMENTS_COMMON_Z_AXISRequired minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being ignored.- See Also:
-
MINIMUM_MEASUREMENTS_GENERAL
public static final int MINIMUM_MEASUREMENTS_GENERALRequired minimum number of measurements for the general case and G-dependent cross biases are being ignored.- See Also:
-
DEFAULT_TURNTABLE_ROTATION_RATE
public static final double DEFAULT_TURNTABLE_ROTATION_RATEDefault turntable rotation rate.- See Also:
-
DEFAULT_TIME_INTERVAL
public static final double DEFAULT_TIME_INTERVALDefault time interval between measurements expressed in seconds (s). This is a typical value when we have 50 samples per second.- See Also:
-
fitter
private final com.irurueta.numerical.fitting.LevenbergMarquardtMultiDimensionFitter fitterLevenberg-Marquardt fitter to find a non-linear solution. -
accelerometerBiasX
private double accelerometerBiasXKnown x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2). -
accelerometerBiasY
private double accelerometerBiasYKnown y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2). -
accelerometerBiasZ
private double accelerometerBiasZKnown z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2). -
accelerometerSx
private double accelerometerSxKnown accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerSy
private double accelerometerSyKnown accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerSz
private double accelerometerSzKnown accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMxy
private double accelerometerMxyKnown accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMxz
private double accelerometerMxzKnow accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMyx
private double accelerometerMyxKnown accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMyz
private double accelerometerMyzKnown accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMzx
private double accelerometerMzxKnown accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
accelerometerMzy
private double accelerometerMzyKnown accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer. -
biasX
private double biasXKnown x-coordinate of gyroscope bias. This is expressed in radians per second (rad/s). -
biasY
private double biasYKnown y-coordinate of gyroscope bias. This is expressed in radians per second (rad/s). -
biasZ
private double biasZKnown z-coordinate of gyroscope bias. This is expressed in radians per second (rad/s). -
initialSx
private double initialSxInitial gyroscope x scaling factor. -
initialSy
private double initialSyInitial gyroscope y scaling factor. -
initialSz
private double initialSzInitial gyroscope z scaling factor. -
initialMxy
private double initialMxyInitial gyroscope x-y cross coupling error. -
initialMxz
private double initialMxzInitial gyroscope x-z cross coupling error. -
initialMyx
private double initialMyxInitial gyroscope y-x cross coupling error. -
initialMyz
private double initialMyzInitial gyroscope y-z cross coupling error. -
initialMzx
private double initialMzxInitial gyroscope z-x cross coupling error. -
initialMzy
private double initialMzyInitial gyroscope z-y cross coupling error. -
initialGg
private com.irurueta.algebra.Matrix initialGgInitial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer. -
turntableRotationRate
private double turntableRotationRateConstant rotation rate at which the turntable is spinning. This is expressed in radians per second (rad/s). -
timeInterval
private double timeIntervalTime interval between measurements being captured expressed in second (s). -
measurements
Contains a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements. -
position
private com.irurueta.navigation.frames.ECEFPosition positionPosition where body kinematics measures have been taken. -
commonAxisUsed
private boolean commonAxisUsedThis flag indicates whether z-axis is assumed to be common for accelerometer and gyroscope. When enabled, this eliminates 3 variables from Mg matrix. -
estimateGDependentCrossBiases
private boolean estimateGDependentCrossBiasesThis flag indicates whether G-dependent cross biases are being estimated or not. When enabled, this adds 9 variables from Gg matrix. -
listener
Listener to handle events raised by this calibrator. -
estimatedMg
private com.irurueta.algebra.Matrix estimatedMgEstimated gyroscope scale factors and cross coupling errors. This is the product of matrix Tg containing cross coupling errors and Kg containing scaling factors. So that:Mg = [sx mxy mxz] = Tg*Kg [myx sy myz] [mzx mzy sz ]Where:Kg = [sx 0 0 ] [0 sy 0 ] [0 0 sz]andTg = [1 -alphaXy alphaXz ] [alphaYx 1 -alphaYz] [-alphaZx alphaZy 1 ]Hence:Mg = [sx mxy mxz] = Tg*Kg = [sx -sy * alphaXy sz * alphaXz ] [myx sy myz] [sx * alphaYx sy -sz * alphaYz] [mzx mzy sz ] [-sx * alphaZx sy * alphaZy sz ]This instance allows any 3x3 matrix however, typically alphaYx, alphaZx and alphaZy are considered to be zero if the gyroscope z-axis is assumed to be the same as the body z-axis. When this is assumed, myx = mzx = mzy = 0 and the Mg matrix becomes upper diagonal:Mg = [sx mxy mxz] [0 sy myz] [0 0 sz ]Values of this matrix are unit-less. -
estimatedGg
private com.irurueta.algebra.Matrix estimatedGgEstimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer. This instance allows any 3x3 matrix. -
estimatedCovariance
private com.irurueta.algebra.Matrix estimatedCovarianceEstimated covariance matrix for estimated parameters. -
estimatedChiSq
private double estimatedChiSqEstimated chi square value. -
estimatedChiSqDegreesOfFreedom
private int estimatedChiSqDegreesOfFreedomEstimated degrees of freedom of chi square value. Degrees of freedom is equal to the number of sampled data minus the number of estimated parameters. -
estimatedReducedChiSq
private double estimatedReducedChiSqEstimated reduced chi square value. This is equal to estimated chi square value divided by its degrees of freedom. Ideally this value should be close to 1.0. -
estimatedMse
private double estimatedMseEstimated mean square error respect to provided measurements. -
estimatedP
private double estimatedPEstimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0. The smaller the found chi square value is, the better the fit of the estimated parameters to the actual parameter. Thus, the smaller the chance of finding a smaller chi square value, then the better the estimated fit is. -
estimatedQ
private double estimatedQEstimated measure of quality of estimated fit as a value between 0.0 and 1.0. The larger the quality value is, the better the fit that has been estimated. -
running
private boolean runningIndicates whether calibrator is running. -
measAngularRateX
private double measAngularRateXInternally holds x-coordinate of measured angular rate during calibration. -
measAngularRateY
private double measAngularRateYInternally holds y-coordinate of measured angular rate during calibration. -
measAngularRateZ
private double measAngularRateZInternally holds z-coordinate of measured angular rate during calibration. -
fmeasX
private double fmeasXInternally holds x-coordinate of measured specific force during calibration. -
fmeasY
private double fmeasYInternally holds y-coordinate of measured specific force during calibration. -
fmeasZ
private double fmeasZInternally holds z-coordinate of measured specific force during calibration. -
measAngularRate
private com.irurueta.algebra.Matrix measAngularRateInternally holds measured angular rate during calibration expressed as a column matrix. -
fmeas
private com.irurueta.algebra.Matrix fmeasInternally holds measured specific force during calibration expressed as a column matrix. -
m
private com.irurueta.algebra.Matrix mInternally holds cross-coupling errors during calibration. -
invM
private com.irurueta.algebra.Matrix invMInternally holds inverse of cross-coupling errors during calibration. -
b
private com.irurueta.algebra.Matrix bInternally holds biases during calibration. -
g
private com.irurueta.algebra.Matrix gInternally hold g-dependent cross biases during calibration. -
trueAngularRate
private com.irurueta.algebra.Matrix trueAngularRateInternally holds computed true angular rate during calibration. -
ftrue
private com.irurueta.algebra.Matrix ftrueInternally holds computed true specific force during calibration. -
ba
private com.irurueta.algebra.Matrix baInternally holds accelerometer bias during calibration. -
ma
private com.irurueta.algebra.Matrix maInternally holds accelerometer scaling and cross coupling errors during calibration. -
tmp
private com.irurueta.algebra.Matrix tmpInternally holds angular rate bias due to g-dependent cross biases -
accelerationFixer
Acceleration fixer.
-
-
Constructor Details
-
KnownBiasTurntableGyroscopeCalibrator
public KnownBiasTurntableGyroscopeCalibrator()Constructor.
-
-
Method Details
-
getAccelerometerBiasX
public double getAccelerometerBiasX()Gets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasXin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known x-coordinate of accelerometer bias.
-
setAccelerometerBiasX
public void setAccelerometerBiasX(double accelerometerBiasX) throws com.irurueta.navigation.LockedException Sets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasXin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasX- known x-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBiasY
public double getAccelerometerBiasY()Gets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasYin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known y-coordinate of accelerometer bias.
-
setAccelerometerBiasY
public void setAccelerometerBiasY(double accelerometerBiasY) throws com.irurueta.navigation.LockedException Sets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasYin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasY- known y-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBiasZ
public double getAccelerometerBiasZ()Gets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasZin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known z-coordinate of accelerometer bias.
-
setAccelerometerBiasZ
public void setAccelerometerBiasZ(double accelerometerBiasZ) throws com.irurueta.navigation.LockedException Sets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasZin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasZ- known z-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBiasXAsAcceleration
public com.irurueta.units.Acceleration getAccelerometerBiasXAsAcceleration()Gets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasXAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known x-coordinate of accelerometer bias.
-
getAccelerometerBiasXAsAcceleration
public void getAccelerometerBiasXAsAcceleration(com.irurueta.units.Acceleration result) Gets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasXAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setAccelerometerBiasX
public void setAccelerometerBiasX(com.irurueta.units.Acceleration accelerometerBiasX) throws com.irurueta.navigation.LockedException Sets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerBiasXin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasX- x-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBiasYAsAcceleration
public com.irurueta.units.Acceleration getAccelerometerBiasYAsAcceleration()Gets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasYAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known y-coordinate of accelerometer bias.
-
getAccelerometerBiasYAsAcceleration
public void getAccelerometerBiasYAsAcceleration(com.irurueta.units.Acceleration result) Gets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasYAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setAccelerometerBiasY
public void setAccelerometerBiasY(com.irurueta.units.Acceleration accelerometerBiasY) throws com.irurueta.navigation.LockedException Sets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerBiasYin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasY- y-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBiasZAsAcceleration
public com.irurueta.units.Acceleration getAccelerometerBiasZAsAcceleration()Gets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasZAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known z-coordinate of accelerometer bias.
-
getAccelerometerBiasZAsAcceleration
public void getAccelerometerBiasZAsAcceleration(com.irurueta.units.Acceleration result) Gets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerBiasZAsAccelerationin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setAccelerometerBiasZ
public void setAccelerometerBiasZ(com.irurueta.units.Acceleration accelerometerBiasZ) throws com.irurueta.navigation.LockedException Sets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerBiasZin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasZ- z-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setAccelerometerBias
public void setAccelerometerBias(double accelerometerBiasX, double accelerometerBiasY, double accelerometerBiasZ) throws com.irurueta.navigation.LockedException Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasX- x-coordinate of accelerometer bias.accelerometerBiasY- y-coordinate of accelerometer bias.accelerometerBiasZ- z-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setAccelerometerBias
public void setAccelerometerBias(com.irurueta.units.Acceleration accelerometerBiasX, com.irurueta.units.Acceleration accelerometerBiasY, com.irurueta.units.Acceleration accelerometerBiasZ) throws com.irurueta.navigation.LockedException Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBiasX- x-coordinate of accelerometer bias.accelerometerBiasY- y-coordinate of accelerometer bias.accelerometerBiasZ- z-coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerBias
public double[] getAccelerometerBias()Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer bias.
-
getAccelerometerBias
public void getAccelerometerBias(double[] result) Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where result data will be copied to.- Throws:
IllegalArgumentException- if provided array does not have length 3.
-
setAccelerometerBias
public void setAccelerometerBias(double[] accelerometerBias) throws com.irurueta.navigation.LockedException Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBias- known accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided array does not have length 3.
-
getAccelerometerBiasAsMatrix
public com.irurueta.algebra.Matrix getAccelerometerBiasAsMatrix()Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasAsMatrixin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer bias.
-
getAccelerometerBiasAsMatrix
public void getAccelerometerBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
getAccelerometerBiasAsMatrixin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where result data will be copied to.- Throws:
IllegalArgumentException- if provided matrix is not 3x1.
-
setAccelerometerBias
public void setAccelerometerBias(com.irurueta.algebra.Matrix accelerometerBias) throws com.irurueta.navigation.LockedException Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer. This is expressed in meters per squared second (m/s^2).- Specified by:
setAccelerometerBiasin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerBias- known accelerometer bias. Must be 3x1.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided matrix is not 3x1.
-
getAccelerometerSx
public double getAccelerometerSx()Gets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerSxin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer x scaling factor.
-
setAccelerometerSx
public void setAccelerometerSx(double accelerometerSx) throws com.irurueta.navigation.LockedException Sets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerSxin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerSx- known accelerometer x scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerSy
public double getAccelerometerSy()Gets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerSyin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer y scaling factor.
-
setAccelerometerSy
public void setAccelerometerSy(double accelerometerSy) throws com.irurueta.navigation.LockedException Sets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerSyin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerSy- known accelerometer y scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerSz
public double getAccelerometerSz()Gets known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerSzin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer z scaling factor.
-
setAccelerometerSz
public void setAccelerometerSz(double accelerometerSz) throws com.irurueta.navigation.LockedException Sets known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerSzin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerSz- known accelerometer z scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMxy
public double getAccelerometerMxy()Gets known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMxyin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer x-y cross coupling error.
-
setAccelerometerMxy
public void setAccelerometerMxy(double accelerometerMxy) throws com.irurueta.navigation.LockedException Sets known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMxyin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMxy- known accelerometer x-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMxz
public double getAccelerometerMxz()Gets known accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMxzin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer x-z cross coupling error.
-
setAccelerometerMxz
public void setAccelerometerMxz(double accelerometerMxz) throws com.irurueta.navigation.LockedException Sets known accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMxzin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMxz- known accelerometer x-z cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMyx
public double getAccelerometerMyx()Gets known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMyxin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer y-x cross coupling error.
-
setAccelerometerMyx
public void setAccelerometerMyx(double accelerometerMyx) throws com.irurueta.navigation.LockedException Sets known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMyxin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMyx- known accelerometer y-x cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMyz
public double getAccelerometerMyz()Gets known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMyzin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer y-z cross coupling error.
-
setAccelerometerMyz
public void setAccelerometerMyz(double accelerometerMyz) throws com.irurueta.navigation.LockedException Sets known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMyzin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMyz- known accelerometer y-z cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMzx
public double getAccelerometerMzx()Gets known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMzxin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer z-x cross coupling error.
-
setAccelerometerMzx
public void setAccelerometerMzx(double accelerometerMzx) throws com.irurueta.navigation.LockedException Sets known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMzxin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMzx- known accelerometer z-x cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMzy
public double getAccelerometerMzy()Gets known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
getAccelerometerMzyin interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer z-y cross coupling error.
-
setAccelerometerMzy
public void setAccelerometerMzy(double accelerometerMzy) throws com.irurueta.navigation.LockedException Sets known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerMzyin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMzy- known accelerometer z-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setAccelerometerScalingFactors
public void setAccelerometerScalingFactors(double accelerometerSx, double accelerometerSy, double accelerometerSz) throws com.irurueta.navigation.LockedException Sets known accelerometer scaling factors to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerScalingFactorsin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerSx- known accelerometer x scaling factor.accelerometerSy- known accelerometer y scaling factor.accelerometerSz- known accelerometer z scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setAccelerometerCrossCouplingErrors
public void setAccelerometerCrossCouplingErrors(double accelerometerMxy, double accelerometerMxz, double accelerometerMyx, double accelerometerMyz, double accelerometerMzx, double accelerometerMzy) throws com.irurueta.navigation.LockedException Sets known accelerometer cross coupling errors to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerCrossCouplingErrorsin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMxy- known accelerometer x-y cross coupling error.accelerometerMxz- known accelerometer x-z cross coupling error.accelerometerMyx- known accelerometer y-x cross coupling error.accelerometerMyz- known accelerometer y-z cross coupling error.accelerometerMzx- known accelerometer z-x cross coupling error.accelerometerMzy- known accelerometer z-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setAccelerometerScalingFactorsAndCrossCouplingErrors
public void setAccelerometerScalingFactorsAndCrossCouplingErrors(double accelerometerSx, double accelerometerSy, double accelerometerSz, double accelerometerMxy, double accelerometerMxz, double accelerometerMyx, double accelerometerMyz, double accelerometerMzx, double accelerometerMzy) throws com.irurueta.navigation.LockedException Sets known accelerometer scaling factors and cross coupling errors to be used to fix measured specific force and find cross biases introduced by the accelerometer.- Specified by:
setAccelerometerScalingFactorsAndCrossCouplingErrorsin interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerSx- known accelerometer x scaling factor.accelerometerSy- known accelerometer y scaling factor.accelerometerSz- known accelerometer z scaling factor.accelerometerMxy- known accelerometer x-y cross coupling error.accelerometerMxz- known accelerometer x-z cross coupling error.accelerometerMyx- known accelerometer y-x cross coupling error.accelerometerMyz- known accelerometer y-z cross coupling error.accelerometerMzx- known accelerometer z-x cross coupling error.accelerometerMzy- known accelerometer z-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getAccelerometerMa
public com.irurueta.algebra.Matrix getAccelerometerMa()Gets known accelerometer scale factors and cross coupling errors matrix.- Specified by:
getAccelerometerMain interfaceAccelerometerDependentGyroscopeCalibrator- Returns:
- known accelerometer scale factors and cross coupling errors matrix.
-
getAccelerometerMa
public void getAccelerometerMa(com.irurueta.algebra.Matrix result) Gets known accelerometer scale factors and cross coupling errors matrix.- Specified by:
getAccelerometerMain interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
result- instance where data will be stored.- Throws:
IllegalArgumentException- if provided matrix is not 3x3.
-
setAccelerometerMa
public void setAccelerometerMa(com.irurueta.algebra.Matrix accelerometerMa) throws com.irurueta.navigation.LockedException Sets known accelerometer scale factors and cross coupling errors matrix.- Specified by:
setAccelerometerMain interfaceAccelerometerDependentGyroscopeCalibrator- Parameters:
accelerometerMa- known accelerometer scale factors and cross coupling errors matrix. Must be 3x3.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided matrix is not 3x3.
-
getBiasX
public double getBiasX()Gets known x-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
getBiasXin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known x-coordinate of gyroscope bias.
-
setBiasX
public void setBiasX(double biasX) throws com.irurueta.navigation.LockedException Sets known x-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
setBiasXin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasX- known x-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasY
public double getBiasY()Gets known y-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
getBiasYin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known y-coordinate of gyroscope bias.
-
setBiasY
public void setBiasY(double biasY) throws com.irurueta.navigation.LockedException Sets known y-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
setBiasYin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasY- known y-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasZ
public double getBiasZ()Gets known z-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
getBiasZin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known z-coordinate of gyroscope bias.
-
setBiasZ
public void setBiasZ(double biasZ) throws com.irurueta.navigation.LockedException Sets known z-coordinate of gyroscope bias. This is expressed in radians per second (rad/s).- Specified by:
setBiasZin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasZ- known z-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasAngularSpeedX
public com.irurueta.units.AngularSpeed getBiasAngularSpeedX()Gets known x-coordinate of gyroscope bias.- Specified by:
getBiasAngularSpeedXin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known x-coordinate of gyroscope bias.
-
getBiasAngularSpeedX
public void getBiasAngularSpeedX(com.irurueta.units.AngularSpeed result) Gets known x-coordinate of gyroscope bias.- Specified by:
getBiasAngularSpeedXin interfaceKnownBiasGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasX
public void setBiasX(com.irurueta.units.AngularSpeed biasX) throws com.irurueta.navigation.LockedException Sets known x-coordinate of gyroscope bias.- Specified by:
setBiasXin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasX- known x-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasAngularSpeedY
public com.irurueta.units.AngularSpeed getBiasAngularSpeedY()Gets known y-coordinate of gyroscope bias.- Specified by:
getBiasAngularSpeedYin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known y-coordinate of gyroscope bias.
-
getBiasAngularSpeedY
public void getBiasAngularSpeedY(com.irurueta.units.AngularSpeed result) Gets known y-coordinate of gyroscope bias.- Specified by:
getBiasAngularSpeedYin interfaceKnownBiasGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasY
public void setBiasY(com.irurueta.units.AngularSpeed biasY) throws com.irurueta.navigation.LockedException Sets known y-coordinate of gyroscope bias to be used to find a solution.- Specified by:
setBiasYin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasY- known y-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasAngularSpeedZ
public com.irurueta.units.AngularSpeed getBiasAngularSpeedZ()Gets known z-coordinate of gyroscope bias to be used to find a solution.- Specified by:
getBiasAngularSpeedZin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known z-coordinate of gyroscope bias.
-
getBiasAngularSpeedZ
public void getBiasAngularSpeedZ(com.irurueta.units.AngularSpeed result) Gets known z-coordinate of gyroscope bias.- Specified by:
getBiasAngularSpeedZin interfaceKnownBiasGyroscopeCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasZ
public void setBiasZ(com.irurueta.units.AngularSpeed biasZ) throws com.irurueta.navigation.LockedException Sets known z-coordinate of gyroscope bias.- Specified by:
setBiasZin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasZ- known z-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setBiasCoordinates
public void setBiasCoordinates(double biasX, double biasY, double biasZ) throws com.irurueta.navigation.LockedException Sets known bias coordinates of gyroscope expressed in radians per second (rad/s).- Specified by:
setBiasCoordinatesin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasX- known x-coordinate of gyroscope bias.biasY- known y-coordinate of gyroscope bias.biasZ- known z-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setBiasCoordinates
public void setBiasCoordinates(com.irurueta.units.AngularSpeed biasX, com.irurueta.units.AngularSpeed biasY, com.irurueta.units.AngularSpeed biasZ) throws com.irurueta.navigation.LockedException Sets known bias coordinates of gyroscope.- Specified by:
setBiasCoordinatesin interfaceKnownBiasGyroscopeCalibrator- Parameters:
biasX- known x-coordinate of gyroscope bias.biasY- known y-coordinate of gyroscope bias.biasZ- known z-coordinate of gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasAsTriad
Gets known gyroscope bias.- Returns:
- known gyroscope bias.
-
getInitialSx
public double getInitialSx()Gets initial x scaling factor of gyroscope.- Specified by:
getInitialSxin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial x scaling factor of gyroscope.
-
setInitialSx
public void setInitialSx(double initialSx) throws com.irurueta.navigation.LockedException Sets initial x scaling factor of gyroscope.- Specified by:
setInitialSxin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialSy
public double getInitialSy()Gets initial y scaling factor of gyroscope.- Specified by:
getInitialSyin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial y scaling factor of gyroscope.
-
setInitialSy
public void setInitialSy(double initialSy) throws com.irurueta.navigation.LockedException Sets initial y scaling factor of gyroscope.- Specified by:
setInitialSyin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialSy- initial y scaling factor of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialSz
public double getInitialSz()Gets initial z scaling factor of gyroscope.- Specified by:
getInitialSzin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial z scaling factor of gyroscope.
-
setInitialSz
public void setInitialSz(double initialSz) throws com.irurueta.navigation.LockedException Sets initial z scaling factor of gyroscope.- Specified by:
setInitialSzin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialSz- initial z scaling factor of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMxy
public double getInitialMxy()Gets initial x-y cross coupling error of gyroscope.- Specified by:
getInitialMxyin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial x-y cross coupling error of gyroscope.
-
setInitialMxy
public void setInitialMxy(double initialMxy) throws com.irurueta.navigation.LockedException Sets initial x-y cross coupling error of gyroscope.- Specified by:
setInitialMxyin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMxy- initial x-y cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMxz
public double getInitialMxz()Gets initial x-z cross coupling error of gyroscope.- Specified by:
getInitialMxzin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial x-z cross coupling error of gyroscope.
-
setInitialMxz
public void setInitialMxz(double initialMxz) throws com.irurueta.navigation.LockedException Sets initial x-z cross coupling error of gyroscope.- Specified by:
setInitialMxzin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMxz- initial x-z cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMyx
public double getInitialMyx()Gets initial y-x cross coupling error of gyroscope.- Specified by:
getInitialMyxin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial y-x cross coupling error of gyroscope.
-
setInitialMyx
public void setInitialMyx(double initialMyx) throws com.irurueta.navigation.LockedException Sets initial y-x cross coupling error of gyroscope.- Specified by:
setInitialMyxin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMyx- initial y-x cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMyz
public double getInitialMyz()Gets initial y-z cross coupling error of gyroscope.- Specified by:
getInitialMyzin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial y-z cross coupling error of gyroscope.
-
setInitialMyz
public void setInitialMyz(double initialMyz) throws com.irurueta.navigation.LockedException Sets initial y-z cross coupling error of gyroscope.- Specified by:
setInitialMyzin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMyz- initial y-z cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMzx
public double getInitialMzx()Gets initial z-x cross coupling error of gyroscope.- Specified by:
getInitialMzxin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial z-x cross coupling error of gyroscope.
-
setInitialMzx
public void setInitialMzx(double initialMzx) throws com.irurueta.navigation.LockedException Sets initial z-x cross coupling error of gyroscope.- Specified by:
setInitialMzxin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMzx- initial z-x cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMzy
public double getInitialMzy()Gets initial z-y cross coupling error of gyroscope.- Specified by:
getInitialMzyin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial z-y cross coupling error of gyroscope.
-
setInitialMzy
public void setInitialMzy(double initialMzy) throws com.irurueta.navigation.LockedException Sets initial z-y cross coupling error of gyroscope.- Specified by:
setInitialMzyin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMzy- initial z-y cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setInitialScalingFactors
public void setInitialScalingFactors(double initialSx, double initialSy, double initialSz) throws com.irurueta.navigation.LockedException Sets initial scaling factors of gyroscope.- Specified by:
setInitialScalingFactorsin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor of gyroscope.initialSy- initial y scaling factor of gyroscope.initialSz- initial z scaling factor of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setInitialCrossCouplingErrors
public void setInitialCrossCouplingErrors(double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) throws com.irurueta.navigation.LockedException Sets initial cross coupling errors of gyroscope.- Specified by:
setInitialCrossCouplingErrorsin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMxy- initial x-y cross coupling error of gyroscope.initialMxz- initial x-z cross coupling error of gyroscope.initialMyx- initial y-x cross coupling error of gyroscope.initialMyz- initial y-z cross coupling error of gyroscope.initialMzx- initial z-x cross coupling error of gyroscope.initialMzy- initial z-y cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setInitialScalingFactorsAndCrossCouplingErrors
public void setInitialScalingFactorsAndCrossCouplingErrors(double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) throws com.irurueta.navigation.LockedException Sets initial scaling factors and cross coupling errors of gyroscope.- Specified by:
setInitialScalingFactorsAndCrossCouplingErrorsin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor of gyroscope.initialSy- initial y scaling factor of gyroscope.initialSz- initial z scaling factor of gyroscope.initialMxy- initial x-y cross coupling error of gyroscope.initialMxz- initial x-z cross coupling error of gyroscope.initialMyx- initial y-x cross coupling error of gyroscope.initialMyz- initial y-z cross coupling error of gyroscope.initialMzx- initial z-x cross coupling error of gyroscope.initialMzy- initial z-y cross coupling error of gyroscope.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBias
public double[] getBias()Gets known gyroscope bias as an array. Array values are expressed in radians per second (rad/s).- Specified by:
getBiasin interfaceKnownBiasGyroscopeCalibrator- Returns:
- array containing coordinates of gyroscope bias.
-
getBias
public void getBias(double[] result) Gets known gyroscope bias as an array. Array values are expressed in radians per second (rad/s).- Specified by:
getBiasin interfaceKnownBiasGyroscopeCalibrator- Parameters:
result- instance where result data will be copied to.- Throws:
IllegalArgumentException- if provided array does not have length 3.
-
setBias
public void setBias(double[] bias) throws com.irurueta.navigation.LockedException Sets known gyroscope bias as an array. Array values are expressed in radians per second (rad/s).- Specified by:
setBiasin interfaceKnownBiasGyroscopeCalibrator- Parameters:
bias- known bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided array does not have length 3.
-
getBiasAsMatrix
public com.irurueta.algebra.Matrix getBiasAsMatrix()Gets known gyroscope bias as a column matrix. Matrix values are expressed in radians per second (rad/s).- Specified by:
getBiasAsMatrixin interfaceKnownBiasGyroscopeCalibrator- Returns:
- known gyroscope bias as a column matrix.
-
getBiasAsMatrix
public void getBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known gyroscope bias as a column matrix. Matrix values are expressed in radians per second (rad/s).- Specified by:
getBiasAsMatrixin interfaceKnownBiasGyroscopeCalibrator- Parameters:
result- instance where result data will be copied to.- Throws:
IllegalArgumentException- if provided matrix is not 3x1.
-
setBias
public void setBias(com.irurueta.algebra.Matrix bias) throws com.irurueta.navigation.LockedException Sets known gyroscope bias as a column matrix. Matrix values are expressed in radians per second (rad/s).- Specified by:
setBiasin interfaceKnownBiasGyroscopeCalibrator- Parameters:
bias- known gyroscope bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided matrix is not 3x1.
-
getInitialMg
public com.irurueta.algebra.Matrix getInitialMg()Gets initial gyroscope scale factors and cross coupling errors matrix.- Specified by:
getInitialMgin interfaceGyroscopeNonLinearCalibrator- Returns:
- initial gyroscope scale factors and cross coupling errors matrix.
-
getInitialMg
public void getInitialMg(com.irurueta.algebra.Matrix result) Gets initial gyroscope scale factors and cross coupling errors matrix.- Specified by:
getInitialMgin interfaceGyroscopeNonLinearCalibrator- Parameters:
result- instance where data will be stored.- Throws:
IllegalArgumentException- if provided matrix is not 3x3.
-
setInitialMg
public void setInitialMg(com.irurueta.algebra.Matrix initialMg) throws com.irurueta.navigation.LockedException Sets initial gyroscope scale factors and cross coupling errors matrix.- Specified by:
setInitialMgin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialMg- initial scale factors and cross coupling errors matrix.- Throws:
IllegalArgumentException- if provided matrix is not 3x3.com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialGg
public com.irurueta.algebra.Matrix getInitialGg()Gets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.- Specified by:
getInitialGgin interfaceGyroscopeNonLinearCalibrator- Returns:
- a 3x3 matrix containing initial g-dependent cross biases.
-
getInitialGg
public void getInitialGg(com.irurueta.algebra.Matrix result) Gets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.- Specified by:
getInitialGgin interfaceGyroscopeNonLinearCalibrator- Parameters:
result- instance where data will be stored.- Throws:
IllegalArgumentException- if provided matrix is not 3x3.
-
setInitialGg
public void setInitialGg(com.irurueta.algebra.Matrix initialGg) throws com.irurueta.navigation.LockedException Sets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.- Specified by:
setInitialGgin interfaceGyroscopeNonLinearCalibrator- Parameters:
initialGg- g-dependent cross biases.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided matrix is not 3x3.
-
getTurntableRotationRate
public double getTurntableRotationRate()Gets constant rotation rate at which the turntable is spinning. This is expressed in radians per second (rad/s).- Returns:
- constant rotation rate of turntable.
-
setTurntableRotationRate
public void setTurntableRotationRate(double turntableRotationRate) throws com.irurueta.navigation.LockedException Sets constant rotation rate at which the turntable is spinning. This is expressed in radians per second (rad/s).- Parameters:
turntableRotationRate- constant rotation rate of turntable.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently runningIllegalArgumentException- if provided value is zero or negative.
-
getTurntableRotationRateAsAngularSpeed
public com.irurueta.units.AngularSpeed getTurntableRotationRateAsAngularSpeed()Gets constant rotation rate at which the turntable is spinning.- Returns:
- constant rotation rate of turntable.
-
getTurntableRotationRateAsAngularSpeed
public void getTurntableRotationRateAsAngularSpeed(com.irurueta.units.AngularSpeed result) Gets constant rotation rate at which the turntable is spinning.- Parameters:
result- instance where result will be stored.
-
setTurntableRotationRate
public void setTurntableRotationRate(com.irurueta.units.AngularSpeed turntableRotationRate) throws com.irurueta.navigation.LockedException Sets constant rotation rate at which the turntable is spinning.- Parameters:
turntableRotationRate- constant rotation rate of turntable.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided value is zero or negative.
-
getTimeInterval
public double getTimeInterval()Gets time interval between measurements being captured expressed in seconds (s).- Returns:
- time interval between measurements.
-
setTimeInterval
public void setTimeInterval(double timeInterval) throws com.irurueta.navigation.LockedException Sets time interval between measurements being captured expressed in seconds (s).- Parameters:
timeInterval- time interval between measurements.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.IllegalArgumentException- if provided value is zero or negative.
-
getTimeIntervalAsTime
public com.irurueta.units.Time getTimeIntervalAsTime()Gets time interval between measurements being captured.- Returns:
- time interval between measurements.
-
getTimeIntervalAsTime
public void getTimeIntervalAsTime(com.irurueta.units.Time result) Gets time interval between measurements being captured.- Parameters:
result- instance where result will be stored.
-
setTimeInterval
public void setTimeInterval(com.irurueta.units.Time timeInterval) throws com.irurueta.navigation.LockedException Sets time interval between measurements being captured.- Parameters:
timeInterval- time interval between measurements.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getMeasurements
Gets a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements.- Specified by:
getMeasurementsin interfaceUnorderedStandardDeviationBodyKinematicsGyroscopeCalibrator- Returns:
- collection of body kinematics measurements at a known position with unknown orientations.
-
setMeasurements
public void setMeasurements(Collection<StandardDeviationBodyKinematics> measurements) throws com.irurueta.navigation.LockedException Sets a collection of body kinematics measurements taken at a given position with different unknown orientations and containing the standard deviations of accelerometer and gyroscope measurements.- Specified by:
setMeasurementsin interfaceUnorderedStandardDeviationBodyKinematicsGyroscopeCalibrator- Parameters:
measurements- collection of body kinematics measurements at a known position with unknown orientations.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getEcefPosition
public com.irurueta.navigation.frames.ECEFPosition getEcefPosition()Gets position where body kinematics measures have been taken expressed in ECEF coordinates.- Returns:
- position where body kinematics measures have been taken.
-
getNedPosition
public com.irurueta.navigation.frames.NEDPosition getNedPosition()Gets position where body kinematics measures have been taken expressed in NED coordinates.- Returns:
- position where body kinematics measures have been taken or null if not available.
-
getMeasurementOrSequenceType
Indicates the type of measurement or sequence used by this calibrator.- Specified by:
getMeasurementOrSequenceTypein interfaceGyroscopeCalibrator- Returns:
- type of measurement or sequence used by this calibrator.
-
isOrderedMeasurementsOrSequencesRequired
public boolean isOrderedMeasurementsOrSequencesRequired()Indicates whether this calibrator requires ordered measurements or sequences in a list or not.- Specified by:
isOrderedMeasurementsOrSequencesRequiredin interfaceGyroscopeCalibrator- Returns:
- true if measurements or sequences must be ordered, false otherwise.
-
isQualityScoresRequired
public boolean isQualityScoresRequired()Indicates whether this calibrator requires quality scores for each measurement/sequence or not.- Specified by:
isQualityScoresRequiredin interfaceGyroscopeCalibrator- Returns:
- true if quality scores are required, false otherwise.
-
isCommonAxisUsed
public boolean isCommonAxisUsed()Indicates whether z-axis is assumed to be common for accelerometer and gyroscope. When enabled, this eliminates 3 variables from Ma matrix.- Specified by:
isCommonAxisUsedin interfaceGyroscopeCalibrator- Returns:
- true if z-axis is assumed to be common for accelerometer and gyroscope, false otherwise.
-
setCommonAxisUsed
public void setCommonAxisUsed(boolean commonAxisUsed) throws com.irurueta.navigation.LockedException Specifies whether z-axis is assumed to be common for accelerometer and gyroscope. When enabled, this eliminates 3 variables from Ma matrix.- Specified by:
setCommonAxisUsedin interfaceGyroscopeCalibrator- Parameters:
commonAxisUsed- true if z-axis is assumed to be common for accelerometer and gyroscope, false otherwise.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
isGDependentCrossBiasesEstimated
public boolean isGDependentCrossBiasesEstimated()Indicates whether G-dependent cross biases are being estimated or not. When enabled, this adds 9 variables from Gg matrix.- Returns:
- true if G-dependent cross biases will be estimated, false otherwise.
-
setGDependentCrossBiasesEstimated
public void setGDependentCrossBiasesEstimated(boolean estimateGDependentCrossBiases) throws com.irurueta.navigation.LockedException Specifies whether G-dependent cross biases are being estimated or not. When enabled, this adds 9 variables from Gg matrix.- Parameters:
estimateGDependentCrossBiases- true if G-dependent cross biases will be estimated, false otherwise.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getListener
Gets listener to handle events raised by this estimator.- Returns:
- listener to handle events raised by this estimator.
-
getMinimumRequiredMeasurementsOrSequences
public int getMinimumRequiredMeasurementsOrSequences()Gets minimum number of required measurements.- Specified by:
getMinimumRequiredMeasurementsOrSequencesin interfaceGyroscopeCalibrator- Returns:
- minimum number of required measurements.
-
isReady
public boolean isReady()Indicates whether calibrator is ready to start.- Specified by:
isReadyin interfaceGyroscopeCalibrator- Returns:
- true if calibrator is ready, false otherwise.
-
isRunning
public boolean isRunning()Indicates whether calibrator is currently running or not.- Specified by:
isRunningin interfaceGyroscopeCalibrator- Returns:
- true if calibrator is running, false otherwise.
-
calibrate
public void calibrate() throws com.irurueta.navigation.LockedException, com.irurueta.navigation.NotReadyException, CalibrationExceptionEstimates gyroscope calibration parameters containing bias, scale factors, cross-coupling errors and G-dependent coupling.- Specified by:
calibratein interfaceGyroscopeCalibrator- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.com.irurueta.navigation.NotReadyException- if calibrator is not ready.CalibrationException- if estimation fails for numerical reasons.
-
getEstimatedMg
public com.irurueta.algebra.Matrix getEstimatedMg()Gets estimated gyroscope scale factors and cross coupling errors. This is the product of matrix Tg containing cross coupling errors and Kg containing scaling factors. So that:Mg = [sx mxy mxz] = Tg*Kg [myx sy myz] [mzx mzy sz ]Where:Kg = [sx 0 0 ] [0 sy 0 ] [0 0 sz]andTg = [1 -alphaXy alphaXz ] [alphaYx 1 -alphaYz] [-alphaZx alphaZy 1 ]Hence:Mg = [sx mxy mxz] = Tg*Kg = [sx -sy * alphaXy sz * alphaXz ] [myx sy myz] [sx * alphaYx sy -sz * alphaYz] [mzx mzy sz ] [-sx * alphaZx sy * alphaZy sz ]This instance allows any 3x3 matrix however, typically alphaYx, alphaZx and alphaZy are considered to be zero if the gyroscope z-axis is assumed to be the same as the body z-axis. When this is assumed, myx = mzx = mzy = 0 and the Mg matrix becomes upper diagonal:Mg = [sx mxy mxz] [0 sy myz] [0 0 sz ]Values of this matrix are unit-less.- Specified by:
getEstimatedMgin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope scale factors and cross coupling errors, or null if not available.
-
getEstimatedSx
Gets estimated gyroscope x-axis scale factor.- Specified by:
getEstimatedSxin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope x-axis scale factor or null if not available.
-
getEstimatedSy
Gets estimated gyroscope y-axis scale factor.- Specified by:
getEstimatedSyin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope y-axis scale factor or null if not available.
-
getEstimatedSz
Gets estimated gyroscope z-axis scale factor.- Specified by:
getEstimatedSzin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope z-axis scale factor or null if not available.
-
getEstimatedMxy
Gets estimated gyroscope x-y cross-coupling error.- Specified by:
getEstimatedMxyin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope x-y cross-coupling error or null if not available.
-
getEstimatedMxz
Gets estimated gyroscope x-z cross-coupling error.- Specified by:
getEstimatedMxzin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope x-z cross-coupling error or null if not available.
-
getEstimatedMyx
Gets estimated gyroscope y-x cross-coupling error.- Specified by:
getEstimatedMyxin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope y-x cross-coupling error or null if not available.
-
getEstimatedMyz
Gets estimated gyroscope y-z cross-coupling error.- Specified by:
getEstimatedMyzin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope y-z cross-coupling error or null if not available.
-
getEstimatedMzx
Gets estimated gyroscope z-x cross-coupling error.- Specified by:
getEstimatedMzxin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope z-x cross-coupling error or null if not available.
-
getEstimatedMzy
Gets estimated gyroscope z-y cross-coupling error.- Specified by:
getEstimatedMzyin interfaceGyroscopeCalibrator- Returns:
- estimated gyroscope z-y cross-coupling error or null if not available.
-
getEstimatedGg
public com.irurueta.algebra.Matrix getEstimatedGg()Gets estimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer. This instance allows any 3x3 matrix.- Specified by:
getEstimatedGgin interfaceGyroscopeCalibrator- Returns:
- estimated G-dependent cross biases.
-
getEstimatedCovariance
public com.irurueta.algebra.Matrix getEstimatedCovariance()Gets estimated covariance matrix for estimated parameters. Diagonal elements of the matrix contains variance for the following parameters (following indicated order): sx, sy, sz, mxy, mxz, myx, myz, mzx, mzy, gg11, gg21, gg31, gg12, gg22, gg32, gg13, gg23, gg33.- Specified by:
getEstimatedCovariancein interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated covariance matrix for estimated parameters.
-
getEstimatedChiSq
public double getEstimatedChiSq()Gets estimated chi square value.- Specified by:
getEstimatedChiSqin interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated chi square value.
-
getEstimatedChiSqDegreesOfFreedom
public int getEstimatedChiSqDegreesOfFreedom()Gets estimated chi square degrees of freedom. Degrees of freedom is equal to the number of sampled data minus the number of estimated parameters.- Specified by:
getEstimatedChiSqDegreesOfFreedomin interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated degrees of freedom of chi square value
-
getEstimatedReducedChiSq
public double getEstimatedReducedChiSq()Gets estimated reduced chi square value. This is equal to estimated chi square value divided by its degrees of freedom. Ideally this value should be close to 1.0, indicating that fit is optimal. A value larger than 1.0 indicates that fit is not good or noise has been underestimated, and a value smaller than 1.0 indicates that there is overfitting or noise has been overestimated.- Specified by:
getEstimatedReducedChiSqin interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated reduced chi square value
-
getEstimatedMse
public double getEstimatedMse()Gets estimated mean square error respect to provided measurements.- Specified by:
getEstimatedMsein interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated mean square error respect to provided measurements.
-
getEstimatedP
public double getEstimatedP()Gets estimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0. The smaller the found chi square value is, the better the fit of the estimated parameters to the actual parameter. Thus, the smaller the chance of finding a smaller chi square value, then the better the estimated fit is.- Specified by:
getEstimatedPin interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated probability of finding a smaller chi square value.
-
getEstimatedQ
public double getEstimatedQ()Gets estimated measure of quality of estimated fit as a value between 0.0 and 1.0. The larger the quality value is, the better the fit that has been estimated.- Specified by:
getEstimatedQin interfaceGyroscopeNonLinearCalibrator- Returns:
- estimated measure of quality of estimated fit.
-
calibrateCommonAxisAndGDependentCrossBiases
private void calibrateCommonAxisAndGDependentCrossBiases() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope and when G-dependent cross biases are being estimated.- Throws:
com.irurueta.algebra.AlgebraException- if there are numerical errors.com.irurueta.numerical.fitting.FittingException- if no convergence to solution is found.com.irurueta.numerical.NotReadyException- if fitter is not ready.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens
-
calibrateGeneralAndGDependentCrossBiases
private void calibrateGeneralAndGDependentCrossBiases() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionInternal method to perform general calibration when G-dependent cross biases are being estimated.- Throws:
com.irurueta.algebra.AlgebraException- if there are numerical errors.com.irurueta.numerical.fitting.FittingException- if no convergence to solution is found.com.irurueta.numerical.NotReadyException- if fitter is not ready.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens
-
calibrateCommonAxis
private void calibrateCommonAxis() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope and G-dependent cross biases are ignored.- Throws:
com.irurueta.algebra.AlgebraException- if there are numerical errors.com.irurueta.numerical.fitting.FittingException- if no convergence to solution is found.com.irurueta.numerical.NotReadyException- if fitter is not ready.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens.
-
calibrateGeneral
private void calibrateGeneral() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionInternal method to perform general calibration when G-dependent cross biases are ignored.- Throws:
com.irurueta.algebra.AlgebraException- if there are numerical errors.com.irurueta.numerical.fitting.FittingException- if no convergence to solution is found.com.irurueta.numerical.NotReadyException- if fitter is not ready.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens.
-
setInputDataWithGDependentCrossBiases
private void setInputDataWithGDependentCrossBiases() throws com.irurueta.algebra.AlgebraException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionSets input data into Levenberg-Marquardt fitter when G-dependent cross biases are taken into account.- Throws:
com.irurueta.algebra.AlgebraException- if provided accelerometer cross coupling errors are not valid.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens
-
setInputData
private void setInputData() throws com.irurueta.algebra.AlgebraException, com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeExceptionSets input data into Levenberg-Marquardt fitter when G-dependent cross biases are ignored.- Throws:
com.irurueta.algebra.AlgebraException- if provided accelerometer cross coupling errors are not valid.com.irurueta.navigation.frames.InvalidSourceAndDestinationFrameTypeException- never happens.
-
convertAcceleration
private static double convertAcceleration(com.irurueta.units.Acceleration acceleration) Converts acceleration instance to meters per squared second.- Parameters:
acceleration- acceleration instance to be converted.- Returns:
- converted value.
-
convertAngularSpeed
private static double convertAngularSpeed(double value, com.irurueta.units.AngularSpeedUnit unit) Converts angular speed instance to radians per second (rad/s).- Parameters:
value- angular speed value.unit- unit of angular speed value.- Returns:
- converted value.
-
convertAngularSpeed
private static double convertAngularSpeed(com.irurueta.units.AngularSpeed angularSpeed) Converts angular speed instance to radians per second (rad/s).- Parameters:
angularSpeed- angular speed instance to be converted.- Returns:
- converted value.
-
convertTime
private static double convertTime(com.irurueta.units.Time time) Converts time instance to seconds.- Parameters:
time- time instance to be converted.- Returns:
- converted value.
-
setResult
private void setResult(com.irurueta.algebra.Matrix m, com.irurueta.algebra.Matrix g) throws com.irurueta.algebra.AlgebraException Makes proper conversion of internal cross-coupling and g-dependent cross bias matrices.- Parameters:
m- internal scaling and cross-coupling matrix.g- internal g-dependent cross bias matrix.- Throws:
com.irurueta.algebra.AlgebraException- if a numerical instability occurs.
-
setResult
private void setResult(com.irurueta.algebra.Matrix m) throws com.irurueta.algebra.AlgebraException Makes proper conversion of internal cross-coupling matrix.- Parameters:
m- internal scaling and cross-coupling matrix.- Throws:
com.irurueta.algebra.AlgebraException- if a numerical instability occurs.
-
evaluateGeneralWitGDependentCrossBiases
private double evaluateGeneralWitGDependentCrossBiases(double[] params) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and specific force along with provided parameters for the general case when G-dependent cross biases are taken into account. This method is internally executed during gradient estimation and Levenberg-Marquardt fitting needed for calibration computation.- Parameters:
params- array containing parameters for the general purpose case when G-dependent cross biases are taken into account. Must have length 18.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-
evaluateCommonAxisWitGDependentCrossBiases
private double evaluateCommonAxisWitGDependentCrossBiases(double[] params) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and specific force along with provided parameters when common z-axis is assumed and G-dependent cross biases are taken into account. This method is internally executed during gradient estimation and Levenberg-Marquardt fitting needed for calibration computation.- Parameters:
params- array containing parameters for the general purpose case when G-dependent cross biases are taken into account. Must have length 15.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-
evaluateGeneral
private double evaluateGeneral(double[] params) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and provided parameters for the general case when G-dependent cross biases are ignored. This method is internally executed during gradient estimation and Levenberg-Marquardt fitting needed for calibration computation.- Parameters:
params- array containing current parameters for the general purpose case when G-dependent cross biases are ignored. Must have length 9.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-
evaluateCommonAxis
private double evaluateCommonAxis(double[] params) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and provided parameters when common z-axis is assumed and G-dependent cross biases are ignored. This method is internally executed during gradient estimation and Levenberg-Marquardt fitting needed for calibration computation.- Parameters:
params- array containing current parameters for the common z-axis case when G-dependent cross biases are ignored. Must have length 6.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-
evaluate
private double evaluate(double m11, double m21, double m31, double m12, double m22, double m32, double m13, double m23, double m33, double g11, double g21, double g31, double g12, double g22, double g32, double g13, double g23, double g33) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and provided parameters. This method is internally executed during gradient estimation and Levenberg-Marquardt fitting needed for calibration computation.- Parameters:
m11- element 1,1 of cross-coupling error matrix.m21- element 2,1 of cross-coupling error matrix.m31- element 3,1 of cross-coupling error matrix.m12- element 1,2 of cross-coupling error matrix.m22- element 2,2 of cross-coupling error matrix.m32- element 3,2 of cross-coupling error matrix.m13- element 1,3 of cross-coupling error matrix.m23- element 2,3 of cross-coupling error matrix.m33- element 3,3 of cross-coupling error matrix.g11- element 1,1 of g-dependent cross bias matrix.g21- element 2,1 of g-dependent cross bias matrix.g31- element 3,1 of g-dependent cross bias matrix.g12- element 1,2 of g-dependent cross bias matrix.g22- element 2,2 of g-dependent cross bias matrix.g32- element 3,2 of g-dependent cross bias matrix.g13- element 1,3 of g-dependent cross bias matrix.g23- element 2,3 of g-dependent cross bias matrix.g33- element 3,3 of g-dependent cross bias matrix.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-
evaluate
private double evaluate(double m11, double m21, double m31, double m12, double m22, double m32, double m13, double m23, double m33) throws com.irurueta.numerical.EvaluationException Computes estimated true angular rate squared norm using current measured angular rate and provided parameters. This method is internally executed during gradient estimation and Levenberg-Marquardt fittin needed for calibration computation.- Parameters:
m11- element 1,1 of cross-coupling error matrix.m21- element 2,1 of cross-coupling error matrix.m31- element 3,1 of cross-coupling error matrix.m12- element 1,2 of cross-coupling error matrix.m22- element 2,2 of cross-coupling error matrix.m32- element 3,2 of cross-coupling error matrix.m13- element 1,3 of cross-coupling error matrix.m23- element 2,3 of cross-coupling error matrix.m33- element 3,3 of cross-coupling error matrix.- Returns:
- estimated true angular rate squared norm.
- Throws:
com.irurueta.numerical.EvaluationException- if there are numerical instabilities.
-