diff options
| -rw-r--r-- | man/man1/cct.1 | 14 | ||||
| -rw-r--r-- | man/man1/cs2cs.1 | 97 | ||||
| -rw-r--r-- | man/man1/geod.1 | 10 | ||||
| -rw-r--r-- | man/man1/gie.1 | 30 | ||||
| -rw-r--r-- | man/man1/proj.1 | 23 |
5 files changed, 108 insertions, 66 deletions
diff --git a/man/man1/cct.1 b/man/man1/cct.1 index ce511d3c..a6f3894b 100644 --- a/man/man1/cct.1 +++ b/man/man1/cct.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "CCT" "1" "Sep 10, 2018" "5.2.0" "PROJ.4" +.TH "CCT" "1" "Feb 14, 2019" "6.0.0" "PROJ.4" .SH NAME cct \- Coordinate Conversion and Transformation . @@ -103,7 +103,7 @@ Usage varies with operation. \fBcct\fP is an acronym meaning \fICoordinate Conversion and Transformation\fP\&. .sp The acronym refers to definitions given in the OGC 08\-015r2/ISO\-19111 -standard “Geographical Information – Spatial Referencing by Coordinates”, +standard "Geographical Information \-\- Spatial Referencing by Coordinates", which defines two different classes of \fIcoordinate operations\fP: .sp \fICoordinate Conversions\fP, which are coordinate operations where input @@ -228,18 +228,18 @@ $ echo 12 56 100 2018.0 auxiliary data | cct +proj=merc .UNINDENT .SH BACKGROUND .sp -\fBcct\fP also refers to Carl Christian Tscherning (1942–2014), +\fBcct\fP also refers to Carl Christian Tscherning (1942\-\-2014), professor of Geodesy at the University of Copenhagen, mentor and advisor for a generation of Danish geodesists, colleague and collaborator for two generations of global geodesists, Secretary General for the -International Association of Geodesy, IAG (1995–2007), fellow of the +International Association of Geodesy, IAG (1995\-\-2007), fellow of the American Geophysical Union (1991), recipient of the IAG Levallois Medal (2007), the European Geosciences Union Vening Meinesz Medal (2008), and of numerous other honours. .sp \fIcct\fP, or Christian, as he was known to most of us, was recognized for his good mood, his sharp wit, his tireless work, and his great commitment to -the development of geodesy – both through his scientific contributions, +the development of geodesy \-\- both through his scientific contributions, comprising more than 250 publications, and by his mentoring and teaching of the next generations of geodesists. .sp @@ -252,7 +252,7 @@ so much, and meant so much to so many people. Hence, in honour of \fIcct\fP (the geodesist) this is \fBcct\fP (the program). .SH SEE ALSO .sp -\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP +\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP .SH BUGS .sp A list of know bugs can be found at \fI\%https://github.com/OSGeo/proj.4/issues\fP @@ -263,6 +263,6 @@ where new bug reports can be submitted to. .SH AUTHOR Thomas Knudsen .SH COPYRIGHT -1983-2018 +1983-2019 .\" Generated by docutils manpage writer. . diff --git a/man/man1/cs2cs.1 b/man/man1/cs2cs.1 index c262ddfd..5dd037a5 100644 --- a/man/man1/cs2cs.1 +++ b/man/man1/cs2cs.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "CS2CS" "1" "Sep 10, 2018" "5.2.0" "PROJ.4" +.TH "CS2CS" "1" "Feb 14, 2019" "6.0.0" "PROJ.4" .SH NAME cs2cs \- Cartographic coordinate system filter . @@ -36,11 +36,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] \fBcs2cs\fP [ \fB\-eEfIlrstvwW\fP [ args ] ] [ \fI+opts[=arg]\fP ] [ +to [\fI+opts[=arg]\fP] ] file[s] .UNINDENT .UNINDENT +.sp +or +.INDENT 0.0 +.INDENT 3.5 +\fBcs2cs\fP [ \fB\-eEfIlrstvwW\fP [ args ] ] {source_crs} +to {target_crs} file[s] +.sp +where {source_crs} or {target_crs} is a PROJ string, a WKT string or a AUTHORITY:CODE +(where AUTHORITY is the name of a CRS authority and CODE the code of a CRS +found in the proj.db database), expressing a coordinate reference system. +.UNINDENT +.UNINDENT +.sp +New in version 6.0.0. + +.sp +or +.INDENT 0.0 +.INDENT 3.5 +\fBcs2cs\fP [ \fB\-eEfIlrstvwW\fP [ args ] ] {source_crs} {target_crs} +.UNINDENT +.UNINDENT +.sp +New in version 6.0.0. + .SH DESCRIPTION .sp \fBcs2cs\fP 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 +cartographic coordinate reference system on a set of input points. The coordinate +reference system transformation can include translation between projected and geographic coordinates as well as the application of datum shifts. .sp The following control parameters can appear in any order: @@ -153,22 +177,25 @@ the program to be printed prior to input data. The \fI+args\fP run\-line arguments are associated with cartographic parameters. .sp -The \fBcs2cs\fP program requires two coordinate system definitions. The first (or +The \fBcs2cs\fP program requires two coordinate reference system (CRS) definitions. The first (or primary is defined based on all projection parameters not appearing after the \fI+to\fP argument. All projection parameters appearing after the \fI+to\fP argument -are considered the definition of the second coordinate system. If there is no -second coordinate system defined, a geographic coordinate system based on the -datum and ellipsoid of the source coordinate system is assumed. Note that the -source and destination coordinate system can both be projections, both be -geographic, or one of each and may have the same or different datums. -.sp -Additional projection control parameters may be contained in two auxiliary -control files: the first is optionally referenced with the -\fI+init=file:id\fP and the second is always processed after the name of the -projection has been established from either the run\-line or the contents of -\fI+init\fP file. The environment parameter \fBPROJ_LIB\fP establishes the default -directory for a file reference without an absolute path. This is also used -for supporting files like datum shift files. +are considered the definition of the second CRS. If there is no +second CRS defined, a geographic CRS based on the +datum and ellipsoid of the source CRS is assumed. Note that the +source and destination CRS can both of same or different nature (geographic, +projected, compound CRS), or one of each and may have the same or different datums. +.sp +When using a WKT definition or a AUTHORITY:CODE, the axis order of the CRS will +be enforced. So for example if using EPSG:4326, the first value expected (or +returned) will be a latitude. +.sp +Internally, \fBcs2cs\fP uses the \fBproj_create_crs_to_crs()\fP function +to compute the appropriate coordinate operation, so implementation details of +this function directly impact the results returned by the program. +.sp +The environment parameter \fBPROJ_LIB\fP establishes the +directory for resource files (database, datum shift grids, etc.) .sp One or more files (processed in left to right order) specify the source of data to be transformed. A \fB\-\fP will specify the location of processing standard @@ -183,7 +210,8 @@ ellipsoid major axis or sphere radius units. Output geographic coordinates will normally be in DMS format (use \fB\-f %.12f\fP for decimal degrees with 12 decimal places), while projected (cartesian) coordinates will be in linear (meter, feet) units. -.SH EXAMPLE +.SH EXAMPLES +.SS Using PROJ strings .sp The following script .INDENT 0.0 @@ -210,14 +238,41 @@ The x\-y output data will appear as three lines of: .sp .nf .ft C -1402285.98 5076292.42 \-0.00 +1402293.44 5076292.68 0.00 +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Using EPSG codes +.sp +Transforming from WGS 84 latitude/longitude (in that order) to UTM Zone 31N/WGS 84 +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +cs2cs EPSG:4326 EPSG:32631 <<EOF +45N 2E +EOF +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +outputs +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +421184.70 4983436.77 0.00 .ft P .fi .UNINDENT .UNINDENT .SH SEE ALSO .sp -\fBproj(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP +\fBproj(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP .SH BUGS .sp A list of know bugs can be found at \fI\%https://github.com/OSGeo/proj.4/issues\fP @@ -228,6 +283,6 @@ where new bug reports can be submitted to. .SH AUTHOR Frank Warmerdam .SH COPYRIGHT -1983-2018 +1983-2019 .\" Generated by docutils manpage writer. . diff --git a/man/man1/geod.1 b/man/man1/geod.1 index 9efd7103..8e2186ed 100644 --- a/man/man1/geod.1 +++ b/man/man1/geod.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "GEOD" "1" "Sep 10, 2018" "5.2.0" "PROJ.4" +.TH "GEOD" "1" "Feb 14, 2019" "6.0.0" "PROJ.4" .SH NAME geod \- Geodesic computations . @@ -143,12 +143,12 @@ azimuthal data must be in decimal degrees or DMS format and input distance data must be in units consistent with the ellipsoid major axis or sphere radius units. The latitude must lie in the range [\-90d,90d]. Output geographic coordinates will be -in DMS (if the \fI\%\-f\fP switch is not employed) to 0.001” with trailing, +in DMS (if the \fI\%\-f\fP switch is not employed) to 0.001" with trailing, zero\-valued minute\-second fields deleted. Output distance data will be in the same units as the ellipsoid or sphere radius. .sp -The Earth’s ellipsoidal figure may be selected in the same manner +The Earth\(aqs ellipsoidal figure may be selected in the same manner as program \fBproj\fP by using \fI+ellps=\fP, \fI+a=\fP, \fI+es=\fP, etc. .sp \fBgeod\fP may also be used to determine intermediate points along @@ -201,7 +201,7 @@ where the first two values are the azimuth from Boston to Portland, the back azimuth from Portland to Boston followed by the distance. .sp An example of forward geodesic use is to use the Boston location -and determine Portland’s location by azimuth and distance: +and determine Portland\(aqs location by azimuth and distance: .INDENT 0.0 .INDENT 3.5 .sp @@ -257,6 +257,6 @@ where new bug reports can be submitted to. .SH AUTHOR Charles Karney .SH COPYRIGHT -1983-2018 +1983-2019 .\" Generated by docutils manpage writer. . diff --git a/man/man1/gie.1 b/man/man1/gie.1 index ea63499a..c0247cae 100644 --- a/man/man1/gie.1 +++ b/man/man1/gie.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "GIE" "1" "Sep 10, 2018" "5.2.0" "PROJ.4" +.TH "GIE" "1" "Feb 14, 2019" "6.0.0" "PROJ.4" .SH NAME gie \- The Geospatial Integrity Investigation Environment . @@ -209,7 +209,7 @@ Many coordinates can be expected for one \fI\%operation\fP\&. For each See \fI\%operation\fP for an example. .sp In addition to expecting a coordinate it is also possible to expect a -PROJ error code in case an operation can’t be created. This is useful when +PROJ error code in case an operation can\(aqt be created. This is useful when testing that errors are caught and handled correctly. Below is an example of that tests that the pipeline operator fails correctly when a non\-invertible pipeline is constructed. @@ -267,7 +267,7 @@ units. Do a roundtrip test of an operation. \fI\%roundtrip\fP needs a \fI\%operation\fP and a \fI\%accept\fP command to function. The accepted coordinate is passed to the operation first in -it’s forward mode, then the output from the forward operation is passed +it\(aqs forward mode, then the output from the forward operation is passed back to the inverse operation. This procedure is done \fBn\fP times. If the resulting coordinate is within the set tolerance of the initial coordinate, the test is passed. @@ -343,7 +343,7 @@ expect 12 55 0 0 .UNINDENT .UNINDENT .sp -The default direction is “forward”. +The default direction is "forward". .UNINDENT .INDENT 0.0 .TP @@ -440,21 +440,21 @@ expect 0 110579.9 .UNINDENT .SH BACKGROUND .sp -More importantly than being an acronym for “Geospatial Integrity Investigation -Environment”, gie were also the initials, user id, and USGS email address of -Gerald Ian Evenden (1935–2016), the geospatial visionary, who, already in the +More importantly than being an acronym for "Geospatial Integrity Investigation +Environment", gie were also the initials, user id, and USGS email address of +Gerald Ian Evenden (1935\-\-2016), the geospatial visionary, who, already in the 1980s, started what was to become the PROJ of today. .sp -Gerald’s clear vision was that map projections are \fIjust special functions\fP\&. +Gerald\(aqs clear vision was that map projections are \fIjust special functions\fP\&. Some of them rather complex, most of them of two variables, but all of them \fIjust special functions\fP, and not particularly more special than the \fBsin()\fP, \fBcos()\fP, \fBtan()\fP, and \fBhypot()\fP already available in the C standard library. .sp And hence, according to Gerald, \fIthey should not be particularly much harder -to use\fP, for a programmer, than the \fBsin()\fP’s, \fBtan()\fP’s and -\fBhypot()\fP’s so readily available. +to use\fP, for a programmer, than the \fBsin()\fP\(aqs, \fBtan()\fP\(aqs and +\fBhypot()\fP\(aqs so readily available. .sp -Gerald’s ingenuity also showed in the implementation of the vision, where +Gerald\(aqs ingenuity also showed in the implementation of the vision, where he devised a comprehensive, yet simple, system of key\-value pairs for parameterising a map projection, and the highly flexible \fBPJ\fP struct, storing run\-time compiled versions of those key\-value pairs, hence making a map @@ -463,15 +463,15 @@ call like \fBhypot(x,y)\fP\&. .sp While today, we may have more formally well defined metadata systems (most prominent the OGC WKT2 representation), nothing comes close being as easily -readable (“human compatible”) as Gerald’s key\-value system. This system in -particular, and the PROJ system in general, was Gerald’s great gift to anyone +readable ("human compatible") as Gerald\(aqs key\-value system. This system in +particular, and the PROJ system in general, was Gerald\(aqs great gift to anyone using and/or communicating about geodata. .sp It is only reasonable to name a program, keeping an eye on the integrity of the PROJ system, in honour of Gerald. .sp So in honour, and hopefully also in the spirit, of Gerald Ian Evenden -(1935–2016), this is the Geospatial Integrity Investigation Environment. +(1935\-\-2016), this is the Geospatial Integrity Investigation Environment. .SH SEE ALSO .sp \fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP @@ -485,6 +485,6 @@ where new bug reports can be submitted to. .SH AUTHOR Thomas Knudsen .SH COPYRIGHT -1983-2018 +1983-2019 .\" Generated by docutils manpage writer. . diff --git a/man/man1/proj.1 b/man/man1/proj.1 index b3c8f422..e49fb97a 100644 --- a/man/man1/proj.1 +++ b/man/man1/proj.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "PROJ" "1" "Sep 10, 2018" "5.2.0" "PROJ.4" +.TH "PROJ" "1" "Feb 14, 2019" "6.0.0" "PROJ.4" .SH NAME proj \- Cartographic projection filter . @@ -188,8 +188,7 @@ with leading zeroes. .TP .B \-v Causes a listing of cartographic control parameters tested for and used by -the program to be printed prior to input data. Should not be used with the -\fI\%\-T\fP option. +the program to be printed prior to input data. .UNINDENT .INDENT 0.0 .TP @@ -197,18 +196,6 @@ the program to be printed prior to input data. Should not be used with the This option causes an expanded annotated listing of the characteristics of the projected point. \fI\%\-v\fP is implied with this option. .UNINDENT -.INDENT 0.0 -.TP -.B \-T <ulow,uhi,vlow,vhi,res[,umax,vmax]> -This option creates a set of bivariate Chebyshev polynomial coefficients -that approximate the selected cartographic projection on stdout. The values -\fIlow\fP and \fIhi\fP denote the range of the input where the \fIu\fP or \fIv\fP prefixes apply to -respective longitude\-x or latitude\-y depending upon whether a forward or -inverse projection is selected. The integer \fIres\fP is a number specifying the -power of 10 precision of the approximation. For example, a \fIres\fP of \-3 -specifies an approximation with an accuracy better than 0.001. Optional \fIumax\fP, and \fIvmax\fP -specify maximum degree of the polynomials (default: 15). -.UNINDENT .sp The \fI+args\fP run\-line arguments are associated with cartographic parameters. Additional projection control parameters may be contained in two auxiliary @@ -229,7 +216,7 @@ portions of the input line are appended to the output line. Input geographic data (longitude and latitude) must be in DMS format and input cartesian data must be in units consistent with the ellipsoid major axis or sphere radius units. Output geographic coordinates will be in DMS (if the -\fB\-w\fP switch is not employed) and precise to 0.001” with trailing, zero\-valued +\fB\-w\fP switch is not employed) and precise to 0.001" with trailing, zero\-valued minute\-second fields deleted. .SH EXAMPLE .sp @@ -273,7 +260,7 @@ between any pair of definable coordinate reference systems, including support for datum translation. .SH SEE ALSO .sp -\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP +\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP .SH BUGS .sp A list of know bugs can be found at \fI\%https://github.com/OSGeo/proj.4/issues\fP @@ -284,6 +271,6 @@ where new bug reports can be submitted to. .SH AUTHOR Gerald I. Evenden .SH COPYRIGHT -1983-2018 +1983-2019 .\" Generated by docutils manpage writer. . |