|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectmccombe.mapping.CoordinateSystem
mccombe.mapping.Projection
mccombe.mapping.TransverseMercator
mccombe.mapping.OSGB
public class OSGB
Class OSGB provides handling for the Ordnance Survey of Great Britain coordinate system.
OSGB is a conventional Transverse Mercator coordinate system in which a standard sphere (the "Airy 1830 sphere") is projected onto a plane. Several other well-known coordinate systems operate in the same way (e.g. the Irish Grid and UTM) but with origins and spheroids chosen to be most suitable to the area of use. The OSGB grid is applicable only to Great Britain (i.e. England, Scotland and Wales but NOT Northern Ireland or the Republic of Ireland, or the Channel Islands).
For more information about OSGB and the manipulation of Transverse Mercator coordinate systems you could try:-
"A guide to coordinate systems in Great Britain" - Ordnance Survey of Great Britain "GDA Technical Manual" at www.anzlic.org.au
Field Summary |
---|
Fields inherited from class mccombe.mapping.TransverseMercator |
---|
northernHemisphere, zone |
Fields inherited from class mccombe.mapping.CoordinateSystem |
---|
locus, ref, sph |
Constructor Summary | |
---|---|
OSGB(ENPair p)
Create a new OSGB object using Easting and Northing distances. |
|
OSGB(ENPair p,
Ellipsoid e,
Datum d)
Create a new OSGB object from easting and northing distances |
|
OSGB(Position p,
Ellipsoid e,
Datum d)
Create a new OSGB object for a specific Position, Ellipsoid and Datum. |
Method Summary | |
---|---|
Datum |
defaultDatum()
Define the defaultDatum for this CoordinateSystem |
Ellipsoid |
defaultEllipsoid()
Define the default Ellipsoid for this CoordinateSystem |
double |
e0()
Define false easting value |
double |
f0()
Define the scale factor on the central meridian |
double |
lamda0()
Define value of central meridian (degrees) |
static OSGB |
makePoint(java.lang.String osReference,
Ellipsoid e,
Datum d)
Create a new OSGB point based on a grid reference. |
double |
n0()
Define the false northing value |
double |
phi0()
Define latitude of true origin |
java.lang.String |
toString()
Provide a String representation for this point. |
protected static boolean |
validateEN(ENPair p)
Check that ENPair lies within the permitted range |
Methods inherited from class mccombe.mapping.TransverseMercator |
---|
gridConvergence, pointScaleFactor, toEN |
Methods inherited from class mccombe.mapping.CoordinateSystem |
---|
getDatum, getEllipsoid, getName, getPosition, getWGS84, parseDouble, toLatLong, toLatLongString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public OSGB(ENPair p, Ellipsoid e, Datum d)
p
- Easting and Northing distances (m)e
- Ellipsoid used by this pointd
- Datum used for this point.public OSGB(ENPair p)
p
- The easting and northing distances (m)public OSGB(Position p, Ellipsoid e, Datum d)
p
- the Position of this point.e
- The Ellipsoid to use (normally Ellipsoid.AIRY)d
- The Datum to use (normally Datum.OSGB_1936)Method Detail |
---|
public static OSGB makePoint(java.lang.String osReference, Ellipsoid e, Datum d) throws GridFormatException
try { OSGB point = OSGB.makePoint("ST755619", Ellipsoid.AIRY, Datum.OSGB_1936); Position here = point.getPosition(); ... } catch(GridFormatException e){ //Handle exception ... }
osReference
- A String containg a valid grid reference. This consists of a two-letter
grid square (e.g. "ST") followed by 1-5 digits of easting and the same number of digits
of northing. Whitespace may appear between the grid-letters and easting and between
easting and northing values.e
- The Ellipsoid used in conjunction with this point. This is almost always the
Airy (1830) sphere.d
- The Datum to use in conjunction with this point. This is almost always the
OSGB (1936) Datum.
GridFormatException
- A GridFormatException is thrown whenever the grid reference provided has invalid
syntax.public Datum defaultDatum()
defaultDatum
in class CoordinateSystem
public Ellipsoid defaultEllipsoid()
defaultEllipsoid
in class CoordinateSystem
public java.lang.String toString()
toString
in class CoordinateSystem
public double f0()
f0
in class TransverseMercator
public double phi0()
phi0
in class TransverseMercator
public double n0()
n0
in class TransverseMercator
public double e0()
e0
in class TransverseMercator
public double lamda0()
lamda0
in class TransverseMercator
protected static boolean validateEN(ENPair p)
p
-
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |