5
.TH PROJ 1 "2000/03/21 Rel. 4.4"
7
proj \- forward cartographic projection filter
9
invproj \- inverse cartographic projection filter
13
.B \-bceEfiIlmorsStTvVwW
23
.B \-bceEfiIlmorsStTwW
34
perform respective forward and inverse transformation of cartographic data
35
to or from cartesian data with a wide range of selectable projection functions.
37
The following control parameters can appear in any order:
40
Special option for binary coordinate data input and output
41
through standard input and standard output.
42
Data is assumed to be in system type
45
This option is to be used when
49
process and allows bypassing formatting operations.
52
Selects binary input only (see
56
alternate method to specify inverse projection.
57
Redundant when used with
61
Selects binary output only (see
66
specifies a character employed as the first character to denote
67
a control line to be passed through without processing.
68
This option applicable to ascii input only.
69
(# is the default value).
73
is an arbitrary string to be output if an error is detected during
75
The default value is: *\et*.
81
options are employed, an error is returned as HUGE_VAL
82
value for both return values.
85
causes the input coordinates to be copied to the output line
86
prior to printing the converted values.
88
.BI \-l "[p|P|=|e|u|d]" id
89
List projection identifiers with
94
that can be selected with
97
gives expanded description of projection
99
List ellipsoid identifiers with
101
that can be selected with
104
list of cartesian to meter conversion factors
105
that can be selected with
109
list of datums that can be selected with
113
This options reverses the order of the
114
expected input from longitude-latitude or x-y to latitude-longitude or y-x.
117
This options reverses the order of the
118
output from x-y or longitude-latitude to y-x or latitude-longitude.
128
.I angular distortion,
133
scale factors to be listed between <> for each input point.
134
For conformal projections meridinal and parallel scales factors
135
will be equal and angular distortion zero.
136
Equal area projections will have an area factor of 1.
142
format string to control the form of the output values.
143
For inverse projections, the output will be in degrees when this option
145
If a format is specified for inverse projection the
146
output data will be in decimal degrees.
147
The default format is "%.2f" for forward projection and DMS
152
is the number of significant fractional digits to employ for
153
seconds output (when the option is not specified,
158
is employed the fields will be constant width and with leading zeroes.
161
causes a listing of cartographic control parameters tested for and
162
used by the program to be printed prior to input data.
163
Should not be used with the
168
This option causes an expanded annotated listing of the characteristics
169
of the projected point.
170
.B -v is implied with this option.
172
.BI \-T " ulow,uhi,vlow,vhi,res[,umax,vmax]"
173
This option creates a set of bivariate Chebyshev polynomial
174
coefficients that approximate the selected cartographic projection on
180
denote the range of the input where the
184
prefixes apply to respective longitude-x or latitude-y
185
depending upon whether a forward or inverse projection is selected.
187
is an integer number specifying the power of 10 precision of the
191
of -3 specifies an approximation with an accuracy better than .001.
195
specify maximum degree of the polynomials (default: 15).
201
run-line arguments are associated with cartographic parameters
202
and usage varies with projection and for a complete description see
203
.I "Cartographic Projection Procedures for the UNIX Environment\(emA User's Manual" )
204
and supplementary documentation for Release 4.
206
Additional projection control parameters may be contained in two
207
auxilliary control files:
208
the first is optionally referenced with the
210
and the second is always processed after the name
211
of the projection has been established from either the run-line
215
The environment parameter
217
establishes the default directory for a file reference without
218
an absolute path. This is also used for supporting files like
223
(processed in left to right order)
224
specify the source of data to be transformed.
225
A \- will specify the location of processing standard input.
226
If no files are specified, the input is assumed to be from
228
For ASCII input data the two data values must be in the
229
first two white space separated fields and
230
when both input and output are ASCII all trailing portions
231
of the input line are appended to the output line.
233
Input geographic data
234
(longitude and latitude) must be in DMS format and input
235
cartesian data must be in units consistent with the ellipsoid
236
major axis or sphere radius units.
237
Output geographic coordinates will be in DMS
240
switch is not employed) and precise to 0.001"
241
with trailing, zero-valued minute-second fields deleted.
245
\f(CWproj +proj=utm +lon_0=112w +ellps=clrk66 -r <<EOF
247
45d15.551666667N -111d30
248
+45.25919444444 111d30'000w
251
will perform UTM forward projection with a standard UTM
252
central meridian nearest longitude 112\(deW.
253
The geographic values of this example are equivalent and meant
254
as examples of various forms of DMS input.
255
The x\-y output data will appear as three lines of:
257
\f(CW460769.27 5011648.45
261
The \fIproj\fR program is limited to converting between geographic and
262
projection coordinates within one datum.
264
The \fIcs2cs\fR program operates
265
similarly, but allows translation between any pair of definable coordinate
266
systems, including support for datum translation.
268
The \fInad2nad\fR program provides for translation between NAD27 and NAD83
269
(also available in \fRcs2cs\fI) in a convenient manner.
271
The \fIgeod\fR program provides the ability to compute geodetic (Great
272
Circle) computations.
274
.B cs2cs(1U), nad2nad(1U), geod(1U),
276
.I "Cartographic Projection Procedures for the UNIX Environment\(emA User's Manual,"
277
(Evenden, 1990, Open-file report 90\-284).
279
.I "Map Projections Used by the U. S. Geological Survey"
283
.I "Map Projections\(emA Working Manual"
284
(Synder, 1988, USGS Prof. Paper 1395).
286
.I "An Album of Map Projections"
287
(Snyder & Voxland, 1989, USGS Prof. Paper 1453).
289
http://www.remotesensing.org/proj