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 + wWhere: - Ω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 AccelerationFixer
Acceleration fixer.private double
Known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Know accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private double
Known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.private com.irurueta.algebra.Matrix
Internally holds biases during calibration.private com.irurueta.algebra.Matrix
Internally holds accelerometer bias during calibration.private double
Known x-coordinate of gyroscope bias.private double
Known y-coordinate of gyroscope bias.private double
Known z-coordinate of gyroscope bias.static final int
Number 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 int
Number of unknowns when common z-axis is assumed for both the accelerometer and gyroscope when G-dependent cross biases are being estimated.private boolean
This flag indicates whether z-axis is assumed to be common for accelerometer and gyroscope.static final boolean
Indicates that by default G-dependent cross biases introduced by the accelerometer on the gyroscope are estimated.static final double
Default time interval between measurements expressed in seconds (s).static final double
Default turntable rotation rate.static final boolean
Indicates whether by default a common z-axis is assumed for both the accelerometer and gyroscope.private double
Estimated chi square value.private com.irurueta.algebra.Matrix
Estimated covariance matrix for estimated parameters.private com.irurueta.algebra.Matrix
Estimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.private com.irurueta.algebra.Matrix
Estimated gyroscope scale factors and cross coupling errors.private double
Estimated mean square error respect to provided measurements.private boolean
This flag indicates whether G-dependent cross biases are being estimated or not.private final com.irurueta.numerical.fitting.LevenbergMarquardtMultiDimensionFitter
Levenberg-Marquardt fitter to find a non-linear solution.private com.irurueta.algebra.Matrix
Internally holds measured specific force during calibration expressed as a column matrix.private double
Internally holds x-coordinate of measured specific force during calibration.private double
Internally holds y-coordinate of measured specific force during calibration.private double
Internally holds z-coordinate of measured specific force during calibration.private com.irurueta.algebra.Matrix
Internally holds computed true specific force during calibration.private com.irurueta.algebra.Matrix
Internally hold g-dependent cross biases during calibration.static final int
Number of unknowns for the general case when G-dependent cross biases are not being estimated.static final int
Number of unknowns for the general case when G-dependent cross biases are being estimated.private com.irurueta.algebra.Matrix
Initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.private double
Initial gyroscope x-y cross coupling error.private double
Initial gyroscope x-z cross coupling error.private double
Initial gyroscope y-x cross coupling error.private double
Initial gyroscope y-z cross coupling error.private double
Initial gyroscope z-x cross coupling error.private double
Initial gyroscope z-y cross coupling error.private double
Initial gyroscope x scaling factor.private double
Initial gyroscope y scaling factor.private double
Initial gyroscope z scaling factor.private com.irurueta.algebra.Matrix
Internally holds inverse of cross-coupling errors during calibration.Listener to handle events raised by this calibrator.private com.irurueta.algebra.Matrix
Internally holds cross-coupling errors during calibration.private com.irurueta.algebra.Matrix
Internally holds accelerometer scaling and cross coupling errors during calibration.private com.irurueta.algebra.Matrix
Internally holds measured angular rate during calibration expressed as a column matrix.private double
Internally holds x-coordinate of measured angular rate during calibration.private double
Internally holds y-coordinate of measured angular rate during calibration.private double
Internally 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 int
Required minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being ignored.static final int
Required minimum number of measurements when common z-axis is assumed and G-dependent cross biases are being estimated.static final int
Required minimum number of measurements for the general case and G-dependent cross biases are being ignored.static final int
Required minimum number of measurements for the general case and G-dependent cross biases are being estimated.private com.irurueta.navigation.frames.ECEFPosition
Position where body kinematics measures have been taken.private boolean
Indicates whether calibrator is running.private double
Time interval between measurements being captured expressed in second (s).private com.irurueta.algebra.Matrix
Internally holds angular rate bias due to g-dependent cross biasesprivate com.irurueta.algebra.Matrix
Internally holds computed true angular rate during calibration.private double
Constant 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 TypeMethodDescriptionvoid
Estimates gyroscope calibration parameters containing bias, scale factors, cross-coupling errors and G-dependent coupling.private void
Internal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope and G-dependent cross biases are ignored.private void
Internal 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 void
Internal method to perform general calibration when G-dependent cross biases are ignored.private void
Internal method to perform general calibration when G-dependent cross biases are being estimated.private static double
convertAcceleration
(com.irurueta.units.Acceleration acceleration) Converts acceleration instance to meters per squared second.private static double
convertAngularSpeed
(double value, com.irurueta.units.AngularSpeedUnit unit) Converts angular speed instance to radians per second (rad/s).private static double
convertAngularSpeed
(com.irurueta.units.AngularSpeed angularSpeed) Converts angular speed instance to radians per second (rad/s).private static com.irurueta.navigation.frames.ECEFPosition
convertPosition
(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 double
convertTime
(com.irurueta.units.Time time) Converts time instance to seconds.private double
evaluate
(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 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) Computes estimated true angular rate squared norm using current measured angular rate and provided parameters.private double
evaluateCommonAxis
(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 double
evaluateCommonAxisWitGDependentCrossBiases
(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 double
evaluateGeneral
(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 double
evaluateGeneralWitGDependentCrossBiases
(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.void
getAccelerometerBias
(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.Matrix
Gets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.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.double
Gets 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.Acceleration
Gets known x-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.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.double
Gets 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.Acceleration
Gets known y-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.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.double
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.units.Acceleration
Gets known z-coordinate of accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.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.com.irurueta.algebra.Matrix
Gets known accelerometer scale factors and cross coupling errors matrix.void
getAccelerometerMa
(com.irurueta.algebra.Matrix result) Gets known accelerometer scale factors and cross coupling errors matrix.double
Gets known accelerometer x-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer x-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer y-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer y-z cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer z-x cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer z-y cross coupling error to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.double
Gets 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.void
getBias
(double[] result) Gets known gyroscope bias as an array.com.irurueta.units.AngularSpeed
Gets known x-coordinate of gyroscope bias.void
getBiasAngularSpeedX
(com.irurueta.units.AngularSpeed result) Gets known x-coordinate of gyroscope bias.com.irurueta.units.AngularSpeed
Gets known y-coordinate of gyroscope bias.void
getBiasAngularSpeedY
(com.irurueta.units.AngularSpeed result) Gets known y-coordinate of gyroscope bias.com.irurueta.units.AngularSpeed
Gets known z-coordinate of gyroscope bias to be used to find a solution.void
getBiasAngularSpeedZ
(com.irurueta.units.AngularSpeed result) Gets known z-coordinate of gyroscope bias.com.irurueta.algebra.Matrix
Gets known gyroscope bias as a column matrix.void
getBiasAsMatrix
(com.irurueta.algebra.Matrix result) Gets known gyroscope bias as a column matrix.Gets known gyroscope bias.void
getBiasAsTriad
(AngularSpeedTriad result) Gets known gyroscope bias.double
getBiasX()
Gets known x-coordinate of gyroscope bias.double
getBiasY()
Gets known y-coordinate of gyroscope bias.double
getBiasZ()
Gets known z-coordinate of gyroscope bias.com.irurueta.navigation.frames.ECEFPosition
Gets position where body kinematics measures have been taken expressed in ECEF coordinates.double
Gets estimated chi square value.com.irurueta.algebra.Matrix
Gets estimated covariance matrix for estimated parameters.com.irurueta.algebra.Matrix
Gets estimated G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.com.irurueta.algebra.Matrix
Gets estimated gyroscope scale factors and cross coupling errors.double
Gets 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.Gets estimated gyroscope x-axis scale factor.Gets estimated gyroscope y-axis scale factor.Gets estimated gyroscope z-axis scale factor.com.irurueta.algebra.Matrix
Gets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.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.com.irurueta.algebra.Matrix
Gets initial gyroscope scale factors and cross coupling errors matrix.void
getInitialMg
(com.irurueta.algebra.Matrix result) Gets initial gyroscope scale factors and cross coupling errors matrix.double
Gets initial x-y cross coupling error of gyroscope.double
Gets initial x-z cross coupling error of gyroscope.double
Gets initial y-x cross coupling error of gyroscope.double
Gets initial y-z cross coupling error of gyroscope.double
Gets initial z-x cross coupling error of gyroscope.double
Gets initial z-y cross coupling error of gyroscope.double
Gets initial x scaling factor of gyroscope.double
Gets initial y scaling factor of gyroscope.double
Gets 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.int
Gets minimum number of required measurements.com.irurueta.navigation.frames.NEDPosition
Gets position where body kinematics measures have been taken expressed in NED coordinates.boolean
getNedPosition
(com.irurueta.navigation.frames.NEDPosition result) Gets position where body kinematics measures have been taken expressed in NED coordinates.double
Gets time interval between measurements being captured expressed in seconds (s).com.irurueta.units.Time
Gets time interval between measurements being captured.void
getTimeIntervalAsTime
(com.irurueta.units.Time result) Gets time interval between measurements being captured.double
Gets constant rotation rate at which the turntable is spinning.com.irurueta.units.AngularSpeed
Gets constant rotation rate at which the turntable is spinning.void
getTurntableRotationRateAsAngularSpeed
(com.irurueta.units.AngularSpeed result) Gets constant rotation rate at which the turntable is spinning.boolean
Indicates whether z-axis is assumed to be common for accelerometer and gyroscope.boolean
Indicates whether G-dependent cross biases are being estimated or not.boolean
Indicates whether this calibrator requires ordered measurements or sequences in a list or not.boolean
Indicates whether this calibrator requires quality scores for each measurement/sequence or not.boolean
isReady()
Indicates whether calibrator is ready to start.boolean
Indicates whether calibrator is currently running or not.void
setAccelerometerBias
(double[] accelerometerBias) Sets known accelerometer bias to be used to fix measured specific force and find cross biases introduced by the accelerometer.void
setAccelerometerBias
(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.void
setAccelerometerBias
(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.void
setAccelerometerBias
(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.void
setAccelerometerBiasX
(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.void
setAccelerometerBiasX
(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.void
setAccelerometerBiasY
(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.void
setAccelerometerBiasY
(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.void
setAccelerometerBiasZ
(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.void
setAccelerometerBiasZ
(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.void
setAccelerometerCrossCouplingErrors
(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.void
setAccelerometerMa
(com.irurueta.algebra.Matrix accelerometerMa) Sets known accelerometer scale factors and cross coupling errors matrix.void
setAccelerometerMxy
(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.void
setAccelerometerMxz
(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.void
setAccelerometerMyx
(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.void
setAccelerometerMyz
(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.void
setAccelerometerMzx
(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.void
setAccelerometerMzy
(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.void
setAccelerometerScalingFactors
(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.void
setAccelerometerScalingFactorsAndCrossCouplingErrors
(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.void
setAccelerometerSx
(double accelerometerSx) Sets known accelerometer x scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.void
setAccelerometerSy
(double accelerometerSy) Sets known accelerometer y scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.void
setAccelerometerSz
(double accelerometerSz) Sets known accelerometer z scaling factor to be used to fix measured specific force and find cross biases introduced by the accelerometer.void
setBias
(double[] bias) Sets known gyroscope bias as an array.void
setBias
(com.irurueta.algebra.Matrix bias) Sets known gyroscope bias as a column matrix.void
setBias
(AngularSpeedTriad bias) Sets known gyroscope bias.void
setBiasCoordinates
(double biasX, double biasY, double biasZ) Sets known bias coordinates of gyroscope expressed in radians per second (rad/s).void
setBiasCoordinates
(com.irurueta.units.AngularSpeed biasX, com.irurueta.units.AngularSpeed biasY, com.irurueta.units.AngularSpeed biasZ) Sets known bias coordinates of gyroscope.void
setBiasX
(double biasX) Sets known x-coordinate of gyroscope bias.void
setBiasX
(com.irurueta.units.AngularSpeed biasX) Sets known x-coordinate of gyroscope bias.void
setBiasY
(double biasY) Sets known y-coordinate of gyroscope bias.void
setBiasY
(com.irurueta.units.AngularSpeed biasY) Sets known y-coordinate of gyroscope bias to be used to find a solution.void
setBiasZ
(double biasZ) Sets known z-coordinate of gyroscope bias.void
setBiasZ
(com.irurueta.units.AngularSpeed biasZ) Sets known z-coordinate of gyroscope bias.void
setCommonAxisUsed
(boolean commonAxisUsed) Specifies whether z-axis is assumed to be common for accelerometer and gyroscope.void
setGDependentCrossBiasesEstimated
(boolean estimateGDependentCrossBiases) Specifies whether G-dependent cross biases are being estimated or not.void
setInitialCrossCouplingErrors
(double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Sets initial cross coupling errors of gyroscope.void
setInitialGg
(com.irurueta.algebra.Matrix initialGg) Sets initial G-dependent cross biases introduced on the gyroscope by the specific forces sensed by the accelerometer.void
setInitialMg
(com.irurueta.algebra.Matrix initialMg) Sets initial gyroscope scale factors and cross coupling errors matrix.void
setInitialMxy
(double initialMxy) Sets initial x-y cross coupling error of gyroscope.void
setInitialMxz
(double initialMxz) Sets initial x-z cross coupling error of gyroscope.void
setInitialMyx
(double initialMyx) Sets initial y-x cross coupling error of gyroscope.void
setInitialMyz
(double initialMyz) Sets initial y-z cross coupling error of gyroscope.void
setInitialMzx
(double initialMzx) Sets initial z-x cross coupling error of gyroscope.void
setInitialMzy
(double initialMzy) Sets initial z-y cross coupling error of gyroscope.void
setInitialScalingFactors
(double initialSx, double initialSy, double initialSz) Sets initial scaling factors of gyroscope.void
setInitialScalingFactorsAndCrossCouplingErrors
(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.void
setInitialSx
(double initialSx) Sets initial x scaling factor of gyroscope.void
setInitialSy
(double initialSy) Sets initial y scaling factor of gyroscope.void
setInitialSz
(double initialSz) Sets initial z scaling factor of gyroscope.private void
Sets input data into Levenberg-Marquardt fitter when G-dependent cross biases are ignored.private void
Sets input data into Levenberg-Marquardt fitter when G-dependent cross biases are taken into account.void
Sets listener to handle events raised by this estimator.void
setMeasurements
(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.void
setPosition
(com.irurueta.navigation.frames.ECEFPosition position) Gets position where body kinematics measures have been taken expressed in ECEF coordinates.void
setPosition
(com.irurueta.navigation.frames.NEDPosition position) Sets position where body kinematics measures have been taken expressed in NED coordinates.private void
setResult
(com.irurueta.algebra.Matrix m) Makes proper conversion of internal cross-coupling matrix.private void
setResult
(com.irurueta.algebra.Matrix m, com.irurueta.algebra.Matrix g) Makes proper conversion of internal cross-coupling and g-dependent cross bias matrices.void
setTimeInterval
(double timeInterval) Sets time interval between measurements being captured expressed in seconds (s).void
setTimeInterval
(com.irurueta.units.Time timeInterval) Sets time interval between measurements being captured.void
setTurntableRotationRate
(double turntableRotationRate) Sets constant rotation rate at which the turntable is spinning.void
setTurntableRotationRate
(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. -
estimatedMse
private double estimatedMseEstimated mean square error respect to provided measurements. -
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:
getAccelerometerBiasX
in 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:
setAccelerometerBiasX
in 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:
getAccelerometerBiasY
in 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:
setAccelerometerBiasY
in 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:
getAccelerometerBiasZ
in 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:
setAccelerometerBiasZ
in 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:
getAccelerometerBiasXAsAcceleration
in 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:
getAccelerometerBiasXAsAcceleration
in 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:
setAccelerometerBiasX
in 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:
getAccelerometerBiasYAsAcceleration
in 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:
getAccelerometerBiasYAsAcceleration
in 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:
setAccelerometerBiasY
in 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:
getAccelerometerBiasZAsAcceleration
in 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:
getAccelerometerBiasZAsAcceleration
in 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:
setAccelerometerBiasZ
in 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:
setAccelerometerBias
in 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:
setAccelerometerBias
in 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:
getAccelerometerBias
in 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:
getAccelerometerBias
in 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:
setAccelerometerBias
in 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:
getAccelerometerBiasAsMatrix
in 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:
getAccelerometerBiasAsMatrix
in 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:
setAccelerometerBias
in 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:
getAccelerometerSx
in 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:
setAccelerometerSx
in 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:
getAccelerometerSy
in 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:
setAccelerometerSy
in 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:
getAccelerometerSz
in 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:
setAccelerometerSz
in 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:
getAccelerometerMxy
in 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:
setAccelerometerMxy
in 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:
getAccelerometerMxz
in 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:
setAccelerometerMxz
in 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:
getAccelerometerMyx
in 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:
setAccelerometerMyx
in 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:
getAccelerometerMyz
in 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:
setAccelerometerMyz
in 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:
getAccelerometerMzx
in 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:
setAccelerometerMzx
in 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:
getAccelerometerMzy
in 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:
setAccelerometerMzy
in 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:
setAccelerometerScalingFactors
in 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:
setAccelerometerCrossCouplingErrors
in 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:
setAccelerometerScalingFactorsAndCrossCouplingErrors
in 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:
getAccelerometerMa
in 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:
getAccelerometerMa
in 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:
setAccelerometerMa
in 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:
getBiasX
in 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:
setBiasX
in 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:
getBiasY
in 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:
setBiasY
in 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:
getBiasZ
in 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:
setBiasZ
in 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:
getBiasAngularSpeedX
in 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:
getBiasAngularSpeedX
in 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:
setBiasX
in 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:
getBiasAngularSpeedY
in 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:
getBiasAngularSpeedY
in 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:
setBiasY
in 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:
getBiasAngularSpeedZ
in 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:
getBiasAngularSpeedZ
in 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:
setBiasZ
in 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:
setBiasCoordinates
in 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:
setBiasCoordinates
in 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:
getInitialSx
in 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:
setInitialSx
in 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:
getInitialSy
in 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:
setInitialSy
in 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:
getInitialSz
in 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:
setInitialSz
in 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:
getInitialMxy
in 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:
setInitialMxy
in 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:
getInitialMxz
in 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:
setInitialMxz
in 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:
getInitialMyx
in 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:
setInitialMyx
in 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:
getInitialMyz
in 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:
setInitialMyz
in 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:
getInitialMzx
in 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:
setInitialMzx
in 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:
getInitialMzy
in 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:
setInitialMzy
in 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:
setInitialScalingFactors
in 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:
setInitialCrossCouplingErrors
in 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:
setInitialScalingFactorsAndCrossCouplingErrors
in 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:
getBias
in 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:
getBias
in 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:
setBias
in 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:
getBiasAsMatrix
in 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:
getBiasAsMatrix
in 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:
setBias
in 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:
getInitialMg
in 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:
getInitialMg
in 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:
setInitialMg
in 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:
getInitialGg
in 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:
getInitialGg
in 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:
setInitialGg
in 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:
getMeasurements
in 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:
setMeasurements
in 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:
getMeasurementOrSequenceType
in 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:
isOrderedMeasurementsOrSequencesRequired
in 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:
isQualityScoresRequired
in 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:
isCommonAxisUsed
in 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:
setCommonAxisUsed
in 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:
getMinimumRequiredMeasurementsOrSequences
in interfaceGyroscopeCalibrator
- Returns:
- minimum number of required measurements.
-
isReady
public boolean isReady()Indicates whether calibrator is ready to start.- Specified by:
isReady
in interfaceGyroscopeCalibrator
- Returns:
- true if calibrator is ready, false otherwise.
-
isRunning
public boolean isRunning()Indicates whether calibrator is currently running or not.- Specified by:
isRunning
in 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:
calibrate
in 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:
getEstimatedMg
in 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:
getEstimatedSx
in interfaceGyroscopeCalibrator
- Returns:
- estimated gyroscope x-axis scale factor or null if not available.
-
getEstimatedSy
Gets estimated gyroscope y-axis scale factor.- Specified by:
getEstimatedSy
in interfaceGyroscopeCalibrator
- Returns:
- estimated gyroscope y-axis scale factor or null if not available.
-
getEstimatedSz
Gets estimated gyroscope z-axis scale factor.- Specified by:
getEstimatedSz
in interfaceGyroscopeCalibrator
- Returns:
- estimated gyroscope z-axis scale factor or null if not available.
-
getEstimatedMxy
Gets estimated gyroscope x-y cross-coupling error.- Specified by:
getEstimatedMxy
in 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:
getEstimatedMxz
in 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:
getEstimatedMyx
in 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:
getEstimatedMyz
in 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:
getEstimatedMzx
in 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:
getEstimatedMzy
in 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:
getEstimatedGg
in 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:
getEstimatedCovariance
in interfaceGyroscopeNonLinearCalibrator
- Returns:
- estimated covariance matrix for estimated parameters.
-
getEstimatedChiSq
public double getEstimatedChiSq()Gets estimated chi square value.- Specified by:
getEstimatedChiSq
in interfaceGyroscopeNonLinearCalibrator
- Returns:
- estimated chi square value.
-
getEstimatedMse
public double getEstimatedMse()Gets estimated mean square error respect to provided measurements.- Specified by:
getEstimatedMse
in interfaceGyroscopeNonLinearCalibrator
- Returns:
- estimated mean square error respect to provided measurements.
-
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.
-