Java Doc for CRS.java in  » GIS » GeoTools-2.4.1 » org » geotools » referencing » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The following methods may be added in a future version:

• CoordinateReferenceSystem parseXML(String)

This factory can be used as a kind of system-wide factory for all authorities. However for more determinist behavior, consider using a more specific factory (as returned by ReferencingFactoryFinder.getCRSAuthorityFactory when the authority in known.
Parameters:
  longitudeFirst - true if axis order should be forced to(longitude,latitude).

 EPSG:1234
 AUTO:42001, ..., ..., ...
 

CRS objects created by previous calls to this method are using . Subsequent calls to this method with the same authority code should be fast, unless the CRS object has been garbage collected.
Parameters:
  code - The Coordinate Reference System authority code. The Coordinate Reference System for the provided code.
throws:
  NoSuchAuthorityCodeException - If the code could not be understood.
throws:
  FactoryException - if the CRS creation failed for an other reason.
See Also:   CRS.getSupportedCodes
See Also:   org.geotools.referencing.factory.AllAuthoritiesFactory.createCoordinateReferenceSystem

 if (longitudeFirst) {
 hints.put(
 , 
 );
 } else {
 // Do not set the FORCE_LONGITUDE_FIRST_AXIS_ORDER hint to FALSE.
 // Left it unset, which means "use system default".
 }
 

This method argument	value	Meaning
true	Boolean.TRUE TRUE	All coordinate reference systems are forced to (longitude, latitude) axis order.
false	null	Coordinate reference systems may or may not be forced to (longitude, latitude) axis order. The behavior depends on user setting, for example the value of the system property.
	Boolean.FALSE FALSE	Forcing (longitude, latitude) axis order is not allowed, no matter the value of the system property.

Parameters:
  code - The Coordinate Reference System authority code.
Parameters:
  longitudeFirst - true if axis order should be forced to(longitude, latitude). Note that false means"use default", not "latitude first". The Coordinate Reference System for the provided code.
throws:
  NoSuchAuthorityCodeException - If the code could not be understood.
throws:
  FactoryException - if the CRS creation failed for an other reason.
See Also:   CRS.getSupportedCodes
See Also:   Hints.FORCE_LONGITUDE_FIRST_AXIS_ORDER
since:
   2.3

FactoryFinder. (null). (sourceCRS, targetCRS). ();

Sample use:

transform = CRS.findMathTransform( CRS. ("EPSG:42102"), CRS. ("EPSG:4326") );

This factory can be used as a kind of system-wide factory for all authorities. However for more determinist behavior, consider using a more specific factory (as returned by ReferencingFactoryFinder.getCRSAuthorityFactory when the authority in known.
Parameters:
  longitudeFirst - true if axis order should be forced to(longitude,latitude). Note that false means"use default", not "latitude first". The CRS authority factory.
throws:
  FactoryRegistryException - if the factory can't be created.
since:
   2.3

If there is more than one factory for the given authority, then this method merges the code set of all of them. If a factory fails to provide a set of supported code, then this particular factory is ignored. Please be aware of the following potential issues:

• If there is more than one EPSG databases (for example an and a ones), then this method will connect to all of them even if their content are identical.
• If two factories format their codes differently (e.g. "4326" and "EPSG:4326" ), then the returned set will contain a lot of synonymous codes.
• For any code c in the returned set, there is no warranty that (c) will use the same authority factory than the one that formatted c.
• This method doesn't report connection problems since it doesn't throw any exception. FactoryException s are logged as warnings and otherwise ignored.

If a more determinist behavior is wanted, consider the code below instead. The following code exploit only one factory, the "preferred" one.

factory = FactoryFinder. (authority, null);
Set<String> codes = factory. (CoordinateReferenceSystem.class);
String code = ...choose a code here...
crs = factory.createCoordinateReferenceSystem(code);

This convenience method delegates its work to IdentifiedObjectFinder . Consider using the later if more control are wanted, for example if the search shall be performed only on some instead of all registered onez, or if the full is wanted instead of only its identifier.
Parameters:
  object - The object (usually a ) looked up.
Parameters:
  fullScan - If true , an exhaustive full scan against all registered objectswill be performed (may be slow). Otherwise only a fast lookup based on embeddedidentifiers and names will be performed. The identifier, or null if not found.
throws:
  FactoryException - if an unexpected failure occured during the search.
See Also:   AbstractAuthorityFactory.getIdentifiedObjectFinder
See Also:   IdentifiedObjectFinder.find
since:
   2.4

By default, this method prints all enumerated objects as Well Known Text. However this method can prints different kind of information if an option such as -factories , -codes or -bursawolfs is provided.

Usage: java org.geotools.referencing.CRS [options] [codes]
Options:

-authority =name
Uses the specified authority factory, for example "EPSG" . The authority name can be any of the authorities listed by the -factories option. If this option is not specified, then the default is all factories.

-bursawolfs codes
Lists the Bursa-Wolf parameters for the specified CRS ou datum objects. For some transformations, there is more than one set of Bursa-Wolf parameters available. The standard Well Known Text format prints only what look like the "main" one. This option display all Bursa-Wolf parameters in a table for a given object.

-codes
Lists all available authority codes. Use the -authority option if the list should be restricted to a single authority.

-colors
Enable syntax coloring on ANSI X3.64 compatible (aka ECMA-48 and ISO/IEC 6429) terminal. This option tries to highlight most of the elements relevant to the CRS.equalsIgnoreMetadataequalsIgnoreMetadata method, with the addition of Bursa-Wolf parameters.

-encoding =charset
Sets the console encoding for this application output. This value has no impact on data, but may improve the output quality. This is not needed on Linux terminal using UTF-8 encoding (tip: the terminus font gives good results). Windows users may need to set this encoding to the value returned by the chcp command line. This parameter need to be specified only once.

-dependencies
Lists authority factory dependencies as a tree.

-factories
Lists all availables CRS authority factories.

-forcexy
Force "longitude first" axis order.

-help
Prints the list of options.

-locale =name
Formats texts in the specified .

-operations sourceCRS targetCRS
Prints all available coordinate operations between a pair of CRS. This option prints only the operations explicitly defined in a database like EPSG. There is sometime many such operations, and sometime none (in which case this option prints nothing - it doesn't try to find an operation by itself).

-transform sourceCRS targetCRS
Prints the preferred math transform between a pair of CRS. At the difference of the "-operations" option, this option pick up only one operation (usually the most accurate one), inferring it if none were explicitly specified in the database.

CRS EPSG:4181 EPSG:4326 CRS:84 AUTO:42001,30,0
Prints the "Luxembourg 1930" CRS, the "WGS 84" CRS (from EPSG database), the ""WGS84" CRS (from the Web Map Service specification) and a UTM projection in WKT format.

CRS -authority=EPSG 4181 4326
Prints the "Luxembourg 1930" and "WGS 84" CRS, looking only in the EPSG database (so there is no need to prefix the codes with "EPSG" ).

CRS -colors EPSG:7411
Prints the "NTF (Paris) / Lambert zone II + NGF Lallemand" CRS with syntax coloring enabled.

CRS -bursawolfs EPSG:4230
Prints three set of Bursa-Wolf parameters for a CRS based on "European Datum 1950".

CRS -authority=EPSG -operations 4230 4326
Prints all operations declared in the EPSG database from "ED50" to "WGS 84" geographic CRS. Note that for this particular pair of CRS, there is close to 40 operations declared in the EPSG database. This method prints only the ones that Geotools can handle.

CRS -transform EPSG:4230 EPSG:4326
Prints the math transform that Geotools would use by default for coordinate transformation from "ED50" to "WGS 84".

FactoryFinder. (null). (wkt);

Note that this method can not handle the case where the envelope contains the North or South pole, or when it cross the ±180� longitude, because do not carry suffisient informations. For a more robust envelope transformation, use CRS.transform(CoordinateOperation,Envelope) instead.
Parameters:
  transform - The transform to use.
Parameters:
  envelope - Envelope to transform, or null . This envelope will not be modified. The transformed envelope, or null if envelope was null.
throws:
  TransformException - if a transform failed.
since:
   2.4

This method can handle the case where the envelope contains the North or South pole, or when it cross the ±180� longitude.
Parameters:
  operation - The operation to use. Source and target dimension must be 2.
Parameters:
  envelope - Envelope to transform, or null . This envelope will not be modified. The transformed envelope, or null if envelope was null.
throws:
  TransformException - if a transform failed.
since:
   2.4

transform(transform, new GeneralEnvelope(envelope)).toRectangle2D()

Note that this method can not handle the case where the rectangle contains the North or South pole, or when it cross the ±180� longitude, because do not carry suffisient informations. For a more robust rectangle transformation, use CRS.transform(CoordinateOperation,Rectangle2D,Rectangle2D) instead.
Parameters:
  transform - The transform to use. Source and target dimension must be 2.
Parameters:
  envelope - The rectangle to transform (may be null ).
Parameters:
  destination - The destination rectangle (may be envelope ).If null , a new rectangle will be created and returned. destination , or a new rectangle if destination was non-nulland envelope was null.
throws:
  TransformException - if a transform failed.
since:
   2.4

transform(operation, new GeneralEnvelope(envelope)).toRectangle2D()

This method can handle the case where the rectangle contains the North or South pole, or when it cross the ±180� longitude.
Parameters:
  operation - The operation to use. Source and target dimension must be 2.
Parameters:
  envelope - The rectangle to transform (may be null ).
Parameters:
  destination - The destination rectangle (may be envelope ).If null , a new rectangle will be created and returned. destination , or a new rectangle if destination was non-nulland envelope was null.
throws:
  TransformException - if a transform failed.
since:
   2.4