org.geotoolkit.referencing.operation.provider
Class AlbersEqualArea

Object
  FormattableObject
      AbstractIdentifiedObject
          DefaultOperationMethod
              MathTransformProvider
                  MapProjection
                      AlbersEqualArea

All Implemented Interfaces:

Serializable, Formattable, Deprecable, LenientComparable, IdentifiedObject, OperationMethod

@Immutable
public class AlbersEqualArea
extends MapProjection

The provider for "Albers Equal Area" projection (EPSG:9822). The math transform implementations instantiated by this provider may be any of the following classes:

• AlbersEqualArea

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

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

in latitudes:	45°00.0′S	to	71°24.0′N
in longitudes:	172°25.8′W	to	155°00.0′E

Parameter name	Default value
semi_major
semi_minor
roll_longitude	false
central_meridian	0°
latitude_of_origin	0°
standard_parallel_1	latitude of origin
standard_parallel_2	standard parallel 1
false_easting	0 metres
false_northing	0 metres

Since:

2.1

Version:

3.20

Author:

Rueben Schulz (UBC), Martin Desruisseaux (Geomatys)

See Also:

Albers Equal-Area Conic on RemoteSensing.org, Geotk coordinate operations matrix, Serialized Form

Module:

referencing/geotk-referencing (download)

View source code for this class

Field Summary

static ParameterDescriptor<Double>	CENTRAL_MERIDIAN 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_ORIGIN Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptorGroup	PARAMETERS The group of all parameters expected by this coordinate operation.
static ParameterDescriptor<Double>	STANDARD_PARALLEL_1 Deprecated. Invoke PARAMETERS.descriptor(String) instead.
static ParameterDescriptor<Double>	STANDARD_PARALLEL_2 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

AlbersEqualArea()
Constructs a new provider.

Method Summary

protected MathTransform2D	createMathTransform(ParameterValueGroup values) Creates a map projection from the specified group of parameter values.
Class<ConicProjection>	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

CENTRAL_MERIDIAN

@Deprecated
public static final ParameterDescriptor<Double> CENTRAL_MERIDIAN

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°.

TODO:

According the remote-sensing web site, the OGC name for this parameter is "longitude_of_center". However the spatial-reference web site said "central_meridian", which was also the usage in GeoTools 2.x and is preserved for now.

LATITUDE_OF_ORIGIN

@Deprecated
public static final ParameterDescriptor<Double> LATITUDE_OF_ORIGIN

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

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

TODO:

According the remote-sensing web site, the OGC name for this parameter is "latitude_of_center". However the spatial-reference web site said "latitude_of_origin", which was also the usage in GeoTools 2.x and is preserved for now.

STANDARD_PARALLEL_1

@Deprecated
public static final ParameterDescriptor<Double> STANDARD_PARALLEL_1

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the first standard parallel parameter value. This parameter is optional - if omitted, it takes the same value than the one given for LATITUDE_OF_ORIGIN. Valid values range is [-90 … 90]°.

STANDARD_PARALLEL_2

@Deprecated
public static final ParameterDescriptor<Double> STANDARD_PARALLEL_2

Deprecated. Invoke PARAMETERS.descriptor(String) instead.

The operation parameter descriptor for the second standard parallel parameter value. This parameter is optional - if omitted, it takes the same value than the one given for STANDARD_PARALLEL_1. Valid values range is [-90 … 90]°.

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:

Note: According the remote-sensing web site, the OGC name for the "central_meridian" and "latitude_of_origin" parameters are "longitude_of_center" and "latitude_of_center" respectively. However the spatial-reference web site uses the former name, which was also the usage in GeoTools 2.x and is preserved for now.

Name:	OGC:	Albers_Conic_Equal_Area
Alias:	EPSG:	Albers Equal Area
	ESRI:	Albers
	ESRI:	Albers_Equal_Area_Conic
	NetCDF:	AlbersEqualArea
	GeoTIFF:	CT_AlbersEqualArea
	PROJ4:	aea
	Geotk:	Albers Equal Area projection
Identifier:	EPSG:	9822
	GeoTIFF:	11

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

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

Name:	OGC:	semi_minor
Alias:	EPSG:	Semi-minor axis
	ESRI:	Semi_Minor
	NetCDF:	semi_minor_axis
	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:	central_meridian
Alias:	EPSG:	Longitude of false origin
	ESRI:	Central_Meridian
	NetCDF:	longitude_of_central_meridian
	GeoTIFF:	NatOriginLong
	PROJ4:	lon_0

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

Name:	OGC:	latitude_of_origin
Alias:	EPSG:	Latitude of false origin
	ESRI:	Latitude_Of_Origin
	NetCDF:	latitude_of_projection_origin
	GeoTIFF:	NatOriginLat
	PROJ4:	lat_0

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

Name:	OGC:	standard_parallel_1
Alias:	EPSG:	Latitude of 1st standard parallel
	ESRI:	Standard_Parallel_1
	NetCDF:	standard_parallel[1]
	GeoTIFF:	StdParallel1
	PROJ4:	lat_1

Type:	Double
Obligation:	optional
Value range:	[-90 … 90]°
Default value:	latitude of origin

Name:	OGC:	standard_parallel_2
Alias:	EPSG:	Latitude of 2nd standard parallel
	ESRI:	Standard_Parallel_2
	NetCDF:	standard_parallel[2]
	GeoTIFF:	StdParallel2
	PROJ4:	lat_2

Type:	Double
Obligation:	optional
Value range:	[-90 … 90]°
Default value:	standard parallel 1

Name:	OGC:	false_easting
Alias:	EPSG:	Easting at false origin
	ESRI:	False_Easting
	NetCDF:	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 false origin
	ESRI:	False_Northing
	NetCDF:	false_northing
	GeoTIFF:	FalseNorthing
	PROJ4:	y_0

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

Constructor Detail

AlbersEqualArea

public AlbersEqualArea()

Constructs a new provider.

Method Detail

getOperationType

public Class<ConicProjection> 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.