Class TransverseMercatorProjection

java.lang.Object

org.locationtech.proj4j.proj.Projection

org.locationtech.proj4j.proj.CylindricalProjection

org.locationtech.proj4j.proj.TransverseMercatorProjection

All Implemented Interfaces:

Serializable, Cloneable

public class TransverseMercatorProjection
extends CylindricalProjection

Transverse Mercator Projection algorithm is taken from the USGS PROJ package.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	isSouth	Indicates whether a Southern Hemisphere UTM zone

Fields inherited from class Projection

a, alpha, DTR, e, ellipsoid, EPS10, es, falseEasting, falseNorthing, fromMetres, geocentric, lonc, maxLatitude, maxLongitude, minLatitude, minLongitude, name, one_es, projectionLatitude, projectionLatitude1, projectionLatitude2, projectionLongitude, rone_es, RTD, scaleFactor, spherical, totalScale, trueScaleLatitude, unit

Constructor Summary

Constructors

Constructor	Description
TransverseMercatorProjection()
TransverseMercatorProjection(Ellipsoid ellipsoid, double lon_0, double lat_0, double k, double x_0, double y_0)	Set up a projection suitable for State Plane Coordinates.

Method Summary

Modifier and Type	Method	Description
Object	clone()
static int	getRowFromNearestParallel(double latitude)
boolean	getSouthernHemisphere()
static int	getZoneFromNearestMeridian(double longitude)
boolean	hasInverse()	Tests whether this projection has an inverse.
void	initialize()	Initialize the projection.
boolean	isRectilinear()	Tests whether under this projection lines of latitude and longitude form a rectangular grid
ProjCoordinate	project(double lplam, double lpphi, ProjCoordinate xy)	Computes the projection of a given point (i.e. from geographics to projection space).
ProjCoordinate	projectInverse(double x, double y, ProjCoordinate out)	Computes the inverse projection of a given point (i.e. from projection space to geographics).
void	setSouthernHemisphere(boolean isSouth)
void	setUTMZone(int zone)
String	toString()

Methods inherited from class Projection

equals, getAlpha, getAxisOrder, getEllipsoid, getEPSGCode, getEquatorRadius, getFalseEasting, getFalseNorthing, getFromMetres, getHeightOfOrbit, getLonC, getMaxLatitude, getMaxLatitudeDegrees, getMaxLongitude, getMaxLongitudeDegrees, getMinLatitude, getMinLatitudeDegrees, getMinLongitude, getMinLongitudeDegrees, getName, getPrimeMeridian, getPROJ4Description, getProjectionLatitude, getProjectionLatitude1, getProjectionLatitude1Degrees, getProjectionLatitude2, getProjectionLatitude2Degrees, getProjectionLatitudeDegrees, getProjectionLongitude, getProjectionLongitudeDegrees, getScaleFactor, getTrueScaleLatitude, getTrueScaleLatitudeDegrees, getUnits, hashCode, inside, inverseProject, inverseProjectRadians, isConformal, isEqualArea, isGeographic, normalizeLongitude, normalizeLongitudeRadians, parallelsAreParallel, project, projectRadians, setAlpha, setAlphaDegrees, setAxisOrder, setEllipsoid, setFalseEasting, setFalseNorthing, setFromMetres, setGamma, setGammaDegrees, setHeightOfOrbit, setLonC, setLonCDegrees, setMaxLatitude, setMaxLongitude, setMaxLongitudeDegrees, setMinLatitude, setMinLongitude, setMinLongitudeDegrees, setName, setNoUoff, setPrimeMeridian, setProjectionLatitude, setProjectionLatitude1, setProjectionLatitude1Degrees, setProjectionLatitude2, setProjectionLatitude2Degrees, setProjectionLatitudeDegrees, setProjectionLongitude, setProjectionLongitudeDegrees, setRadius, setScaleFactor, setTrueScaleLatitude, setTrueScaleLatitudeDegrees, setUnits

Methods inherited from class Object

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

Field Details

isSouth

protected boolean isSouth

Indicates whether a Southern Hemisphere UTM zone

Constructor Details

TransverseMercatorProjection

public TransverseMercatorProjection()

TransverseMercatorProjection

public TransverseMercatorProjection(Ellipsoid ellipsoid,
 double lon_0,
 double lat_0,
 double k,
 double x_0,
 double y_0)

Set up a projection suitable for State Plane Coordinates.

Method Details

setSouthernHemisphere

public void setSouthernHemisphere(boolean isSouth)

Overrides:

setSouthernHemisphere in class Projection

getSouthernHemisphere

public boolean getSouthernHemisphere()

Overrides:

getSouthernHemisphere in class Projection

clone

public Object clone()

Overrides:

clone in class Projection

isRectilinear

public boolean isRectilinear()

Description copied from class: Projection

Tests whether under this projection lines of latitude and longitude form a rectangular grid

Overrides:

isRectilinear in class CylindricalProjection

initialize

public void initialize()

Description copied from class: Projection

Initialize the projection. This should be called after setting parameters and before using the projection. This is for performance reasons as initialization may be expensive.

Overrides:

initialize in class Projection

getRowFromNearestParallel

public static int getRowFromNearestParallel(double latitude)

getZoneFromNearestMeridian

public static int getZoneFromNearestMeridian(double longitude)

setUTMZone

public void setUTMZone(int zone)

project

public ProjCoordinate project(double lplam,
 double lpphi,
 ProjCoordinate xy)

Description copied from class: Projection

Computes the projection of a given point (i.e. from geographics to projection space). This should be overridden for all projections.

Overrides:

project in class Projection

Parameters:

lplam - the geographic x ordinate (in radians)

lpphi - the geographic y ordinatee (in radians)

xy - the projected coordinate (in coordinate system units)

Returns:

the target coordinate

projectInverse

public ProjCoordinate projectInverse(double x,
 double y,
 ProjCoordinate out)

Description copied from class: Projection

Computes the inverse projection of a given point (i.e. from projection space to geographics). This should be overridden for all projections.

Overrides:

projectInverse in class Projection

Parameters:

x - the projected x ordinate (in coordinate system units)

y - the projected y ordinate (in coordinate system units)

out - the inverse-projected geographic coordinate (in radians)

Returns:

the target coordinate

hasInverse

public boolean hasInverse()

Description copied from class: Projection

Tests whether this projection has an inverse. If this method returns true then the Projection.inverseProject(ProjCoordinate, ProjCoordinate) and Projection.inverseProjectRadians(ProjCoordinate, ProjCoordinate) methods will return meaningful results.

Overrides:

hasInverse in class Projection

Returns:

true if this projection has an inverse

toString

public String toString()

Overrides:

toString in class CylindricalProjection