ilog.views.maps.srs.coordsys

Class IlvGeographicCoordinateSystem

java.lang.Object

ilog.views.maps.srs.coordsys.IlvCoordinateSystem

ilog.views.maps.srs.coordsys.IlvGeographicCoordinateSystem

All Implemented Interfaces:

IlvPersistentObject

public class IlvGeographicCoordinateSystem
extends IlvCoordinateSystem

The base class for geographic coordinate systems. Geographic coordinate systems define coordinates using their longitude (angle from the prime meridian of the coordinate system), their latitude and eventually an height. The latitude can be either expressed in spherical angle from the equator (in which case, the altitude corresponds to the distance from the earth center) or as geodetic height, in which case the altitude corresponds to the ellipsoid height.

Since:

JViews 5.0

Field Summary

Fields

Modifier and Type	Field and Description
static IlvGeographicCoordinateSystem	KERNEL The Kernel geographic coordinate.
static IlvGeographicCoordinateSystem	WGS84 The WGS84 Geographic Coordinate System.

Constructor Summary

Constructors

Modifier	Constructor and Description
	IlvGeographicCoordinateSystem(IlvGeographicCoordinateSystem source) Copy constructor.
	IlvGeographicCoordinateSystem(IlvHorizontalDatum datum, IlvMeridian primeMeridian) Creates a new IlvGeographicCoordinateSystem from the specified datum.
	IlvGeographicCoordinateSystem(IlvInputStream stream) Reads an IlvGeographicCoordinateSystem from the specified input stream.
	IlvGeographicCoordinateSystem(String name, IlvHorizontalDatum datum, IlvMeridian primeMeridian, IlvAngularUnit angularUnit, IlvLinearUnit linearUnit) Creates a new IlvGeographicCoordinateSystem from the specified datum.
protected	IlvGeographicCoordinateSystem(String name, IlvMeridian primeMeridian, IlvUnit[] units, String[] axisNames, IlvHorizontalDatum datum) Constructs a new IlvGeographicCoordinateSystem using the specified parameters.

Method Summary

Modifier and Type	Method and Description
IlvCoordinateSystem	copy() Returns a new copy of this coordinate system.
boolean	equals(Object other) Returns true if this coordinate system is equivalent to the specified coordinate system.
IlvLinearUnit	equivalentLinearUnit() Returns an equivalent linear unit at the equator.
IlvHorizontalDatum	getDatum() Returns the datum of this coordinate system.
IlvMeridian	getPrimeMeridian() Returns the prime meridian.
String	toString() Returns a string representation of this coordinate system.
void	write(IlvOutputStream stream) Writes the object to the specified IlvOutputStream.

Methods inherited from class ilog.views.maps.srs.coordsys.IlvCoordinateSystem

getAxisName, getDimension, getName, getUnit, toString

Methods inherited from class java.lang.Object

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

Field Detail

KERNEL

public static final IlvGeographicCoordinateSystem KERNEL

The Kernel geographic coordinate. This coordinate system is the coordinate system used internally for computations. It is basically a WGS84 coordinate system, with longitude and latitude expressed in radians and ellipsoidal height expressed in meters.

WGS84

public static final IlvGeographicCoordinateSystem WGS84

The WGS84 Geographic Coordinate System. Longitude and latitude are expressed in degrees, and altitude in meters.

Constructor Detail

IlvGeographicCoordinateSystem

public IlvGeographicCoordinateSystem(IlvHorizontalDatum datum,
                                     IlvMeridian primeMeridian)

Creates a new IlvGeographicCoordinateSystem from the specified datum. The created coordinate system describes 2D coordinates on an ellipsoid, expressed in the same unit as the primeMeridian. The created geographic coordinate system has a dimension of 2 and maps the coordinates in the following way:

• The longitude of points is stored in the x field of IlvCoordinate.
• The latitude of points is stored in the y field of IlvCoordinate.
• The z field of IlvCoordinate is not used.

Parameters:

datum - The datum.

primeMeridian - The prime meridian of this coordinate system.

IlvGeographicCoordinateSystem

public IlvGeographicCoordinateSystem(String name,
                                     IlvHorizontalDatum datum,
                                     IlvMeridian primeMeridian,
                                     IlvAngularUnit angularUnit,
                                     IlvLinearUnit linearUnit)

Creates a new IlvGeographicCoordinateSystem from the specified datum. The created coordinate system describes 2D or 3D coordinates on an ellipsoid; angles are expressed in the specified angular unit, and lengths are expressed in the specified linear unit. The created geographic coordinate system has a dimension of 2 or 3 and maps coordinates the following way:

• The longitude of points is stored in the x field of IlvCoordinate.
• The latitude of points is stored in the y field of IlvCoordinate.
• If linearUnit is non-null, the ellipsoidal height is stored in the z field of the IlvCoordinate. If linearUnit is null, the z field of IlvCoordinate is not used.

Parameters:

name - The name of the geographic coordinate system.

datum - The datum.

primeMeridian - The prime meridian of this coordinate system.

angularUnit - The unit used to measure angles.

linearUnit - The unit used to measure lengths.

IlvGeographicCoordinateSystem

protected IlvGeographicCoordinateSystem(String name,
                                        IlvMeridian primeMeridian,
                                        IlvUnit[] units,
                                        String[] axisNames,
                                        IlvHorizontalDatum datum)

Constructs a new IlvGeographicCoordinateSystem using the specified parameters.

IlvGeographicCoordinateSystem

public IlvGeographicCoordinateSystem(IlvGeographicCoordinateSystem source)

Copy constructor.

Parameters:

source - The source coordinate system.

IlvGeographicCoordinateSystem

public IlvGeographicCoordinateSystem(IlvInputStream stream)
                              throws IlvReadFileException

Reads an IlvGeographicCoordinateSystem from the specified input stream.

Throws:

IlvReadFileException

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to the specified IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvCoordinateSystem

Parameters:

stream - The stream to write this unit to.

Throws:

IOException - If an I/O error occurs.

getPrimeMeridian

public IlvMeridian getPrimeMeridian()

Returns the prime meridian.

getDatum

public IlvHorizontalDatum getDatum()

Returns the datum of this coordinate system.

copy

public IlvCoordinateSystem copy()

Returns a new copy of this coordinate system.

Specified by:

copy in class IlvCoordinateSystem

equals

public boolean equals(Object other)

Returns true if this coordinate system is equivalent to the specified coordinate system.

Overrides:

equals in class IlvCoordinateSystem

toString

public String toString()

Returns a string representation of this coordinate system.

Overrides:

toString in class Object

equivalentLinearUnit

public IlvLinearUnit equivalentLinearUnit()

Returns an equivalent linear unit at the equator.
This equivalent linear unit maps angular unit of this coordinate system to meters.