Package org.opengis.referencing.cs

Interface CSAuthorityFactory

All Superinterfaces:

AuthorityFactory, Factory

public interface CSAuthorityFactory
extends AuthorityFactory

Creates coordinate systems using authority codes. External authorities are used to manage definitions of objects used in this interface. The definitions of these objects are referenced using code strings. A commonly used authority is EPSG.

Since:

1.0

See Also:

CRSAuthorityFactory, DatumAuthorityFactory

Departure from OGC/ISO specification:
Added for consistency with CRS and datum factories. This CS factory was not defined in the OGC specification because OGC 01-009 was created before ISO 19111 and had no equivalent of the ISO Coordinate System types.

Method Summary

Modifier and Type	Method	Description
CartesianCS	createCartesianCS(String code)	Returns a Cartesian coordinate system from a code.
CoordinateSystem	createCoordinateSystem(String code)	Returns an arbitrary coordinate system from a code.
CoordinateSystemAxis	createCoordinateSystemAxis(String code)	Returns a coordinate system axis from a code.
CylindricalCS	createCylindricalCS(String code)	Returns a cylindrical coordinate system from a code.
EllipsoidalCS	createEllipsoidalCS(String code)	Returns an ellipsoidal coordinate system from a code.
ParametricCS	createParametricCS(String code)	Returns a parametric coordinate system from a code.
PolarCS	createPolarCS(String code)	Returns a polar coordinate system from a code.
SphericalCS	createSphericalCS(String code)	Returns a spherical coordinate system from a code.
TimeCS	createTimeCS(String code)	Returns a temporal coordinate system from a code.
Unit<?>	createUnit(String code)	Returns an unit of measurement from a code.
VerticalCS	createVerticalCS(String code)	Returns a vertical coordinate system from a code.

Methods inherited from interface AuthorityFactory

createObject, getAuthority, getAuthorityCodes, getDescriptionText

Methods inherited from interface Factory

getVendor

Method Detail

createCoordinateSystem

CoordinateSystem createCoordinateSystem(String code)
                                 throws NoSuchAuthorityCodeException,
                                        FactoryException

Returns an arbitrary coordinate system from a code.

If the coordinate system type is known at compile time, then it is recommended to invoke the most precise method instead of this one. For example it is usually better to invoke createCartesianCS(code) instead of createCoordinateSystem(code) if the requested object is known to be a CartesianCS instance.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createCartesianCS

CartesianCS createCartesianCS(String code)
                       throws NoSuchAuthorityCodeException,
                              FactoryException

Returns a Cartesian coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createPolarCS

PolarCS createPolarCS(String code)
               throws NoSuchAuthorityCodeException,
                      FactoryException

Returns a polar coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createCylindricalCS

CylindricalCS createCylindricalCS(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns a cylindrical coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createSphericalCS

SphericalCS createSphericalCS(String code)
                       throws NoSuchAuthorityCodeException,
                              FactoryException

Returns a spherical coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createEllipsoidalCS

EllipsoidalCS createEllipsoidalCS(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns an ellipsoidal coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createVerticalCS

VerticalCS createVerticalCS(String code)
                     throws NoSuchAuthorityCodeException,
                            FactoryException

Returns a vertical coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createTimeCS

TimeCS createTimeCS(String code)
             throws NoSuchAuthorityCodeException,
                    FactoryException

Returns a temporal coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createParametricCS

ParametricCS createParametricCS(String code)
                         throws NoSuchAuthorityCodeException,
                                FactoryException

Returns a parametric coordinate system from a code.

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createCoordinateSystemAxis

CoordinateSystemAxis createCoordinateSystemAxis(String code)
                                         throws NoSuchAuthorityCodeException,
                                                FactoryException

Returns a coordinate system axis from a code.

Parameters:

code - value allocated by authority.

Returns:

the axis for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

createUnit

@UML(identifier="CS_CoordinateSystemAuthorityFactory.createLinearUnit, createAngularUnit",
     specification=OGC_01009)
Unit<?> createUnit(String code)
            throws NoSuchAuthorityCodeException,
                   FactoryException

Returns an unit of measurement from a code.

Parameters:

code - value allocated by authority.

Returns:

the unit for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.