Package ucar.unidata.geoloc

Interface Projection

All Known Implementing Classes:

AlbersEqualArea, AlbersEqualAreaEllipse, CylindricalEqualAreaProjection, EquidistantAzimuthalProjection, FlatEarth, Geostationary, LambertAzimuthalEqualArea, LambertConformal, LambertConformalConicEllipse, LatLonProjection, McIDASAreaProjection, Mercator, MSGnavigation, Orthographic, PolyconicProjection, ProjectionAdapter, ProjectionImpl, RotatedLatLon, RotatedPole, Sinusoidal, Stereographic, StereographicAzimuthalProjection, TransverseMercator, TransverseMercatorProjection, UtmProjection, VerticalPerspectiveView

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	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()	Deprecated. Do not use.
String	getName()	The name of this projection.
List<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.
ProjectionPoint	latLonToProj(LatLonPoint latlon, ProjectionPointImpl result)	Deprecated. use latLonToProj(LatLonPoint latlon)
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.
default LatLonPoint	projToLatLon(double x, double y)	Convert projection x, y to LatLonPoint point.
LatLonPoint	projToLatLon(ProjectionPoint ppt)	Convert projection coordinates to a LatLonPoint.
LatLonPoint	projToLatLon(ProjectionPoint ppt, LatLonPointImpl result)	Deprecated. use projToLatLon(ProjectionPoint ppt)
LatLonRect	projToLatLonBB(ProjectionRect bb)	Deprecated. use Projections.projToLatLonBB(Projection proj, ...)

Method Detail

getClassName

String getClassName()

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

getName

String getName()

The name of this projection.

isLatLon

boolean isLatLon()

Is this the lat/lon Projection ?

paramsToString

String paramsToString()

String representation of the projection parameters.

latLonToProj

@Deprecated
ProjectionPoint latLonToProj(LatLonPoint latlon,
                             ProjectionPointImpl result)

Deprecated.

use latLonToProj(LatLonPoint latlon)

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

projToLatLon

@Deprecated
LatLonPoint projToLatLon(ProjectionPoint ppt,
                         LatLonPointImpl result)

Deprecated.

use projToLatLon(ProjectionPoint ppt)

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

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

@Deprecated
ProjectionRect getDefaultMapArea()

Deprecated.

Do not use.

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 TODO will return ImmutableList in ver6

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

projToLatLonBB

LatLonRect projToLatLonBB(ProjectionRect bb)

Deprecated.

use Projections.projToLatLonBB(Projection proj, ...)

Compute lat/lon bounding box from projection bounding box.

Parameters:

bb - projection bounding box

Returns:

lat, lon bounding box.