Package com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor

Class ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

java.lang.Object

com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.IntervalDetectorThresholdFactorOptimizer<com.irurueta.navigation.inertial.BodyKinematics,AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource>

com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.AccelerometerIntervalDetectorThresholdFactorOptimizer

com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

All Implemented Interfaces:

com.irurueta.navigation.inertial.calibration.AccelerometerBiasUncertaintySource, com.irurueta.navigation.inertial.calibration.AccelerometerCalibrationSource, com.irurueta.navigation.inertial.calibration.AccelerometerNoiseRootPsdSource

public class ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer
extends AccelerometerIntervalDetectorThresholdFactorOptimizer

Optimizes the threshold factor for interval detection of accelerometer data based on results of calibration. Only accelerometer calibrators based on unknown orientation are supported (in other terms, calibrators must be AccelerometerNonLinearCalibrator and must support AccelerometerCalibratorMeasurementType.STANDARD_DEVIATION_BODY_KINEMATICS). This implementation makes an exhaustive search between minimum and maximum threshold factor values to find the threshold value that produces the minimum Mean Square Error (MSE) for calibration parameters.

Field Summary

Fields

Modifier and Type	Field	Description
static final double	DEFAULT_STEP	Default step value to make exhaustive search of threshold factor values.
private double	thresholdFactorStep	Step to make exhaustive search of threshold factor values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().

Fields inherited from class com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.AccelerometerIntervalDetectorThresholdFactorOptimizer

DEFAULT_MAX_THRESHOLD_FACTOR, DEFAULT_MIN_THRESHOLD_FACTOR, maxThresholdFactor, minThresholdFactor

Fields inherited from class com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.IntervalDetectorThresholdFactorOptimizer

dataSource, DEFAULT_PROGRESS_DELTA, listener, MAX_PROGRESS_DELTA, MIN_PROGRESS_DELTA, minMse, optimalThresholdFactor, previousProgress, progress, progressDelta, running

Constructor Summary

Constructors

Constructor	Description
ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer()	Constructor.
ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(com.irurueta.navigation.inertial.calibration.accelerometer.AccelerometerNonLinearCalibrator calibrator)	Constructor.
ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource dataSource)	Constructor.
ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource dataSource, com.irurueta.navigation.inertial.calibration.accelerometer.AccelerometerNonLinearCalibrator calibrator)	Constructor.

Method Summary

Modifier and Type	Method	Description
double	getThresholdFactorStep()	Gets the step to make exhaustive search of threshold values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().
double	optimize()	Optimizes the threshold factor for a static interval detector or measurement generator to minimize MSE (Minimum Squared Error) of estimated calibration parameters.
void	setThresholdFactorStep(double thresholdStep)	Sets step to make exhaustive search of threshold values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().

Methods inherited from class com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.AccelerometerIntervalDetectorThresholdFactorOptimizer

evaluateForThresholdFactor, getAccelerometerBaseNoiseLevel, getAccelerometerBaseNoiseLevelAsMeasurement, getAccelerometerBaseNoiseLevelAsMeasurement, getAccelerometerBaseNoiseLevelPsd, getAccelerometerBaseNoiseLevelRootPsd, getBaseNoiseLevelAbsoluteThreshold, getBaseNoiseLevelAbsoluteThresholdAsMeasurement, getBaseNoiseLevelAbsoluteThresholdAsMeasurement, getCalibrator, getEstimatedBiases, getEstimatedBiasFxVariance, getEstimatedBiasFyVariance, getEstimatedBiasFzVariance, getEstimatedBiasStandardDeviationNorm, getEstimatedMa, getInitialStaticSamples, getInstantaneousNoiseLevelFactor, getMaxDynamicSamples, getMaxThresholdFactor, getMinStaticSamples, getMinThresholdFactor, getQualityScoreMapper, getThreshold, getThresholdAsMeasurement, getThresholdAsMeasurement, getTimeInterval, getTimeIntervalAsTime, getTimeIntervalAsTime, getWindowSize, isReady, setBaseNoiseLevelAbsoluteThreshold, setBaseNoiseLevelAbsoluteThreshold, setCalibrator, setInitialStaticSamples, setInstantaneousNoiseLevelFactor, setMaxDynamicSamples, setMinStaticSamples, setQualityScoreMapper, setThresholdFactorRange, setTimeInterval, setTimeInterval, setWindowSize

Methods inherited from class com.irurueta.navigation.inertial.calibration.intervals.thresholdfactor.IntervalDetectorThresholdFactorOptimizer

checkAndNotifyProgress, getDataSource, getListener, getMinMse, getOptimalThresholdFactor, getProgressDelta, initProgress, isRunning, setDataSource, setListener, setProgressDelta

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_STEP

public static final double DEFAULT_STEP

Default step value to make exhaustive search of threshold factor values.

See Also:

• Constant Field Values

thresholdFactorStep

private double thresholdFactorStep

Step to make exhaustive search of threshold factor values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().

Constructor Details

ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

public ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer()

Constructor.

ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

public ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource dataSource)

Constructor.

Parameters:

dataSource - instance in charge of retrieving data for this optimizer.

ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

public ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(com.irurueta.navigation.inertial.calibration.accelerometer.AccelerometerNonLinearCalibrator calibrator)

Constructor.

Parameters:

calibrator - an accelerometer calibrator to be used to optimize its Mean Square Error (MSE).

Throws:

IllegalArgumentException - if accelerometer calibrator does not use StandardDeviationBodyKinematics measurements.

ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer

public ExhaustiveAccelerometerIntervalDetectorThresholdFactorOptimizer(AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource dataSource,
 com.irurueta.navigation.inertial.calibration.accelerometer.AccelerometerNonLinearCalibrator calibrator)

Constructor.

Parameters:

dataSource - instance in charge of retrieving data for this optimizer.

calibrator - an accelerometer calibrator to be used to optimize its Mean Square Error (MSE).

Throws:

IllegalArgumentException - if accelerometer calibrator does not use StandardDeviationBodyKinematics measurements.

Method Details

getThresholdFactorStep

public double getThresholdFactorStep()

Gets the step to make exhaustive search of threshold values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().

Returns:

step to make exhaustive search of threshold values.

setThresholdFactorStep

public void setThresholdFactorStep(double thresholdStep)
                            throws com.irurueta.navigation.LockedException

Sets step to make exhaustive search of threshold values between AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor() and AccelerometerIntervalDetectorThresholdFactorOptimizer.getMaxThresholdFactor().

Parameters:

thresholdStep - step to make exhaustive search of threshold values.

Throws:

com.irurueta.navigation.LockedException - if optimizer is already running.

IllegalArgumentException - if provided value is zero or negative.

optimize

public double optimize()
                throws com.irurueta.navigation.NotReadyException,
com.irurueta.navigation.LockedException,
IntervalDetectorThresholdFactorOptimizerException

Optimizes the threshold factor for a static interval detector or measurement generator to minimize MSE (Minimum Squared Error) of estimated calibration parameters.

Specified by:

optimize in class IntervalDetectorThresholdFactorOptimizer<com.irurueta.navigation.inertial.BodyKinematics,AccelerometerIntervalDetectorThresholdFactorOptimizerDataSource>

Returns:

optimized threshold factor.

Throws:

com.irurueta.navigation.NotReadyException - if this optimizer is not ready to start optimization.

com.irurueta.navigation.LockedException - if optimizer is already running.

IntervalDetectorThresholdFactorOptimizerException - if optimization fails for some reason.