From 50f8e968783c48fc8164450201cd0ab0970a1c09 Mon Sep 17 00:00:00 2001 From: Kristian Evers Date: Thu, 14 Feb 2019 23:24:49 +0100 Subject: Update man-pages from Sphinx-docs --- man/man1/cct.1 | 14 ++++---- man/man1/cs2cs.1 | 97 ++++++++++++++++++++++++++++++++++++++++++++------------ man/man1/geod.1 | 10 +++--- man/man1/gie.1 | 30 +++++++++--------- 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 < -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. . -- cgit v1.2.3