ucar.unidata.geoloc.projection

Class UnstructuredProjection

java.lang.Object

ucar.unidata.geoloc.ProjectionImpl

ucar.unidata.geoloc.projection.UnstructuredProjection

All Implemented Interfaces:

java.io.Serializable, Projection

public class UnstructuredProjection
extends ProjectionImpl

A dummy ProjectionImpl subclass for unstructured grids. Since unstructured grids do not follow a single mathematical projection, this class does not implement real forward/inverse transformations. Instead, it serves as a placeholder so netCDF-Java can represent the grid in a coordinate system, while actual lat/lon positions are handled separately (e.g., by per-cell coordinate arrays).

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EARTH_SHAPE
static java.lang.String	NUMBER_OF_GRID_IN_REFERENCE
static java.lang.String	NUMBER_OF_GRID_USED
static java.lang.String	UUID

Fields inherited from class ucar.unidata.geoloc.ProjectionImpl

atts, defaultMapArea, defaultUnits, EARTH_RADIUS, INDEX_LAT, INDEX_LON, INDEX_X, INDEX_Y, isLatLon, name, PI, PI_OVER_2, PI_OVER_4, TOLERANCE

Constructor Summary

Constructors

Constructor and Description
UnstructuredProjection(int earthShape, int numberOfGridUsed, int numberOfGridInReference, java.lang.String uuid) Create a new UnstructuredProjection with a given name.

Method Summary

Modifier and Type	Method and Description
ProjectionImpl	constructCopy() copy constructor - avoid clone !!
boolean	crossSeam(ProjectionPoint pt1, ProjectionPoint pt2) For unstructured grids, the notion of crossing a seam is irrelevant, so we return false (or you could throw an exception).
boolean	equals(java.lang.Object o) Returns true if this represents the same Projection as proj.
int	hashCode()
ProjectionPoint	latLonToProj(LatLonPoint latlon, ProjectionPointImpl dest) Since we do not have a formula for an unstructured grid, throw an exception if someone tries to do forward transform.
java.lang.String	paramsToString() Get a string representation of the projection parameters
LatLonPoint	projToLatLon(ProjectionPoint world, LatLonPointImpl dest) Similarly, inverse transform is not defined for unstructured grids.

Methods inherited from class ucar.unidata.geoloc.ProjectionImpl

addParameter, addParameter, addParameter, findProjectionParameter, getClassName, getDefaultMapArea, getDefaultMapAreaLL, getDefaultUnits, getHeader, getName, getProjectionParameters, getProjectionTypeLabel, isLatLon, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProjBB, projToLatLon, projToLatLon, projToLatLon, projToLatLon, projToLatLon, projToLatLonBB, projToLatLonBBold, setDefaultMapArea, setName, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.unidata.geoloc.Projection

latLonToProj, projToLatLon

Field Detail

EARTH_SHAPE

public static final java.lang.String EARTH_SHAPE

See Also:

Constant Field Values

NUMBER_OF_GRID_USED

public static final java.lang.String NUMBER_OF_GRID_USED

See Also:

Constant Field Values

NUMBER_OF_GRID_IN_REFERENCE

public static final java.lang.String NUMBER_OF_GRID_IN_REFERENCE

See Also:

Constant Field Values

UUID

public static final java.lang.String UUID

See Also:

Constant Field Values

Constructor Detail

UnstructuredProjection

public UnstructuredProjection(int earthShape,
                              int numberOfGridUsed,
                              int numberOfGridInReference,
                              java.lang.String uuid)

Create a new UnstructuredProjection with a given name.

Method Detail

constructCopy

public ProjectionImpl constructCopy()

Description copied from class: ProjectionImpl

copy constructor - avoid clone !!

Specified by:

constructCopy in class ProjectionImpl

Returns:

a copy of this Projection. TODO return Projection in ver6

latLonToProj

public ProjectionPoint latLonToProj(LatLonPoint latlon,
                                    ProjectionPointImpl dest)

Since we do not have a formula for an unstructured grid, throw an exception if someone tries to do forward transform.

Specified by:

latLonToProj in interface Projection

Specified by:

latLonToProj in class ProjectionImpl

Parameters:

latlon - convert from these lat, lon coordinates

dest - the object to write to

Returns:

the given destPoint

projToLatLon

public LatLonPoint projToLatLon(ProjectionPoint world,
                                LatLonPointImpl dest)

Similarly, inverse transform is not defined for unstructured grids.

Specified by:

projToLatLon in interface Projection

Specified by:

projToLatLon in class ProjectionImpl

Parameters:

world - convert from these projection coordinates

dest - the object to write to

Returns:

LatLonPoint convert to these lat/lon coordinates

crossSeam

public boolean crossSeam(ProjectionPoint pt1,
                         ProjectionPoint pt2)

For unstructured grids, the notion of crossing a seam is irrelevant, so we return false (or you could throw an exception).

Specified by:

crossSeam in interface Projection

Specified by:

crossSeam in class ProjectionImpl

Parameters:

pt1 - the line goes between these two points

pt2 - the line goes between these two points

Returns:

false if there is no seam

paramsToString

public java.lang.String paramsToString()

Description copied from class: ProjectionImpl

Get a string representation of the projection parameters

Specified by:

paramsToString in interface Projection

Specified by:

paramsToString in class ProjectionImpl

Returns:

string representation of the projection parameters

equals

public boolean equals(java.lang.Object o)

Description copied from class: ProjectionImpl

Returns true if this represents the same Projection as proj.

Specified by:

equals in interface Projection

Specified by:

equals in class ProjectionImpl

Parameters:

o - projection in question

Returns:

true if this represents the same Projection as proj.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object