Package com.irurueta.navigation.indoor.fingerprint

Class LinearFingerprintPositionEstimator2D

java.lang.Object

com.irurueta.navigation.indoor.fingerprint.BaseFingerprintPositionEstimator<com.irurueta.geometry.Point2D,FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D>>

com.irurueta.navigation.indoor.fingerprint.FingerprintPositionEstimator<com.irurueta.geometry.Point2D>

com.irurueta.navigation.indoor.fingerprint.LinearFingerprintPositionEstimator<com.irurueta.geometry.Point2D>

com.irurueta.navigation.indoor.fingerprint.LinearFingerprintPositionEstimator2D

public class LinearFingerprintPositionEstimator2D
extends LinearFingerprintPositionEstimator<com.irurueta.geometry.Point2D>

2D position estimator based on located fingerprints containing only RSSI readings and having as well prior knowledge of the location of radio sources associated to those readings. This implementation uses a first-order Taylor approximation over provided located fingerprints to determine an approximate position for a non-located fingerprint.

Field Summary

Fields inherited from class com.irurueta.navigation.indoor.fingerprint.FingerprintPositionEstimator

removeMeansFromFingerprintReadings, sources, useNoMeanNearestFingerprintFinder, useSourcesPathLossExponentWhenAvailable

Fields inherited from class com.irurueta.navigation.indoor.fingerprint.BaseFingerprintPositionEstimator

DEFAULT_MAX_NEAREST_FINGERPRINTS, DEFAULT_MIN_NEAREST_FINGERPRINTS, DEFAULT_PATH_LOSS_EXPONENT, estimatedPositionCoordinates, fingerprint, listener, locatedFingerprints, locked, maxNearestFingerprints, minNearestFingerprints, nearestFingerprints, pathLossExponent

Constructor Summary

Constructors

Constructor	Description
LinearFingerprintPositionEstimator2D()	Constructor.
LinearFingerprintPositionEstimator2D(FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D> listener)	Constructor.
LinearFingerprintPositionEstimator2D(List<? extends RssiFingerprintLocated<? extends RadioSource,? extends RssiReading<? extends RadioSource>,com.irurueta.geometry.Point2D>> locatedFingerprints, RssiFingerprint<? extends RadioSource,? extends RssiReading<? extends RadioSource>> fingerprint, List<? extends RadioSourceLocated<com.irurueta.geometry.Point2D>> sources)	Constructor.
LinearFingerprintPositionEstimator2D(List<? extends RssiFingerprintLocated<? extends RadioSource,? extends RssiReading<? extends RadioSource>,com.irurueta.geometry.Point2D>> locatedFingerprints, RssiFingerprint<? extends RadioSource,? extends RssiReading<? extends RadioSource>> fingerprint, List<? extends RadioSourceLocated<com.irurueta.geometry.Point2D>> sources, FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D> listener)	Constructor.

Method Summary

Modifier and Type	Method	Description
com.irurueta.geometry.Point2D	getEstimatedPosition()	Gets estimated position or null if not available yet.
int	getNumberOfDimensions()	Gets number of dimensions of points.

Methods inherited from class com.irurueta.navigation.indoor.fingerprint.LinearFingerprintPositionEstimator

estimate

Methods inherited from class com.irurueta.navigation.indoor.fingerprint.FingerprintPositionEstimator

getSources, getUseNoMeanNearestFingerprintFinder, getUseSourcesPathLossExponentWhenAvailable, isMeansFromFingerprintReadingsRemoved, isReady, setMeansFromFingerprintReadingsRemoved, setSources, setUseNoMeanNearestFingerprintFinder, setUseSourcesPathLossExponentWhenAvailable

Methods inherited from class com.irurueta.navigation.indoor.fingerprint.BaseFingerprintPositionEstimator

getEstimatedPosition, getEstimatedPositionCoordinates, getFingerprint, getListener, getLocatedFingerprints, getMaxNearestFingerprints, getMinNearestFingerprints, getNearestFingerprints, getPathLossExponent, isLocked, setFingerprint, setListener, setLocatedFingerprints, setMinMaxNearestFingerprints, setPathLossExponent, totalReadings

Methods inherited from class java.lang.Object

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

Constructor Details

LinearFingerprintPositionEstimator2D

public LinearFingerprintPositionEstimator2D()

Constructor.

LinearFingerprintPositionEstimator2D

public LinearFingerprintPositionEstimator2D(FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D> listener)

Constructor.

Parameters:

listener - listener in charge of handling events.

LinearFingerprintPositionEstimator2D

public LinearFingerprintPositionEstimator2D(List<? extends RssiFingerprintLocated<? extends RadioSource,? extends RssiReading<? extends RadioSource>,com.irurueta.geometry.Point2D>> locatedFingerprints,
 RssiFingerprint<? extends RadioSource,? extends RssiReading<? extends RadioSource>> fingerprint,
 List<? extends RadioSourceLocated<com.irurueta.geometry.Point2D>> sources)

Constructor.

Parameters:

locatedFingerprints - located fingerprints containing RSSI readings.

fingerprint - fingerprint containing readings at an unknown location for provided located fingerprints.

sources - located radio sources.

Throws:

IllegalArgumentException - if provided non located fingerprint is null, located fingerprints value is null or there are not enough fingerprints or readings within provided fingerprints (for 2D position estimation at least 2 located total readings are required among all fingerprints, for example 2 readings are required in a single fingerprint, or at least 2 fingerprints at different locations containing a single reading are required).

LinearFingerprintPositionEstimator2D

public LinearFingerprintPositionEstimator2D(List<? extends RssiFingerprintLocated<? extends RadioSource,? extends RssiReading<? extends RadioSource>,com.irurueta.geometry.Point2D>> locatedFingerprints,
 RssiFingerprint<? extends RadioSource,? extends RssiReading<? extends RadioSource>> fingerprint,
 List<? extends RadioSourceLocated<com.irurueta.geometry.Point2D>> sources,
 FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D> listener)

Constructor.

Parameters:

locatedFingerprints - located fingerprints containing RSSI readings.

fingerprint - fingerprint containing readings at an unknown location for provided located fingerprints.

sources - located radio sources.

listener - listener in charge of handling events.

Throws:

IllegalArgumentException - if provided non located fingerprint is null, located fingerprints value is null or there are not enough fingerprints or readings within provided fingerprints (for 2D position estimation at least 2 located total readings are required among all fingerprints, for example 2 readings are required in a single fingerprint, or at least 2 fingerprints at different locations containing a single reading are required).

Method Details

getNumberOfDimensions

public int getNumberOfDimensions()

Gets number of dimensions of points.

Specified by:

getNumberOfDimensions in class BaseFingerprintPositionEstimator<com.irurueta.geometry.Point2D,FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D>>

Returns:

number of dimensions of points.

getEstimatedPosition

public com.irurueta.geometry.Point2D getEstimatedPosition()

Gets estimated position or null if not available yet.

Specified by:

getEstimatedPosition in class BaseFingerprintPositionEstimator<com.irurueta.geometry.Point2D,FingerprintPositionEstimatorListener<com.irurueta.geometry.Point2D>>

Returns:

estimated position or null.