ilog.views.maps.projection

Class IlvLambertEqualAreaConicProjection

java.lang.Object

ilog.views.maps.projection.IlvProjection

ilog.views.maps.projection.IlvConicProjection

ilog.views.maps.projection.IlvAlbersEqualAreaProjection

ilog.views.maps.projection.IlvLambertEqualAreaConicProjection

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvLambertEqualAreaConicProjection
extends IlvAlbersEqualAreaProjection

This class defines the Lambert Equal Area projection. The Lambert Equal Area projection is a special form of the Albers Equal Area projection where the second secant latitude is always set to a pole, either the south pole or the north pole.

This projection is Equal Area.

Since:

JViews 3.0

See Also:

Serialized Form

Field Summary

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

CONFORMAL, EQUAL_AREA, NONE

Constructor Summary

Constructors

Constructor and Description
IlvLambertEqualAreaConicProjection() Creates an instance of the class IlvLambertEqualAreaConicProjection and initializes its secant latitudes to 0N and 90N.
IlvLambertEqualAreaConicProjection(double lat1, boolean south) Creates an instance of the class IlvLambertEqualAreaConicProjection and specifies its secant latitudes.
IlvLambertEqualAreaConicProjection(IlvInputStream stream) Reads the object from an IlvInputStream.
IlvLambertEqualAreaConicProjection(IlvLambertEqualAreaConicProjection source) Creates a new IlvLambertEqualAreaConicProjection by copying an existing one.

Method Summary

Modifier and Type	Method and Description
IlvProjection	copy() Copies the projection.
boolean	isSouth() Returns true if the projection is set for the southern hemisphere.
void	setSecantLatitudes(IlvCoordinate secant) Sets the latitudes at which the cone intersects with the earth.
void	setSouth(boolean south) Sets the projection for the specified hemisphere.
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.IlvAlbersEqualAreaProjection

eForward, eInverse, setEllipsoid, setLLCenter, sForward, sInverse

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

addDescription, getSecantLatitude1, getSecantLatitude2, getSecantLatitudes, setSecantLatitude1, setSecantLatitude2

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

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, setUnit, setUsingLongitudeReduction, setXYOffset

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvLambertEqualAreaConicProjection

public IlvLambertEqualAreaConicProjection()

Creates an instance of the class IlvLambertEqualAreaConicProjection and initializes its secant latitudes to 0N and 90N.

IlvLambertEqualAreaConicProjection

public IlvLambertEqualAreaConicProjection(double lat1,
                                          boolean south)
                                   throws IlvBadProjectionParameter

Creates an instance of the class IlvLambertEqualAreaConicProjection and specifies its secant latitudes.

Parameters:

lat1 - the first secant latitude in radians.

south - specifies if the projection is set for the southern hemisphere.

Throws:

IlvBadProjectionParameter - if the secant latitudes define a limiting form of the projection.

IlvLambertEqualAreaConicProjection

public IlvLambertEqualAreaConicProjection(IlvInputStream stream)
                                   throws IlvReadFileException

Reads the object from an IlvInputStream.

Parameters:

stream - the input stream.

Throws:

IlvReadFileException - if the format is not correct.

IlvLambertEqualAreaConicProjection

public IlvLambertEqualAreaConicProjection(IlvLambertEqualAreaConicProjection source)

Creates a new IlvLambertEqualAreaConicProjection by copying an existing one.

Parameters:

source - the projection that is copied.

Method Detail

copy

public IlvProjection copy()

Copies the projection.

Overrides:

copy in class IlvAlbersEqualAreaProjection

Returns:

a copy of the projection.

isSouth

public boolean isSouth()

Returns true if the projection is set for the southern hemisphere.

setSouth

public void setSouth(boolean south)
              throws IlvBadProjectionParameter

Sets the projection for the specified hemisphere.

Parameters:

south - if this parameter is true, the projection is set for the southern hemisphere, otherwise, it is set for the northern hemisphere.

Throws:

IlvBadProjectionParameter - if the argument specifies a limiting form of a conic projection.

setSecantLatitudes

public void setSecantLatitudes(IlvCoordinate secant)
                        throws IlvBadProjectionParameter

Sets the latitudes at which the cone intersects with the earth. The second secant latitude is forced to a pole, depending on the hemisphere shown by the projection.

Overrides:

setSecantLatitudes in class IlvAlbersEqualAreaProjection

Parameters:

secant - the first secant latitude in radians is in secant.x and the second secant latitude in radians is in secant.y.

Throws:

IlvBadProjectionParameter - if the latitudes specify a limiting form of a conic projection.

See Also:

isSouth(), setSouth(boolean)

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvConicProjection

Parameters:

stream - the output stream.

Throws:

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

toString

public String toString()

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

Overrides:

toString in class IlvAlbersEqualAreaProjection