ilog.views.maps.projection
Class IlvCylindricalEqualAreaProjection

java.lang.Object
  ilog.views.maps.projection.IlvProjection
      ilog.views.maps.projection.IlvCylindricalEqualAreaProjection

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvCylindricalEqualAreaProjection
extends IlvProjection

This class defines the Cylindrical Equal Area projection. A cylindrical projection is obtained by wrapping a large, flat plane around the globe to form a cylinder.

The Cylindrical Equal Area projection is also known as:

• Lambert Cylindric Equal Area (when the projection cylinder is tangent at the Equator).
• Behrmann (when the secant parallels are set to 30°N and S).
• Gall Orthographic (when the secant parallels are set to 45°N and S).
• Peters (same as Gall Orthographic).

This class applies both to spherical and non-spherical ellipsoids and implements an inverse function.

This projection is Equal Area.

See Also:

Serialized Form

Field Summary

Fields inherited from class ilog.views.maps.projection.IlvProjection

CONFORMAL, EQUAL_AREA, NONE

Constructor Summary

IlvCylindricalEqualAreaProjection()
Creates an instance of the class IlvCylindricalEqualAreaProjection.

IlvCylindricalEqualAreaProjection(double latitudeOfTrueScale)
Creates an instance of the class IlvCylindricalEqualAreaProjection and specifies the latitude of the true scale.

IlvCylindricalEqualAreaProjection(IlvCylindricalEqualAreaProjection source)
Creates a new IlvCylindricalEqualAreaProjection.

IlvCylindricalEqualAreaProjection(IlvInputStream stream)
Reads the object from an IlvInputStream.

Method Summary

IlvProjection	copy() Copies the projection.
protected void	eForward(IlvCoordinate ll) Implements the projection for an ellipsoid.
protected void	eInverse(IlvCoordinate xy) Implements the inverse projection for an ellipsoid.
double	getLatitudeOfTrueScale() Returns the latitude of the true scale.
void	setEllipsoid(IlvEllipsoid ellipsoid) Sets the ellipsoid used for the projection ellipsoid.
void	setLatitudeOfTrueScale(double latitudeOfTrueScale) Sets the latitude of the true scale.
protected void	sForward(IlvCoordinate ll) Implements the projection for a sphere.
protected void	sInverse(IlvCoordinate xy) Implements the inverse projection for a sphere.
String	toString() Converts the projection to a string with Evenden's format.
void	write(IlvOutputStream stream) Writes the object to an IlvOutputStream.

Methods inherited from class ilog.views.maps.projection.IlvProjection

addDescription, adjustLongitude, equals, forward, forward, getCentralMeridian, getCentralParallel, getDatum, getEllipsoid, getFalseEasting, getFalseNorthing, GetProjection, getProperty, getUnit, getXYOffset, inverse, inverse, inverse, isEllipsoidEnabled, isGeocentric, isInverseEnabled, isUsingLongitudeReduction, setCentralMeridian, setCentralParallel, setDatum, setFalseEasting, setFalseNorthing, setGeocentric, setLLCenter, setUnit, setUsingLongitudeReduction, setXYOffset

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvCylindricalEqualAreaProjection

public IlvCylindricalEqualAreaProjection()

Creates an instance of the class IlvCylindricalEqualAreaProjection.

IlvCylindricalEqualAreaProjection

public IlvCylindricalEqualAreaProjection(double latitudeOfTrueScale)

Creates an instance of the class IlvCylindricalEqualAreaProjection and specifies the latitude of the true scale.

Parameters:

latitudeOfTrueScale - The latitude of the true scale, in radians.

IlvCylindricalEqualAreaProjection

public IlvCylindricalEqualAreaProjection(IlvInputStream stream)
                                  throws IlvReadFileException

Reads the object from an IlvInputStream.

Parameters:

stream - The input stream.

Throws:

IlvReadFileException - If the format is not correct.

Since:

JViews 3.0

IlvCylindricalEqualAreaProjection

public IlvCylindricalEqualAreaProjection(IlvCylindricalEqualAreaProjection source)

Creates a new IlvCylindricalEqualAreaProjection. by copying an existing one.

Parameters:

source - The graphic object that is copied.

Since:

JViews 3.0

Method Detail

copy

public IlvProjection copy()

Copies the projection.

Specified by:

copy in class IlvProjection

Returns:

A copy of the projection.

Since:

JViews 3.0

sForward

protected void sForward(IlvCoordinate ll)

Implements the projection for a sphere.

Specified by:

sForward in class IlvProjection

Parameters:

ll - The longitude/latitude coordinates in radians (x = longitude, y = latitude).

eForward

protected void eForward(IlvCoordinate ll)

Implements the projection for an ellipsoid.

Overrides:

eForward in class IlvProjection

Parameters:

ll - The longitude/latitude coordinates in radians (x = longitude, y = latitude).

eInverse

protected void eInverse(IlvCoordinate xy)

Implements the inverse projection for an ellipsoid.

Overrides:

eInverse in class IlvProjection

Parameters:

xy - The Cartesian coordinates.

See Also:

IlvProjection.inverse(ilog.views.IlvPoint), IlvProjection.isEllipsoidEnabled(), IlvProjection.isInverseEnabled()

sInverse

protected void sInverse(IlvCoordinate xy)
                 throws IlvToleranceConditionException

Implements the inverse projection for a sphere.

Overrides:

sInverse in class IlvProjection

Parameters:

xy - The Cartesian coordinates.

Throws:

IlvToleranceConditionException - If the values are not within the tolerated limits.

See Also:

IlvProjection.inverse(ilog.views.IlvPoint), IlvProjection.isInverseEnabled()

setLatitudeOfTrueScale

public void setLatitudeOfTrueScale(double latitudeOfTrueScale)

Sets the latitude of the true scale.

Parameters:

latitudeOfTrueScale - The latitude of the true scale in radians.

getLatitudeOfTrueScale

public final double getLatitudeOfTrueScale()

Returns the latitude of the true scale.

Returns:

The latitude of the true scale in radians.

setEllipsoid

public void setEllipsoid(IlvEllipsoid ellipsoid)

Sets the ellipsoid used for the projection ellipsoid. This function also updates the projection parameters for the given ellipsoid.

Overrides:

setEllipsoid in class IlvProjection

Parameters:

ellipsoid - The ellipsoid.

See Also:

IlvEllipsoid

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvProjection

Parameters:

stream - The output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

Since:

JViews 3.0

toString

public String toString()

Converts the projection to a string with Evenden's format.

Overrides:

toString in class Object