GeoTransform



Overview
Download
API
Sample Code
Credits

 

JavaDoc Documentation:

The source code for the GeoTransform package has been documented to support the javadoc utility. This utility automatically extracts structure and comment information from the package's source code.

Click here for the GeoTransform javadoc documentation.

API Overview:

This package is designed around a flat hierarchy to avoid the overhead of many classes. Speed was chosen over the niceties of object oriented design. Each coordinate conversion class was designed to transform an array of points - rather than a single point - in order to reduce the overhead of method calls for large numbers of conversions. A simple wrapper method is supplied in each class to also convert a single point.

The conversion classes are first initialized by the user. During initialization constants are created that are used for repeated calls to the converter.  The initialization method defaults to the WGS-84 Ellipsoid.  It may also be called with another ellipsoid or with direct input of the semi-major axis and inverse flatting.

Note that the conversion classes are static and cannot be instantiated directly.

The sub-directory structure and package is designed as follows:
 
 
geotransform
coords ellipsoids datum transforms
Gcc_Coord_3d Ellipsoid Create_Datum Gcc_To_Gdc_Converter
Gdc_Coord_3d AA_Ellipsoid Datum.java Gdc_To_Gcc_Converter
Utm_Coord_3d AN_Ellipsoid Gdc_To_Utm_Converter
OSGB_Coord_3d BN_Ellipsoid Utm_To_Gdc_Converter
... BR_Ellipsoid Gcc_To_Utm_Converter
CC_Ellipsoid Utm_To_Gcc_Converter
... ...
WE_Ellipsoid (wgs 84)

Ellipsoid Support:

The ellispoid classes are as follows:
 
 

Class Name a f Description
AA_Ellipsoid 6377563.396 299.3249646 Airy 1830
AM_Ellipsoid 6377340.189 299.3249646 Modified Airy
AN_Ellipsoid 6378160 298.25 Australian National
BN_Ellipsoid 6377483.865 299.1528128 Bessel 1841 (Namibia)
BR_Ellipsoid 6377397.155 299.1528128 Bessel 1841 (Ethiopia Indonesia Japan Korea)
CC_Ellipsoid 6378206.4 294.9786982 Clarke 1866
CD_Ellipsoid 6378249.145 293.465 Clarke 1880
EA_Ellipsoid 6377276.345 300.8017 Everest (India 1830)
EB_Ellipsoid 6377298.556 300.8017 Everest (Sabah & Sarawak)
EC_Ellipsoid 6377301.243 300.8017 Everest (India 1956)
ED_Ellipsoid 6377295.664 300.8017 Everest (West Malaysia 1969)
EE_Ellipsoid 6377304.063 300.8017 Everest (West Malaysia & Singapore 1948)
FA_Ellipsoid 6378155 298.3 Modified Fischer 1960
HE_Ellipsoid 6378200 298.3 Helmert 1906
HO_Ellipsoid 6378270 297 Hough 1960
IN_Ellipsoid 6378388 297 International 1924
KA_Ellipsoid 6378245 298.3 Krassovsky 1940
RF_Ellipsoid 6378137 298.257222101 Geodetic Reference System 1980 (GRS 80)
SA_Ellipsoid 6378160 298.25 South American 1969
WD_Ellipsoid 6378135 298.26 WGS 72
WE_Ellipsoid 6378137 298.257223563 WGS 84

.get_id()  Each ellispoid provides this function that returns a byte code identifier.

Datum Support:

GeoTransform supports 239 Datum definitions.

Datum	Ellipsoid	Where?
----------------------------------------
WGS 1984	WE	Global Definition
Adindan	CD	Burkina Faso
Adindan	CD	Cameroon
Adindan	CD	Ethiopia
Adindan	CD	Mali
Adindan	CD	MEAN FOR Ethiopia, Sudan
Adindan	CD	Senegal
Adindan	CD	Sudan
Afgooye	KA	Somalia
Ain el Abd 1970	IN	Bahrain
Ain el Abd 1970	IN	Saudi Arabia
American Samoa 1962	CC	American Samoa Islands
Anna 1 Astro 1965	AN	Cocos Islands
Antigua Island Astro 1943	CD	Antigua (Leeward Islands)
Arc 1950	CD	Botswana
Arc 1950	CD	Burundi
Arc 1950	CD	Lesotho
Arc 1950	CD	Malawi
Arc 1950	CD	MEAN FOR Botswana, Lesotho, Malawi,
Arc 1950	CD	  Swaziland, Zaire, Zambia, Zimbabwe
Arc 1950	CD	Swaziland
Arc 1950	CD	Zaire
Arc 1950	CD	Zambia
Arc 1950	CD	Zimbabwe
Arc 1960	CD	MEAN FOR Kenya, Tanzania
Ascension Island 1958	IN	Ascension Island
Astro Beacon E 1945	IN	Iwo Jima
Astro DOS 71/4	IN	St Helena Island
Astro Tern Island (FRIG) 1961	IN	Tern Island
Astronomical Station 1952	IN	Marcus Island
Australian Geodetic 1966	AN	Australia, Tasmania
Australian Geodetic 1984	AN	Australia, Tasmania
Ayabelle Lighthouse	CD	Djibouti
Bellevue (IGN)	IN	Efate & Erromango Islands
Bermuda 1957	CC	Bermuda
Bissau	IN	Guinea-Bissau
Bogota Observatory	IN	Colombia
Bukit Rimpah	BR	Indonesia (Bangka & Belitung Ids)
Camp Area Astro	IN	Antarctica (McMurdo Camp Area)
Campo Inchauspe	IN	Argentina
Canton Astro 1966	IN	Phoenix Islands
Cape	CD	South Africa
Cape Canaveral	CC	Bahamas, Florida
Carthage	CD	Tunisia
Chatham Island Astro 1971	IN	New Zealand (Chatham Island)
Chua Astro	IN	Paraguay
Corrego Alegre	IN	Brazil
Dabola	CD	Guinea
Deception Island	CD	Deception Island, Antarctia
Djakarta (Batavia)	BR	Indonesia (Sumatra)
DOS 1968	IN	New Georgia Islands (Gizo Island)
Easter Island 1967	IN	Easter Island
European 1950	IN	Cyprus
European 1950	IN	Egypt
European 1950	IN	England, Channel Islands, Scotland,
European 1950	IN	  Shetland Islands
European 1950	IN	England, Ireland, Scotland,
European 1950	IN	  Shetland Islands
European 1950	IN	Finland, Norway
European 1950	IN	Greece
European 1950	IN	Iran
European 1950	IN	Italy (Sardinia)
European 1950	IN	Italy (Sicily)
European 1950	IN	Malta
European 1950	IN	MEAN FOR Austria, Belgium, Denmark,
European 1950	IN	  Finland, France, W Germany,
European 1950	IN	  Gibralter, Greece, Italy,
European 1950	IN	  Luxembourg, Netherlands, Norway,
European 1950	IN	  Portugal, Spain, Sweden,
European 1950	IN	  Switzerland
European 1950	IN	MEAN FOR Austria, Denmark, France,
European 1950	IN	  W Germany, Netherlands, Switzerland
European 1950	IN	MEAN FOR Iraq, Israel, Jordan,
European 1950	IN	  Lebanon, Kuwait, Saudi Arabia,
European 1950	IN	  Syria
European 1950	IN	Portugal, Spain
European 1950	IN	Tunisia
European 1979	IN	MEAN FOR Austria, Finland,
European 1979	IN	  Netherlands, Norway, Spain, Sweden,
European 1979	IN	  Switzerland
Fort Thomas 1955	CD	Nevis, St. Kitts (Leeward Islands)
Gan 1970	IN	Republic of Maldives
Geodetic Datum 1949	IN	New Zealand
Graciosa Base SW 1948	IN	Azores (Faial, Graciosa, Pico,
Graciosa Base SW 1948	IN	  Sao Jorge, Terceira)
Guam 1963	CC	Guam
Gunung Segara	BR	Indonesia (Kalimantan)
GUX 1 Astro	IN	Guadalcanal Island
Herat North	IN	Afghanistan
Hjorsey 1955	IN	Iceland
Hong Kong 1963	IN	Hong Kong
Hu-Tzu-Shan	IN	Taiwan
Indian	EA	Bangladesh
Indian	EC	India, Nepal
Indian	EF	Pakistan
Indian 1954	EA	Thailand
Indian 1960	EA	Vietnam (Con Son Island)
Indian 1960	EA	Vietnam (Near 16N)
Indian 1975	EA	Thailand
Indonesian 1974	ID	Indonesia
Ireland 1965	AM	Ireland
ISTS 061 Astro 1968	IN	South Georgia Islands
ISTS 073 Astro 1969	IN	Diego Garcia
Johnston Island 1961	IN	Johnston Island
Kandawala	EA	Sri Lanka
Kerguelen Island 1949	IN	Kerguelen Island
Kertau 1948	ED	West Malaysia & Singapore
Kusaie Astro 1951	IN	Caroline Islands
L. C. 5 Astro 1961	CC	Cayman Brac Island
Leigon	CD	Ghana
Liberia 1964	CD	Liberia
Luzon	CC	Philippines (Excluding Mindanao)
Luzon	CC	Philippines (Mindanao)
M'Poraloko	CD	Gabon
Mahe 1971	CD	Mahe Island
Massawa	BR	Ethiopia (Eritrea)
Merchich	CD	Morocco
Midway Astro 1961	IN	Midway Islands
Minna	CD	Cameroon
Minna	CD	Nigeria
Montserrat Island Astro 1958	CD	Montserrat (Leeward Islands)
Nahrwan	CD	Oman (Masirah Island)
Nahrwan	CD	Saudi Arabia
Nahrwan	CD	United Arab Emirates
Naparima BWI	IN	Trinidad & Tobago
North American 1927	CC	Alaska (Excluding Aleutian Ids)
North American 1927	CC	Alaska (Aleutian Ids East of 180W)
North American 1927	CC	Alaska (Aleutian Ids West of 180W)
North American 1927	CC	Bahamas (Except San Salvador Id)
North American 1927	CC	Bahamas (San Salvador Island)
North American 1927	CC	Canada (Alberta, British Columbia)
North American 1927	CC	Canada (Manitoba, Ontario)
North American 1927	CC	Canada (New Brunswick,
North American 1927	CC	  Newfoundland, Nova Scotia, Quebec)
North American 1927	CC	Canada (Northwest Territories,
North American 1927	CC	  Saskatchewan)
North American 1927	CC	Canada (Yukon)
North American 1927	CC	Canal Zone
North American 1927	CC	Cuba
North American 1927	CC	Greenland (Hayes Peninsula)
North American 1927	CC	MEAN FOR Antigua, Barbados,
North American 1927	CC	  Barbuda, Caicos Islands, Cuba,
North American 1927	CC	  Dominican Republic, Grand Cayman,
North American 1927	CC	  Jamaica, Turks Islands
North American 1927	CC	MEAN FOR Belize, Costa Rica,
North American 1927	CC	  El Salvador, Guatemala, Honduras,
North American 1927	CC	  Nicaragua
North American 1927	CC	MEAN FOR Canada
North American 1927	CC	MEAN FOR CONUS
North American 1927	CC	MEAN FOR CONUS (East of Mississippi
North American 1927	CC	  River Including Louisiana,
North American 1927	CC	  Missouri, Minnesota)
North American 1927	CC	MEAN FOR CONUS (West of Mississippi
North American 1927	CC	  River Excluding Louisiana,
North American 1927	CC	  Minnisota, Missouri)
North American 1927	CC	Mexico
North American 1983	RF	Alaska (Excluding Aleutian Ids)
North American 1983	RF	Aleutian Ids
North American 1983	RF	Canada
North American 1983	RF	CONUS
North American 1983	RF	Hawaii
North American 1983	RF	Mexico, Central America
North Sahara 1959	CD	Algeria
Observatorio Meteorologico 1939	IN	Azores (Corvo & Flores Islands)
Old Egyptian 1907	HE	Egypt
Old Hawaiian	CC	Hawaii
Old Hawaiian	CC	Kauai
Old Hawaiian	CC	Maui
Old Hawaiian	CC	MEAN FOR Hawaii, Kauai, Maui, Oahu
Old Hawaiian	CC	Oahu
Oman	CD	Oman
Ordnance Survey Great Britain 1936	AA	England
Ordnance Survey Great Britain 1936	AA	England, Isle of Man, Wales
Ordnance Survey Great Britain 1936	AA	MEAN FOR England, Isle of Man,
Ordnance Survey Great Britain 1936	AA	  Scotland, Shetland Islands, Wales
Ordnance Survey Great Britain 1936	AA	Scotland, Shetland Islands
Ordnance Survey Great Britain 1936	AA	Wales
Pico de las Nieves	IN	Canary Islands
Pitcairn Astro 1967	IN	Pitcairn Island
Point 58	CD	MEAN FOR Burkina Faso & Niger
Pointe Noire 1948	CD	Congo
Porto Santo 1936	IN	Porto Santo, Madeira Islands
Provisional South American 1956	IN	Bolivia
Provisional South American 1956	IN	Chile (Northern, Near 19S)
Provisional South American 1956	IN	Chile (Southern, Near 43S)
Provisional South American 1956	IN	Colombia
Provisional South American 1956	IN	Ecuador
Provisional South American 1956	IN	Guyana
Provisional South American 1956	IN	MEAN FOR Bolivia, Chile, Colombia,
Provisional South American 1956	IN	  Ecuador, Guyana, Peru, Venezuela
Provisional South American 1956	IN	Peru
Provisional South American 1956	IN	Venezuela
Provisional South Chilean 1963	IN	Chile (Near 53S) (Hito XVIII)
Puerto Rico	CC	Puerto Rico, Virgin Islands
Pulkovo 1942	KA	Russia
Qatar National	IN	Qatar
Qornoq	IN	Greenland (South)
Reunion	IN	Mascarene Islands
Rome 1940	IN	Italy (Sardinia)
S-42 (Pulkovo 1942)	KA	Hungary
S-JTSK	BR	Czechoslavakia (Prior 1 JAN 1993)
Santo (DOS) 1965	IN	Espirito Santo Island
Sao Braz	IN	Azores (Sao Miguel, Santa Maria Ids)
Sapper Hill 1943	IN	East Falkland Island
Schwarzeck	BN	Namibia
Selvagem Grande 1938	IN	Salvage Islands
South American 1969	SA	Argentina
South American 1969	SA	Bolivia
South American 1969	SA	Brazil
South American 1969	SA	Chile
South American 1969	SA	Colombia
South American 1969	SA	Ecuador
South American 1969	SA	Ecuador (Baltra, Galapagos)
South American 1969	SA	Guyana
South American 1969	SA	MEAN FOR Argentina, Bolivia,
South American 1969	SA	  Brazil, Chile, Colombia, Ecuador,
South American 1969	SA	  Guyana, Paraguay, Peru, Trinidad &
South American 1969	SA	  Tobago, Venezuela
South American 1969	SA	Paraguay
South American 1969	SA	Peru
South American 1969	SA	Trinidad & Tobago
South American 1969	SA	Venezuela
South Asia	FA	Singapore
Tananarive Observatory 1925	IN	Madagascar
Timbalai 1948	EB	Brunei, E. Malaysia (Sabah Sarawak)
Tokyo	BR	Japan
Tokyo	BR	MEAN FOR Japan, South Korea,
Tokyo	BR	  Okinawa
Tokyo	BR	Okinawa
Tokyo	BR	South Korea
Tristan Astro 1968	IN	Tristan da Cunha
Viti Levu 1916	CD	Fiji (Viti Levu Island)
Voirol 1960	CD	Algeria
Wake Island Astro 1952	IN	Wake Atoll
Wake-Eniwetok 1960	HO	Marshall Islands
WGS 1972	WD	Global Definition
WGS 1984	WE	Global Definition
Yacare	IN	Uruguay
Zanderij	IN	Suriname