ilog.views.maps

Class IlvGeocentricCoordinateFormater

java.lang.Object

ilog.views.maps.IlvAbstractCoordinateFormatter

ilog.views.maps.IlvGeocentricCoordinateFormater

All Implemented Interfaces:

IlvPersistentObject, IlvCoordinateFormatter, Serializable

public class IlvGeocentricCoordinateFormater
extends IlvAbstractCoordinateFormatter

The IlvGeocentricCoordinateFormater class is a utility class that converts longitude and latitude (measured in radians) into cartesian geocentric coordinates (X,Y,Z) such as X:-6,364,039.61 Y:29,416.96 Z:296,204.96.

Since:

JViews 7.5

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvGeocentricCoordinateFormater() Default constructor
IlvGeocentricCoordinateFormater(IlvInputStream stream) Creates a new IlvDecimalCoordinateFormatter from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other) Overrides deep comparison equals.
String	getAngleString(double angleRad) This method is not supported by this coordinate formatter
double	getHeight() Returns the height of the current point.
double	getLatitude() Returns the latitude of current point.
double	getLongitude() Returns the longitude of current point.
double	getX() Returns cartesian X coordinate of the current point.
double	getY() Returns cartesian Y coordinate of the current point.
double	getZ() Returns cartesian Z coordinate of the current point.
void	parse(String pointString) Parse a formatted string containing a point's coordinates in this system
void	setHeight(double height) Sets the height (from the ellipsoid) of the current point
void	setLonLat(double longitude, double latitude) Sets latitude and longitude of the current point.
protected void	setupFormatters() This method is called after precision has been changed and should update the internal number formatters, if any.
void	setXYZ(double x, double y, double z) Sets cartesian XYZ coordinates of the current point
String	toString() Returns the string representation of current point in this system.

Methods inherited from class ilog.views.maps.IlvAbstractCoordinateFormatter

getDecimalFormatSymbols, getEllipsoid, getInputSeparator, getOutputSeparator, getPrecision, hashCode, setCoordinatePrecision, setEllipsoid, setOutputSeparator, setParseSeparator, setPrecision, write

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvGeocentricCoordinateFormater

public IlvGeocentricCoordinateFormater()

Default constructor

IlvGeocentricCoordinateFormater

public IlvGeocentricCoordinateFormater(IlvInputStream stream)
                                throws IlvReadFileException

Creates a new IlvDecimalCoordinateFormatter from an IlvInputStream.

Parameters:

stream - The input stream.

Throws:

IlvReadFileException - if an error occurs while reading.

Method Detail

getHeight

public double getHeight()
                 throws IllegalStateException

Returns the height of the current point.

Returns:

Returns the height of the current point if coordinates were not set first on the system

Throws:

IllegalStateException

getLatitude

public double getLatitude()
                   throws IllegalStateException

Returns the latitude of current point.

Returns:

Returns the latitude of current point.

Throws:

IllegalStateException - if coordinates were not set first on the system

getLongitude

public double getLongitude()
                    throws IllegalStateException

Returns the longitude of current point.

Returns:

Returns the longitude of current point.

Throws:

IllegalStateException - if coordinates were not set first on the system

getX

public double getX()

Returns cartesian X coordinate of the current point.

Returns:

Returns cartesian X coordinate of the current point.

getY

public double getY()

Returns cartesian Y coordinate of the current point.

Returns:

Returns cartesian Y coordinate of the current point.

getZ

public double getZ()

Returns cartesian Z coordinate of the current point.

Returns:

Returns cartesian Z coordinate of the current point.

parse

public void parse(String pointString)
           throws IllegalArgumentException

Parse a formatted string containing a point's coordinates in this system

Parameters:

pointString - String to parse.

Throws:

IllegalArgumentException - if string format is not valid

setHeight

public void setHeight(double height)

Sets the height (from the ellipsoid) of the current point

Parameters:

height - altitude of the point.

setLonLat

public void setLonLat(double longitude,
                      double latitude)

Sets latitude and longitude of the current point.

Parameters:

longitude - longitude in radians.

latitude - latitude in radians.

See Also:

IlvCoordinateFormatter.setLonLat(double, double)

setXYZ

public void setXYZ(double x,
                   double y,
                   double z)

Sets cartesian XYZ coordinates of the current point

Parameters:

x - x coordinate in meters.

y - y coordinate in meters.

z - z coordinate in meters.

toString

public String toString()

Returns the string representation of current point in this system.

Specified by:

toString in interface IlvCoordinateFormatter

Overrides:

toString in class Object

Returns:

Returns the string representation of current point in this system.

setupFormatters

protected void setupFormatters()

This method is called after precision has been changed and should update the internal number formatters, if any.

Specified by:

setupFormatters in class IlvAbstractCoordinateFormatter

See Also:

IlvAbstractCoordinateFormatter.setupFormatters()

getAngleString

public String getAngleString(double angleRad)
                      throws UnsupportedOperationException

This method is not supported by this coordinate formatter

Parameters:

angleRad - angle in radians.

Returns:

the formatted string.

Throws:

UnsupportedOperationException - if the formatter does not support angles.

See Also:

IlvCoordinateFormatter.getAngleString(double)

equals

public boolean equals(Object other)

Overrides deep comparison equals.

Overrides:

equals in class IlvAbstractCoordinateFormatter

See Also:

Object.equals(java.lang.Object)