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...