1NAD2NAD(1) General Commands Manual NAD2NAD(1)
2
6 nad2nad - North American Datum conversion filter
7
9 nad2nad [ -eEfihortwW [ args ] ] [ +args ]
10 file[s]
11
13 Program nad2nad is a filter to convert data
14 between North America Datum 1927 (NAD27) and
15 North American Datum 1983. nad2nad can option‐
16 ally process both State Plane Coordinate System
17 (SPCS) and Universal Transverse Mercator (UTM)
18 grid data as well as geographic data for both
19 input and output. This can also be accomplished
20 with the cs2cs program.
21 The following control parameters can appear in
23 any order:
24 -[i|o] keyword[,keyword]
26 The -i and -o option expect keyword argu‐
27 ments which define various characteris‐
28 tics and processing modes of the respec‐
29 tive input data. Usage allows multiple
30 arguments to be included with a - opera‐
31 tor when separated by commas. Datum con‐
32 version requires the data to be in geo‐
33 graphic coordinates, but nad2nad will
34 allow conversion of data to and from SPCS
35 or UTM grid systems. The following are
36 keywords and arguments reconized by both
37 the -i and -o that will apply to respec‐
38 tive input and output conversion of user
39 data to internal geographic coordinates:
40 27|83 datum of data
42 utm=n UTM coordinates in meters for
44 zone n
45 spcs=n for data in SPCS coordinates,
47 where n is state zone number.
48 feet data units are in U.S. Sur‐
50 veyor's feet. This is allowed
51 only when the spcs option been
52 previously used. Default coor‐
53 dinates are in meters.
54 bin for data in binary form.
56 rev data in lat-lon order rather
58 than default lon-lat order.
59 hp=ss use high precision conversion
61 zone ss. Certain States have
62 ancillary correction tables to
63 further refine the basic conus
64 table. Ss key and States are:
65 FL Florida
66 MD Maryland
67 TN Tennessee
68 WI Wisconsin
69 WO Washington, Oregon and north‐
70 ern part of California.
71 -ta A specifies a character employed as the
73 first character to denote a control line
74 to be passed through without processing.
75 This option applicable to ascii input
76 only. (# is the default value).
77 -e string
79 String is an arbitrary string to be out‐
80 put if an error is detected during data
81 transformations. The default value is:
82 *\t*. Note that if the -o bin option is
83 employed, an error is output as HUGE_VAL
84 for both values.
85 -r region
87 specifies which regional conversion table
88 to employ which are identified by the
89 following:
90 conus - conterminous 48 States
91 alaska - State of Alaska
92 hawaii - State of Hawaii
93 prvi - Puerto Rico and Virgin Islands
94 stgeorge - St. George Is, Alaska
95 stpaul - St. Paul Is, Alaska
96 stlrnc - St. Lawrence Is, Alaska
97 -E Input coordinates are echoed to out‐
99 put before ouput values.
100 -f format
102 Format is a printf format string to con‐
103 trol the form of the output values. For
104 inverse projections, the output will be
105 in degrees when this option is employed.
106 If a format is specified for inverse pro‐
107 jection the output data will be in deci‐
108 mal degrees. The default format is %.2f
109 for forward projection and DMS for
110 inverse.
111 -[w|W]n
113 N is the number of significant fractional
114 digits to employ for seconds output (when
115 the option is not specified, -w3 is
116 assumed). When -W is employed the fields
117 will be constant width and with leading
118 zeroes.
119 One or more files (processed in left to right
121 order) specify the source of data to be trans‐
122 formed. A - will specify the location of pro‐
123 cessing standard input. If no files are speci‐
124 fied, the input is assumed to be from stdin.
125 For ASCII input data the two data values must be
126 in the first two white space separated fields
127 and when both input and output are ASCII all
128 trailing portions of the input line are appended
129 to the output line.
130 Input geographic data (longitude and latitude)
132 must be in DMS format when neither utm nor spcs
133 is specified, otherwise in meters or feet (feet
134 option used). Input data fields must be sepa‐
135 rated by white space and not have imbedded white
136 space.
137 Output data will be in tab separated fields of
139 DMS or grid coordinates in meters or feet.
140 Any data after the two input values are echoed
142 after the two output data values.
143
145 cs2cs(1U), proj(1U),
146 Cartographic Projection Procedures for the UNIX
147 Environment—A User's Manual, (Evenden, 1990,
148 Open-file report 90-284).
149
151 http://www.remotesensing.org/proj
152 2000/03/21 Rel. 4.4 NAD2NAD(1)