ucar.visad

Class ProjectionCoordinateSystem

java.lang.Object

visad.CoordinateSystem

visad.georef.NavigatedCoordinateSystem

visad.georef.MapProjection

ucar.visad.ProjectionCoordinateSystem

All Implemented Interfaces:

java.io.Serializable, XmlPersistable

public class ProjectionCoordinateSystem
extends visad.georef.MapProjection
implements XmlPersistable

Adapts a ucar.unidata.Projection into a VisAD MapProjection CoordinateSystem. Transforms between world coordinates (x,y) in km and lat/lon in degrees. Reference is lat/lon (RealTupleType.LatitudeLongitudeTuple)

Version:

$Revision: 1.25 $ $Date: 2006/08/18 17:28:41 $

Author:

Don Murray

See Also:

Projection, MapProjection, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug _more_

Constructor Summary

Constructors

Constructor and Description
ProjectionCoordinateSystem(ucar.unidata.geoloc.ProjectionImpl projection) Constructs an instance from the supplied Projection.
ProjectionCoordinateSystem(ucar.unidata.geoloc.ProjectionImpl projection, visad.Unit[] units) Constructs an instance from the supplied Projection.

Method Summary

Modifier and Type	Method and Description
org.w3c.dom.Element	createElement(XmlEncoder encoder) Create the XML to represent this object.
boolean	equals(java.lang.Object obj) Check for equality of CoordinateSystem objects
double[][]	fromReference(double[][] latlon) Convert lat/lon coordinates to world (projection) coords.
float[][]	fromReference(float[][] latlon) Convert lat/lon coordinates to world (projection) coords.
java.awt.geom.Rectangle2D	getDefaultMapArea() Get a reasonable bounding box in this coordinate system.
ucar.unidata.geoloc.ProjectionImpl	getProjection() Get the Projection used for the transformations.
boolean	initFromXml(XmlEncoder encoder, org.w3c.dom.Element node) Do nothing, return true to tell the encoder that it is ok to process any methods or properties.
double[][]	toReference(double[][] world) Convert world coordinates to lat/lon.
float[][]	toReference(float[][] world) Convert world coordinates to lat/lon.
java.lang.String	toString() Override the parent toString method to use the contained ProjectionImpl's name

Methods inherited from class visad.georef.MapProjection

getCenterLatLon, getLatLon, getXIndex, getYIndex, isLatLonOrder, isXYOrder

Methods inherited from class visad.georef.NavigatedCoordinateSystem

getLatitudeIndex, getLongitudeIndex

Methods inherited from class visad.CoordinateSystem

canConvert, fromReference, fromReference, getCoordinateSystemUnits, getDimension, getReference, getReferenceUnits, toReference, toReference, transformCoordinates, transformCoordinates, transformCoordinates, transformCoordinates, transformCoordinatesFreeUnits, transformCoordinatesFreeUnits

Methods inherited from class java.lang.Object

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

Field Detail

debug

public static boolean debug

_more_

Constructor Detail

ProjectionCoordinateSystem

public ProjectionCoordinateSystem(ucar.unidata.geoloc.ProjectionImpl projection)
                           throws visad.VisADException

Constructs an instance from the supplied Projection. The reference coordinate system is RealTupleType.LatitudeLongitudeTuple; the incoming units are assumed to be km (1000 m).

Parameters:

projection - projection to adapt

Throws:

visad.VisADException

ProjectionCoordinateSystem

public ProjectionCoordinateSystem(ucar.unidata.geoloc.ProjectionImpl projection,
                                  visad.Unit[] units)
                           throws visad.VisADException

Constructs an instance from the supplied Projection. The reference coordinate system is RealTupleType.LatitudeLongitudeTuple; the incoming units are assumed to be km (1000 m).

Parameters:

projection - projection to adapt

units - units to use

Throws:

visad.VisADException

Method Detail

toString

public java.lang.String toString()

Override the parent toString method to use the contained ProjectionImpl's name

Overrides:

toString in class visad.georef.MapProjection

Returns:

string representation

getDefaultMapArea

public java.awt.geom.Rectangle2D getDefaultMapArea()

Get a reasonable bounding box in this coordinate system. MapProjections are typically specific to an area of the world; there's no bounding box that works for all projections so each subclass must implement this method.

Specified by:

getDefaultMapArea in class visad.georef.MapProjection

Returns:

the default MapArea of the Projection

getProjection

public ucar.unidata.geoloc.ProjectionImpl getProjection()

Get the Projection used for the transformations.

Returns:

projection

toReference

public double[][] toReference(double[][] world)
                       throws visad.VisADException

Convert world coordinates to lat/lon. Input coords are in km.

Specified by:

toReference in class visad.CoordinateSystem

Parameters:

world - world projection coordinates (x = world[0][i])

Returns:

corresponding lat/lon values (lat = latlon[0][i])

Throws:

visad.VisADException - world coordinate array length != 2

fromReference

public double[][] fromReference(double[][] latlon)
                         throws visad.VisADException

Convert lat/lon coordinates to world (projection) coords.

Specified by:

fromReference in class visad.CoordinateSystem

Parameters:

latlon - lat/lon values (lat = latlon[0][i])

Returns:

world projection coordinates (x = world[0][i])

Throws:

visad.VisADException - latlon coordinate array length != 2

toReference

public float[][] toReference(float[][] world)
                      throws visad.VisADException

Convert world coordinates to lat/lon. Input coords are in km.

Overrides:

toReference in class visad.CoordinateSystem

Parameters:

world - world projection coordinates (x = world[0][i])

Returns:

corresponding lat/lon values (lat = latlon[0][i])

Throws:

visad.VisADException - world coordinate array length != 2

fromReference

public float[][] fromReference(float[][] latlon)
                        throws visad.VisADException

Convert lat/lon coordinates to world (projection) coords.

Overrides:

fromReference in class visad.CoordinateSystem

Parameters:

latlon - lat/lon values (lat = latlon[0][i])

Returns:

world projection coordinates (x = world[0][i])

Throws:

visad.VisADException - latlon coordinate array length != 2

equals

public boolean equals(java.lang.Object obj)

Check for equality of CoordinateSystem objects

Specified by:

equals in class visad.CoordinateSystem

Parameters:

obj - other object in question

Returns:

true if the object in question is a ProjectionCoordinateSystem and it's Projection is equal the this object's Projection

createElement

public org.w3c.dom.Element createElement(XmlEncoder encoder)

Create the XML to represent this object.

Specified by:

createElement in interface XmlPersistable

Parameters:

encoder - encoder to use

Returns:

Element that represents this object.

initFromXml

public boolean initFromXml(XmlEncoder encoder,
                           org.w3c.dom.Element node)

Do nothing, return true to tell the encoder that it is ok to process any methods or properties.

Specified by:

initFromXml in interface XmlPersistable

Parameters:

encoder - encoder to use

node - node to process

Returns:

true