org.orekit.gnss

Class DOPComputer

java.lang.Object

org.orekit.gnss.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 Summary

Fields

Modifier and Type	Field and Description
static double	DOP_MIN_ELEVATION Minimum elevation : 0°.

Method Summary

Modifier and Type	Method and Description
DOP	compute(AbsoluteDate date, List<Propagator> gnss) Compute the DOP at a given date for a set of GNSS spacecrafts.
static DOPComputer	create(OneAxisEllipsoid shape, GeodeticPoint location) Creates a DOP computer for one location.
ElevationMask	getElevationMask() Get the elevation mask.
double	getMinElevation() Get the minimum elevation.
DOPComputer	withElevationMask(ElevationMask newElevationMask) Set the elevation mask.
DOPComputer	withMinElevation(double newMinElevation) Set the minimum elevation.

Methods inherited from class java.lang.Object

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

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)
            throws OrekitException

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

Throws:

OrekitException - if something wrong occurs

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