org.geotoolkit.referencing.operation.provider
Class ObliqueMercator

Object
  FormattableObject
      AbstractIdentifiedObject
          DefaultOperationMethod
              MathTransformProvider
                  MapProjection
                      ObliqueMercator

All Implemented Interfaces:

Serializable, Formattable, Deprecable, LenientComparable, IdentifiedObject, OperationMethod

Direct Known Subclasses:

HotineObliqueMercator, ObliqueMercator.TwoPoint

@Immutable
public class ObliqueMercator
extends MapProjection

The provider for "Oblique Mercator" projection (EPSG:9815). The math transform implementations instantiated by this provider may be any of the following classes:

• ObliqueMercator

The following table summarizes the parameters recognized by this provider. For a more detailed parameter list, see the PARAMETERS constant.

Operation name: Oblique_Mercator
Area of use: (union of CRS domains of validity in EPSG database)

in latitudes:	25°39.6′S	to	48°36.0′N
in longitudes:	5°58.2′E	to	119°18.0′E

Parameter name	Default value
semi_major
semi_minor
roll_longitude	false
longitude_of_center	0°
latitude_of_center	0°
azimuth
rectified_grid_angle	Azimuth of initial line
scale_factor	1
false_easting	0 metres
false_northing	0 metres

Since:

2.1

Version:

3.20

Author:

Rueben Schulz (UBC), Martin Desruisseaux (Geomatys)

See Also:

Oblique Mercator on RemoteSensing.org, Geotk coordinate operations matrix, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Nested Class Summary

static class

ObliqueMercator.TwoPoint The provider for "Oblique Mercator" projection specified by two points on the central line.

Field Summary

static ParameterDescriptor<Double>	AZIMUTH Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	FALSE_EASTING Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	FALSE_NORTHING Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	LATITUDE_OF_CENTRE Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	LONGITUDE_OF_CENTRE Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptorGroup	PARAMETERS The group of all parameters expected by this coordinate operation.
static ParameterDescriptor<Double>	RECTIFIED_GRID_ANGLE Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	SCALE_FACTOR Deprecated. Invoke PARAMETERS.descriptor(String) instead.

Fields inherited from class MapProjection

ROLL_LONGITUDE, SEMI_MAJOR, SEMI_MINOR, X_SCALE, XY_PLANE_ROTATION, Y_SCALE

Fields inherited from class DefaultOperationMethod

sourceDimension, targetDimension

Fields inherited from class FormattableObject

EPSG, GEOTIFF, INTERNAL, OGC, SINGLE_LINE

Fields inherited from interface OperationMethod

FORMULA_KEY

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

ObliqueMercator()
Constructs a new provider.

Method Summary

protected MathTransform2D	createMathTransform(ParameterValueGroup values) Creates a map projection from the specified group of parameter values.
Class<CylindricalProjection>	getOperationType() Returns the operation type for this map projection.

Methods inherited from class MathTransformProvider

ensureValidValues, formatWKT

Methods inherited from class DefaultOperationMethod

checkDimensions, computeHashCode, equals, getFormula, getParameters, getSourceDimensions, getTargetDimensions

Methods inherited from class AbstractIdentifiedObject

equals, getAlias, getIdentifier, getIdentifiers, getName, getName, getRemarks, hashCode, isDeprecated, nameMatches

Methods inherited from class FormattableObject

getDefaultIndentation, print, setDefaultIndentation, toString, toWKT, toWKT, toWKT, toWKT

Methods inherited from class Object

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

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

LONGITUDE_OF_CENTRE

@Deprecated
public static final ParameterDescriptor<Double> LONGITUDE_OF_CENTRE

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the central meridian parameter value. This parameter is mandatory. Valid values range is [-180 … 180]° and default value is 0°.

LATITUDE_OF_CENTRE

@Deprecated
public static final ParameterDescriptor<Double> LATITUDE_OF_CENTRE

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the latitude of origin parameter value. This parameter is mandatory. Valid values range is [-90 … 90]° and default value is 0°.

AZIMUTH

@Deprecated
public static final ParameterDescriptor<Double> AZIMUTH

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the azimuth parameter value. Valid values range is from -360 to -270, -90 to 90, and 270 to 360 degrees. This parameter is mandatory and has no default value.

RECTIFIED_GRID_ANGLE

@Deprecated
public static final ParameterDescriptor<Double> RECTIFIED_GRID_ANGLE

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the rectifiedGridAngle parameter value. This parameter is optional. Valid values rage is [-360 … 360]° and default value is the azimuth.

SCALE_FACTOR

@Deprecated
public static final ParameterDescriptor<Double> SCALE_FACTOR

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the scale factor parameter value. This parameter is mandatory. Valid values range is (0 … ∞) and default value is 1.

FALSE_EASTING

@Deprecated
public static final ParameterDescriptor<Double> FALSE_EASTING

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the false easting parameter value. This parameter is mandatory. Valid values range is unrestricted and default value is 0 metre.

FALSE_NORTHING

@Deprecated
public static final ParameterDescriptor<Double> FALSE_NORTHING

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the false northing parameter value. This parameter is mandatory. Valid values range is unrestricted and default value is 0 metre.

PARAMETERS

public static final ParameterDescriptorGroup PARAMETERS

The group of all parameters expected by this coordinate operation. The following table lists the operation names and the parameters recognized by Geotk:

Name:	OGC:	Oblique_Mercator
Alias:	EPSG:	Hotine Oblique Mercator (variant B)
	EPSG:	Rectified Skew Orthomorphic (RSO)
	EPSG:	Oblique Mercator
	ESRI:	Hotine_Oblique_Mercator_Azimuth_Center
	ESRI:	Rectified_Skew_Orthomorphic_Center
	GeoTIFF:	CT_ObliqueMercator
	PROJ4:	omerc
	Geotk:	Oblique Mercator projection
Identifier:	EPSG:	9815
	GeoTIFF:	3

Name:	OGC:	semi_major
Alias:	EPSG:	Semi-major axis
	ESRI:	Semi_Major
	GeoTIFF:	SemiMajor
	PROJ4:	a

Type:	Double
Obligation:	mandatory
Value range:	[0…∞) metres

Name:	OGC:	semi_minor
Alias:	EPSG:	Semi-minor axis
	ESRI:	Semi_Minor
	GeoTIFF:	SemiMinor
	PROJ4:	b

Type:	Double
Obligation:	mandatory
Value range:	[0…∞) metres

Name:

Geotk:

roll_longitude

Type:	Boolean
Obligation:	optional
Default value:	false

Name:	OGC:	longitude_of_center
Alias:	EPSG:	Longitude of projection centre
	ESRI:	Longitude_Of_Center
	GeoTIFF:	CenterLong
	PROJ4:	lon_0

Type:	Double
Obligation:	mandatory
Value range:	[-180 … 180]°
Default value:	0°

Name:	OGC:	latitude_of_center
Alias:	EPSG:	Latitude of projection centre
	ESRI:	Latitude_Of_Center
	GeoTIFF:	CenterLat
	PROJ4:	lat_0

Type:	Double
Obligation:	mandatory
Value range:	[-90 … 90]°
Default value:	0°

Name:	OGC:	azimuth
Alias:	EPSG:	Azimuth of initial line
	ESRI:	Azimuth
	GeoTIFF:	AzimuthAngle

Type:	Double
Obligation:	mandatory
Value range:	[-360 … 360]°

Name:	OGC:	rectified_grid_angle
Alias:	EPSG:	Angle from Rectified to Skew Grid
	ESRI:	XY_Plane_Rotation
	GeoTIFF:	RectifiedGridAngle

Type:	Double
Obligation:	optional
Value range:	[-360 … 360]°
Default value:	Azimuth of initial line

Name:	OGC:	scale_factor
Alias:	EPSG:	Scale factor on initial line
	ESRI:	Scale_Factor
	GeoTIFF:	ScaleAtCenter
	PROJ4:	k

Type:	Double
Obligation:	mandatory
Value range:	[0…∞)
Default value:	1

Name:	OGC:	false_easting
Alias:	EPSG:	Easting at projection centre
	ESRI:	False_Easting
	GeoTIFF:	FalseEasting
	PROJ4:	x_0

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞) metres
Default value:	0 metres

Name:	OGC:	false_northing
Alias:	EPSG:	Northing at projection centre
	ESRI:	False_Northing
	GeoTIFF:	FalseNorthing
	PROJ4:	y_0

Type:	Double
Obligation:	mandatory
Value range:	(-∞ … ∞) metres
Default value:	0 metres

Constructor Detail

ObliqueMercator

public ObliqueMercator()

Constructs a new provider.

Method Detail

getOperationType

public Class<CylindricalProjection> getOperationType()

Returns the operation type for this map projection.

Overrides:

getOperationType in class MapProjection

Returns:

The GeoAPI interface implemented by this operation.

createMathTransform

protected MathTransform2D createMathTransform(ParameterValueGroup values)

Creates a map projection from the specified group of parameter values.

Specified by:

createMathTransform in class MapProjection

Parameters:

values - The group of parameter values.

Returns:

The created map projection.