ucar.unidata.geoloc

Interface Projection

All Known Implementing Classes:

ProjectionImpl

public interface Projection

Projective geometry transformations from (lat,lon) to (x,y) on a projective cartesian surface.

Method Summary

Modifier and Type	Method and Description
boolean	crossSeam(ProjectionPoint pt1, ProjectionPoint pt2) Does the line between these two points cross the projection "seam", which is a discontinuity in the function latlon <-> projection plane
boolean	equals(Object proj) Check for equality with the object in question
String	getClassName() The name of this class of projections, eg "Transverse Mercator".
ProjectionRect	getDefaultMapArea() Get a reasonable bounding box in this projection.
String	getName() The name of this projection.
List<Parameter>	getProjectionParameters() Get parameters as list of ucar.unidata.util.Parameter
ProjectionPoint	latLonToProj(LatLonPoint latlon, ProjectionPointImpl result) Convert a LatLonPoint to projection coordinates.
ProjectionRect	latLonToProjBB(LatLonRect latlonRect) Convert a lat/lon bounding box to a world coordinate bounding box, by finding the minimum enclosing box.
String	paramsToString() String representation of the projection parameters.
LatLonPoint	projToLatLon(ProjectionPoint ppt, LatLonPointImpl result) Convert projection coordinates to a LatLonPoint.

Method Detail

getClassName

String getClassName()

The name of this class of projections, eg "Transverse Mercator".

Returns:

the class name

getName

String getName()

The name of this projection.

Returns:

the name of this projection

paramsToString

String paramsToString()

String representation of the projection parameters.

Returns:

String representation of the projection parameters.

latLonToProj

ProjectionPoint latLonToProj(LatLonPoint latlon,
                             ProjectionPointImpl result)

Convert a LatLonPoint to projection coordinates. Note: do not assume a new object is created on each call for the return value.

Parameters:

latlon - convert from these lat, lon coordinates

result - point to put result in

Returns:

ProjectionPoint convert to these projection coordinates

projToLatLon

LatLonPoint projToLatLon(ProjectionPoint ppt,
                         LatLonPointImpl result)

Convert projection coordinates to a LatLonPoint. Note: do not assume a new object is created on each call for the return value.

Parameters:

ppt - convert from these projection coordinates

result - return result here, or null

Returns:

lat/lon coordinates

crossSeam

boolean crossSeam(ProjectionPoint pt1,
                  ProjectionPoint pt2)

Does the line between these two points cross the projection "seam", which is a discontinuity in the function latlon <-> projection plane

Parameters:

pt1 - the line goes between these two points

pt2 - the line goes between these two points

Returns:

false if there is no seam, or the line does not cross it.

getDefaultMapArea

ProjectionRect getDefaultMapArea()

Get a reasonable bounding box in this projection. Projections are typically specific to an area of the world; theres no bounding box that works for all projections.

Returns:

a reasonable bounding box in this projection.

equals

boolean equals(Object proj)

Check for equality with the object in question

Overrides:

equals in class Object

Parameters:

proj - projection to check

Returns:

true if this represents the same Projection as proj.

getProjectionParameters

List<Parameter> getProjectionParameters()

Get parameters as list of ucar.unidata.util.Parameter

Returns:

List of parameters

latLonToProjBB

ProjectionRect latLonToProjBB(LatLonRect latlonRect)

Convert a lat/lon bounding box to a world coordinate bounding box, by finding the minimum enclosing box. Handles lat/lon points that do not intersect the projection panel.

Parameters:

latlonRect - input lat,lon bounding box

Returns:

minimum enclosing box in world coordinates, or null if no part of the LatLonRect intersects the projection plane