Class KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
java.lang.Object
com.irurueta.navigation.inertial.calibration.accelerometer.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
- All Implemented Interfaces:
AccelerometerCalibrator,AccelerometerNonLinearCalibrator,KnownBiasAccelerometerCalibrator,KnownBiasAndFrameAccelerometerCalibrator<StandardDeviationFrameBodyKinematics,,KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener> UnorderedStandardDeviationFrameBodyKinematicsAccelerometerCalibrator
public class KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
extends Object
implements KnownBiasAndFrameAccelerometerCalibrator<StandardDeviationFrameBodyKinematics,KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener>, AccelerometerNonLinearCalibrator, UnorderedStandardDeviationFrameBodyKinematicsAccelerometerCalibrator
Estimates accelerometer cross couplings and scaling factors.
This estimator assumes that biases are known.
This calibrator uses an iterative approach to find a minimum least squared error solution.
To use this calibrator it is assumed that body position and orientation is known and that body remains static on the same position while being calibrated.
Measured specific force is assumed to follow the model shown below:
fmeas = ba + (I + Ma) * ftrue + w
Where:
- fmeas is the measured specific force. This is a 3x1 vector.
- ba is accelerometer bias. This is a known 3x1 vector.
- I is the 3x3 identity matrix.
- Ma is the 3x3 matrix containing cross-couplings and scaling factors. Ideally, on
a perfect accelerometer, this should be a 3x3 zero matrix.
- ftrue is ground-trush specific force.
- w is measurement noise.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate doubleKnown x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).private doubleKnown y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).private doubleKnown z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).private static final intNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope.private booleanThis flag indicates whether z-axis is assumed to be common for accelerometer and gyroscope.static final booleanIndicates whether by default a common z-axis is assumed for both the accelerometer and gyroscope.private doubleEstimated chi square value.private intEstimated degrees of freedom of chi square value.private com.irurueta.algebra.MatrixEstimated covariance matrix for estimated position.private com.irurueta.algebra.MatrixEstimated accelerometer scale factors and cross coupling errors.private doubleEstimated mean square error respect to provided measurements.private doubleEstimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0.private doubleEstimated measure of quality of estimated fit as a value between 0.0 and 1.0.private doubleEstimated reduced chi square value.private final com.irurueta.numerical.fitting.LevenbergMarquardtMultiVariateFitterLevenberg-Marquardt fitter to find a non-linear solution.private static final intNumber of unknowns for the general case.private doubleInitial x-y cross coupling error.private doubleInitial x-z cross coupling error.private doubleInitial y-x cross coupling error.private doubleInitial y-z cross coupling error.private doubleInitial z-x cross coupling error.private doubleInitial z-y cross coupling error.private doubleInitial x scaling factor.private doubleInitial y scaling factor.private doubleInitial z scaling factor.Listener to handle events raised by this estimator.Contains a collections of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements.static final intRequired minimum number of measurements.private booleanIndicates whether estimator is running. -
Constructor Summary
ConstructorsConstructorDescriptionConstructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double[] bias, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double[] bias, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double[] bias, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor.KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener listener) Constructor. -
Method Summary
Modifier and TypeMethodDescriptionvoidEstimates accelerometer calibration parameters containing bias, scale factors and cross-coupling errors.private voidInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope.private voidInternal method to perform general calibration.private static doubleconvertAcceleration(double value, com.irurueta.units.AccelerationUnit unit) Converts acceleration value and unit to meters per squared second.private static doubleconvertAcceleration(com.irurueta.units.Acceleration acceleration) Converts acceleration instance to meters per squared second.double[]getBias()Gets known accelerometer bias as an array.voidgetBias(double[] result) Gets known accelerometer bias as an array.com.irurueta.algebra.MatrixGets known accelerometer bias as a column matrix.voidgetBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known accelerometer bias as a column matrix.Gets known accelerometer bias.voidgetBiasAsTriad(AccelerationTriad result) Gets known accelerometer bias.doublegetBiasX()Gets known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).com.irurueta.units.AccelerationGets known x coordinate of accelerometer bias.voidgetBiasXAsAcceleration(com.irurueta.units.Acceleration result) Gets known x coordinate of accelerometer bias.doublegetBiasY()Gets known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).com.irurueta.units.AccelerationGets known y coordinate of accelerometer bias.voidgetBiasYAsAcceleration(com.irurueta.units.Acceleration result) Gets known y coordinate of accelerometer bias.doublegetBiasZ()Gets known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).com.irurueta.units.AccelerationGets known z coordinate of accelerometer bias.voidgetBiasZAsAcceleration(com.irurueta.units.Acceleration result) Gets known z coordinate of accelerometer bias.doubleGets estimated chi square value.intGets estimated chi square degrees of freedom.com.irurueta.algebra.MatrixGets estimated covariance matrix for estimated calibration parameters.com.irurueta.algebra.MatrixGets estimated accelerometer scale factors and ross coupling errors.doubleGets estimated mean square error respect to provided measurements.Gets estimated x-y cross-coupling error.Gets estimated x-z cross-coupling error.Gets estimated y-x cross-coupling error.Gets estimated y-z cross-coupling error.Gets estimated z-x cross-coupling error.Gets estimated z-y cross-coupling error.doubleGets estimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0.doubleGets estimated measure of quality of estimated fit as a value between 0.0 and 1.0.doubleGets estimated reduced chi square value.Gets estimated x-axis scale factor.Gets estimated y-axis scale factor.Gets estimated z-axis scale factor.com.irurueta.algebra.MatrixGets initial scale factors and cross coupling errors matrix.voidgetInitialMa(com.irurueta.algebra.Matrix result) Gets initial scale factors and cross coupling errors matrix.doubleGets initial x-y cross coupling error.doubleGets initial x-z cross coupling error.doubleGets initial y-x cross coupling error.doubleGets initial y-z cross coupling error.doubleGets initial z-x cross coupling error.doubleGets initial z-y cross coupling error.doubleGets initial x scaling factor.doubleGets initial y scaling factor.doubleGets initial z scaling factor.Gets listener to handle events raised by this estimator.Gets a collection of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements.Indicates the type of measurement used by this calibrator.intGets minimum number of required measurements.booleanIndicates whether z-axis is assumed to be common for accelerometer and gyroscope.booleanIndicates whether this calibrator requires ordered measurements in a list or not.booleanIndicates whether this calibrator requires quality scores for each measurement or not.booleanisReady()Indicates whether calibrator is ready to start.booleanIndicates whether calibrator is currently running or not.voidsetBias(double[] bias) Sets known accelerometer bias as an array.voidsetBias(com.irurueta.algebra.Matrix bias) Sets known accelerometer bias as a column matrix.voidsetBias(AccelerationTriad bias) Sets known accelerometer bias.voidsetBiasCoordinates(double biasX, double biasY, double biasZ) Sets known accelerometer bias coordinates expressed in meters per squared second (m/s^2).voidsetBiasCoordinates(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) Sets known accelerometer bias coordinates.voidsetBiasX(double biasX) Sets known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).voidsetBiasX(com.irurueta.units.Acceleration biasX) Sets known x coordinate of accelerometer bias.voidsetBiasY(double biasY) Sets known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).voidsetBiasY(com.irurueta.units.Acceleration biasY) Sets known y coordinate of accelerometer bias.voidsetBiasZ(double biasZ) Sets known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).voidsetBiasZ(com.irurueta.units.Acceleration biasZ) Sets known z coordinate of accelerometer bias.voidsetCommonAxisUsed(boolean commonAxisUsed) Specifies whether z-axis is assumed to be common for accelerometer and gyroscope.voidsetInitialCrossCouplingErrors(double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Sets initial cross coupling errors.voidsetInitialMa(com.irurueta.algebra.Matrix initialMa) Sets initial scale factors and cross coupling errors matrix.voidsetInitialMxy(double initialMxy) Sets initial x-y cross coupling error.voidsetInitialMxz(double initialMxz) Sets initial x-z cross coupling error.voidsetInitialMyx(double initialMyx) Sets initial y-x cross coupling error.voidsetInitialMyz(double initialMyz) Sets initial y-z cross coupling error.voidsetInitialMzx(double initialMzx) Sets initial z-x cross coupling error.voidsetInitialMzy(double initialMzy) Sets initial z-y cross coupling error.voidsetInitialScalingFactors(double initialSx, double initialSy, double initialSz) Sets initial scaling factors.voidsetInitialScalingFactorsAndCrossCouplingErrors(double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Sets initial scaling factors and cross coupling errors.voidsetInitialSx(double initialSx) Sets initial x scaling factor.voidsetInitialSy(double initialSy) Sets initial y scaling factor.voidsetInitialSz(double initialSz) Sets initial z scaling factor.private voidSets input data into Levenberg-Marquardt fitter.voidSets listener to handle events raised by this estimator.voidsetMeasurements(Collection<? extends StandardDeviationFrameBodyKinematics> measurements) Sets a collection of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements.
-
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:
-
MINIMUM_MEASUREMENTS
public static final int MINIMUM_MEASUREMENTSRequired minimum number of measurements.- See Also:
-
COMMON_Z_AXIS_UNKNOWNS
private static final int COMMON_Z_AXIS_UNKNOWNSNumber of unknowns when common z-axis is assumed for both the accelerometer and gyroscope.- See Also:
-
GENERAL_UNKNOWNS
private static final int GENERAL_UNKNOWNSNumber of unknowns for the general case.- See Also:
-
fitter
private final com.irurueta.numerical.fitting.LevenbergMarquardtMultiVariateFitter fitterLevenberg-Marquardt fitter to find a non-linear solution. -
biasX
private double biasXKnown x coordinate of accelerometer bias expressed in meters per squared second (m/s^2). -
biasY
private double biasYKnown y coordinate of accelerometer bias expressed in meters per squared second (m/s^2). -
biasZ
private double biasZKnown z coordinate of accelerometer bias expressed in meters per squared second (m/s^2). -
initialSx
private double initialSxInitial x scaling factor. -
initialSy
private double initialSyInitial y scaling factor. -
initialSz
private double initialSzInitial z scaling factor. -
initialMxy
private double initialMxyInitial x-y cross coupling error. -
initialMxz
private double initialMxzInitial x-z cross coupling error. -
initialMyx
private double initialMyxInitial y-x cross coupling error. -
initialMyz
private double initialMyzInitial y-z cross coupling error. -
initialMzx
private double initialMzxInitial z-x cross coupling error. -
initialMzy
private double initialMzyInitial z-y cross coupling error. -
measurements
Contains a collections of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements. If a single device IMU needs to be calibrated, typically all measurements are taken at the same position, with zero velocity and multiple orientations. However, if we just want to calibrate a given IMU model (e.g. obtain an average and less precise calibration for the IMU of a given phone model), we could take measurements collected throughout the planet at multiple positions while the phone remains static (e.g. while charging), hence each measurement position will change, velocity will remain zero and orientation will be typically constant at horizontal orientation while the phone remains on a flat surface. -
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 Ma matrix. -
listener
Listener to handle events raised by this estimator. -
estimatedMa
private com.irurueta.algebra.Matrix estimatedMaEstimated accelerometer scale factors and cross coupling errors. This is the product of matrix Ta containing cross coupling errors and Ka containing scaling factors. So tat:Ma = [sx mxy mxz] = Ta*Ka [myx sy myz] [mzx mzy sz ]Where:Ka = [sx 0 0 ] [0 sy 0 ] [0 0 sz]andTa = [1 -alphaXy alphaXz ] [alphaYx 1 -alphaYz] [-alphaZx alphaZy 1 ]Hence:Ma = [sx mxy mxz] = Ta*Ka = [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 accelerometer z-axis is assumed to be the same as the body z-axis. When this is assumed, myx = mzx = mzy = 0 and the Ma matrix becomes upper diagonal:Ma = [sx mxy mxz] [0 sy myz] [0 0 sz ]Values of this matrix are unit-less. -
estimatedCovariance
private com.irurueta.algebra.Matrix estimatedCovarianceEstimated covariance matrix for estimated position. -
estimatedChiSq
private double estimatedChiSqEstimated chi square value. -
estimatedChiSqDegreesOfFreedom
private int estimatedChiSqDegreesOfFreedomEstimated degrees of freedom of chi square value. Degrees of freedom is equal to the number of sampled data minus the number of estimated parameters. -
estimatedReducedChiSq
private double estimatedReducedChiSqEstimated reduced chi square value. This is equal to estimated chi square value divided by its degrees of freedom. Ideally this value should be close to 1.0. -
estimatedMse
private double estimatedMseEstimated mean square error respect to provided measurements. -
estimatedP
private double estimatedPEstimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0. The smaller the found chi square value is, the better the fit of the estimated parameters to the actual parameter. Thus, the smaller the chance of finding a smaller chi square value, then the better the estimated fit is. -
estimatedQ
private double estimatedQEstimated measure of quality of estimated fit as a value between 0.0 and 1.0. The larger the quality value is, the better the fit that has been estimated. -
running
private boolean runningIndicates whether estimator is running.
-
-
Constructor Details
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator()Constructor. -
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed) Constructor.- Parameters:
commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, boolean commonAxisUsed, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double biasX, double biasY, double biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasY- known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).biasZ- known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ, boolean commonAxisUsed, double initialSx, double initialSy, double initialSz, double initialMxy, double initialMxz, double initialMyx, double initialMyz, double initialMzx, double initialMzy) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double[] bias) Constructor.- Parameters:
bias- known bias. This must have length 3 and is expressed in meters per squared second (m/s^2).- Throws:
IllegalArgumentException- if provided bias array does not have length 3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must have length 3 and is expressed in meters per squared second (m/s^2).- Throws:
IllegalArgumentException- if provided bias array does not have length 3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(double[] bias, boolean commonAxisUsed) Constructor.- Parameters:
bias- known bias. This must have length 3 and is expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.- Throws:
IllegalArgumentException- if provided bias array does not have length 3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, double[] bias, boolean commonAxisUsed) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must have length 3 and is expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.- Throws:
IllegalArgumentException- if provided bias array does not have length 3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias) Constructor.- Parameters:
bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).- Throws:
IllegalArgumentException- if provided bias matrix is not 3x1.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).- Throws:
IllegalArgumentException- if provided bias matrix is not 3x1.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed) Constructor.- Parameters:
bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.- Throws:
IllegalArgumentException- if provided bias matrix is not 3x1.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.- Throws:
IllegalArgumentException- if provided bias matrix is not 3x1.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa) Constructor.- Parameters:
bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).initialMa- initial scale factors and cross coupling errors matrix.- Throws:
IllegalArgumentException- if either provided bias matrix is not 3x1 or scaling and coupling error matrix is not 3x3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, com.irurueta.algebra.Matrix initialMa) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).initialMa- initial scale factors and cross coupling errors matrix.- Throws:
IllegalArgumentException- if either provided bias matrix is not 3x1 or scaling and coupling error matrix is not 3x3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa) Constructor.- Parameters:
bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialMa- initial scale factors and cross coupling errors matrix.- Throws:
IllegalArgumentException- if either provided bias matrix is not 3x1 or scaling and coupling error matrix is not 3x3.
-
KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator
public KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibrator(Collection<StandardDeviationFrameBodyKinematics> measurements, com.irurueta.algebra.Matrix bias, boolean commonAxisUsed, com.irurueta.algebra.Matrix initialMa) Constructor.- Parameters:
measurements- collection of body kinematics measurements with standard deviations taken at different frames (positions, orientations and velocities).bias- known bias. This must be a 3x1 matrix expressed in meters per squared second (m/s^2).commonAxisUsed- indicates whether z-axis is assumed to be common for accelerometer and gyroscope.initialMa- initial scale factors and cross coupling errors matrix.- Throws:
IllegalArgumentException- if either provided bias matrix is not 3x1 or scaling and coupling error matrix is not 3x3.
-
-
Method Details
-
getBiasX
public double getBiasX()Gets known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
getBiasXin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known x coordinate of accelerometer bias.
-
setBiasX
public void setBiasX(double biasX) throws com.irurueta.navigation.LockedException Sets known x coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
setBiasXin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasX- known x coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasY
public double getBiasY()Gets known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
getBiasYin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known y coordinate of accelerometer bias.
-
setBiasY
public void setBiasY(double biasY) throws com.irurueta.navigation.LockedException Sets known y coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
setBiasYin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasY- known y coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasZ
public double getBiasZ()Gets known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
getBiasZin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known z coordinate of accelerometer bias.
-
setBiasZ
public void setBiasZ(double biasZ) throws com.irurueta.navigation.LockedException Sets known z coordinate of accelerometer bias expressed in meters per squared second (m/s^2).- Specified by:
setBiasZin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasZ- known z coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasXAsAcceleration
public com.irurueta.units.Acceleration getBiasXAsAcceleration()Gets known x coordinate of accelerometer bias.- Specified by:
getBiasXAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known x coordinate of accelerometer bias.
-
getBiasXAsAcceleration
public void getBiasXAsAcceleration(com.irurueta.units.Acceleration result) Gets known x coordinate of accelerometer bias.- Specified by:
getBiasXAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasX
public void setBiasX(com.irurueta.units.Acceleration biasX) throws com.irurueta.navigation.LockedException Sets known x coordinate of accelerometer bias.- Specified by:
setBiasXin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasX- known x coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasYAsAcceleration
public com.irurueta.units.Acceleration getBiasYAsAcceleration()Gets known y coordinate of accelerometer bias.- Specified by:
getBiasYAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known y coordinate of accelerometer bias.
-
getBiasYAsAcceleration
public void getBiasYAsAcceleration(com.irurueta.units.Acceleration result) Gets known y coordinate of accelerometer bias.- Specified by:
getBiasYAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasY
public void setBiasY(com.irurueta.units.Acceleration biasY) throws com.irurueta.navigation.LockedException Sets known y coordinate of accelerometer bias.- Specified by:
setBiasYin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasY- known y coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasZAsAcceleration
public com.irurueta.units.Acceleration getBiasZAsAcceleration()Gets known z coordinate of accelerometer bias.- Specified by:
getBiasZAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known z coordinate of accelerometer bias.
-
getBiasZAsAcceleration
public void getBiasZAsAcceleration(com.irurueta.units.Acceleration result) Gets known z coordinate of accelerometer bias.- Specified by:
getBiasZAsAccelerationin interfaceKnownBiasAccelerometerCalibrator- Parameters:
result- instance where result data will be stored.
-
setBiasZ
public void setBiasZ(com.irurueta.units.Acceleration biasZ) throws com.irurueta.navigation.LockedException Sets known z coordinate of accelerometer bias.- Specified by:
setBiasZin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasZ- known z coordinate of accelerometer 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 accelerometer bias coordinates expressed in meters per squared second (m/s^2).- Specified by:
setBiasCoordinatesin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
setBiasCoordinates
public void setBiasCoordinates(com.irurueta.units.Acceleration biasX, com.irurueta.units.Acceleration biasY, com.irurueta.units.Acceleration biasZ) throws com.irurueta.navigation.LockedException Sets known accelerometer bias coordinates.- Specified by:
setBiasCoordinatesin interfaceKnownBiasAccelerometerCalibrator- Parameters:
biasX- known x coordinate of accelerometer bias.biasY- known y coordinate of accelerometer bias.biasZ- known z coordinate of accelerometer bias.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBiasAsTriad
Gets known accelerometer bias.- Specified by:
getBiasAsTriadin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known accelerometer bias.
-
getInitialSx
public double getInitialSx()Gets initial x scaling factor.- Specified by:
getInitialSxin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial x scaling factor.
-
setInitialSx
public void setInitialSx(double initialSx) throws com.irurueta.navigation.LockedException Sets initial x scaling factor.- Specified by:
setInitialSxin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialSy
public double getInitialSy()Gets initial y scaling factor.- Specified by:
getInitialSyin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial y scaling factor.
-
setInitialSy
public void setInitialSy(double initialSy) throws com.irurueta.navigation.LockedException Sets initial y scaling factor.- Specified by:
setInitialSyin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialSy- initial y scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialSz
public double getInitialSz()Gets initial z scaling factor.- Specified by:
getInitialSzin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial z scaling factor.
-
setInitialSz
public void setInitialSz(double initialSz) throws com.irurueta.navigation.LockedException Sets initial z scaling factor.- Specified by:
setInitialSzin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialSz- initial z scaling factor.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMxy
public double getInitialMxy()Gets initial x-y cross coupling error.- Specified by:
getInitialMxyin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial x-y cross coupling error.
-
setInitialMxy
public void setInitialMxy(double initialMxy) throws com.irurueta.navigation.LockedException Sets initial x-y cross coupling error.- Specified by:
setInitialMxyin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMxy- initial x-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMxz
public double getInitialMxz()Gets initial x-z cross coupling error.- Specified by:
getInitialMxzin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial x-z cross coupling error.
-
setInitialMxz
public void setInitialMxz(double initialMxz) throws com.irurueta.navigation.LockedException Sets initial x-z cross coupling error.- Specified by:
setInitialMxzin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMxz- initial x-z cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMyx
public double getInitialMyx()Gets initial y-x cross coupling error.- Specified by:
getInitialMyxin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial y-x cross coupling error.
-
setInitialMyx
public void setInitialMyx(double initialMyx) throws com.irurueta.navigation.LockedException Sets initial y-x cross coupling error.- Specified by:
setInitialMyxin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMyx- initial y-x cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMyz
public double getInitialMyz()Gets initial y-z cross coupling error.- Specified by:
getInitialMyzin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial y-z cross coupling error.
-
setInitialMyz
public void setInitialMyz(double initialMyz) throws com.irurueta.navigation.LockedException Sets initial y-z cross coupling error.- Specified by:
setInitialMyzin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMyz- initial y-z cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMzx
public double getInitialMzx()Gets initial z-x cross coupling error.- Specified by:
getInitialMzxin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial z-x cross coupling error.
-
setInitialMzx
public void setInitialMzx(double initialMzx) throws com.irurueta.navigation.LockedException Sets initial z-x cross coupling error.- Specified by:
setInitialMzxin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMzx- initial z-x cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getInitialMzy
public double getInitialMzy()Gets initial z-y cross coupling error.- Specified by:
getInitialMzyin interfaceAccelerometerNonLinearCalibrator- Returns:
- initial z-y cross coupling error.
-
setInitialMzy
public void setInitialMzy(double initialMzy) throws com.irurueta.navigation.LockedException Sets initial z-y cross coupling error.- Specified by:
setInitialMzyin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMzy- initial z-y cross coupling error.- 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.- Specified by:
setInitialScalingFactorsin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.- 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.- Specified by:
setInitialCrossCouplingErrorsin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.- 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.- Specified by:
setInitialScalingFactorsAndCrossCouplingErrorsin interfaceAccelerometerNonLinearCalibrator- Parameters:
initialSx- initial x scaling factor.initialSy- initial y scaling factor.initialSz- initial z scaling factor.initialMxy- initial x-y cross coupling error.initialMxz- initial x-z cross coupling error.initialMyx- initial y-x cross coupling error.initialMyz- initial y-z cross coupling error.initialMzx- initial z-x cross coupling error.initialMzy- initial z-y cross coupling error.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getBias
public double[] getBias()Gets known accelerometer bias as an array. Array values are expressed in meters per squared second (m/s^2).- Specified by:
getBiasin interfaceKnownBiasAccelerometerCalibrator- Returns:
- array containing coordinates of known bias.
-
getBias
public void getBias(double[] result) Gets known accelerometer bias as an array. Array values are expressed in meters per squared second (m/s^2).- Specified by:
getBiasin interfaceKnownBiasAccelerometerCalibrator- 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 accelerometer bias as an array. Array values are expressed in meters per squared second (m/s^2).- Specified by:
setBiasin interfaceKnownBiasAccelerometerCalibrator- Parameters:
bias- known accelerometer 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 accelerometer bias as a column matrix.- Specified by:
getBiasAsMatrixin interfaceKnownBiasAccelerometerCalibrator- Returns:
- known accelerometer bias as a column matrix.
-
getBiasAsMatrix
public void getBiasAsMatrix(com.irurueta.algebra.Matrix result) Gets known accelerometer bias as a column matrix.- Specified by:
getBiasAsMatrixin interfaceKnownBiasAccelerometerCalibrator- 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 accelerometer bias as a column matrix.- Specified by:
setBiasin interfaceKnownBiasAccelerometerCalibrator- Parameters:
bias- accelerometer bias to be set.- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently runningIllegalArgumentException- if provided matrix is not 3x1.
-
getInitialMa
public com.irurueta.algebra.Matrix getInitialMa()Gets initial scale factors and cross coupling errors matrix.- Specified by:
getInitialMain interfaceAccelerometerNonLinearCalibrator- Returns:
- initial scale factors and cross coupling errors matrix.
-
getInitialMa
public void getInitialMa(com.irurueta.algebra.Matrix result) Gets initial scale factors and cross coupling errors matrix.- Specified by:
getInitialMain interfaceAccelerometerNonLinearCalibrator- Parameters:
result- instance where data will be stored.- Throws:
IllegalArgumentException- if provided matrix is not 3x3.
-
setInitialMa
public void setInitialMa(com.irurueta.algebra.Matrix initialMa) throws com.irurueta.navigation.LockedException Sets initial scale factors and cross coupling errors matrix.- Specified by:
setInitialMain interfaceAccelerometerNonLinearCalibrator- Parameters:
initialMa- 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.
-
getMeasurements
Gets a collection of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements. If a single device IMU needs to be calibrated, typically all measurements are taken at the same position, with zero velocity and multiple orientations. However, if we just want to calibrate the a given IMU model (e.g. obtain an average and less precise calibration for the IMU of a given phone model), we could take measurements collected throughout the planet at multiple positions while the phone remains static (e.g. while charging), hence each measurement position will change, velocity will remain zero and orientation will be typically constant at horizontal orientation while the phone remains on a flat surface.- Specified by:
getMeasurementsin interfaceKnownBiasAndFrameAccelerometerCalibrator<StandardDeviationFrameBodyKinematics,KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener> - Specified by:
getMeasurementsin interfaceUnorderedStandardDeviationFrameBodyKinematicsAccelerometerCalibrator- Returns:
- a collection of body kinematics measurements taken at different frames (positions, orientations and velocities).
-
setMeasurements
public void setMeasurements(Collection<? extends StandardDeviationFrameBodyKinematics> measurements) throws com.irurueta.navigation.LockedException Sets a collection of body kinematics measurements taken at different frames (positions, orientations and velocities) and containing the standard deviations of accelerometer and gyroscope measurements. If a single device IMU needs to be calibrated, typically all measurements are taken at the same position, with zero velocity and multiple orientations. However, if we just want to calibrate the a given IMU model (e.g. obtain an average and less precise calibration for the IMU of a given phone model), we could take measurements collected throughout the planet at multiple positions while the phone remains static (e.g. while charging), hence each measurement position will change, velocity will remain zero and orientation will be typically constant at horizontal orientation while the phone remains on a flat surface.- Specified by:
setMeasurementsin interfaceKnownBiasAndFrameAccelerometerCalibrator<StandardDeviationFrameBodyKinematics,KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener> - Specified by:
setMeasurementsin interfaceUnorderedStandardDeviationFrameBodyKinematicsAccelerometerCalibrator- Parameters:
measurements- collection of body kinematics measurements taken at different frames (positions, orientations and velocities).- Throws:
com.irurueta.navigation.LockedException- if calibrator is currently running.
-
getMeasurementType
Indicates the type of measurement used by this calibrator.- Specified by:
getMeasurementTypein interfaceAccelerometerCalibrator- Returns:
- type of measurement used by this calibrator.
-
isOrderedMeasurementsRequired
public boolean isOrderedMeasurementsRequired()Indicates whether this calibrator requires ordered measurements in a list or not.- Specified by:
isOrderedMeasurementsRequiredin interfaceAccelerometerCalibrator- Returns:
- true if measurements must be ordered, false otherwise.
-
isQualityScoresRequired
public boolean isQualityScoresRequired()Indicates whether this calibrator requires quality scores for each measurement or not.- Specified by:
isQualityScoresRequiredin interfaceAccelerometerCalibrator- Returns:
- true if quality scores are required, false otherwise.
-
isCommonAxisUsed
public boolean isCommonAxisUsed()Indicates whether z-axis is assumed to be common for accelerometer and gyroscope. When enabled, this eliminates 3 variables from Ma matrix.- Specified by:
isCommonAxisUsedin interfaceAccelerometerCalibrator- Returns:
- true if z-axis is assumed to be common for accelerometer and gyroscope, false otherwise.
-
setCommonAxisUsed
public void setCommonAxisUsed(boolean commonAxisUsed) throws com.irurueta.navigation.LockedException Specifies whether z-axis is assumed to be common for accelerometer and gyroscope. When enabled, this eliminates 3 variables from Ma matrix.- Specified by:
setCommonAxisUsedin interfaceAccelerometerCalibrator- 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.
-
getListener
Gets listener to handle events raised by this estimator.- Specified by:
getListenerin interfaceKnownBiasAndFrameAccelerometerCalibrator<StandardDeviationFrameBodyKinematics,KnownBiasAndFrameAccelerometerNonLinearLeastSquaresCalibratorListener> - Returns:
- listener to handle events raised by this estimator.
-
getMinimumRequiredMeasurements
public int getMinimumRequiredMeasurements()Gets minimum number of required measurements.- Specified by:
getMinimumRequiredMeasurementsin interfaceAccelerometerCalibrator- Returns:
- minimum number of required measurements.
-
isReady
public boolean isReady()Indicates whether calibrator is ready to start.- Specified by:
isReadyin interfaceAccelerometerCalibrator- Returns:
- true if calibrator is ready, false otherwise.
-
isRunning
public boolean isRunning()Indicates whether calibrator is currently running or not.- Specified by:
isRunningin interfaceAccelerometerCalibrator- Returns:
- true if calibrator is running, false otherwise.
-
calibrate
public void calibrate() throws com.irurueta.navigation.LockedException, com.irurueta.navigation.NotReadyException, CalibrationExceptionEstimates accelerometer calibration parameters containing bias, scale factors and cross-coupling errors.- Specified by:
calibratein interfaceAccelerometerCalibrator- 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.
-
getEstimatedMa
public com.irurueta.algebra.Matrix getEstimatedMa()Gets estimated accelerometer scale factors and ross coupling errors. This is the product of matrix Ta containing cross coupling errors and Ka containing scaling factors. So tat:Ma = [sx mxy mxz] = Ta*Ka [myx sy myz] [mzx mzy sz ]Where:Ka = [sx 0 0 ] [0 sy 0 ] [0 0 sz]andTa = [1 -alphaXy alphaXz ] [alphaYx 1 -alphaYz] [-alphaZx alphaZy 1 ]Hence:Ma = [sx mxy mxz] = Ta*Ka = [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 accelerometer z-axis is assumed to be the same as the body z-axis. When this is assumed, myx = mzx = mzy = 0 and the Ma matrix becomes upper diagonal:Ma = [sx mxy mxz] [0 sy myz] [0 0 sz ]Values of this matrix are unit-less.- Specified by:
getEstimatedMain interfaceAccelerometerCalibrator- Returns:
- estimated accelerometer scale factors and cross coupling errors, or null if not available.
-
getEstimatedSx
Gets estimated x-axis scale factor.- Specified by:
getEstimatedSxin interfaceAccelerometerCalibrator- Returns:
- estimated x-axis scale factor or null if not available.
-
getEstimatedSy
Gets estimated y-axis scale factor.- Specified by:
getEstimatedSyin interfaceAccelerometerCalibrator- Returns:
- estimated y-axis scale factor or null if not available.
-
getEstimatedSz
Gets estimated z-axis scale factor.- Specified by:
getEstimatedSzin interfaceAccelerometerCalibrator- Returns:
- estimated z-axis scale factor or null if not available.
-
getEstimatedMxy
Gets estimated x-y cross-coupling error.- Specified by:
getEstimatedMxyin interfaceAccelerometerCalibrator- Returns:
- estimated x-y cross-coupling error or null if not available.
-
getEstimatedMxz
Gets estimated x-z cross-coupling error.- Specified by:
getEstimatedMxzin interfaceAccelerometerCalibrator- Returns:
- estimated x-z cross-coupling error or null if not available.
-
getEstimatedMyx
Gets estimated y-x cross-coupling error.- Specified by:
getEstimatedMyxin interfaceAccelerometerCalibrator- Returns:
- estimated y-x cross-coupling error or null if not available.
-
getEstimatedMyz
Gets estimated y-z cross-coupling error.- Specified by:
getEstimatedMyzin interfaceAccelerometerCalibrator- Returns:
- estimated y-z cross-coupling error or null if not available.
-
getEstimatedMzx
Gets estimated z-x cross-coupling error.- Specified by:
getEstimatedMzxin interfaceAccelerometerCalibrator- Returns:
- estimated z-x cross-coupling error or null if not available.
-
getEstimatedMzy
Gets estimated z-y cross-coupling error.- Specified by:
getEstimatedMzyin interfaceAccelerometerCalibrator- Returns:
- estimated z-y cross-coupling error or null if not available.
-
getEstimatedCovariance
public com.irurueta.algebra.Matrix getEstimatedCovariance()Gets estimated covariance matrix for estimated calibration parameters. Diagonal elements of the matrix contains variance for the following parameters (following indicated order): sx, sy, sz, mxy, mxz, myx, myz, mzx, mzy.- Specified by:
getEstimatedCovariancein interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated covariance matrix for estimated calibration parameters.
-
getEstimatedChiSq
public double getEstimatedChiSq()Gets estimated chi square value.- Specified by:
getEstimatedChiSqin interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated chi square value.
-
getEstimatedChiSqDegreesOfFreedom
public int getEstimatedChiSqDegreesOfFreedom()Gets estimated chi square degrees of freedom. Degrees of freedom is equal to the number of sampled data minus the number of estimated parameters.- Specified by:
getEstimatedChiSqDegreesOfFreedomin interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated degrees of freedom of chi square value
-
getEstimatedReducedChiSq
public double getEstimatedReducedChiSq()Gets estimated reduced chi square value. This is equal to estimated chi square value divided by its degrees of freedom. Ideally this value should be close to 1.0, indicating that fit is optimal. A value larger than 1.0 indicates that fit is not good or noise has been underestimated, and a value smaller than 1.0 indicates that there is overfitting or noise has been overestimated.- Specified by:
getEstimatedReducedChiSqin interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated reduced chi square value
-
getEstimatedMse
public double getEstimatedMse()Gets estimated mean square error respect to provided measurements.- Specified by:
getEstimatedMsein interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated mean square error respect to provided measurements.
-
getEstimatedP
public double getEstimatedP()Gets estimated probability of finding a smaller chi square value expressed as a value between 0.0 and 1.0. The smaller the found chi square value is, the better the fit of the estimated parameters to the actual parameter. Thus, the smaller the chance of finding a smaller chi square value, then the better the estimated fit is.- Specified by:
getEstimatedPin interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated probability of finding a smaller chi square value.
-
getEstimatedQ
public double getEstimatedQ()Gets estimated measure of quality of estimated fit as a value between 0.0 and 1.0. The larger the quality value is, the better the fit that has been estimated.- Specified by:
getEstimatedQin interfaceAccelerometerNonLinearCalibrator- Returns:
- estimated measure of quality of estimated fit.
-
calibrateCommonAxis
private void calibrateCommonAxis() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyExceptionInternal method to perform calibration when common z-axis is assumed for both the accelerometer and gyroscope.- 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.
-
calibrateGeneral
private void calibrateGeneral() throws com.irurueta.algebra.AlgebraException, com.irurueta.numerical.fitting.FittingException, com.irurueta.numerical.NotReadyExceptionInternal method to perform general calibration.- 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.
-
setInputData
private void setInputData() throws com.irurueta.algebra.WrongSizeExceptionSets input data into Levenberg-Marquardt fitter.- Throws:
com.irurueta.algebra.WrongSizeException- never happens.
-
convertAcceleration
private static double convertAcceleration(double value, com.irurueta.units.AccelerationUnit unit) Converts acceleration value and unit to meters per squared second.- Parameters:
value- acceleration value.unit- unit of acceleration value.- Returns:
- converted value.
-
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.
-