com.esri.sde.sdk.pe
Class PeCoordinateSystem

java.lang.Object
  com.esri.sde.sdk.pe.PeObject
      com.esri.sde.sdk.pe.PeCoordinateSystem

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

PeGeographicCS, PeProjectedCS

public abstract class PeCoordinateSystem
extends PeObject

A Coordinate System superclass to manipulate a Projected and Geographic Coordinate System object.

All spatial data has a coordinate system. A coordinate system locates the data in either two- or three-dimensional space. Knowing the data's coordinate system is very important if you want to combine data from different sources. Most spatial data are in a geographic or projected (planar) coordinate system. The model for coordinate reference systems described here is based upon the OpenGIS specification and the POSC Epicentre Model V 2.1 which share a common set of basic principles. Please refer to these references for the full description of the concepts and definitions for components of a coordinate reference system.

Applications that use maps as analytical tools need the coordinate system and its properties for all spatial data. The Projection Engine uses a projection system to store projection and coordinate information in a format that is accessible to applications. In addition to x,y planar coordinates, you can store z-coordinates or measures. The PE software assumes planar data when performing calculations. The PE software can store projected or geographic data but measurements and calculations on geographic coordinates may not be accurate.

The Projection Engine does the actual creation and maintenance of the coordinate system. The Projection Engine supports projected and geographic coordinate system with the PeProjectedCS and PeGeographicCS classes.

Constructor Summary

PeCoordinateSystem()

Method Summary

java.lang.Object	clone() Clone a coordinate system.
void	delete() Deletes a coordsys.
static PeCoordinateSystem	fromPrjFile(java.lang.String path) Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.fromPrjFile(java.lang.String).
static PeCoordinateSystem	fromPrjString(java.lang.String string) Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.fromPrjString(java.lang.String).
static PeCoordinateSystem	fromString(java.lang.String str) Create a coordsys from a string.
PeAuthority	getAuthority() Set the authority in a coordsys
PeMetadata	getMetadata() Get the metadata in a coordsys
boolean	isEqual(PeCoordinateSystem coordsys) Tests if two coordinate systems are identical.
void	setAuthority(PeAuthority authority) Get the authority in a coordsys
void	setMetadata(PeMetadata metadata) Set the metadata in a coordsys
void	toPrjFile(PeUnit zunit, java.lang.String filePath) Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.toPrjFile(com.esri.sde.sdk.pe.PeCoordinateSystem, com.esri.sde.sdk.pe.PeUnit, java.lang.String).
java.lang.String	toPrjString(PeUnit zunit) Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.toPrjString(com.esri.sde.sdk.pe.PeCoordinateSystem, com.esri.sde.sdk.pe.PeUnit).
java.lang.String	toString() Retrieves the external representation of this coordinate system.
java.lang.String	toString(int mode) Retrieves the extended external representation of this coordinate system.

Methods inherited from class com.esri.sde.sdk.pe.PeObject

fromAnyString, fromStringByType, getAuth, getCode, getName, getStatus, getType, isEqual, setAuth

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PeCoordinateSystem

public PeCoordinateSystem()

Method Detail

delete

public void delete()

Deletes a coordsys.

Specified by:

delete in class PeObject

fromString

public static PeCoordinateSystem fromString(java.lang.String str)
                                     throws PeProjectionException

Create a coordsys from a string.

Throws:

PeProjectionException

isEqual

public boolean isEqual(PeCoordinateSystem coordsys)

Tests if two coordinate systems are identical.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Clone a coordinate system.

Overrides:

clone in class java.lang.Object

Throws:

java.lang.CloneNotSupportedException

toString

public java.lang.String toString()

Retrieves the external representation of this coordinate system.

Specified by:

toString in class PeObject

toString

public java.lang.String toString(int mode)

Retrieves the extended external representation of this coordinate system.

Specified by:

toString in class PeObject

getAuthority

public PeAuthority getAuthority()

Set the authority in a coordsys

setAuthority

public void setAuthority(PeAuthority authority)

Get the authority in a coordsys

getMetadata

public PeMetadata getMetadata()

Get the metadata in a coordsys

setMetadata

public void setMetadata(PeMetadata metadata)

Set the metadata in a coordsys

fromPrjFile

public static PeCoordinateSystem fromPrjFile(java.lang.String path)
                                      throws PeProjectionException

Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.fromPrjFile(java.lang.String).

Creates a CS object from an ARC/INFO workstation PRJ file.

Throws:

PeProjectionException

fromPrjString

public static PeCoordinateSystem fromPrjString(java.lang.String string)
                                        throws PeProjectionException

Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.fromPrjString(java.lang.String).

Creates a CS object from an ARC/INFO workstation PRJ.

Throws:

PeProjectionException

toPrjFile

public void toPrjFile(PeUnit zunit,
                      java.lang.String filePath)
               throws PeProjectionException

Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.toPrjFile(com.esri.sde.sdk.pe.PeCoordinateSystem, com.esri.sde.sdk.pe.PeUnit, java.lang.String).

Creates an ARC/INFO workstation PRJ file from a CS.

Throws:

PeProjectionException

toPrjString

public java.lang.String toPrjString(PeUnit zunit)
                             throws PeProjectionException

Deprecated. This will be removed after version 10.0. It is replaced by PeProjFile.toPrjString(com.esri.sde.sdk.pe.PeCoordinateSystem, com.esri.sde.sdk.pe.PeUnit).

Creates an ARC/INFO workstation PRJ string from a CS.

Throws:

PeProjectionException