Package com.irurueta.navigation.indoor

Class RangingAndRssiReadingLocated<S extends RadioSource,P extends com.irurueta.geometry.Point<?>>

java.lang.Object

com.irurueta.navigation.indoor.Reading<S>

com.irurueta.navigation.indoor.RangingAndRssiReading<S>

com.irurueta.navigation.indoor.RangingAndRssiReadingLocated<S,P>

Type Parameters:

S - a RadioSource type.

P - a Point type.

All Implemented Interfaces:

ReadingLocated<P>, Serializable

Direct Known Subclasses:

RangingAndRssiReadingLocated2D, RangingAndRssiReadingLocated3D

public class RangingAndRssiReadingLocated<S extends RadioSource,P extends com.irurueta.geometry.Point<?>>
extends RangingAndRssiReading<S>
implements ReadingLocated<P>

Contains a located reading associated to a given radio source (e.g. Wi-Fi access point or bluetooth beacon) containing signal strength and distance to associated radio source.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private P	position	Position where Wi-Fi reading was made.
private com.irurueta.algebra.Matrix	positionCovariance	Covariance of inhomogeneous coordinates of current position (if available).

Fields inherited from class com.irurueta.navigation.indoor.RangingAndRssiReading

DEFAULT_NUM_MEASUREMENTS

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RangingAndRssiReadingLocated()	Empty constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, com.irurueta.algebra.Matrix positionCovariance)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, com.irurueta.algebra.Matrix positionCovariance, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, Double distanceStandardDeviation, Double rssiStandardDeviation)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, Double distanceStandardDeviation, Double rssiStandardDeviation, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, Double distanceStandardDeviation, Double rssiStandardDeviation, com.irurueta.algebra.Matrix positionCovariance)	Constructor.
	RangingAndRssiReadingLocated(S source, double distance, double rssi, P position, Double distanceStandardDeviation, Double rssiStandardDeviation, com.irurueta.algebra.Matrix positionCovariance, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.

Method Summary

Modifier and Type	Method	Description
P	getPosition()	Gets position where reading was made.
com.irurueta.algebra.Matrix	getPositionCovariance()	Gets covariance of inhomogeneous coordinates of current position (if available).

Methods inherited from class com.irurueta.navigation.indoor.RangingAndRssiReading

getDistance, getDistanceStandardDeviation, getNumAttemptedMeasurements, getNumSuccessfulMeasurements, getRssi, getRssiStandardDeviation, getType

Methods inherited from class com.irurueta.navigation.indoor.Reading

getSource, hasSameSource

Methods inherited from class java.lang.Object

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

Field Details

position

private P extends com.irurueta.geometry.Point<?> position

Position where Wi-Fi reading was made.

positionCovariance

private com.irurueta.algebra.Matrix positionCovariance

Covariance of inhomogeneous coordinates of current position (if available).

Constructor Details

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative or position is null.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 int numAttemptedMeasurements,
 int numSuccessfulMeasurements)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

numAttemptedMeasurements - number of attempted measurements used in the RTT exchange.

numSuccessfulMeasurements - number of successful measurements used to calculate the distance and standard deviation.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 Double distanceStandardDeviation,
 Double rssiStandardDeviation)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

distanceStandardDeviation - standard deviation of distance, if available.

rssiStandardDeviation - standard deviation of RSSI, if available.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null or any of the standard deviations is zero or negative.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 Double distanceStandardDeviation,
 Double rssiStandardDeviation,
 int numAttemptedMeasurements,
 int numSuccessfulMeasurements)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

distanceStandardDeviation - standard deviation of distance, if available.

rssiStandardDeviation - standard deviation of RSSI, if available.

numAttemptedMeasurements - number of attempted measurements used in the RTT exchange.

numSuccessfulMeasurements - number of successful measurements used to calculate the distance and standard deviation.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null, any of the standard deviations is zero or negative, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 com.irurueta.algebra.Matrix positionCovariance)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

positionCovariance - covariance of inhomogeneous coordinates of current position (if available).

Throws:

IllegalArgumentException - if radio source data is null, distance is negative position is null or position covariance has wrong size.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 com.irurueta.algebra.Matrix positionCovariance,
 int numAttemptedMeasurements,
 int numSuccessfulMeasurements)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

positionCovariance - covariance of inhomogeneous coordinates of current position (if available).

numAttemptedMeasurements - number of attempted measurements used in the RTT exchange.

numSuccessfulMeasurements - number of successful measurements used to calculate the distance and standard deviation.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null, position covariance has wrong size, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 Double distanceStandardDeviation,
 Double rssiStandardDeviation,
 com.irurueta.algebra.Matrix positionCovariance)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

distanceStandardDeviation - standard deviation of distance, if available.

rssiStandardDeviation - standard deviation of RSSI value.

positionCovariance - covariance of inhomogeneous coordinates of current position (if available).

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null or standard deviation is zero or negative.

RangingAndRssiReadingLocated

public RangingAndRssiReadingLocated(S source,
 double distance,
 double rssi,
 P position,
 Double distanceStandardDeviation,
 Double rssiStandardDeviation,
 com.irurueta.algebra.Matrix positionCovariance,
 int numAttemptedMeasurements,
 int numSuccessfulMeasurements)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

position - position where reading was made.

distanceStandardDeviation - standard deviation of distance, if available.

rssiStandardDeviation - standard deviation of RSSI value.

positionCovariance - covariance of inhomogeneous coordinates of current position (if available).

numAttemptedMeasurements - number of attempted measurements used in the RTT exchange.

numSuccessfulMeasurements - number of successful measurements used to calculate the distance and standard deviation.

Throws:

IllegalArgumentException - if radio source data is null, distance is negative, position is null, any of the standard deviations is zero or negative, position covariance has wrong size, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReadingLocated

protected RangingAndRssiReadingLocated()

Empty constructor.

Method Details

getPosition

public P getPosition()

Gets position where reading was made.

Specified by:

getPosition in interface ReadingLocated<S extends RadioSource>

Returns:

position where reading was made.

getPositionCovariance

public com.irurueta.algebra.Matrix getPositionCovariance()

Gets covariance of inhomogeneous coordinates of current position (if available).

Specified by:

getPositionCovariance in interface ReadingLocated<S extends RadioSource>

Returns:

covariance of position or null.