ucar.unidata.geoloc.ogc

Class WKTParser

java.lang.Object

ucar.unidata.geoloc.ogc.WKTParser

public class WKTParser
extends java.lang.Object

This class parses OGC WKT Spatial Reference Text.

Author:

Barrodale Computing Services, Ltd. (Eric Davies), Unidata Java Development Team

Constructor Summary

Constructors

Constructor and Description
WKTParser(java.lang.String srtext) Creates a new instance of WKTParser.

Method Summary

Methods

Modifier and Type	Method and Description
static ProjectionImpl	convertWKTToProjection(WKTParser srp) Convert OGC spatial reference WKT to a ProjectionImpl.
java.lang.String	getDatumName() Get the datum name.
java.lang.String	getGeogcsName() Get the name of the geographic coordinate system.
java.lang.String	getGeogUnitName() Get the name of the unit that the prime meridian is expressed in.
double	getGeogUnitValue() Get the size of the unit that the prime meridian is expressed in.
double	getInverseFlattening() Get the inverse flattening.
double	getMajorAxis() Get the major axis of the spheroid.
double	getParameter(java.lang.String name) Get the value of the projection parameter.
java.lang.String	getPrimeMeridianName() Get the name of the prime meridian.
double	getPrimeMeridianValue() Return the value of prime meridian.
java.lang.String	getProjectionType() Get the name of the type of projection.
java.lang.String	getProjName() Get the name of the projection.
java.lang.String	getProjUnitName() Get the name of the projection unit.
double	getProjUnitValue() Get the projection unit value.
java.lang.String	getSpheroidName() Get the name of the spheroid.
boolean	hasParameter(java.lang.String name) Inquire if a particular projection parameter is present.
boolean	isPlanarProjection() Determine if the spatial reference text defines a planar projection, as opposed to a Geographic coordinate system.
static void	main(java.lang.String[] args)

Methods inherited from class java.lang.Object

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

Constructor Detail

WKTParser

public WKTParser(java.lang.String srtext)
          throws java.text.ParseException

Creates a new instance of WKTParser. If the constructor succeeds, the spatial reference text was successfully parsed.

Parameters:

srtext - The spatial reference text to be parsed. Geocentric coordinate text is not currently supported.

Throws:

java.text.ParseException - A ParseException is thrown if the spatial reference text could not be parsed.

Method Detail

getGeogcsName

public java.lang.String getGeogcsName()

Get the name of the geographic coordinate system.

Returns:

the name.

getDatumName

public java.lang.String getDatumName()

Get the datum name. Note that the datum name itself implies information not found in the spheroid.

Returns:

The name of the datum.

getSpheroidName

public java.lang.String getSpheroidName()

Get the name of the spheroid.

Returns:

The name of the spheroid.

getMajorAxis

public double getMajorAxis()

Get the major axis of the spheroid.

Returns:

The major axis of the spheroid, in meters.

getInverseFlattening

public double getInverseFlattening()

Get the inverse flattening.

Returns:

The inverse flattening. Note that this is unitless.

getPrimeMeridianName

public java.lang.String getPrimeMeridianName()

Get the name of the prime meridian.

Returns:

the name of the prime meridian. Usually "Greenwich".

getPrimeMeridianValue

public double getPrimeMeridianValue()

Return the value of prime meridian.

Returns:

The longitude of the prime meridian, usually 0.

getGeogUnitName

public java.lang.String getGeogUnitName()

Get the name of the unit that the prime meridian is expressed in.

Returns:

Tje name of the unit that the prime meridian is expressed in. Usually "Degree".

getGeogUnitValue

public double getGeogUnitValue()

Get the size of the unit that the prime meridian is expressed in.

Returns:

The conversion from the prime meridian units to radians.

hasParameter

public boolean hasParameter(java.lang.String name)

Inquire if a particular projection parameter is present.

Parameters:

name - The name of the parameter. Case is ignored.

Returns:

True if the parameter is present.

getParameter

public double getParameter(java.lang.String name)

Get the value of the projection parameter. An IllegalArgument exception is thrown if the parameter is not found.

Parameters:

name - The name of the parameter. Case is ignored.

Returns:

The value of the parameter, as a double.

isPlanarProjection

public boolean isPlanarProjection()

Determine if the spatial reference text defines a planar projection, as opposed to a Geographic coordinate system.

Returns:

True if the spatial reference text defines a planar projection system.

getProjName

public java.lang.String getProjName()

Get the name of the projection.

Returns:

The name of the projection.

getProjectionType

public java.lang.String getProjectionType()

Get the name of the type of projection.

Returns:

Returns the name of the type of the projection. For example,Transverse_Mercator. Returns null for geographic coordinate systems.

getProjUnitName

public java.lang.String getProjUnitName()

Get the name of the projection unit.

Returns:

Get the name of the projection unit. Usually "Meter".

getProjUnitValue

public double getProjUnitValue()

Get the projection unit value.

Returns:

The size of the projection unit, in meters.

convertWKTToProjection

public static ProjectionImpl convertWKTToProjection(WKTParser srp)

Convert OGC spatial reference WKT to a ProjectionImpl. An IllegalArgumentException may be thrown if a parameter is missing.

Parameters:

srp - The parsed OGC WKT spatial reference text.

Returns:

The ProjectionImpl class.

Throws:

java.text.ParseException - If the OGIS spatial reference text was not parseable.

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException,
                        java.text.ParseException

Throws:

java.io.IOException

java.text.ParseException