ucar.unidata.geoloc.projection.sat

Class VerticalPerspectiveView

java.lang.Object

ucar.unidata.geoloc.projection.AbstractProjection

ucar.unidata.geoloc.projection.sat.VerticalPerspectiveView

All Implemented Interfaces:

Projection

@Immutable
public class VerticalPerspectiveView
extends AbstractProjection

Vertical Perspective Projection, spherical earth.

See John Snyder, Map Projections used by the USGS, Bulletin 1532, 2nd edition (1983), p 176

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
VerticalPerspectiveView() Constructor with default parameters
VerticalPerspectiveView(double lat0, double lon0, double earthRadius, double distance) Construct a VerticalPerspectiveView Projection
VerticalPerspectiveView(double lat0, double lon0, double earthRadius, double distance, double false_easting, double false_northing) Construct a VerticalPerspectiveView Projection

Method Summary

Modifier and Type	Method and Description
Projection	constructCopy() copy constructor - avoid clone !!
boolean	crossSeam(ProjectionPoint pt1, ProjectionPoint pt2) This returns true when the line between pt1 and pt2 crosses the seam.
boolean	equals(Object o)
double	getHeight() Get the height above the earth
double	getOriginLat() Get the origin latitude in degrees
double	getOriginLon() Get the origin longitude in degrees
double	getP()
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 rect) Create a ProjectionRect from the given LatLonRect.
String	paramsToString() Create a String of the parameters.
LatLonPoint	projToLatLon(ProjectionPoint world) Convert projection coordinates to a LatLonPoint.
String	toString() Get a String representation of this projection.

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

addParameter, addParameter, addParameter, addParameter, findProjectionParameter, getClassName, getHeader, getMinOrMaxLon, getName, getProjectionAttributes, getProjectionParameters, isLatLon, projToLatLonBB

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

VerticalPerspectiveView

public VerticalPerspectiveView()

Constructor with default parameters

VerticalPerspectiveView

public VerticalPerspectiveView(double lat0,
                               double lon0,
                               double earthRadius,
                               double distance)

Construct a VerticalPerspectiveView Projection

Parameters:

lat0 - lat origin of the coord. system on the projection plane

lon0 - lon origin of the coord. system on the projection plane

earthRadius - radius of the earth (km)

distance - height above the earth (km)

VerticalPerspectiveView

public VerticalPerspectiveView(double lat0,
                               double lon0,
                               double earthRadius,
                               double distance,
                               double false_easting,
                               double false_northing)

Construct a VerticalPerspectiveView Projection

Parameters:

lat0 - lat origin of the coord. system on the projection plane

lon0 - lon origin of the coord. system on the projection plane

earthRadius - radius of the earth (km)

distance - height above the earth (km)

false_easting - easting offset (km)

false_northing - northing offset (km)

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.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getHeight

public double getHeight()

Get the height above the earth

Returns:

the height above the earth

getOriginLon

public double getOriginLon()

Get the origin longitude in degrees

Returns:

the origin longitude.

getOriginLat

public double getOriginLat()

Get the origin latitude in degrees

Returns:

the origin latitude.

getP

public double getP()

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()

Create a String of the parameters.

Specified by:

paramsToString in interface Projection

Specified by:

paramsToString in class AbstractProjection

Returns:

a String of the parameters

toString

public String toString()

Description copied from class: AbstractProjection

Get a String representation of this projection.

Overrides:

toString in class AbstractProjection

Returns:

the name of the projection. This is what gets displayed when you add the projection object to a UI widget (e.g. label, combobox)

crossSeam

public boolean crossSeam(ProjectionPoint pt1,
                         ProjectionPoint pt2)

This returns true when the line between pt1 and pt2 crosses the seam. When the cone is flattened, the "seam" is lon0 +- 180.

Parameters:

pt1 - point 1

pt2 - point 2

Returns:

true when the line between pt1 and pt2 crosses the seam.

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.

latLonToProjBB

public ProjectionRect latLonToProjBB(LatLonRect rect)

Create a ProjectionRect from the given LatLonRect. Handles lat/lon points that do not intersect the projection panel.

Specified by:

latLonToProjBB in interface Projection

Overrides:

latLonToProjBB in class AbstractProjection

Parameters:

rect - the LatLonRect

Returns:

ProjectionRect, or null if no part of the LatLonRect intersects the projection plane