@@ -27,15 +27,15 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
2727.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
2828.in \\n[ rst2man-indent\\n[ rst2man-indent-level ] ]u
2929..
30- .TH "PROJ" "1" "May 24, 2023" "9.2.1 " "PROJ"
30+ .TH "PROJ" "1" "1 Sep 2023" "9.3 " "PROJ"
3131.SH NAME
3232proj \- Cartographic projection filter
3333.SH SYNOPSIS
3434.INDENT 0.0
3535.INDENT 3.5
36- \fB proj \fP [\fB \- beEfiIlmorsStTvVwW \fP ] [args]] [\fI +opt[=arg] \fP ...] file ...
36+ \fB proj \fP [\fB \- beEfiIlmorsStTvVwW \fP ] [args]] ( [\fI +opt[=arg] \fP ...] | {crs}) file ...
3737.sp
38- \fB invproj \fP [\fB \- beEfiIlmorsStTvVwW \fP ] [args]] [\fI +opt[=arg] \fP ...] file ...
38+ \fB invproj \fP [\fB \- beEfiIlmorsStTvVwW \fP ] [args]] ( [\fI +opt[=arg] \fP ...] | {crs}) file ...
3939.UNINDENT
4040.UNINDENT
4141.SH DESCRIPTION
@@ -200,6 +200,13 @@ projection has been established from either the run\-line or the contents of
200200+init file. The environment parameter \fI \% PROJ_DATA \fP establishes the
201201default directory for a file reference without an absolute path. This is
202202also used for supporting files like datum shift files.
203+ .sp
204+ New in version 9.3.0: \fI {crs} \fP is one of the possibilities accepted by :c:\fB proj_create() \fP , provided it
205+ expresses a projected CRS, like a WKT string, an object code (like "EPSG:32632")
206+ a PROJJSON string, etc.
207+ The projection computed will be those of the map projection implied by
208+ the transformation from the base geographic CRS of the projected CRS to the projected CRS.
209+
203210.sp
204211One or more files (processed in left to right order) specify the source of
205212data to be converted. A \fB \- \fP will specify the location of processing standard
@@ -221,7 +228,7 @@ The following script
221228.sp
222229.nf
223230.ft C
224- proj +proj=utm +lon_0=112w +ellps=clrk66 \- r <<EOF
231+ proj +proj=utm +zone=12 +ellps=GRS80 \- r <<EOF
22523245d15\(aq 33.1" 111.5W
22623345d15.551666667N \- 111d30
227234+45.25919444444 111d30\(aq 000w
@@ -231,16 +238,63 @@ EOF
231238.UNINDENT
232239.UNINDENT
233240.sp
234- will perform UTM forward projection with a standard UTM central meridian
235- nearest longitude 112W. The geographic values of this example are equivalent
241+ will perform UTM zone 12 forward projection.
242+ The geographic values of this example are equivalent
236243and meant as examples of various forms of DMS input. The x\- y output
237244data will appear as three lines of:
238245.INDENT 0.0
239246.INDENT 3.5
240247.sp
241248.nf
242249.ft C
243- 460769.27 5011648.45
250+ 460770.43 5011865.86
251+ .ft P
252+ .fi
253+ .UNINDENT
254+ .UNINDENT
255+ .sp
256+ This other example
257+ .INDENT 0.0
258+ .INDENT 3.5
259+ .sp
260+ .nf
261+ .ft C
262+ proj EPSG:6421 \- V <<EOF
263+ \- 120 35.8
264+ EOF
265+ .ft P
266+ .fi
267+ .UNINDENT
268+ .UNINDENT
269+ .sp
270+ Will perform the projection of the coordinates in "NAD83(2011) / California zone 4"
271+ (\fI EPSG:6421 \fP ) into its geographic system, "NAD83(2011)", showing the expanded annotated listing.
272+ The output will appear as:
273+ .INDENT 0.0
274+ .INDENT 3.5
275+ .sp
276+ .nf
277+ .ft C
278+ #Lambert Conformal Conic
279+ # Conic, Sph&Ell
280+ # lat_1= and lat_2= or lat_0, k_0=
281+ # +proj=lcc +lat_0=35.3333333333333 +lon_0=\- 119 +lat_1=37.25 +lat_2=36
282+ # +x_0=2000000 +y_0=500000 +ellps=GRS80
283+ #Final Earth figure: ellipsoid
284+ # Major axis (a): 6378137.000
285+ # 1/flattening: 298.257222
286+ # squared eccentricity: 0.006694380023
287+ Longitude: 120dW [ \- 120 ]
288+ Latitude: 35d48\(aq N [ 35.8 ]
289+ Easting (x): 1909606.87
290+ Northing (y): 552253.58
291+ Meridian scale (h) : 1.00004382 ( 0.004382 % error )
292+ Parallel scale (k) : 1.00004382 ( 0.004382 % error )
293+ Areal scale (s): 1.00008765 ( 0.008765 % error )
294+ Angular distortion (w): 0.000
295+ Meridian/Parallel angle: 90.00000
296+ Convergence : \- 0d35\(aq 47.714" [ \- 0.59658715 ]
297+ Max\- min (Tissot axis a\- b) scale error: 1.00004 1.00004
244298.ft P
245299.fi
246300.UNINDENT
@@ -266,6 +320,6 @@ where new bug reports can be submitted to.
266320.SH AUTHOR
267321Gerald I. Evenden
268322.SH COPYRIGHT
269- 1983-2023
323+ 1983-2023, PROJ contributors
270324.\" Generated by docutils manpage writer.
271325.
0 commit comments