Class RobustRssiRadioSourceEstimator3D<S extends RadioSource>

java.lang.Object
com.irurueta.navigation.indoor.radiosource.RobustRadioSourceEstimator<com.irurueta.geometry.Point3D,RssiReadingLocated<S,com.irurueta.geometry.Point3D>,RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D>>
com.irurueta.navigation.indoor.radiosource.RobustRssiRadioSourceEstimator<S,com.irurueta.geometry.Point3D>
com.irurueta.navigation.indoor.radiosource.RobustRssiRadioSourceEstimator3D<S>
Type Parameters:
S - a RadioSource type.
Direct Known Subclasses:
LMedSRobustRssiRadioSourceEstimator3D, MSACRobustRssiRadioSourceEstimator3D, PROMedSRobustRssiRadioSourceEstimator3D, PROSACRobustRssiRadioSourceEstimator3D, RANSACRobustRssiRadioSourceEstimator3D

public abstract class RobustRssiRadioSourceEstimator3D<S extends RadioSource> extends RobustRssiRadioSourceEstimator<S,com.irurueta.geometry.Point3D>
This is an abstract class to robustly estimate 3D position, transmitted power and path-loss exponent of a radio source (e.g. Wi-Fi access point or bluetooth beacon), by discarding outliers and assuming that the radio source emits isotropically following the expression below: Pr = Pt*Gt*Gr*lambda^2 / (4*pi*d)^2, where Pr is the received power (expressed in mW), Gt is the Gain of the transmission antenna Gr is the Gain of the receiver antenna d is the distance between emitter and receiver and lambda is the wavelength and is equal to: lambda = c / f, where c is the speed of light and f is the carrier frequency of the radio signal. Because usually information about the antenna of the radio source cannot be retrieved (because many measurements are made on unknown access points where physical access is not possible), this implementation will estimate the equivalent transmitted power as: Pte = Pt * Gt * Gr. If RssiReadings contain RSSI standard deviations, those values will be used, otherwise it will be assumed an RSSI standard deviation of 1 dB. Implementations of this class should be able to detect and discard outliers in order to find the best solution.

IMPORTANT: Implementations of this class can choose to estimate a combination of radio source position, transmitted power and path loss exponent. However enabling all three estimations usually achieves inaccurate results. When using this class, estimation must be of at least one parameter (position, transmitted power or path loss exponent) when initial values are provided for the other two, and at most it should consist of two parameters (either position and transmitted power, position and path loss exponent or transmitted power and path loss exponent), providing an initial value for the remaining parameter.

  • Field Details

  • Constructor Details

    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D()
      Constructor.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor.
      Parameters:
      listener - listener in charge of attending events raised by this instance.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      listener - listener in charge of attending events raised by this instance.
      Throws:
      IllegalArgumentException - if fingerprints are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      Throws:
      IllegalArgumentException - if fingerprints are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
      Throws:
      IllegalArgumentException - if fingerprints are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(Double initialTransmittedPowerdBm)
      Constructor.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - in charge of attending events raised by this instance.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
    • RobustRssiRadioSourceEstimator3D

      protected RobustRssiRadioSourceEstimator3D(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Constructor. Sets signal readings belonging to the same radio source.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      Throws:
      IllegalArgumentException - if readings are not valid.
  • Method Details

    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener, com.irurueta.numerical.robust.RobustEstimatorMethod method)
      Creates a robust 3D position radio source estimator.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source .
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of access point transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      method - robust estimator method.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create()
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of access point position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      listener - listener in charge of attending events raised by this instance
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's)
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of access point position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
    • create

      public static <S extends RadioSource> RobustRssiRadioSourceEstimator3D<S> create(double[] qualityScores, List<? extends RssiReadingLocated<S,com.irurueta.geometry.Point3D>> readings, com.irurueta.geometry.Point3D initialPosition, Double initialTransmittedPowerdBm, double initialPathLossExponent, RobustRssiRadioSourceEstimatorListener<S,com.irurueta.geometry.Point3D> listener)
      Creates a robust 3D position radio source estimator using default method.
      Type Parameters:
      S - a RadioSource type.
      Parameters:
      qualityScores - quality scores corresponding to each provided sample. The larger the score value the better the quality of the sample.
      readings - signal readings belonging to the same radio source.
      initialPosition - initial position to start the estimation of radio source position.
      initialTransmittedPowerdBm - initial transmitted power to start the estimation of radio source transmitted power (expressed in dBm's).
      initialPathLossExponent - initial path loss exponent. A typical value is 2.0.
      listener - listener in charge of attending events raised by this instance.
      Returns:
      a new robust 3D position radio source estimator.
      Throws:
      IllegalArgumentException - if readings are not valid.
    • getMinReadings

      public int getMinReadings()
      Gets minimum required number of readings to estimate power, position and path-loss exponent. This value depends on the number of parameters to be estimated, but for position only, this is 4 readings for 3D.
      Specified by:
      getMinReadings in class RobustRadioSourceEstimator<com.irurueta.geometry.Point3D,RssiReadingLocated<S extends RadioSource,com.irurueta.geometry.Point3D>,RobustRssiRadioSourceEstimatorListener<S extends RadioSource,com.irurueta.geometry.Point3D>>
      Returns:
      minimum required number of readings.
    • getNumberOfDimensions

      public int getNumberOfDimensions()
      Gets number of dimensions of position points.
      Specified by:
      getNumberOfDimensions in class RobustRadioSourceEstimator<com.irurueta.geometry.Point3D,RssiReadingLocated<S extends RadioSource,com.irurueta.geometry.Point3D>,RobustRssiRadioSourceEstimatorListener<S extends RadioSource,com.irurueta.geometry.Point3D>>
      Returns:
      always returns 3 dimensions.
    • getEstimatedRadioSource

      public RadioSourceWithPowerAndLocated<com.irurueta.geometry.Point3D> getEstimatedRadioSource()
      Gets estimated located radio source with estimated transmitted power.
      Specified by:
      getEstimatedRadioSource in class RobustRadioSourceEstimator<com.irurueta.geometry.Point3D,RssiReadingLocated<S extends RadioSource,com.irurueta.geometry.Point3D>,RobustRssiRadioSourceEstimatorListener<S extends RadioSource,com.irurueta.geometry.Point3D>>
      Returns:
      estimated located radio source with estimated transmitted power or null.
    • solvePreliminarySolutions

      protected void solvePreliminarySolutions(int[] samplesIndices, List<RobustRssiRadioSourceEstimator.Solution<com.irurueta.geometry.Point3D>> solutions)
      Solves preliminary solution for a subset of samples.
      Specified by:
      solvePreliminarySolutions in class RobustRssiRadioSourceEstimator<S extends RadioSource,com.irurueta.geometry.Point3D>
      Parameters:
      samplesIndices - indices of subset samples.
      solutions - instance where solution will be stored.
    • attemptRefine

      protected void attemptRefine(RobustRssiRadioSourceEstimator.Solution<com.irurueta.geometry.Point3D> result)
      Attempts to refine estimated position and transmitted power contained in provided solution if refinement is requested. This method sets a refined result and transmitted power or provided input result if refinement is not requested or has failed. If refinement is enabled, and it is requested to keep covariance, this method will also keep covariance of refined result. solution if not requested or refinement failed.
      Parameters:
      result - result to be refined.