ucar.unidata.geoloc.projection

Class LatLonProjection

java.lang.Object

ucar.unidata.geoloc.projection.AbstractProjection

ucar.unidata.geoloc.projection.LatLonProjection

All Implemented Interfaces:

Projection

@Immutable
public class LatLonProjection
extends AbstractProjection

This is the "fake" identity projection where world coord = latlon coord. Topologically its the same as a cylinder tangent to the earth at the equator. The cylinder is cut at the "seam" = centerLon +- 180. Longitude values are always kept in the range [centerLon +-180]

Field Summary

Fields inherited from class ucar.unidata.geoloc.projection.AbstractProjection

atts, 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
LatLonProjection()
LatLonProjection(Earth earth)
LatLonProjection(String name)
LatLonProjection(String name, Earth earth, double centerLon)

Method Summary

Modifier and Type	Method and Description
Projection	constructCopy() copy constructor - avoid clone !!
boolean	crossSeam(ProjectionPoint pt1, ProjectionPoint pt2) Does the line between these two points cross the projection "seam".
boolean	equals(Object o) See if this projection equals the object in question
double	getCenterLon() Get the center of the Longitude range.
Earth	getEarth() Get the Earth used in this projection.
String	getProjectionTypeLabel() Get the label to be used in the gui for this type of projection
int	hashCode()
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.
ProjectionRect[]	latLonToProjRect(double lat0, double lon0, double lat1, double lon1) Create a latlon rectangle from two points.
ProjectionRect[]	latLonToProjRect(LatLonRect latlonR) Split a latlon rectangle to the equivalent ProjectionRect(s).
String	paramsToString() Get a String of the parameters
LatLonPoint	projToLatLon(ProjectionPoint world) Convert projection coordinates to a LatLonPoint.
LatLonRect	projToLatLonBB(ProjectionRect world) Compute lat/lon bounding box from projection bounding box.

Methods inherited from class ucar.unidata.geoloc.projection.AbstractProjection

addParameter, addParameter, addParameter, addParameter, findProjectionParameter, getClassName, getHeader, getMinOrMaxLon, getName, getProjectionAttributes, getProjectionParameters, isLatLon, 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

Constructor Detail

LatLonProjection

public LatLonProjection()

LatLonProjection

public LatLonProjection(String name)

LatLonProjection

public LatLonProjection(Earth earth)

LatLonProjection

public LatLonProjection(String name,
                        @Nullable
                        Earth earth,
                        double centerLon)

Method Detail

constructCopy

public Projection constructCopy()

Description copied from class: AbstractProjection

copy constructor - avoid clone !!

Specified by:

constructCopy in class AbstractProjection

Returns:

a copy of this Projection.

getProjectionTypeLabel

public String getProjectionTypeLabel()

Get the label to be used in the gui for this type of projection

Overrides:

getProjectionTypeLabel in class AbstractProjection

Returns:

Type label

paramsToString

public String paramsToString()

Get a String of the parameters

Specified by:

paramsToString in interface Projection

Specified by:

paramsToString in class AbstractProjection

Returns:

a String of the parameters

equals

public boolean equals(Object o)

See if this projection equals the object in question

Overrides:

equals in class Object

Parameters:

o - object in question

Returns:

true if it is a LatLonProjection and covers the same area

hashCode

public int hashCode()

Overrides:

hashCode in class Object

latLonToProj

public ProjectionPoint latLonToProj(LatLonPoint latlon)

Description copied from interface: Projection

Convert a LatLonPoint to projection coordinates.

projToLatLon

public LatLonPoint projToLatLon(ProjectionPoint world)

Description copied from interface: Projection

Convert projection coordinates to a LatLonPoint.

getCenterLon

public double getCenterLon()

Get the center of the Longitude range. It is normalized to +/- 180.

getEarth

public Earth getEarth()

Get the Earth used in this projection.

crossSeam

public boolean crossSeam(ProjectionPoint pt1,
                         ProjectionPoint pt2)

Does the line between these two points cross the projection "seam".

Parameters:

pt1 - the line goes between these two points

pt2 - the line goes between these two points

Returns:

false if there is no seam

projToLatLonBB

public LatLonRect projToLatLonBB(ProjectionRect world)

Description copied from interface: Projection

Compute lat/lon bounding box from projection bounding box.

Specified by:

projToLatLonBB in interface Projection

Overrides:

projToLatLonBB in class AbstractProjection

Parameters:

world - projection bounding box

Returns:

lat, lon bounding box.

latLonToProjBB

public ProjectionRect latLonToProjBB(LatLonRect latlonRect)

Description copied from interface: Projection

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.

Specified by:

latLonToProjBB in interface Projection

Overrides:

latLonToProjBB in class AbstractProjection

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

latLonToProjRect

public ProjectionRect[] latLonToProjRect(LatLonRect latlonR)

Split a latlon rectangle to the equivalent ProjectionRect(s). using this LatLonProjection to split it at the seam if needed.

Parameters:

latlonR - the latlon rectangle to transform

Returns:

1 or 2 ProjectionRect. If it doesnt cross the seam, the second rectangle is null. see latLonToProjRect(double, double, double, double)

latLonToProjRect

public ProjectionRect[] latLonToProjRect(double lat0,
                                         double lon0,
                                         double lat1,
                                         double lon1)

Create a latlon rectangle from two points. The ending point is always to the east of the starting point. The longitudes do not have to be normalized to +-180. Using the center longitude of this projection, split into 2 rectangles if the rectangle crosses the seam = centerLon + 180.

Parameters:

lat0 - lat of starting point

lon0 - lon of starting point, unnormalized

lat1 - lat of ending point

lon1 - lon of ending point, unnormalized

Returns:

1 or 2 ProjectionRect. If it doesnt cross the seam, the second rectangle is null.