ilog.views.maps.projection
Class IlvUniversalPolarStereographicProjection

java.lang.Object
  ilog.views.maps.projection.IlvProjection
      ilog.views.maps.projection.IlvStereographicProjection
          ilog.views.maps.projection.IlvUniversalPolarStereographicProjection

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvUniversalPolarStereographicProjection
extends IlvStereographicProjection

This class defines the Universal Polar Stereographic projection, also known as the UPS projection. The UPS projection is a pre-configured form of the Stereographic projection. It is usually used with non-spherical ellipsoids. It is designed to cover regions where lat >= 84N or lat <= 80S. The scale factor is fixed to 0.994. The false northing and false easting are set to 2 000 000 m.

See Also:

IlvUniversalTransverseMercatorProjection, Serialized Form

Field Summary

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

CONFORMAL, EQUAL_AREA, NONE

Constructor Summary

IlvUniversalPolarStereographicProjection()
Creates an instance of the UPS projection.

IlvUniversalPolarStereographicProjection(boolean south)
Creates an instance of the class IlvUniversalPolarStereographicProjection and specifies the Pole.

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

IlvUniversalPolarStereographicProjection(IlvUniversalPolarStereographicProjection source)
Creates a new IlvUniversalPolarStereographicProjection by copying an existing one.

Method Summary

IlvProjection	copy() Copies the projection.
boolean	isSouth() Returns true if the projection is set for the South Pole.
void	setLLCenter(double lon, double lat) Does nothing.
void	setScaleFactor(double k0) Does nothing.
void	setSouth(boolean south) Sets the projection either for the South Pole or for the North Pole.
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.IlvStereographicProjection

eForward, eInverse, getLatitudeOfTrueScale, getScaleFactor, setEllipsoid, setLatitudeOfTrueScale, sForward, sInverse

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

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvUniversalPolarStereographicProjection

public IlvUniversalPolarStereographicProjection()

Creates an instance of the UPS projection. The ellipsoid is set to the WGS84 ellipsoid. The projection is initialized for the North Pole.

IlvUniversalPolarStereographicProjection

public IlvUniversalPolarStereographicProjection(boolean south)

Creates an instance of the class IlvUniversalPolarStereographicProjection and specifies the Pole. The ellipsoid is set to the WGS84 ellipsoid.

Parameters:

south - if true, the projection is set for the South Pole.

IlvUniversalPolarStereographicProjection

public IlvUniversalPolarStereographicProjection(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

IlvUniversalPolarStereographicProjection

public IlvUniversalPolarStereographicProjection(IlvUniversalPolarStereographicProjection source)

Creates a new IlvUniversalPolarStereographicProjection by copying an existing one.

Parameters:

source - the projection that is copied.

Since:

JViews 3.0

Method Detail

copy

public IlvProjection copy()

Copies the projection.

Overrides:

copy in class IlvStereographicProjection

Returns:

a copy of the projection.

Since:

JViews 3.0

setLLCenter

public void setLLCenter(double lon,
                        double lat)

Does nothing. In UPS projections the center cannot be changed.

Overrides:

setLLCenter in class IlvStereographicProjection

Parameters:

lon - the central meridian in radians

lat - the central parallel in radians

See Also:

setSouth(boolean)

setSouth

public void setSouth(boolean south)

Sets the projection either for the South Pole or for the North Pole.

Parameters:

south - if true, the projection is set for the South Pole

isSouth

public final boolean isSouth()

Returns true if the projection is set for the South Pole. Returns false if the projection is set for the North Pole.

setScaleFactor

public void setScaleFactor(double k0)

Does nothing. The UPS projection has a specified scaling factor of 0.994.

Overrides:

setScaleFactor in class IlvStereographicProjection

Parameters:

k0 - ignored

See Also:

IlvStereographicProjection.setLatitudeOfTrueScale(double)

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvStereographicProjection

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 IlvStereographicProjection