ucar.unidata.geoloc.projection

Class VerticalPerspectiveView

java.lang.Object

ucar.unidata.geoloc.ProjectionImpl

ucar.unidata.geoloc.projection.VerticalPerspectiveView

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Projection

public class VerticalPerspectiveView
extends ProjectionImpl

Vertical Perspective Projection, spherical earth.

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

Author:

Unidata Development Team

See Also:

Projection, ProjectionImpl, Serialized Form

Field Summary

Fields inherited from class ucar.unidata.geoloc.ProjectionImpl

ATTR_NAME, atts, defaultMapArea, 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) Construct a VerticalPerspectiveView Projection.
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

Methods

Modifier and Type	Method and Description
java.lang.Object	clone() Clone this projection.
ProjectionImpl	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(java.lang.Object proj) Check for equality with the Object in question
double	getHeight() Get the height above the earth
double	getOriginLat() Get the origin latitude.
double	getOriginLon() Get the origin longitude.
java.lang.String	getProjectionTypeLabel() Get the label to be used in the gui for this type of projection
double[][]	latLonToProj(double[][] from, double[][] to, int latIndex, int lonIndex) Convert lat/lon coordinates to projection coordinates.
float[][]	latLonToProj(float[][] from, float[][] to, int latIndex, int lonIndex) Convert lat/lon coordinates to projection coordinates.
ProjectionPoint	latLonToProj(LatLonPoint latLon, ProjectionPointImpl result) Convert a LatLonPoint to projection coordinates
ProjectionRect	latLonToProjBB(LatLonRect rect) Create a ProjectionRect from the given LatLonRect.
static void	main(java.lang.String[] args)
static void	main2(java.lang.String[] args) Test
java.lang.String	paramsToString() Create a String of the parameters.
double[][]	projToLatLon(double[][] from, double[][] to) Convert lat/lon coordinates to projection coordinates.
float[][]	projToLatLon(float[][] from, float[][] to) Convert lat/lon coordinates to projection coordinates.
LatLonPoint	projToLatLon(ProjectionPoint world, LatLonPointImpl result) Convert projection coordinates to a LatLonPoint Note: a new object is not created on each call for the return value.
void	setHeight(double height) Set the height above the earth
void	setOriginLat(double lat) Set the origin latitude.
void	setOriginLon(double lon) Set the origin longitude.

Methods inherited from class ucar.unidata.geoloc.ProjectionImpl

addParameter, addParameter, addParameter, getClassName, getDefaultMapArea, getDefaultMapAreaLL, getHeader, getLatLonBoundingBox, getName, getProjectionParameters, isLatLon, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, projToLatLon, projToLatLon, projToLatLon, projToLatLon, projToLatLonBB, setDefaultMapArea, setName, toString

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

VerticalPerspectiveView

public VerticalPerspectiveView()

Constructor with default parameters

VerticalPerspectiveView

public VerticalPerspectiveView(double lat0,
                       double lon0)

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

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

copy constructor - avoid clone !!

Specified by:

constructCopy in class ProjectionImpl

Returns:

a copy of this Projection

clone

public java.lang.Object clone()

Clone this projection.

Overrides:

clone in class ProjectionImpl

Returns:

Clone of this

equals

public boolean equals(java.lang.Object proj)

Check for equality with the Object in question

Specified by:

equals in interface Projection

Specified by:

equals in class ProjectionImpl

Parameters:

proj - object to check

Returns:

true if they are equal

getOriginLon

public double getOriginLon()

Get the origin longitude.

Returns:

the origin longitude.

setOriginLon

public void setOriginLon(double lon)

Set the origin longitude.

Parameters:

lon - the origin longitude.

getHeight

public double getHeight()

Get the height above the earth

Returns:

the height above the earth

setHeight

public void setHeight(double height)

Set the height above the earth

Parameters:

height - height above the earth

getOriginLat

public double getOriginLat()

Get the origin latitude.

Returns:

the origin latitude.

setOriginLat

public void setOriginLat(double lat)

Set the origin latitude.

Parameters:

lat - the origin latitude.

getProjectionTypeLabel

public java.lang.String getProjectionTypeLabel()

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

Overrides:

getProjectionTypeLabel in class ProjectionImpl

Returns:

Type label

paramsToString

public java.lang.String paramsToString()

Create a String of the parameters.

Specified by:

paramsToString in interface Projection

Specified by:

paramsToString in class ProjectionImpl

Returns:

a String of the parameters

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.

Specified by:

crossSeam in interface Projection

Specified by:

crossSeam in class ProjectionImpl

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,
                           ProjectionPointImpl result)

Convert a LatLonPoint to projection coordinates

Specified by:

latLonToProj in interface Projection

Specified by:

latLonToProj in class ProjectionImpl

Parameters:

latLon - convert from these lat, lon coordinates

result - the object to write to

Returns:

the given result

projToLatLon

public LatLonPoint projToLatLon(ProjectionPoint world,
                       LatLonPointImpl result)

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

Specified by:

projToLatLon in interface Projection

Specified by:

projToLatLon in class ProjectionImpl

Parameters:

world - convert from these projection coordinates

result - the object to write to

Returns:

LatLonPoint convert to these lat/lon coordinates

latLonToProj

public float[][] latLonToProj(float[][] from,
                     float[][] to,
                     int latIndex,
                     int lonIndex)

Convert lat/lon coordinates to projection coordinates.

Overrides:

latLonToProj in class ProjectionImpl

Parameters:

from - array of lat/lon coordinates: from[2][n], where from[0][i], from[1][i] is the (lat,lon) coordinate of the ith point

to - resulting array of projection coordinates, where to[0][i], to[1][i] is the (x,y) coordinate of the ith point

latIndex - index of latitude in "from"

lonIndex - index of longitude in "from"

Returns:

the "to" array.

projToLatLon

public float[][] projToLatLon(float[][] from,
                     float[][] to)

Convert lat/lon coordinates to projection coordinates.

Overrides:

projToLatLon in class ProjectionImpl

Parameters:

from - array of lat/lon coordinates: from[2][n], where (from[0][i], from[1][i]) is the (lat,lon) coordinate of the ith point

to - resulting array of projection coordinates: to[2][n] where (to[0][i], to[1][i]) is the (x,y) coordinate of the ith point

Returns:

the "to" array

latLonToProj

public double[][] latLonToProj(double[][] from,
                      double[][] to,
                      int latIndex,
                      int lonIndex)

Convert lat/lon coordinates to projection coordinates.

Overrides:

latLonToProj in class ProjectionImpl

Parameters:

from - array of lat/lon coordinates: from[2][n], where from[0][i], from[1][i] is the (lat,lon) coordinate of the ith point

to - resulting array of projection coordinates, where to[0][i], to[1][i] is the (x,y) coordinate of the ith point

latIndex - index of latitude in "from"

lonIndex - index of longitude in "from"

Returns:

the "to" array.

projToLatLon

public double[][] projToLatLon(double[][] from,
                      double[][] to)

Convert lat/lon coordinates to projection coordinates.

Overrides:

projToLatLon in class ProjectionImpl

Parameters:

from - array of lat/lon coordinates: from[2][n], where (from[0][i], from[1][i]) is the (lat,lon) coordinate of the ith point

to - resulting array of projection coordinates: to[2][n] where (to[0][i], to[1][i]) is the (x,y) coordinate of the ith point

Returns:

the "to" array

latLonToProjBB

public ProjectionRect latLonToProjBB(LatLonRect rect)

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

Overrides:

latLonToProjBB in class ProjectionImpl

Parameters:

rect - the LatLonRect

Returns:

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

main2

public static void main2(java.lang.String[] args)

Test

Parameters:

args - not used

main

public static void main(java.lang.String[] args)