Program PROJTOOL

Usage

    PROJTOOL
(and then respond to the prompts for coordinate system specification and coordinate-conversion operation that PROJTOOL gives you)

Supersedes utmtool

Summary

The PROJTOOL program provides coordinate conversion back and forth among LAT-LON, Lambert Conformal, UTM, Polar Stereographic, General Transverse Mercator, Equatorial Mercator, and Albers Conic Equal Area coordinate systems. Longitudes are specified in signed degrees (so that for the US, longitudes are negative); coordinate system "UAM/EPS" means the thing with the kilometer units instead of the UTM standard units, which are meters.

Inputs are 8-byte REAL double precision, matching the double precision used internally by GCTP. For high precision calculations, uses the I/O API SETSPHERE and SPHEREDAT package to allow the user to customize the geodetic spheroid to be used for high precision computations.

PROJTOOL also provides grid-corner calculations, assuming either a UTM-based or a Lambert-based grid, as appropriate (to get UTM or Lambert corners of a LAT-LON based grid, work one corner at a time using the coordinate conversion facilities).

NOTE: according to the standard, UTM coordinates should be specified in _meters_ instead of the UAM/EPS bastardized system which claims to be UTM but in fact uses kilometers; the latter is a distinct (partially-supported) system, also.

Usage

The program is a character-based application (runs in, e.g., an xterm) rather than being a GUI X application. It will repeatedly prompt you for operation to be performed, from a menu that offers the following choices, for specification of (input or output) coordinate transformation, coordinate-to-coordinate conversion, and grid-corner determination. Note that for Lambert, Polar Stereographic, Transverse Mercator, and Equatorial Mercator projections, you must specify it before using it as an input or output coordinate system.

The menu is:

  1. Quit the program
  2. Set up input map projection by name
  3. Set up output map projection by name
  4. Set up input grid & projection by name
  5. Set up output grid & projection by name
  6. Set up input map projection by angles (etc.)
  7. Set up output map projection by angles (etc.)
  8. Define a grid w.r.t. the input map projection
  9. Convert from input X-Y to output X-Y
  10. Get output-projection grid corners for grid, e.g., for Lat-Lon corners, set the output projection to Lat-Lon and choose this action.
  11. Get output-projection grid-corner-cell centers

See Also

EDSS/Models-3 horizontal coordinate and grid conventions

EDSS/Models-3 grid and coordinate manipulation routines

Earlier coordinate-transform program UTMTOOL

US Geological Survey General Coordinate Transformation Package (GCTP)

Geodetic spheroid manipulation routine SETSPHERE


Previous: JULDATE

Up: Related Programs

To: Models-3/EDSS I/O API: The Help Pages