ucar.unidata.geoloc

Interface Projection

public interface Projection

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

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(java.lang.Object proj) Check for equality with the object in question
java.lang.String	getClassName() The name of this class of projections, eg "Transverse Mercator".
java.lang.String	getName() The name of this projection.
java.util.List<ucar.unidata.util.Parameter>	getProjectionParameters() Get parameters as list of ucar.unidata.util.Parameter
boolean	isLatLon() Is this the lat/lon Projection ?
default ProjectionPoint	latLonToProj(double lat, double lon) Convert lat, lon to Projection point.
ProjectionPoint	latLonToProj(LatLonPoint latlon) 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.
java.lang.String	paramsToString() String representation of the projection parameters.
default LatLonPoint	projToLatLon(double x, double y) Convert projection x, y to LatLonPoint point.
LatLonPoint	projToLatLon(ProjectionPoint ppt) Convert projection coordinates to a LatLonPoint.

Method Detail

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.

equals

boolean equals(java.lang.Object proj)

Check for equality with the object in question

Overrides:

equals in class java.lang.Object

Parameters:

proj - projection to check

Returns:

true if this represents the same Projection as proj.

getClassName

java.lang.String getClassName()

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

getName

java.lang.String getName()

The name of this projection.

getProjectionParameters

java.util.List<ucar.unidata.util.Parameter> getProjectionParameters()

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

Returns:

List of parameters TODO will return ImmutableList in ver6

isLatLon

boolean isLatLon()

Is this the lat/lon Projection ?

latLonToProj

default ProjectionPoint latLonToProj(double lat,
                                     double lon)

Convert lat, lon to Projection point.

latLonToProj

ProjectionPoint latLonToProj(LatLonPoint latlon)

Convert a LatLonPoint to projection coordinates.

Parameters:

latlon - convert from these lat, lon coordinates

Returns:

ProjectionPoint convert to these projection coordinates

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

paramsToString

java.lang.String paramsToString()

String representation of the projection parameters.

projToLatLon

default LatLonPoint projToLatLon(double x,
                                 double y)

Convert projection x, y to LatLonPoint point.

projToLatLon

LatLonPoint projToLatLon(ProjectionPoint ppt)

Convert projection coordinates to a LatLonPoint.

Parameters:

ppt - convert from these projection coordinates

Returns:

lat/lon coordinates