Package com.irurueta.navigation.indoor

Class RangingAndRssiReading<S extends RadioSource>

java.lang.Object

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

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

Type Parameters:

S - a RadioSource type.

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

RangingAndRssiReadingLocated

public class RangingAndRssiReading<S extends RadioSource>
extends Reading<S>

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

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_NUM_MEASUREMENTS	Default number of measurements.
private double	distance	Distance in meters to the radio source.
private Double	distanceStandardDeviation	Standard deviation of distance, if available.
private int	numAttemptedMeasurements	Number of attempted measurements using in the RTT exchange.
private int	numSuccessfulMeasurements	Number of successful measurements used to calculate the distance and standard deviation.
private double	rssi	Received signal strength indicator (of this 802.11 network for a Wi-Fi access point or of this bluetooth beacon), in dBm.
private Double	rssiStandardDeviation	Standard deviation of RSSI, if available.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RangingAndRssiReading()	Empty constructor.
	RangingAndRssiReading(S source, double distance, double rssi)	Constructor.
	RangingAndRssiReading(S source, double distance, double rssi, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.
	RangingAndRssiReading(S source, double distance, double rssi, Double distanceStandardDeviation, Double rssiStandardDeviation)	Constructor.
	RangingAndRssiReading(S source, double distance, double rssi, Double distanceStandardDeviation, Double rssiStandardDeviation, int numAttemptedMeasurements, int numSuccessfulMeasurements)	Constructor.

Method Summary

Modifier and Type	Method	Description
double	getDistance()	Gets distance in meters to the radio source.
Double	getDistanceStandardDeviation()	Gets standard deviation of distance, if available.
int	getNumAttemptedMeasurements()	Gets number of attempted measurements used in the RTT exchange.
int	getNumSuccessfulMeasurements()	Gets number of successful measurements used to calculate the distance and standard deviation.
double	getRssi()	Gets received signal strength indicator of (of this 802.11 network for a Wi-Fi access point or of this bluetooth beacon), in dBm.
Double	getRssiStandardDeviation()	Gets standard deviation of RSSI, if available.
ReadingType	getType()	Contains radio source reading type.

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

DEFAULT_NUM_MEASUREMENTS

public static final int DEFAULT_NUM_MEASUREMENTS

Default number of measurements.

See Also:

• Constant Field Values

distance

private double distance

Distance in meters to the radio source.

distanceStandardDeviation

private Double distanceStandardDeviation

Standard deviation of distance, if available.

numAttemptedMeasurements

private int numAttemptedMeasurements

Number of attempted measurements using in the RTT exchange.

numSuccessfulMeasurements

private int numSuccessfulMeasurements

Number of successful measurements used to calculate the distance and standard deviation.

rssi

private double rssi

Received signal strength indicator (of this 802.11 network for a Wi-Fi access point or of this bluetooth beacon), in dBm.

rssiStandardDeviation

private Double rssiStandardDeviation

Standard deviation of RSSI, if available.

Constructor Details

RangingAndRssiReading

public RangingAndRssiReading(S source,
 double distance,
 double rssi)

Constructor.

Parameters:

source - radio source associated to this reading.

distance - distance in meters to the radio source.

rssi - received signal strength indicator in dBm.

Throws:

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

RangingAndRssiReading

public RangingAndRssiReading(S source,
 double distance,
 double rssi,
 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.

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, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReading

public RangingAndRssiReading(S source,
 double distance,
 double rssi,
 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.

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 or any of the standard deviations is zero or negative.

RangingAndRssiReading

public RangingAndRssiReading(S source,
 double distance,
 double rssi,
 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.

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, any of the standard deviations is zero or negative, number of attempted measures is less than 1 or number of successful measures is negative.

RangingAndRssiReading

protected RangingAndRssiReading()

Empty constructor.

Method Details

getType

public ReadingType getType()

Contains radio source reading type.

Specified by:

getType in class Reading<S extends RadioSource>

Returns:

reading type.

getDistance

public double getDistance()

Gets distance in meters to the radio source.

Returns:

distance in meters to the radio source.

getDistanceStandardDeviation

public Double getDistanceStandardDeviation()

Gets standard deviation of distance, if available.

Returns:

standard deviation of distance or null.

getNumAttemptedMeasurements

public int getNumAttemptedMeasurements()

Gets number of attempted measurements used in the RTT exchange.

Returns:

number of attempted measurements used in the RTT exchange.

getNumSuccessfulMeasurements

public int getNumSuccessfulMeasurements()

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

Returns:

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

getRssi

public double getRssi()

Gets received signal strength indicator of (of this 802.11 network for a Wi-Fi access point or of this bluetooth beacon), in dBm.

Returns:

received signal strength indicator.

getRssiStandardDeviation

public Double getRssiStandardDeviation()

Gets standard deviation of RSSI, if available.

Returns:

standard deviation of RSSI, if available.