NAD2BIN(1) General Commands Manual NAD2BIN(1)NAME
nad2bin - convert nad ASCII files into binary format usable by nad2nad
DESCRIPTION
This command is undocumented upstream. This very rough documentation was quickly assembled by your friendly Debian maintainer (who doesn't
use this command, and so is not the best person to document it!).
The proj package includes the nad2nad binary, the North American Datum conversion filter used to convert data between North America Datum
1927 (NAD27) and North American Datum 1983, and cs2cs a binary that performs transformation between the source and destination cartographic
coordinate system on a set of input points. The coordinate system transformation can include translation between projected and geographic
coordinates as well as the application of datum shifts.
See the nad2nad(1) and cs2cs(1) man pages for more information.
nad2nad and cs2cs need arch-dependent conversion data files in a library directory, /usr/share/proj/ Those files are included in the proj
Debian package since 4.6.1-5. To produce/update them yourself, get the *.lla files from
http://download.osgeo.org/proj/proj-datumgrid-1.5.zip
and then run nad2bin to produce the binary files used by nad2nad and cs2cs like so:
# nad2bin < conus.lla /usr/share/proj/conus
Test nad2nad with the following example:
$ nad2nad -i 83 -o 27 -r conus << EOF
71d14'58.27"W 44d20'15.227"N
EOF
It should produce:
71d15'W 44d20'15"N
SEE ALSO nad2nad(1), cs2cs(1)AUTHOR
This manual page by Peter S Galbraith <psg@debian.org>.
NAD2BIN(1)
Check Out this Related Man Page
NAD2NAD(1) General Commands Manual NAD2NAD(1)NAME
nad2nad - North American Datum conversion filter
SYNOPSIS
nad2nad [ -eEfihortwW [ args ] ] [ +args ] file[s]
DESCRIPTION
Program nad2nad is a filter to convert data between North America Datum 1927 (NAD27) and North American Datum 1983. nad2nad can optionally
process both State Plane Coordinate System (SPCS) and Universal Transverse Mercator (UTM) grid data as well as geographic data for both
input and output. This can also be accomplished with the cs2cs program.
The following control parameters can appear in any order:
-[i|o] keyword[,keyword]
The -i and -o option expect keyword arguments which define various characteristics and processing modes of the respective input
data. Usage allows multiple arguments to be included with a - operator when separated by commas. Datum conversion requires the
data to be in geographic coordinates, but nad2nad will allow conversion of data to and from SPCS or UTM grid systems. The following
are keywords and arguments recognized by both the -i and -o that will apply to respective input and output conversion of user data
to internal geographic coordinates:
27|83 datum of data
utm=n UTM coordinates in meters for zone n
spcs=n for data in SPCS coordinates, where n is state zone number.
feet data units are in U.S. Surveyor's feet. This is allowed only when the spcs option been previously used. Default coordi-
nates are in meters.
bin for data in binary form.
rev data in lat-lon order rather than default lon-lat order.
hp=ss use high precision conversion zone ss. Certain States have ancillary correction tables to further refine the basic conus
table. Ss key and States are:
FL Florida
MD Maryland
TN Tennessee
WI Wisconsin
WO Washington, Oregon and northern part of California.
-ta A specifies a character employed as the first character to denote a control line to be passed through without processing. This
option applicable to ascii input only. (# is the default value).
-e string
String is an arbitrary string to be output if an error is detected during data transformations. The default value is: * *. Note
that if the -o bin option is employed, an error is output as HUGE_VAL for both values.
-r region
specifies which regional conversion table to employ which are identified by the following:
conus - conterminous 48 States
alaska - State of Alaska
hawaii - State of Hawaii
prvi - Puerto Rico and Virgin Islands
stgeorge - St. George Is, Alaska
stpaul - St. Paul Is, Alaska
stlrnc - St. Lawrence Is, Alaska
-E Input coordinates are echoed to output before ouput values.
-f format
Format is a printf format string to control the form of the output values. For inverse projections, the output will be in degrees
when this option is employed. If a format is specified for inverse projection the output data will be in decimal degrees. The
default format is %.2f for forward projection and DMS for inverse.
-[w|W]n
N is the number of significant fractional digits to employ for seconds output (when the option is not specified, -w3 is assumed).
When -W is employed the fields will be constant width and with leading zeroes.
One or more files (processed in left to right order) specify the source of data to be transformed. A - will specify the location of pro-
cessing standard input. If no files are specified, the input is assumed to be from stdin. For ASCII input data the two data values must
be in the first two white space separated fields and when both input and output are ASCII all trailing portions of the input line are
appended to the output line.
Input geographic data (longitude and latitude) must be in DMS format when neither utm nor spcs is specified, otherwise in meters or feet
(feet option used). Input data fields must be separated by white space and not have imbedded white space.
Output data will be in tab separated fields of DMS or grid coordinates in meters or feet.
Any data after the two input values are echoed after the two output data values.
SEE ALSO cs2cs(1U), proj(1U),
Cartographic Projection Procedures for the UNIX Environment--A User's Manual, (Evenden, 1990, Open-file report 90-284).
HOME PAGE
http://www.remotesensing.org/proj
2000/03/21 Rel. 4.4 NAD2NAD(1)