org.openstreetmap.josm.data.projection.proj

Class EquidistantCylindrical

java.lang.Object

org.openstreetmap.josm.data.projection.proj.AbstractProj

org.openstreetmap.josm.data.projection.proj.EquidistantCylindrical

All Implemented Interfaces:

Proj

public class EquidistantCylindrical
extends AbstractProj

Equidistant cylindrical projection (EPSG code 9823). In the particular case where the standard_parallel_1 is 0°, this projection is also called Plate Carree or Equirectangular. This is used in, for example, WGS84 / Plate Carree (EPSG:32662).

References:

• John P. Snyder (Map Projections - A Working Manual,
  U.S. Geological Survey Professional Paper 1395, 1987)
• "Coordinate Conversions and Transformations including Formulas",
  EPSG Guidence Note Number 7 part 2, Version 24.

Since:

13598

See Also:

Cylindrical Equidistant projection on MathWorld, "Equirectangular" on RemoteSensing.org

Field Summary

Fields

Modifier and Type	Field and Description
private double	cosStandardParallel Cosinus of the "standard_parallel_1" parameter.

Fields inherited from class org.openstreetmap.josm.data.projection.proj.AbstractProj

e, e2, en0, en1, en2, en3, en4, spherical

Constructor Summary

Constructors

Constructor and Description
EquidistantCylindrical()

Method Summary

Modifier and Type	Method and Description
Bounds	getAlgorithmBounds() Return the bounds where this projection is applicable.
java.lang.String	getName() Replies a human readable name of this projection.
java.lang.String	getProj4Id() Replies the Proj.4 identifier.
void	initialize(ProjParameters params) Initialize the projection using the provided parameters.
double[]	invproject(double east, double north) Convert east/north to lat/lon.
double[]	project(double latRad, double lonRad) Convert lat/lon to east/north.

Methods inherited from class org.openstreetmap.josm.data.projection.proj.AbstractProj

aasin, cphi2, invMlfn, isGeographic, mlfn, msfn, tsfn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openstreetmap.josm.data.projection.proj.Proj

lonIsLinearToEast

Field Detail

cosStandardParallel

private double cosStandardParallel

Cosinus of the "standard_parallel_1" parameter.

Constructor Detail

EquidistantCylindrical

public EquidistantCylindrical()

Method Detail

getName

public java.lang.String getName()

Description copied from interface: Proj

Replies a human readable name of this projection.

Returns:

The projection name. must not be null.

getProj4Id

public java.lang.String getProj4Id()

Description copied from interface: Proj

Replies the Proj.4 identifier.

Returns:

The Proj.4 identifier (as reported by cs2cs -lp). If no id exists, return null.

initialize

public void initialize(ProjParameters params)
                throws ProjectionConfigurationException

Description copied from interface: Proj

Initialize the projection using the provided parameters.

Specified by:

initialize in interface Proj

Overrides:

initialize in class AbstractProj

Parameters:

params - The projection parameters

Throws:

ProjectionConfigurationException - in case parameters are not suitable

project

public double[] project(double latRad,
                        double lonRad)

Description copied from interface: Proj

Convert lat/lon to east/north.

Parameters:

latRad - the latitude in radians

lonRad - the longitude in radians

Returns:

array of length 2, containing east and north value in meters, divided by the semi major axis of the ellipsoid.

invproject

public double[] invproject(double east,
                           double north)

Description copied from interface: Proj

Convert east/north to lat/lon.

Parameters:

east - east value in meters, divided by the semi major axis of the ellipsoid

north - north value in meters, divided by the semi major axis of the ellipsoid

Returns:

array of length 2, containing lat and lon in radians.

getAlgorithmBounds

public Bounds getAlgorithmBounds()

Description copied from interface: Proj

Return the bounds where this projection is applicable. This is a fallback for when the projection bounds are not specified explicitly. In this area, the round trip lat/lon -> east/north -> lat/lon should return the starting value with small error. In addition, regions with extreme distortions should be excluded, if possible. It need not be the absolute maximum, but rather an area that is safe to display in JOSM and contain everything that one would expect to use.

Returns:

the bounds where this projection is applicable, null if unknown