SRM.BaseSRF Class Reference

The BaseSRF abstract class is the base class for all SRFs. More...

Inheritance diagram for SRM.BaseSRF:


Public Member Functions
SRM_SRF_Code	getSRFCode ()
	Returns this pre-defined ("standard") SRF code.
SRM_SRFT_Code	getSRFTemplateCode ()
	Returns this SRF's Template code.
SRM_SRFS_Code	getSRFSetCode ()
	Returns this SRF's Set code.
SRM_SRFSM_Code	getSRFSetMemberCode ()
	Returns this SRF's Set member code.
SRM_CS_Code	getCSCode ()
	Returns this SRF's CS Code.
SRM_ORM_Code	get_orm ()
	Returns this SRF's Object Reference Model code.
SRM_RT_Code	get_rt ()
	Returns this SRF's Rt code.
SRM_Coordinate_Valid_Region_Code	changeCoordinateSRF (Coord src, Coord tgt) throws SrmException
	Changes a coordinate's values to this SRF.
SRM_Coordinate_Valid_Region_Code	checkCoordinate (Coord src) throws SrmException
	Check a coordinate in this SRF for valid region.
abstract String	toString ()
	Returns a string representation of this SRF.
abstract boolean	isEqual (BaseSRF srf)
BaseSRF	makeClone () throws SrmException
	Returns the shallow copy of this object instance.
Static Public Member Functions
BaseSRF	createStandardSRF (SRM_SRF_Code srf_code, SRM_RT_Code rt_code) throws SrmException
	Creates a Standard SRF from its SRF code.
BaseSRF	createSRFSetMember (SRM_SRFS_Code srf_set, SRM_SRFSM_Code set_member, SRM_ORM_Code orm, SRM_RT_Code rt) throws SrmException
	Creates an SRF from a SRF set code, a set member code specific to that set, and an ORM code.
boolean	querySRFTSupport (SRM_SRFT_Code srft_code)
	Queries for the SRFT support by the implementation.
double	calculateEuclideanDistance (Coord coord1, Coord coord2) throws SrmException
	Returns the euclidean distance between two coordinates.
Protected Member Functions
void	setSrfCode (SRM_SRF_Code srfCode)
void	setSrfSetCode (SRM_SRFS_Code srfSetCode)
void	setSrfSetMemberCode (SRM_SRFSM_Code srfSetMemberCode)
Static Protected Member Functions
double[]	interimConv (Coord src_coord, SRM_SRFT_Code tgt_srft) throws SrmException
Protected Attributes
SRM_ORM_Code	_orm
SRM_RT_Code	_rt
SRM_SRFT_Code	_mySrftCode = SRM_SRFT_Code.SRFT_UNDEFINED
SRM_CS_Code	_myCsCode = SRM_CS_Code.CS_UNDEFINED
CacheManager	_myOpSeq
HashMap	_internalSRFs
Static Package Functions
boolean	queryORMSupport (SRM_ORM_Code orm_code, SRM_RT_Code rt_code)
	Queries for the ORM/RT pair support by the implementation.

Detailed Description

The BaseSRF abstract class is the base class for all SRFs.

Author:: David Shen

See also:: BaseSRF_2D, BaseSRF_3D

Member Function Documentation

double SRM.BaseSRF.calculateEuclideanDistance ( Coord coord1,

Coord coord2

) throws SrmException [static]

Returns the euclidean distance between two coordinates.

Parameters:

coord1 in: a coordinate in some SRF

coord2 in: a coordinate in some SRF

Returns:
the Euclidean distance between the two coordinates (in meters).

Note:
The input coordinates do not need to be from the same SRF, but must have the same dimensionality, i.e., both 2D, 3D, or Surface.
This method will make (and cache) internal conversions when the inputs coordinates are from SRFs other than SRF_Celestiocentric.

SRM_Coordinate_Valid_Region_Code SRM.BaseSRF.changeCoordinateSRF ( Coord src,

Coord tgt

) throws SrmException

Changes a coordinate's values to this SRF.

Parameters:

src in: the source coordinate in some other SRF

tgt in out: the target coordinate in this SRF

Returns:
the Valid Region of the target coordinate The source and target coordinates must be of same the dimension (2D or 3D).

SRM_Coordinate_Valid_Region_Code SRM.BaseSRF.checkCoordinate ( Coord src ) throws SrmException

Check a coordinate in this SRF for valid region.

Parameters:

src in: the source coordinate in some other SRF

Returns:
the coordinate valid region code in the coordinate's SRF

Note:
The input coordinate must have been created using this SRF.
This case is where the validity boundaries for an SRF are in a different SRF from the SRF itself
this is the easy case where the boundaries are in the same srf

BaseSRF SRM.BaseSRF.createSRFSetMember ( SRM_SRFS_Code srf_set,

SRM_SRFSM_Code set_member,

SRM_ORM_Code orm,

SRM_RT_Code rt

) throws SrmException [static]

Creates an SRF from a SRF set code, a set member code specific to that set, and an ORM code.

Parameters:

srf_set in: the code for an SRF set

set_member in: the code for an SRF set member.

orm in: the ORM code associated with the created SRF

rt in: the RT transformation associated with the created SRF

Returns:
a SRF template instance associated with the SRF Set member.

Note:
All SRFs are intrinsically created from a template, hence the appropriate template instance will always be returned.
There is a specific sub-class of SRM_SRFSM_Code class associated with a SRF set for specifying its member code as follows:.
The SRFS member code "UNDEFINED" is not allowed when specifying a SRF set member.

Alabama SPCS => SRM_SRFSM_Alabama_SPCS_Code

Global Coordinate System (GTRS) => SRM_SRFSM_GTRS_GCS_Code

Lambert NTF => SRM_SRFSM_Lambert_NTF_Code

Japan Plane System => SRM_SRFSM_Japan_RPCS_Code

Universal Polar Stereographic => SRM_SRFSM_UPS_Code

Universal Transverse Mercator => SRM_SRFSM_UTM_Code

Wisconsin SPCS => SRM_SRFSM_Wisconsin_SPCS_Code

See also:
createSRFSetMember(), SRM_SRFS_Code, SRM_SSM_Code
A sample code to create a UTM SRF corresponding to Zone 12 Southern hemisphere based on WGS 1984 with Identity transformation is as follows:
import SRM.*; ... // call createSRFSetMember with: // SRF Set code => UTM // Set Member code => Zone 12 southern hemisphere // ORM => WGS 1984 // RT => WGS 1984 IDENTITY transformation try { BaseSRF utmSrf = BaseSRF.createSRFSetMember( SRM_SRFS_Code.SRFS_UNIVERSAL_TRANSVERSE_MERCATOR, SRFSM_UTM_Code.SRFMSUTM_ZONE_12_SOUTHERN_HEMISPHERE, SRM_ORM_Code.ORM_WGS_1984, SRM_RT_Code.RT_WGS_1984_IDENTITY ); } catch (SrmException ex) ... // Note1: In this example, the returned object is of class SRF_TransverseMercator with its paramters pre-defined. // Note2: The SRFS member code (SRFSM_UTM_Code) must be compatible with the SRFS code (SRFS_UNIVERSAL_TRANSVERSE_MERCATOR).

BaseSRF SRM.BaseSRF.createStandardSRF ( SRM_SRF_Code srf_code,

SRM_RT_Code rt_code

) throws SrmException [static]

Creates a Standard SRF from its SRF code.

Parameters:

srf_code in: the code for a standard SRF to create

Returns:
a SRF template instance associated with the "Standard" SRF.

Note:
Use the concrete SRF classes to create SRFs that are not "standard", which require specific constructor parameters.
All SRFs are intrinsically created from a template, hence the appropriate template instance will always be returned.

See also:
createStandardSRF(), SRM_SRF_Code
A sample code to create a British National Grid (BNG) SRF is a follows:
import SRM.*; ... // call createStandardSRF with: // SRF code => SRF_BRITISH_NATIONAL_GRID_AIRY try { BaseSRF bngSrf = BaseSRF.createStandardSRF( SRM_SRF_Code.SRF_BRITISH_NATIONAL_GRID, SRM_RT_Code.RT_OSGB_1936_3_MEAN_SOLUTION ); } catch (SrmException ex) ... // Note1: In this example, the returned object is of class SRF_TransverseMercator with its pre-defined parameters. // Note2: The RT parameter must be compitible with the ORM_OSGB_1936. (See User's Guide for the pre-assigned ORMs to each of the standard SRFs.

SRM_ORM_Code SRM.BaseSRF.get_orm ( )

Returns this SRF's Object Reference Model code.

Returns:
an ORM code of this SRF

SRM_RT_Code SRM.BaseSRF.get_rt ( )

Returns this SRF's Rt code.

Returns:
an RT code of this SRF

SRM_CS_Code SRM.BaseSRF.getCSCode ( )

Returns this SRF's CS Code.

Returns:
the SRF CS code of this SRF

SRM_SRF_Code SRM.BaseSRF.getSRFCode ( )

Returns this pre-defined ("standard") SRF code.

Returns:
the pre-defined SRF code of this SRF This method will return "SRF_UNDEFINED" if the SRF was not originally created with the createStandardSRF method.

See also:
createStandardSRF()

SRM_SRFS_Code SRM.BaseSRF.getSRFSetCode ( )

Returns this SRF's Set code.

Returns:
the SRF Set code of this SRF This method will return "SRFS_UNDEFINED" if the SRF Set was not originally created with the createSRFSetMember method.

See also:
createSRFSetMember()

SRM_SRFSM_Code SRM.BaseSRF.getSRFSetMemberCode ( )

Returns this SRF's Set member code.

Returns:
the SRF Set member code of this SRF This method will return 0 (which means "UNDEFINED") if the SRF Set was not originally created with the createSRFSetMember method.

See also:
createSRFSetMember()

SRM_SRFT_Code SRM.BaseSRF.getSRFTemplateCode ( )

Returns this SRF's Template code.

Returns:
the SRF Template code of this SRF

See also:
createStandardSRF()

abstract boolean SRM.BaseSRF.isEqual ( BaseSRF srf ) [pure virtual]

Returns:
TRUE if the SRF parameters are equal.

Note:
This method returns FALSE if the input srf is null

BaseSRF SRM.BaseSRF.makeClone ( ) throws SrmException

Returns the shallow copy of this object instance.

Note:
The cloned object will reference the same object as the original object.

boolean SRM.BaseSRF.queryORMSupport ( SRM_ORM_Code orm_code,

SRM_RT_Code rt_code

) [static, package]

Queries for the ORM/RT pair support by the implementation.

Parameters:

orm_code in: the object reference model code.

rt_code in: the reference transformation code.

Returns:
true if the ORM/RT pair is supported by this implementation.

Note:
Not all the supported SRFTs is compatible with all the supported ORM/RT pairs.

boolean SRM.BaseSRF.querySRFTSupport ( SRM_SRFT_Code srft_code ) [static]

Queries for the SRFT support by the implementation.

Returns:
true if the SRFT is supported by this implementation.

The documentation for this class was generated from the following file:

BaseSRF.java

Spatial Reference Model Java API	Version 4.1 - 10 Apr 2006
Copyright © 2006 SEDRIS™	Docs by Doxygen 1.3.2

SRM.BaseSRF Class Reference

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Package Functions

Detailed Description

Member Function Documentation