Back to Introduction. Forward to Code organization. Up to Contents. The following steps will get you started with GeographicLib:
- Download the source.
- Unpack the tar file somewhere convenient with, e.g.,
- tar xfpvz geographiclib-1.2.tar.gz
This will create a geographiclib-1.2 directory. (Alternatively, download and unpack the zip file.)
- Change to the geographiclib-1.2 directory
- Create the library and the utility programs
The compiled utility programs are in the tools directory.
- windows/GeographicLib-vc9.sln (resp. vc8) is MS Visual Studio 2008 (resp. 2005) solution file which compiles the library and the utility programs under Windows.
- Try out GeoConvert (for help, type cd tools; ./GeoConvert -h)
- echo 33.3 44.4 | ./GeoConvert -m -p -3
- echo 38SMB4484 | ./GeoConvert -d
- Similarly, try out Geod, TransverseMercatorTest, CartConvert, and EquidistantTest.
- Read the section, Code organization, for an overview of the library.
- Browse the Class List for full documentation on the library.
- Read the section, Transverse Mercator Projection, for more information on this projection.
- If you use the library frequently, install it, e.g., to $(PREFIX) = /usr/local with
- make PREFIX=/usr/local install install-doc
Here's a list of some of the abbreviations used here with links to the corresponding Wikipedia articles:
- WGS84, World Geodetic System 1984.
- UTM, Universal Transverse Mercator coordinate system.
- UPS, Universal Polar Stereographic coordinate system.
- MGRS, Military Grid Reference System.
- EGM, Earth Gravity Model.
Back to Introduction. Forward to Code organization. Up to Contents.