Package org.orekit.gnss

Class DOPComputer

  • public class DOPComputer
extends Object
    This class aims at computing the dilution of precision.
    Since:
    8.0
    Author:
    Pascal Parraud
    See Also:
    Dilution of precision

    • Field Detail

      • DOP_MIN_ELEVATION

        public static final double DOP_MIN_ELEVATION
        Minimum elevation : 0°.
        See Also:
        Constant Field Values

    • Method Detail

      • create

        public static DOPComputer create​(OneAxisEllipsoid shape,
                                 GeodeticPoint location)
        Creates a DOP computer for one location.

        A minimum elevation of 0° is taken into account to compute visibility between the location and the GNSS spacecrafts.

        Parameters:
        shape - the body shape on which the location is defined
        location - the point of interest
        Returns:
        a configured DOP computer

      • withMinElevation

        public DOPComputer withMinElevation​(double newMinElevation)
        Set the minimum elevation.

        This will override an elevation mask if it has been configured as such previously.

        Parameters:
        newMinElevation - minimum elevation for visibility (rad)
        Returns:
        a new DOP computer with updated configuration (the instance is not changed)
        See Also:
        getMinElevation()

      • withElevationMask

        public DOPComputer withElevationMask​(ElevationMask newElevationMask)
        Set the elevation mask.

        This will override the min elevation if it has been configured as such previously.

        Parameters:
        newElevationMask - elevation mask to use for the computation
        Returns:
        a new detector with updated configuration (the instance is not changed)
        See Also:
        getElevationMask()

      • compute

        public DOP compute​(AbsoluteDate date,
                   List<Propagator> gnss)
        Compute the DOP at a given date for a set of GNSS spacecrafts.

        Four GNSS spacecraft at least are needed to compute the DOP. If less than 4 propagators are provided, an exception will be thrown. If less than 4 spacecrafts are visible at the date, all DOP values will be set to NaN.

        Parameters:
        date - the computation date
        gnss - the propagators for GNSS spacecraft involved in the DOP computation
        Returns:
        the DOP at the location

      • getMinElevation

        public double getMinElevation()
        Get the minimum elevation.
        Returns:
        the minimum elevation (rad)

      • getElevationMask

        public ElevationMask getElevationMask()
        Get the elevation mask.
        Returns:
        the elevation mask