ucar.unidata.geoloc.projection
Class Orthographic

java.lang.Object
  extended by ucar.unidata.geoloc.ProjectionImpl
      extended by ucar.unidata.geoloc.projection.Orthographic
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, Projection

public class Orthographic
extends ProjectionImpl

Orthographic Projection spherical earth.

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

Author:
Unidata Development Team
See Also:
Projection, ProjectionImpl, Serialized Form

Field Summary
 
Fields inherited from class ucar.unidata.geoloc.ProjectionImpl
ATTR_NAME, EARTH_RADIUS, INDEX_LAT, INDEX_LON, INDEX_X, INDEX_Y, PI, PI_OVER_2, PI_OVER_4
 
Constructor Summary
Orthographic()
          Constructor with default parameters
Orthographic(double lat0, double lon0)
          Construct a Orthographic Projection.
Orthographic(double lat0, double lon0, double earthRadius)
          Construct a Orthographic Projection, two standard parellels.
 
Method Summary
 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 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
static void main(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 setOriginLat(double lat)
          Set the origin latitude.
 void setOriginLon(double lon)
          Set the origin longitude.
 
Methods inherited from class ucar.unidata.geoloc.ProjectionImpl
getClassName, getDefaultMapArea, getDefaultMapAreaLL, getHeader, getLatLonBoundingBox, getName, getProjectionParameters, isLatLon, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProj, latLonToProjBB, projToLatLon, projToLatLon, projToLatLon, projToLatLon, projToLatLonBB, setDefaultMapArea, setName, toString
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Orthographic

public Orthographic()
Constructor with default parameters


Orthographic

public Orthographic(double lat0,
                    double lon0)
Construct a Orthographic Projection.

Parameters:
lat0 - lat origin of the coord. system on the projection plane
lon0 - lon origin of the coord. system on the projection plane
Throws:
java.lang.IllegalArgumentException

Orthographic

public Orthographic(double lat0,
                    double lon0,
                    double earthRadius)
Construct a Orthographic Projection, two standard parellels. For the one standard parellel case, set them both to the same value.

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
Throws:
java.lang.IllegalArgumentException - if lat0, par1, par2 = +/-90 deg
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.

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

main

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

Parameters:
args - not used