| org.jscience.geography.coordinates.UTM
| UTM | | final public class UTM extends Coordinates> (Code) | | This class represents the
ProjectedCRS projected Universal Transverse Mercator (UTM) coordinates onto the WGS84 ellipsoid.
The UTM system is limited to values between -80 and +84 degrees latitude.
Values beyond these limits (i.e., the polar regions) are projected
using the Universal Polar Stereographic (UPS) projection. Although
mathematically distinct, the two projections are represented identically.
This class returns correct results for both UTM and UPS projections.
The conversion routines for this class were derived from formulas described
in the
Defense Mapping Agency Technical Manual 8358.2.
author:
Paul D. Anderson
version:
3.0, February 25, 2006
See Also:
* Wikipedia: Universal Transverse Mercator Coordinate System |
| Method Summary | |
| public UTM | copy()
| | final public double | eastingValue(Unit<Length> unit)
Returns the projected distance of the position from the central meridian.
Parameters:
unit - the length unit of the easting to return. | | public static double | getCentralMeridian(int longitudeZone, char latitudeZone)
Returns the central meridian (in radians) for the specified
UTM/UPS zone.
Parameters:
longitudeZone - The UTM/UPS longitude zone number.
Parameters:
latitudeZone - The UTM/UPS latitude zone character. | | public ProjectedCRS<UTM> | getCoordinateReferenceSystem()
| | public int | getDimension()
| | public static char | getLatitudeZone(LatLong latLong)
Returns the UTM/UPS latitude zone identifier for the specified coordinates.
Parameters:
latLong - The coordinates. | | public static int | getLongitudeZone(LatLong latLong)
Returns the UTM/UPS longitude zone number for the specified
coordinates.
Parameters:
latLong - The coordinates. | | public double | getOrdinate(int dimension)
| | public static boolean | isNorthPolar(LatLong latLong)
Returns true if the position indicated by the coordinates is
north of the northern limit of the UTM grid (84 degrees).
Parameters:
latLong - The coordinates. | | public static boolean | isSouthPolar(LatLong latLong)
Returns true if the position indicated by the coordinates is
south of the southern limit of the UTM grid (-80 degrees).
Parameters:
latLong - The coordinates. | | public static UTM | latLongToUps(LatLong latLong, ReferenceEllipsoid ellipsoid)
Converts latitude/longitude coordinates to UPS coordinates based on
the specified reference ellipsoid.
Parameters:
latLong - The latitude/longitude coordinates.
Parameters:
ellipsoid - The reference ellipsoid. | | public static UTM | latLongToUtm(LatLong latLong, ReferenceEllipsoid ellipsoid)
Converts latitude/longitude coordinates to UTM coordinates based on
the specified reference ellipsoid.
Parameters:
latLong - The latitude/longitude coordinates.
Parameters:
ellipsoid - The reference ellipsoid. | | final public char | latitudeZone()
Returns the latitude zone identifier. | | final public int | longitudeZone()
Returns the longitude zone identifier. | | final public double | northingValue(Unit<Length> unit)
Returns the projected distance of the point from the equator.
Parameters:
unit - the length unit of the northing to return. | | public static LatLong | upsToLatLong(UTM ups, ReferenceEllipsoid ellipsoid)
Converts the UPS coordinates to latitude/longitude coordinates,
based on the specified reference ellipsoid.
Parameters:
ups - The UPS coordinates.
Parameters:
ellipsoid - The reference ellipsoid. | | public static LatLong | utmToLatLong(UTM utm, ReferenceEllipsoid ellipsoid)
Converts the UTM coordinates to latitude/longitude coordinates,
based on the specified reference ellipsoid.
Parameters:
utm - The UTM coordinates.
Parameters:
ellipsoid - The reference ellipsoid. | | public static UTM | valueOf(int longitudeZone, char latitudeZone, double easting, double northing, Unit<Length> unit)
Returns the projected UTM position corresponding to the specified
coordinates.
Parameters:
longitudeZone - the longitude zone number.
Parameters:
latitudeZone - the longitude zone character.
Parameters:
easting - the easting value stated in the specified unit.
Parameters:
northing - the northing value stated in the specified unit.
Parameters:
unit - the easting/northing length unit. |
| CRS | | final public static ProjectedCRS<UTM> CRS(Code) | | Holds the coordinate reference system for all instances of this class.
|
| UPS_FALSE_EASTING | | public static Measure<Integer, Length> UPS_FALSE_EASTING(Code) | | The UPS "false easting" value. This quantity is added to the true
easting to avoid using negative numbers in the coordinates.
|
| UPS_FALSE_NORTHING | | public static Measure<Integer, Length> UPS_FALSE_NORTHING(Code) | | The UPS "false northing" value. This quantity is added to the true
northing to avoid using negative numbers in the coordinates.
The UPS system, unlike the UTM system, always includes the false northing.
|
| UPS_SCALE_FACTOR | | final public static double UPS_SCALE_FACTOR(Code) | | The UPS scale factor.
|
| UTM_FALSE_EASTING | | public static Measure<Integer, Length> UTM_FALSE_EASTING(Code) | | The UTM "false easting" value. This quantity is added to the true
easting to avoid using negative numbers in the coordinates.
|
| UTM_FALSE_NORTHING | | public static Measure<Integer, Length> UTM_FALSE_NORTHING(Code) | | The UTM "false northing" value. This quantity is added to the true
northing for coordinates in the southern hemisphere only
to avoid using negative numbers in the coordinates.
|
| UTM_NORTHERN_LIMIT | | final public static Measure<Integer, Angle> UTM_NORTHERN_LIMIT(Code) | | The northern limit of the UTM grid. Beyond this limit the distortion
introduced by the transverse Mercator projection is impractically
large, and the UPS grid is used instead.
|
| UTM_SCALE_FACTOR | | final public static double UTM_SCALE_FACTOR(Code) | | The UTM scale factor. This the exact scale factor only on a pair of
lines lying either side of the central meridian, but the effect is to
reduce overall distortion within the UTM zone to less than one part per
thousand.
|
| UTM_SOUTHERN_LIMIT | | final public static Measure<Integer, Angle> UTM_SOUTHERN_LIMIT(Code) | | The southern limit of the UTM grid. Beyond this limit the distortion
introduced by the transverse Mercator projection is impractically
large, and the UPS grid is used instead.
|
| eastingValue | | final public double eastingValue(Unit<Length> unit)(Code) | | Returns the projected distance of the position from the central meridian.
Parameters:
unit - the length unit of the easting to return. the easting stated in the specified unit. |
| getCentralMeridian | | public static double getCentralMeridian(int longitudeZone, char latitudeZone)(Code) | | Returns the central meridian (in radians) for the specified
UTM/UPS zone.
Parameters:
longitudeZone - The UTM/UPS longitude zone number.
Parameters:
latitudeZone - The UTM/UPS latitude zone character. The central meridian for the specified zone. |
| getDimension | | public int getDimension()(Code) | | |
| getLatitudeZone | | public static char getLatitudeZone(LatLong latLong)(Code) | | Returns the UTM/UPS latitude zone identifier for the specified coordinates.
Parameters:
latLong - The coordinates. the latitude zone character. |
| getLongitudeZone | | public static int getLongitudeZone(LatLong latLong)(Code) | | Returns the UTM/UPS longitude zone number for the specified
coordinates.
Parameters:
latLong - The coordinates. the longitude zone number. |
| isNorthPolar | | public static boolean isNorthPolar(LatLong latLong)(Code) | | Returns true if the position indicated by the coordinates is
north of the northern limit of the UTM grid (84 degrees).
Parameters:
latLong - The coordinates. True if the latitude is greater than 84 degrees. |
| isSouthPolar | | public static boolean isSouthPolar(LatLong latLong)(Code) | | Returns true if the position indicated by the coordinates is
south of the southern limit of the UTM grid (-80 degrees).
Parameters:
latLong - The coordinates. True if the latitude is less than -80 degrees. |
| latLongToUps | | public static UTM latLongToUps(LatLong latLong, ReferenceEllipsoid ellipsoid)(Code) | | Converts latitude/longitude coordinates to UPS coordinates based on
the specified reference ellipsoid.
Parameters:
latLong - The latitude/longitude coordinates.
Parameters:
ellipsoid - The reference ellipsoid. The UPS coordinates. |
| latLongToUtm | | public static UTM latLongToUtm(LatLong latLong, ReferenceEllipsoid ellipsoid)(Code) | | Converts latitude/longitude coordinates to UTM coordinates based on
the specified reference ellipsoid.
Parameters:
latLong - The latitude/longitude coordinates.
Parameters:
ellipsoid - The reference ellipsoid. The UTM coordinates. |
| latitudeZone | | final public char latitudeZone()(Code) | | Returns the latitude zone identifier.
the latitude zone character. |
| longitudeZone | | final public int longitudeZone()(Code) | | Returns the longitude zone identifier.
the longitude zone number. |
| northingValue | | final public double northingValue(Unit<Length> unit)(Code) | | Returns the projected distance of the point from the equator.
Parameters:
unit - the length unit of the northing to return. the northing stated in the specified unit. |
| upsToLatLong | | public static LatLong upsToLatLong(UTM ups, ReferenceEllipsoid ellipsoid)(Code) | | Converts the UPS coordinates to latitude/longitude coordinates,
based on the specified reference ellipsoid.
Parameters:
ups - The UPS coordinates.
Parameters:
ellipsoid - The reference ellipsoid. The latitude/longitude coordinates. |
| utmToLatLong | | public static LatLong utmToLatLong(UTM utm, ReferenceEllipsoid ellipsoid)(Code) | | Converts the UTM coordinates to latitude/longitude coordinates,
based on the specified reference ellipsoid.
Parameters:
utm - The UTM coordinates.
Parameters:
ellipsoid - The reference ellipsoid. The latitude/longitude coordinates. |
| valueOf | | public static UTM valueOf(int longitudeZone, char latitudeZone, double easting, double northing, Unit<Length> unit)(Code) | | Returns the projected UTM position corresponding to the specified
coordinates.
Parameters:
longitudeZone - the longitude zone number.
Parameters:
latitudeZone - the longitude zone character.
Parameters:
easting - the easting value stated in the specified unit.
Parameters:
northing - the northing value stated in the specified unit.
Parameters:
unit - the easting/northing length unit. the corresponding surface position. |
|
|