org.geolatte.geom.crs

Class CoordinateReferenceSystems

java.lang.Object

org.geolatte.geom.crs.CoordinateReferenceSystems

public class CoordinateReferenceSystems
extends Object

Common coordinate reference systems.

Author:

Karel Maesen, Geovise BVBA creation-date: 3/31/14

Field Summary

Fields

Modifier and Type	Field and Description
static GeographicCoordinateReferenceSystem<G2D>	ETRS89 The European ETRS89 geographic reference system.
static SingleCoordinateReferenceSystem<C2D>	PROJECTED_2D_METER A generic projected 2D CoordinateReferenceSystem with meter coordinates
static CompoundCoordinateReferenceSystem<C2DM>	PROJECTED_2DM_METER A generic projected 2DM CoordinateReferenceSystem with meter coordinates
static CompoundCoordinateReferenceSystem<C3D>	PROJECTED_3D_METER A generic projected 3D CoordinateReferenceSystem with meter coordinates
static CompoundCoordinateReferenceSystem<C3DM>	PROJECTED_3DM_METER A generic projected 3DM CoordinateReferenceSystem with meter coordinates
static ProjectedCoordinateReferenceSystem	WEB_MERCATOR The WGS 84/Pseudo-Mercator ProjectedCoordinateReferenceSystem
static Geographic2DCoordinateReferenceSystem	WGS84 The WGS 84 GeographicCoordinateReferenceSystem

Constructor Summary

Constructors

Constructor and Description
CoordinateReferenceSystems()

Method Summary

Modifier and Type	Method and Description
static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R>	addLinearSystem(CoordinateReferenceSystem<P> base, Class<R> resultCSPtype, LinearUnit unit)
static <P extends Position> CompoundCoordinateReferenceSystem<?>	addLinearSystem(CoordinateReferenceSystem<P> base, LinearUnit unit)
static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R>	addVerticalSystem(CoordinateReferenceSystem<P> base, Class<R> resultCSPtype, LinearUnit unit)
static <P extends Position> CompoundCoordinateReferenceSystem<?>	addVerticalSystem(CoordinateReferenceSystem<P> base, LinearUnit unit)
static CoordinateReferenceSystem<?>	adjustTo(CoordinateReferenceSystem<?> crs, boolean hasZ, boolean hasM)
static CoordinateReferenceSystem<?>	adjustTo(CoordinateReferenceSystem<?> crs, int coordinateDimension)
static CoordinateReferenceSystem<?>	adjustTo(CoordinateReferenceSystem<?> crs, int coordinateDimension, boolean hasM)
static <P extends Position> ProjectedCoordinateReferenceSystem	asProjected(CoordinateReferenceSystem<P> original) Turn a geographic CRS into a projected CRS, using a no-op projection
static <P extends Position> CompoundCoordinateReferenceSystem<?>	combine(CoordinateReferenceSystem<P> base, SingleCoordinateReferenceSystem ods)
static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R>	combine(CoordinateReferenceSystem<P> base, SingleCoordinateReferenceSystem ods, Class<R> resultCSPtype)
static <P extends Position> boolean	hasAxisOrder(CoordinateReferenceSystem<P> crs, int order)
static <P extends Position> boolean	hasMeasureAxis(CoordinateReferenceSystem<P> crs) Deprecated. Use crs.hasM()
static <P extends Position> boolean	hasVerticalAxis(CoordinateReferenceSystem<P> crs) Deprecated. User crs.hasZ()
static CoordinateReferenceSystem<?>	mkCoordinateReferenceSystem(CoordinateReferenceSystem<?> baseCrs, LinearUnit verticalUnit, LinearUnit measureUnit) Returns a CoordinateReferenceSystem derived from the specified @{code CoordinateReferenceSystem} but extended with the specified axis
static <P extends Position> CoordinateReferenceSystem<P>	mkCoordinateReferenceSystem(CoordinateReferenceSystem<?> baseCrs, LinearUnit verticalUnit, LinearUnit measureUnit, Class<P> positionType)
static CoordinateReferenceSystem<?>	mkCoordinateReferenceSystem(int epsgCode, LinearUnit verticalUnit, LinearUnit measureUnit)
static GeographicCoordinateReferenceSystem	mkGeographic(AngularUnit unit)
static GeographicCoordinateReferenceSystem	mkGeographic(CrsId srid, AngularUnit unit) Creates a generic geographic coordinate reference system using the specified units of length for coordinates.
static LinearCoordinateReferenceSystem	mkLinear(LinearUnit unit) Creates a 1-Dimensional LinearCoordinateReferenceSystem
static ProjectedCoordinateReferenceSystem	mkProjected(CrsId srid, LinearUnit unit)
static ProjectedCoordinateReferenceSystem	mkProjected(LinearUnit unit) Creates a generic projected coordinate reference system using the specified units of length for coordinates.
static VerticalCoordinateReferenceSystem	mkVertical(LinearUnit unit) Creates a 1-Dimensional VerticalCoordinateReferenceSystem

Methods inherited from class java.lang.Object

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

Field Detail

PROJECTED_2D_METER

public static final SingleCoordinateReferenceSystem<C2D> PROJECTED_2D_METER

A generic projected 2D CoordinateReferenceSystem with meter coordinates

PROJECTED_2DM_METER

public static final CompoundCoordinateReferenceSystem<C2DM> PROJECTED_2DM_METER

A generic projected 2DM CoordinateReferenceSystem with meter coordinates

PROJECTED_3D_METER

public static final CompoundCoordinateReferenceSystem<C3D> PROJECTED_3D_METER

A generic projected 3D CoordinateReferenceSystem with meter coordinates

PROJECTED_3DM_METER

public static final CompoundCoordinateReferenceSystem<C3DM> PROJECTED_3DM_METER

A generic projected 3DM CoordinateReferenceSystem with meter coordinates

WGS84

public static Geographic2DCoordinateReferenceSystem WGS84

The WGS 84 GeographicCoordinateReferenceSystem

WEB_MERCATOR

public static ProjectedCoordinateReferenceSystem WEB_MERCATOR

The WGS 84/Pseudo-Mercator ProjectedCoordinateReferenceSystem

This is de de facto standard for Web mapping applications. See this Wikipedia article for more information, and some warnings of its use.

ETRS89

public static GeographicCoordinateReferenceSystem<G2D> ETRS89

The European ETRS89 geographic reference system.

This system can be used for all of Europe.

Constructor Detail

CoordinateReferenceSystems

public CoordinateReferenceSystems()

Method Detail

mkProjected

public static ProjectedCoordinateReferenceSystem mkProjected(CrsId srid,
                                                             LinearUnit unit)

mkProjected

public static ProjectedCoordinateReferenceSystem mkProjected(LinearUnit unit)

Creates a generic projected coordinate reference system using the specified units of length for coordinates.

A generic system is one without a precisely defined Coordinate Reference System

Parameters:

unit - the unit to use for the planar coordinates.

Returns:

a CoordinateReferenceSystem with the specified length units

mkGeographic

public static GeographicCoordinateReferenceSystem mkGeographic(CrsId srid,
                                                               AngularUnit unit)

Creates a generic geographic coordinate reference system using the specified units of length for coordinates.

A generic system is one without a precisely defined datum or ellipsoid.

Parameters:

unit - the unit to use for the planar coordinates.

Returns:

a CoordinateReferenceSystem

mkGeographic

public static GeographicCoordinateReferenceSystem mkGeographic(AngularUnit unit)

mkCoordinateReferenceSystem

public static CoordinateReferenceSystem<?> mkCoordinateReferenceSystem(CoordinateReferenceSystem<?> baseCrs,
                                                                       LinearUnit verticalUnit,
                                                                       LinearUnit measureUnit)

Returns a CoordinateReferenceSystem derived from the specified @{code CoordinateReferenceSystem} but extended with the specified axis

Parameters:

baseCrs - the base Coordinate Reference System

verticalUnit - the Unit for the Vertical axis (or null if not required)

measureUnit - the Unit for measures (or null if not required)

Returns:

a CoordinateReferenceSystem with at least the specified dimension, and using the specified crs as base

mkCoordinateReferenceSystem

public static CoordinateReferenceSystem<?> mkCoordinateReferenceSystem(int epsgCode,
                                                                       LinearUnit verticalUnit,
                                                                       LinearUnit measureUnit)

mkCoordinateReferenceSystem

public static <P extends Position> CoordinateReferenceSystem<P> mkCoordinateReferenceSystem(CoordinateReferenceSystem<?> baseCrs,
                                                                                            LinearUnit verticalUnit,
                                                                                            LinearUnit measureUnit,
                                                                                            Class<P> positionType)

mkLinear

public static LinearCoordinateReferenceSystem mkLinear(LinearUnit unit)

Creates a 1-Dimensional LinearCoordinateReferenceSystem

Parameters:

unit - the linear unit tot use

Returns:

a LinearCoordinateReferenceSystem with an M-axis

mkVertical

public static VerticalCoordinateReferenceSystem mkVertical(LinearUnit unit)

Creates a 1-Dimensional VerticalCoordinateReferenceSystem

Parameters:

unit - the linear unit to use

Returns:

a LinearCoordinateReferenceSystem with an Z-axis

combine

public static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R> combine(CoordinateReferenceSystem<P> base,
                                                                                                   SingleCoordinateReferenceSystem ods,
                                                                                                   Class<R> resultCSPtype)

Type Parameters:

P -

R -

Parameters:

base -

ods -

resultCSPtype - the Position class for the result of the combined coordinate reference system

Returns:

addLinearSystem

public static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R> addLinearSystem(CoordinateReferenceSystem<P> base,
                                                                                                           Class<R> resultCSPtype,
                                                                                                           LinearUnit unit)

addVerticalSystem

public static <P extends Position,R extends Position> CompoundCoordinateReferenceSystem<R> addVerticalSystem(CoordinateReferenceSystem<P> base,
                                                                                                             Class<R> resultCSPtype,
                                                                                                             LinearUnit unit)

asProjected

public static <P extends Position> ProjectedCoordinateReferenceSystem asProjected(CoordinateReferenceSystem<P> original)

Turn a geographic CRS into a projected CRS, using a no-op projection

Parameters:

original -

Returns:

combine

public static <P extends Position> CompoundCoordinateReferenceSystem<?> combine(CoordinateReferenceSystem<P> base,
                                                                                SingleCoordinateReferenceSystem ods)

addLinearSystem

public static <P extends Position> CompoundCoordinateReferenceSystem<?> addLinearSystem(CoordinateReferenceSystem<P> base,
                                                                                        LinearUnit unit)

addVerticalSystem

public static <P extends Position> CompoundCoordinateReferenceSystem<?> addVerticalSystem(CoordinateReferenceSystem<P> base,
                                                                                          LinearUnit unit)

adjustTo

public static CoordinateReferenceSystem<?> adjustTo(CoordinateReferenceSystem<?> crs,
                                                    boolean hasZ,
                                                    boolean hasM)

adjustTo

public static CoordinateReferenceSystem<?> adjustTo(CoordinateReferenceSystem<?> crs,
                                                    int coordinateDimension)

adjustTo

public static CoordinateReferenceSystem<?> adjustTo(CoordinateReferenceSystem<?> crs,
                                                    int coordinateDimension,
                                                    boolean hasM)

hasAxisOrder

public static <P extends Position> boolean hasAxisOrder(CoordinateReferenceSystem<P> crs,
                                                        int order)

hasVerticalAxis

@Deprecated
public static <P extends Position> boolean hasVerticalAxis(CoordinateReferenceSystem<P> crs)

Deprecated. User crs.hasZ()

hasMeasureAxis

@Deprecated
public static <P extends Position> boolean hasMeasureAxis(CoordinateReferenceSystem<P> crs)

Deprecated. Use crs.hasM()