Package com.irurueta.navigation.indoor

Class WifiAccessPointWithPower

java.lang.Object

com.irurueta.navigation.indoor.WifiAccessPoint

com.irurueta.navigation.indoor.WifiAccessPointWithPower

All Implemented Interfaces:

RadioSource, RadioSourceWithPower, Serializable

Direct Known Subclasses:

WifiAccessPointWithPowerAndLocated

public class WifiAccessPointWithPower
extends WifiAccessPoint
implements RadioSourceWithPower

Data related to a Wi-Fi access point with estimated transmitted power.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final double	DEFAULT_PATH_LOSS_EXPONENT	Default exponent typically used on free space for path loss propagation in terms of distance.
private double	pathLossExponent	Exponent typically used on free space for path loss propagation in terms of distance.
private Double	pathLossExponentStandardDeviation	Standard deviation of path loss exponent or null if unknown.
private double	transmittedPower	Transmitted power expressed in dBm's.
private Double	transmittedPowerStandardDeviation	Standard deviation of transmitted power value or null if unknown.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	WifiAccessPointWithPower()	Empty constructor.
	WifiAccessPointWithPower(String bssid, double frequency, double transmittedPower)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, double transmittedPower, double pathLossExponent)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, double transmittedPower, Double transmittedPowerStandardDeviation)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, double transmittedPower, Double transmittedPowerStandardDeviation, double pathLossExponent)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, double transmittedPower, Double transmittedPowerStandardDeviation, double pathLossExponent, Double pathLossExponentStandardDeviation)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, String ssid, double transmittedPower)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, String ssid, double transmittedPower, Double transmittedPowerStandardDeviation)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, String ssid, double transmittedPower, Double transmittedPowerStandardDeviation, double pathLossExponent)	Constructor.
	WifiAccessPointWithPower(String bssid, double frequency, String ssid, double transmittedPower, Double transmittedPowerStandardDeviation, double pathLossExponent, Double pathLossExponentStandardDeviation)	Constructor.

Method Summary

Modifier and Type	Method	Description
double	getPathLossExponent()	Gets exponent typically used on free space for path loss propagation in terms of distance.
Double	getPathLossExponentStandardDeviation()	Gets standard deviation of path loss exponent or null if unknown.
double	getTransmittedPower()	Gets transmitted power expressed in dBm's.
Double	getTransmittedPowerStandardDeviation()	Gets standard deviation of transmitted power value or null if unknown.

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

equals, getBssid, getFrequency, getSsid, getType, hashCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.irurueta.navigation.indoor.RadioSource

equals, getFrequency, getType

Field Details

DEFAULT_PATH_LOSS_EXPONENT

public static final double DEFAULT_PATH_LOSS_EXPONENT

Default exponent typically used on free space for path loss propagation in terms of distance. This value is used for free space environments.

See Also:

• Constant Field Values

transmittedPower

private double transmittedPower

Transmitted power expressed in dBm's.

transmittedPowerStandardDeviation

private Double transmittedPowerStandardDeviation

Standard deviation of transmitted power value or null if unknown.

pathLossExponent

private double pathLossExponent

Exponent typically used on free space for path loss propagation in terms of distance. On different environments path loss exponent might have different values: - Free space: 2.0 - Urban Area: 2.7 to 3.5 - Suburban Area: 3 to 5 - Indoor (line-of-sight): 1.6 to 1.8 If path loss exponent estimation is not enabled, this value will always be equal to DEFAULT_PATH_LOSS_EXPONENT

pathLossExponentStandardDeviation

private Double pathLossExponentStandardDeviation

Standard deviation of path loss exponent or null if unknown.

Constructor Details

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 double transmittedPower)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

transmittedPower - transmitted power by this access point (expressed in dBm's).

Throws:

IllegalArgumentException - if BSSID is null or frequency is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 String ssid,
 double transmittedPower)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

ssid - service set identifier (SSID) of this 802.11 network.

transmittedPower - transmitted power by this access point (expressed in dBM's).

Throws:

IllegalArgumentException - if BSSID is null or frequency is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 double transmittedPower,
 Double transmittedPowerStandardDeviation)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

transmittedPower - transmitted power by this access point (expressed in dBm's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative or transmitted power standard deviation is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 String ssid,
 double transmittedPower,
 Double transmittedPowerStandardDeviation)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

ssid - service set identifier (SSID) of this 802.11 network.

transmittedPower - transmitted power by this access point (expressed in dBM's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative, or transmitted power standard deviation is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 double transmittedPower,
 double pathLossExponent)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

transmittedPower - transmitted power by this access point (expressed in dBm's).

pathLossExponent - path loss exponent. By default, this is 2.0.

Throws:

IllegalArgumentException - if BSSID is null or frequency is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 double transmittedPower,
 Double transmittedPowerStandardDeviation,
 double pathLossExponent)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

transmittedPower - transmitted power by this access point (expressed in dBm's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

pathLossExponent - path loss exponent. By default, this is 2.0.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative or transmitted power standard deviation is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 String ssid,
 double transmittedPower,
 Double transmittedPowerStandardDeviation,
 double pathLossExponent)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

ssid - service set identifier (SSID) of this 802.11 network.

transmittedPower - transmitted power by this access point (expressed in dBM's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

pathLossExponent - path loss exponent. By default, this is 2.0.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative, or transmitted power standard deviation is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 double transmittedPower,
 Double transmittedPowerStandardDeviation,
 double pathLossExponent,
 Double pathLossExponentStandardDeviation)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

transmittedPower - transmitted power by this access point (expressed in dBm's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

pathLossExponent - path loss exponent. By default, this is 2.0.

pathLossExponentStandardDeviation - standard deviation of path loss exponent or null if unknown.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative or any standard deviation is negative.

WifiAccessPointWithPower

public WifiAccessPointWithPower(String bssid,
 double frequency,
 String ssid,
 double transmittedPower,
 Double transmittedPowerStandardDeviation,
 double pathLossExponent,
 Double pathLossExponentStandardDeviation)

Constructor.

Parameters:

bssid - basic service set identifier of this access point in the form of a six-byte MAC address: xx:xx:xx:xx:xx:xx.

frequency - frequency used by this Access Point (expressed in Hz).

ssid - service set identifier (SSID) of this 802.11 network.

transmittedPower - transmitted power by this access point (expressed in dBM's).

transmittedPowerStandardDeviation - standard deviation of transmitted power value or null if unknown.

pathLossExponent - path loss exponent. By default, this is 2.0.

pathLossExponentStandardDeviation - standard deviation of path loss exponent or null if unknown.

Throws:

IllegalArgumentException - if either BSSID is null, frequency is negative, or transmitted power standard deviation is negative.

WifiAccessPointWithPower

protected WifiAccessPointWithPower()

Empty constructor.

Method Details

getTransmittedPower

public double getTransmittedPower()

Gets transmitted power expressed in dBm's.

Specified by:

getTransmittedPower in interface RadioSourceWithPower

Returns:

transmitted power expressed in dBm's.

getTransmittedPowerStandardDeviation

public Double getTransmittedPowerStandardDeviation()

Gets standard deviation of transmitted power value or null if unknown.

Specified by:

getTransmittedPowerStandardDeviation in interface RadioSourceWithPower

Returns:

standard deviation of transmitted power value or null if unknown.

getPathLossExponent

public double getPathLossExponent()

Gets exponent typically used on free space for path loss propagation in terms of distance. On different environments path loss exponent might have different values: - Free space: 2.0 - Urban Area: 2.7 to 3.5 - Suburban Area: 3 to 5 - Indoor (line-of-sight): 1.6 to 1.8 If path loss exponent estimation is not enabled, this value will always be equal to DEFAULT_PATH_LOSS_EXPONENT

Specified by:

getPathLossExponent in interface RadioSourceWithPower

Returns:

path loss exponent.

getPathLossExponentStandardDeviation

public Double getPathLossExponentStandardDeviation()

Gets standard deviation of path loss exponent or null if unknown.

Specified by:

getPathLossExponentStandardDeviation in interface RadioSourceWithPower

Returns:

standard deviation of path loss exponent or null if unknown.