org.geotools.cs
Class CoordinateSystemFactory

java.lang.Object
  org.geotools.cs.CoordinateSystemFactory

Deprecated. Replaced by CRSFactory.

public class CoordinateSystemFactory

extends java.lang.Object

Builds up complex objects from simpler objects or values. CoordinateSystemFactory allows applications to make coordinate systems that cannot be created by a CoordinateSystemAuthorityFactory. This factory is very flexible, whereas the authority factory is easier to use. So CoordinateSystemAuthorityFactory can be used to make 'standard' coordinate systems, and CoordinateSystemFactory can be used to make "special" coordinate systems. For example, the EPSG authority has codes for USA state plane coordinate systems using the NAD83 datum, but these coordinate systems always use meters. EPSG does not have codes for NAD83 state plane coordinate systems that use feet units. This factory lets an application create such a hybrid coordinate system.

Version:

$Id: CoordinateSystemFactory.java 17751 2006-01-26 21:51:55Z desruisseaux $

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_CoordinateSystemFactory

Constructor Summary

protected

CoordinateSystemFactory() Deprecated. Default constructor.

Method Summary

CompoundCoordinateSystem	createCompoundCoordinateSystem(java.lang.CharSequence name, CoordinateSystem head, CoordinateSystem tail) Deprecated. Creates a compound coordinate system.
Ellipsoid	createEllipsoid(java.lang.CharSequence name, double semiMajorAxis, double semiMinorAxis, Unit unit) Deprecated. Creates an ellipsoid from radius values.
FittedCoordinateSystem	createFittedCoordinateSystem(java.lang.CharSequence name, CoordinateSystem base, MathTransform toBase, AxisInfo[] axes) Deprecated. Creates a fitted coordinate system.
Ellipsoid	createFlattenedSphere(java.lang.CharSequence name, double semiMajorAxis, double inverseFlattening, Unit unit) Deprecated. Creates an ellipsoid from an major radius, and inverse flattening.
CoordinateSystem	createFromWKT(java.lang.String text) Deprecated. Creates a coordinate system object from a Well-Known Text (WKT) string.
GeocentricCoordinateSystem	createGeocentricCoordinateSystem(java.lang.CharSequence name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo[] axis) Deprecated. Constructs a geocentric coordinate system.
GeographicCoordinateSystem	createGeographicCoordinateSystem(java.lang.CharSequence name, HorizontalDatum datum) Deprecated. Creates a geographic coordinate system.
GeographicCoordinateSystem	createGeographicCoordinateSystem(java.lang.CharSequence name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo axis0, AxisInfo axis1) Deprecated. Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.
HorizontalDatum	createHorizontalDatum(java.lang.CharSequence name, DatumType.Horizontal type, Ellipsoid ellipsoid, WGS84ConversionInfo toWGS84) Deprecated. Creates horizontal datum from ellipsoid and Bursa-Wolf parameters.
HorizontalDatum	createHorizontalDatum(java.lang.CharSequence name, Ellipsoid ellipsoid) Deprecated. Creates horizontal datum from an ellipsoid.
LocalCoordinateSystem	createLocalCoordinateSystem(java.lang.CharSequence name, LocalDatum datum, Unit[] units, AxisInfo[] axes) Deprecated. Creates a local coordinate system.
LocalCoordinateSystem	createLocalCoordinateSystem(java.lang.CharSequence name, LocalDatum datum, Unit unit, AxisInfo[] axes) Deprecated. Creates a local coordinate system.
LocalDatum	createLocalDatum(java.lang.CharSequence name, DatumType.Local type) Deprecated. Creates a local datum.
PrimeMeridian	createPrimeMeridian(java.lang.CharSequence name, Unit unit, double longitude) Deprecated. Creates a prime meridian, relative to Greenwich.
ProjectedCoordinateSystem	createProjectedCoordinateSystem(java.lang.CharSequence name, GeographicCoordinateSystem gcs, Projection projection) Deprecated. Creates a projected coordinate system using the specified geographic system.
ProjectedCoordinateSystem	createProjectedCoordinateSystem(java.lang.CharSequence name, GeographicCoordinateSystem gcs, Projection projection, Unit unit, AxisInfo axis0, AxisInfo axis1) Deprecated. Creates a projected coordinate system using a projection object.
Projection	createProjection(java.lang.CharSequence name, java.lang.String classification, Ellipsoid ellipsoid, java.awt.geom.Point2D centre, java.awt.geom.Point2D translation) Deprecated. Convenience method for constructing a projection using the specified ellipsoid.
Projection	createProjection(java.lang.CharSequence name, java.lang.String classification, javax.media.jai.ParameterList parameters) Deprecated. Creates a projection.
javax.media.jai.ParameterList	createProjectionParameterList(java.lang.String classification) Deprecated. Returns a default parameter list for the specified projection.
VerticalCoordinateSystem	createVerticalCoordinateSystem(java.lang.CharSequence name, VerticalDatum datum) Deprecated. Creates a vertical coordinate system from a datum.
VerticalCoordinateSystem	createVerticalCoordinateSystem(java.lang.CharSequence name, VerticalDatum datum, Unit unit, AxisInfo axis) Deprecated. Creates a vertical coordinate system from a datum and linear units.
VerticalDatum	createVerticalDatum(java.lang.CharSequence name, DatumType.Vertical type) Deprecated. Creates a vertical datum from an enumerated type value.
static CoordinateSystemFactory	getDefault() Deprecated. Returns the default coordinate system factory.
java.text.Format	getWKTFormat(java.util.Locale locale) Deprecated. Returns an object to use for parsing and formatting Well-Known Text.

Methods inherited from class java.lang.Object

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

Constructor Detail

CoordinateSystemFactory

protected CoordinateSystemFactory()

Deprecated.

Default constructor.

Method Detail

getDefault

public static CoordinateSystemFactory getDefault()

Deprecated.

Returns the default coordinate system factory.

createGeocentricCoordinateSystem

public GeocentricCoordinateSystem createGeocentricCoordinateSystem(java.lang.CharSequence name,
                                                                   Unit unit,
                                                                   HorizontalDatum datum,
                                                                   PrimeMeridian meridian,
                                                                   AxisInfo[] axis)
                                                            throws org.opengis.referencing.FactoryException

Deprecated.

Constructs a geocentric coordinate system. The X axis points towards the prime meridian. The Y axis points East or West. The Z axis points North or South.

Parameters:

name - The coordinate system name.

unit - The linear unit.

datum - The horizontal datum.

meridian - The prime meridian.

axis - The axis info. This is usually an array of length 3.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createGeographicCoordinateSystem

public GeographicCoordinateSystem createGeographicCoordinateSystem(java.lang.CharSequence name,
                                                                   HorizontalDatum datum)
                                                            throws org.opengis.referencing.FactoryException

Deprecated.

Creates a geographic coordinate system. This coordinate system will use longitude/latitude ordinates with longitude values increasing east and latitude values increasing north. Angular units are degrees and prime meridian is Greenwich.

Parameters:

name - Name to give new object.

datum - Horizontal datum for created coordinate system.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createGeographicCoordinateSystem

public GeographicCoordinateSystem createGeographicCoordinateSystem(java.lang.CharSequence name,
                                                                   Unit unit,
                                                                   HorizontalDatum datum,
                                                                   PrimeMeridian meridian,
                                                                   AxisInfo axis0,
                                                                   AxisInfo axis1)
                                                            throws org.opengis.referencing.FactoryException

Deprecated.

Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

Parameters:

name - Name to give new object.

unit - Angular units for created coordinate system.

datum - Horizontal datum for created coordinate system.

meridian - Prime Meridian for created coordinate system.

axis0 - Details of 0th ordinates.

axis1 - Details of 1st ordinates.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createGeographicCoordinateSystem(java.lang.String, org.opengis.cs.CS_AngularUnit, org.opengis.cs.CS_HorizontalDatum, org.opengis.cs.CS_PrimeMeridian, org.opengis.cs.CS_AxisInfo, org.opengis.cs.CS_AxisInfo)

createProjectedCoordinateSystem

public ProjectedCoordinateSystem createProjectedCoordinateSystem(java.lang.CharSequence name,
                                                                 GeographicCoordinateSystem gcs,
                                                                 Projection projection)
                                                          throws org.opengis.referencing.FactoryException

Deprecated.

Creates a projected coordinate system using the specified geographic system. Projected coordinates will be in meters, x values increasing east and y values increasing north.

Parameters:

name - Name to give new object.

gcs - Geographic coordinate system to base projection on.

projection - Projection from geographic to projected coordinate system.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createProjectedCoordinateSystem

public ProjectedCoordinateSystem createProjectedCoordinateSystem(java.lang.CharSequence name,
                                                                 GeographicCoordinateSystem gcs,
                                                                 Projection projection,
                                                                 Unit unit,
                                                                 AxisInfo axis0,
                                                                 AxisInfo axis1)
                                                          throws org.opengis.referencing.FactoryException

Deprecated.

Creates a projected coordinate system using a projection object.

Parameters:

name - Name to give new object.

gcs - Geographic coordinate system to base projection on.

projection - Projection from geographic to projected coordinate system.

unit - Linear units of returned PCS.

axis0 - Details of 0th ordinates in returned PCS coordinates.

axis1 - Details of 1st ordinates in returned PCS coordinates.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createProjectedCoordinateSystem(java.lang.String, org.opengis.cs.CS_GeographicCoordinateSystem, org.opengis.cs.CS_Projection, org.opengis.cs.CS_LinearUnit, org.opengis.cs.CS_AxisInfo, org.opengis.cs.CS_AxisInfo)

createVerticalCoordinateSystem

public VerticalCoordinateSystem createVerticalCoordinateSystem(java.lang.CharSequence name,
                                                               VerticalDatum datum)
                                                        throws org.opengis.referencing.FactoryException

Deprecated.

Creates a vertical coordinate system from a datum. Units will be metres and values will be increasing upward.

Parameters:

name - Name to give new object.

datum - Datum to use for new coordinate system.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createVerticalCoordinateSystem

public VerticalCoordinateSystem createVerticalCoordinateSystem(java.lang.CharSequence name,
                                                               VerticalDatum datum,
                                                               Unit unit,
                                                               AxisInfo axis)
                                                        throws org.opengis.referencing.FactoryException

Deprecated.

Creates a vertical coordinate system from a datum and linear units.

Parameters:

name - Name to give new object.

datum - Datum to use for new coordinate system.

unit - Units to use for new coordinate system.

axis - Axis to use for new coordinate system.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createVerticalCoordinateSystem(java.lang.String, org.opengis.cs.CS_VerticalDatum, org.opengis.cs.CS_LinearUnit, org.opengis.cs.CS_AxisInfo)

createCompoundCoordinateSystem

public CompoundCoordinateSystem createCompoundCoordinateSystem(java.lang.CharSequence name,
                                                               CoordinateSystem head,
                                                               CoordinateSystem tail)
                                                        throws org.opengis.referencing.FactoryException

Deprecated.

Creates a compound coordinate system.

Parameters:

name - Name to give new object.

head - Coordinate system to use for earlier ordinates.

tail - Coordinate system to use for later ordinates.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createCompoundCoordinateSystem(java.lang.String, org.opengis.cs.CS_CoordinateSystem, org.opengis.cs.CS_CoordinateSystem)

createFittedCoordinateSystem

public FittedCoordinateSystem createFittedCoordinateSystem(java.lang.CharSequence name,
                                                           CoordinateSystem base,
                                                           MathTransform toBase,
                                                           AxisInfo[] axes)
                                                    throws org.opengis.referencing.FactoryException

Deprecated.

Creates a fitted coordinate system. The units of the axes in the fitted coordinate system will be inferred from the units of the base coordinate system. If the affine map performs a rotation, then any mixed axes must have identical units. For example, a (lat_deg,lon_deg,height_feet) system can be rotated in the (lat,lon) plane, since both affected axes are in degrees. But you should not rotate this coordinate system in any other plane.

Parameters:

name - Name to give new object.

base - Coordinate system to base the fitted CS on.

toBase - The transform from created CS to base CS.

axes - Axes for fitted coordinate system. The number of axes must match the source dimension of the transform toBase. If this argument is null, then axes will be infered from the base coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException

See Also:

CS_CoordinateSystemFactory.createFittedCoordinateSystem(java.lang.String, org.opengis.cs.CS_CoordinateSystem, java.lang.String, org.opengis.cs.CS_AxisInfo[])

createLocalCoordinateSystem

public LocalCoordinateSystem createLocalCoordinateSystem(java.lang.CharSequence name,
                                                         LocalDatum datum,
                                                         Unit unit,
                                                         AxisInfo[] axes)
                                                  throws org.opengis.referencing.FactoryException

Deprecated.

Creates a local coordinate system. The dimension of the local coordinate system is determined by the size of the axis array. All the axes will have the same units.

Parameters:

name - Name to give new object.

datum - Local datum to use in created CS.

unit - Units to use for all axes in created CS.

axes - Axes to use in created CS.

Returns:

The coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createLocalCoordinateSystem(java.lang.String, org.opengis.cs.CS_LocalDatum, org.opengis.cs.CS_Unit, org.opengis.cs.CS_AxisInfo[])

createLocalCoordinateSystem

public LocalCoordinateSystem createLocalCoordinateSystem(java.lang.CharSequence name,
                                                         LocalDatum datum,
                                                         Unit[] units,
                                                         AxisInfo[] axes)
                                                  throws org.opengis.referencing.FactoryException

Deprecated.

Creates a local coordinate system. The dimension of the local coordinate system is determined by the size of the axis array. All the axes will have the same units.

Parameters:

name - Name to give new object.

datum - Local datum to use in created coordinate system.

units - Units to use in created coordinate system.

axes - Axes to use in created coordinate system.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createEllipsoid

public Ellipsoid createEllipsoid(java.lang.CharSequence name,
                                 double semiMajorAxis,
                                 double semiMinorAxis,
                                 Unit unit)
                          throws org.opengis.referencing.FactoryException

Deprecated.

Creates an ellipsoid from radius values.

Parameters:

name - Name to give new object.

semiMajorAxis - Equatorial radius in supplied linear units.

semiMinorAxis - Polar radius in supplied linear units.

unit - Linear units of ellipsoid axes.

Returns:

The ellipsoid.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createEllipsoid(java.lang.String, double, double, org.opengis.cs.CS_LinearUnit)

createFlattenedSphere

public Ellipsoid createFlattenedSphere(java.lang.CharSequence name,
                                       double semiMajorAxis,
                                       double inverseFlattening,
                                       Unit unit)
                                throws org.opengis.referencing.FactoryException

Deprecated.

Creates an ellipsoid from an major radius, and inverse flattening.

Parameters:

name - Name to give new object.

semiMajorAxis - Equatorial radius in supplied linear units.

inverseFlattening - Eccentricity of ellipsoid.

unit - Linear units of major axis.

Returns:

The ellipsoid.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createFlattenedSphere(java.lang.String, double, double, org.opengis.cs.CS_LinearUnit)

createPrimeMeridian

public PrimeMeridian createPrimeMeridian(java.lang.CharSequence name,
                                         Unit unit,
                                         double longitude)
                                  throws org.opengis.referencing.FactoryException

Deprecated.

Creates a prime meridian, relative to Greenwich.

Parameters:

name - Name to give new object.

unit - Angular units of longitude.

longitude - Longitude of prime meridian in supplied angular units East of Greenwich.

Returns:

The prime meridian.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createPrimeMeridian(java.lang.String, org.opengis.cs.CS_AngularUnit, double)

createProjection

public Projection createProjection(java.lang.CharSequence name,
                                   java.lang.String classification,
                                   javax.media.jai.ParameterList parameters)
                            throws org.opengis.referencing.FactoryException

Deprecated.

Creates a projection. The client must ensure that all the linear parameters are expressed in meters, and all the angular parameters are expressed in degrees. Also, they must supply "semi_major" and "semi_minor" parameters. The set of legal parameters and their default values can be queried using createProjectionParameterList(java.lang.String). Example:

  ParameterList param = createProjectionParameterList("Transverse_Mercator")
                                      .setParameter("semi_major", 6378206.4)
                                      .setParameter("semi_minor", 6356583.8);
  Projection proj = createProjection("My projection", "Transverse_Mercator", param);
 

Parameters:

name - Name to give new object.

classification - Classification string for projection (e.g. "Transverse_Mercator").

parameters - Parameters to use for projection. A default set of parameters can be constructed using createProjectionParameterList(classification) and initialized using a chain of setParameter(...) calls. If null, then the default parameters will be used.

Returns:

The projection.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createProjection(java.lang.String, java.lang.String, org.opengis.cs.CS_ProjectionParameter[])

createProjection

public Projection createProjection(java.lang.CharSequence name,
                                   java.lang.String classification,
                                   Ellipsoid ellipsoid,
                                   java.awt.geom.Point2D centre,
                                   java.awt.geom.Point2D translation)
                            throws org.opengis.referencing.FactoryException

Deprecated.

Convenience method for constructing a projection using the specified ellipsoid.

Parameters:

name - Name to give new object.

classification - Classification string for projection (e.g. "Transverse_Mercator").

ellipsoid - Ellipsoid parameter. If non-null, then "semi_major" and "semi_minor" parameters will be set accordingly.

centre - Central meridian and latitude of origin, in degrees. If non-null, then "central_meridian" and "latitude_of_origin" will be set accordingly.

translation - False easting and northing, in metres. If non-null, then "false_easting" and "false_northing" will be set accordingly.

Returns:

The projection.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createProjectionParameterList

public javax.media.jai.ParameterList createProjectionParameterList(java.lang.String classification)

Deprecated.

Returns a default parameter list for the specified projection.

Parameters:

classification - Classification string for projection (e.g. "Transverse_Mercator").

Returns:

A default parameter list for the supplied projection class.

See Also:

createProjection(CharSequence, String, ParameterList)

createHorizontalDatum

public HorizontalDatum createHorizontalDatum(java.lang.CharSequence name,
                                             DatumType.Horizontal type,
                                             Ellipsoid ellipsoid,
                                             WGS84ConversionInfo toWGS84)
                                      throws org.opengis.referencing.FactoryException

Deprecated.

Creates horizontal datum from ellipsoid and Bursa-Wolf parameters. Since this method contains a set of Bursa-Wolf parameters, the created datum will always have a relationship to WGS84. If you wish to create a horizontal datum that has no relationship with WGS84, then you can either specify DatumType.Horizontal.OTHER as the horizontalDatumType, or create it via WKT.

Parameters:

name - Name to give new object.

type - Type of horizontal datum to create.

ellipsoid - Ellipsoid to use in new horizontal datum.

toWGS84 - Suggested approximate conversion from new datum to WGS84.

Returns:

The datum.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createHorizontalDatum(java.lang.String, org.opengis.cs.CS_DatumType, org.opengis.cs.CS_Ellipsoid, org.opengis.cs.CS_WGS84ConversionInfo)

createHorizontalDatum

public HorizontalDatum createHorizontalDatum(java.lang.CharSequence name,
                                             Ellipsoid ellipsoid)
                                      throws org.opengis.referencing.FactoryException

Deprecated.

Creates horizontal datum from an ellipsoid. The datum type will be DatumType.Horizontal.OTHER.

Parameters:

name - Name to give new object.

ellipsoid - Ellipsoid to use in new horizontal datum.

Returns:

The datum.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

createVerticalDatum

public VerticalDatum createVerticalDatum(java.lang.CharSequence name,
                                         DatumType.Vertical type)
                                  throws org.opengis.referencing.FactoryException

Deprecated.

Creates a vertical datum from an enumerated type value.

Parameters:

name - Name to give new object.

type - Type of vertical datum to create.

Returns:

The datum.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createVerticalDatum(java.lang.String, org.opengis.cs.CS_DatumType)

createLocalDatum

public LocalDatum createLocalDatum(java.lang.CharSequence name,
                                   DatumType.Local type)
                            throws org.opengis.referencing.FactoryException

Deprecated.

Creates a local datum.

Parameters:

name - Name to give new object.

type - Type of local datum to create.

Returns:

The datum.

Throws:

java.lang.IllegalArgumentException - if an argument is null or incompatible with the object to be created.

org.opengis.referencing.FactoryException - if an error occurred during the object creation. It may be, for example, a network error or a failure on the server side.

See Also:

CS_CoordinateSystemFactory.createLocalDatum(java.lang.String, org.opengis.cs.CS_DatumType)

createFromWKT

public CoordinateSystem createFromWKT(java.lang.String text)
                               throws org.opengis.referencing.FactoryException

Deprecated.

Creates a coordinate system object from a Well-Known Text (WKT) string. WKT are part of Coordinate Transformation Services Specification. For example, the following is a WKT for a geocentric coordinate system:

 GEOCCS["Geocentric",
   DATUM["WGS_1984",
     SPHEROID["WGS 84", 6378137, 298.257223563, AUTHORITY["EPSG","7030"]],
     TOWGS84[0,0,0,0,0,0,0], AUTHORITY["EPSG","6326"]],
   PRIMEM["Greenwich",0], UNIT["Meter",1],
   AXIS["X", OTHER],
   AXIS["Y", EAST],
   AXIS["Z", NORTH]]
 

Parameters:

text - The Well-Known Text.

Returns:

The coordinate system (never null).

Throws:

org.opengis.referencing.FactoryException - if the Well-Known Text can't be parsed, or if the coordinate system creation failed from some other reason.

getWKTFormat

public java.text.Format getWKTFormat(java.util.Locale locale)

Deprecated.

Returns an object to use for parsing and formatting Well-Known Text. The Format.parseObject(String) method can be used for parsing coordinate systems, datum, ellipsoid and prime meridian.

Parameters:

locale - The locale for the parser (usually Locale.US. This locale will affect the way numbers are parsed.