MB-System Unix Manual Page

mbm_project

Section: MB-System 5.0 (1)
Updated: 3 June 2013
Index
 

NAME

mbm_utm - Macro to perform forward and inverse UTM projections of ASCII data triples.

 

VERSION

Version 5.0

 

SYNOPSIS

mbm_utm -Iinfile -Ooutfile -Zzone -Eellipsoid [-F -Q -H -V]

 

DESCRIPTION

mbm_utm is a macro to perform forward and inverse UTM projections of ASCII data triples using the GMT program mapproject. Forward projections translate from geographic data (lon, lat, value) to UTM eastings and northings (x, y, value). Inverse projections translate from (x, y, z) to (lon, lat, z). Both the input and output files must be specified.

 

AUTHORSHIP

David W. Caress (caress@mbari.org)

  Monterey Bay Aquarium Research Institute
Dale N. Chayes (dale@ldeo.columbia.edu)

  Lamont-Doherty Earth Observatory

 

SIMPLE DESCRIPTION OF BASIC OPTIONS

-H
This "help" flag cause the program to print out a description of its operation and then exit immediately.
-Eellipsoid
Sets the ellipsoid to be used. The default is to use the WGS-84 ellipsoid, in accordance with the NAD-83 datum. If ellipsoid = "Clarke-1866", then the Clarke-1866 ellipsoid will be used in accordance with the NAD-27 datum. Note that this macro cannot be used to accomplish a true datum shift between NAD-27 and NAD-83 because the 1986 transition to NAD-83 also involved additional adjustments to positions.
-F
Causes mbm_utm to use or generate eastings and northings in feet rather than meters.
-Iinfile
Sets the name of the data file to be processed. The first two columns of the ASCII input data stream must be either longitude and latitude values (for geographic to projected transformation) or easting and northing values (for projected to geographic transformation). Any additional columns of data are passed unaltered to the output.
-Ooutfile
Sets the name of the output data file to be generated. The first two columns of the ASCII output data stream will be either easting and northing values (for geographic to projected transformation) or longitude and latitude values (for projected to geographic transformation). Any additional columns of data are passed unaltered to the output.
-Q
This option causes the transformation to be from projected coordinates (eastings and northings) to geographic coordinates (longitude and latitude). The default is to transform from geographic to projected coordinates.
-Zzone
Sets the UTM zone.

 

EXAMPLES

Suppose we have a file containing longitude, latitude, and depth triples called llz.dat. To transform the coordinates to eastings and northings in the UTM Zone 10 projection, use:

        mbm_utm -Illz.dat -Z10 -Oenz.dat

The file enz.dat will contain eastings and northings instead of longitude and latitude values. To transform back to geographic coordinates, use:

        mbm_utm -Ienz.dat -Z10 -Q -Ollz2.dat

 

SEE ALSO

mbsystem(1), project

 

BUGS

Too new to have bugs.


 

Index

NAME
VERSION
SYNOPSIS
DESCRIPTION
AUTHORSHIP
SIMPLE DESCRIPTION OF BASIC OPTIONS
EXAMPLES
SEE ALSO
BUGS


Last Updated: 3 June 2013


Return to list of MB-System manual pages...

Back to MB-System Home Page...