IlvGeodeticComputation (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.maps.IlvGeodeticComputation

```
public class IlvGeodeticComputation
extends Object
```
The IlvGeodeticComputation class is useful for calculating distances, azimuths, and point coordinates. Calculations of this kind are needed to compute the shortest distance between two objects positioned on the globe, to draw the shortest trajectory of a plane, to obtain the current distance of a plane to its destination, etc. Computations of class IlvGeodeticComputation are very useful when JViews Map objects have to be placed or moved with precision over a given geographic map to simulate real-world scenarios.

Example: The azimuth and the distance between two points, can be calculated given their latitudes and longitudes.

// Create an instance of class IlvGeodeticComputation. IlvGeodeticComputation c = new IlvGeodeticComputation(); // Specify the ellipsoid by which the spherical model of the earth should be corrected. c.setEllipsoid(IlvEllipsoid.WGS84); // Specify the two points of interest. c.setPoint1(Math.toRadians(2.44638), Math.toRadians(48.88755));//Paris c.setPoint2(Math.toRadians(-74.10708), Math.toRadians(40.75471));//New York // Start the computation. c.computeGeodeticInverse(); // Obtain the results. System.out.println("Paris to New York: " + c.getDistance()/1000.0 + " Km using WGS 84"); System.out.println("Forward Azimuth: " + Math.toDegrees(c.getForwardAzimuth())); System.out.println("Backward Azimuth: " + Math.toDegrees(c.getBackwardAzimuth()));
Results: Paris to New York: 5862.1871801901925 Km using WGS 84 Forward Azimuth: -68.04306044159112 Backward Azimuth: 53.65332529862143

Since:

JViews 7.5

Constructor Summary

Constructors
Constructor and Description
`IlvGeodeticComputation()` The constructor of a `IlvGeodeticComputation` instance.
`IlvGeodeticComputation(IlvEllipsoid el)` The constructor of an `IlvGeodeticComputation` instance with the ellipsoid `el`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`computeGeodeticForward()` Computes the longitude and latitude of a point relative to a given point according to the forward azimuth and the distance between these two points.
`void`	`computeGeodeticInverse()` Computes the geodetic azimuth and distance between two points.
`double`	`getBackwardAzimuth()` Gets the backward azimuth between the first and second reference points.
`double`	`getDistance()` Gets the distance (in meters) between the first and second reference points.
`double`	`getForwardAzimuth()` Gets the forward azimuth between the first and second reference points.
`double`	`getLatitude1()` Gets the latitude of the first reference point.
`double`	`getLatitude2()` Gets the latitude of the second reference point.
`double`	`getLongitude1()` Gets the longitude of the first reference point.
`double`	`getLongitude2()` Gets the longitude of the second reference point.
`void`	`setDistance(double distance)` Sets the distance (in meters) between the first and second reference points.
`void`	`setEllipsoid(double semiMajorAxisLength, double invFlat)` Specifies the ellipsoid.
`void`	`setEllipsoid(IlvEllipsoid el)` Sets the ellipsoid.
`void`	`setForwardAzimuth(double fAzimuth)` Sets the forward azimuth.
`void`	`setLatitude1(double lat)` Sets the latitude of the first reference point.
`void`	`setLatitude2(double lat)` Sets the latitude of the second reference point.
`void`	`setLongitude1(double lon)` Sets the longitude of the first reference point.
`void`	`setLongitude2(double lon)` Sets the longitude of the second reference point.
`void`	`setPoint1(double lon, double lat)` Sets the first reference point.
`void`	`setPoint2(double lon, double lat)` Sets the second reference point.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IlvGeodeticComputation
```
public IlvGeodeticComputation()
```
    The constructor of a IlvGeodeticComputation instance. The default ellipsoid is spherical with a radius of 6,366,707m.
  - IlvGeodeticComputation
```
public IlvGeodeticComputation(IlvEllipsoid el)
```
    The constructor of an IlvGeodeticComputation instance with the ellipsoid el.
    
    Parameters:
    
    el - The ellipsoid used for the computations.
- Method Detail
  - setEllipsoid
```
public void setEllipsoid(double semiMajorAxisLength,
                         double invFlat)
```
    Specifies the ellipsoid.
    
    Parameters:
    
    semiMajorAxisLength - The length of the semi-major axis in meters.
    
    invFlat - The inverse flattening of the ellipsoid.
  - setEllipsoid
```
public void setEllipsoid(IlvEllipsoid el)
```
    Sets the ellipsoid.
    
    Parameters:
    
    el - The ellipsoid used for the computations.
  - setPoint1
```
public void setPoint1(double lon,
                      double lat)
```
    Sets the first reference point.
    
    Parameters:
    
    lon - The longitude of the reference point in radians.
    
    lat - The latitude of the reference point in radians.
  - setPoint2
```
public void setPoint2(double lon,
                      double lat)
```
    Sets the second reference point.
    
    Parameters:
    
    lon - The longitude of the reference point in radians.
    
    lat - The latitude of the reference point in radians.
  - setLongitude1
```
public void setLongitude1(double lon)
```
    Sets the longitude of the first reference point.
    
    Parameters:
    
    lon - The longitude of the reference point in radians.
  - setLongitude2
```
public void setLongitude2(double lon)
```
    Sets the longitude of the second reference point.
    
    Parameters:
    
    lon - The longitude of the reference point in radians.
  - setLatitude1
```
public void setLatitude1(double lat)
```
    Sets the latitude of the first reference point.
    
    Parameters:
    
    lat - The latitude of the reference point in radians.
  - setLatitude2
```
public void setLatitude2(double lat)
```
    Sets the latitude of the second reference point.
    
    Parameters:
    
    lat - The latitude of the reference point in radians.
  - getLongitude1
```
public double getLongitude1()
```
    Gets the longitude of the first reference point.
    
    Returns:
    
    The longitude of the reference point in radians.
  - getLongitude2
```
public double getLongitude2()
```
    Gets the longitude of the second reference point.
    
    Returns:
    
    The longitude of the reference point in radians.
  - getLatitude1
```
public double getLatitude1()
```
    Gets the latitude of the first reference point.
    
    Returns:
    
    The latitude of the reference point in radians.
  - getLatitude2
```
public double getLatitude2()
```
    Gets the latitude of the second reference point.
    
    Returns:
    
    The latitude of the reference point in radians.
  - getDistance
```
public double getDistance()
```
    Gets the distance (in meters) between the first and second reference points.
    
    Returns:
    
    The distance (in meters) between the first and second reference points.
  - setDistance
```
public void setDistance(double distance)
```
    Sets the distance (in meters) between the first and second reference points.
    
    Parameters:
    
    distance - The desired distance in meters.
  - getForwardAzimuth
```
public double getForwardAzimuth()
```
    Gets the forward azimuth between the first and second reference points.
    
    Returns:
    
    The forward azimuth between the first and second reference points.
  - setForwardAzimuth
```
public void setForwardAzimuth(double fAzimuth)
```
    Sets the forward azimuth.
    
    Parameters:
    
    fAzimuth - The desired forward azimuth.
  - getBackwardAzimuth
```
public double getBackwardAzimuth()
```
    Gets the backward azimuth between the first and second reference points.
    
    Returns:
    
    The backward azimuth.
  - computeGeodeticInverse
```
public void computeGeodeticInverse()
```
    Computes the geodetic azimuth and distance between two points. To obtain defined results the longitude and latitude of the two reference points must have been set using the setPoint1 and setPoint2 methods.
    
    See Also:
    
    setPoint1(double, double), setPoint2(double, double)
  - computeGeodeticForward
```
public void computeGeodeticForward()
```
    Computes the longitude and latitude of a point relative to a given point according to the forward azimuth and the distance between these two points. To obtain defined results, methods setForwardAzimuth, setDistance, and setPoint1 must have been called before.
    
    See Also:
    
    setPoint1(double, double), setForwardAzimuth(double), setDistance(double)

Class IlvGeodeticComputation

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

IlvGeodeticComputation

IlvGeodeticComputation

Method Detail

setEllipsoid

setEllipsoid

setPoint1

setPoint2

setLongitude1

setLongitude2

setLatitude1

setLatitude2

getLongitude1

getLongitude2

getLatitude1

getLatitude2

getDistance

setDistance

getForwardAzimuth

setForwardAzimuth

getBackwardAzimuth

computeGeodeticInverse

computeGeodeticForward