From 5324937759b602a9eba8314daa1ac40f2ffcaa8e Mon Sep 17 00:00:00 2001 From: Kristian Evers Date: Sat, 17 Mar 2018 20:50:15 +0100 Subject: Reformat doc pages for cct, cs2cs, geod and proj The doc pages are reformatted to better use the features of the Sphinx documentation system. All four pages has been formatted such that they can serve as the basis for both the website and UNIX man-pages. This will make it easier to keep the man-pages aligned with the main documentation in the future. --- docs/source/usage/apps/cct.rst | 163 +++++++++++-------- docs/source/usage/apps/cs2cs.rst | 264 +++++++++++++++++------------- docs/source/usage/apps/geod.rst | 164 ++++++++++++------- docs/source/usage/apps/proj.rst | 336 ++++++++++++++++++++++++--------------- 4 files changed, 558 insertions(+), 369 deletions(-) (limited to 'docs/source/usage/apps') diff --git a/docs/source/usage/apps/cct.rst b/docs/source/usage/apps/cct.rst index 014e7732..9153e29b 100644 --- a/docs/source/usage/apps/cct.rst +++ b/docs/source/usage/apps/cct.rst @@ -4,135 +4,162 @@ cct ================================================================================ - .. Index:: cct +.. only:: html + Coordinate Conversion and Transformation. +Synopsis +******** -``cct`` a 4D equivalent to the ``proj`` projection -program, performs transformation coordinate systems on a set of input points. -The coordinate system transformation can include translation between -projected and geographic coordinates as well as the application of datum shifts. + **cct** [ **-cotvz** [ args ] ] *+opts[=arg]* file[s] -cct is an acronym meaning *Coordinate Conversion and Transformation*. +Description +*********** -The acronym refers to definitions given in the OGC 08-015r2/ISO-19111 -standard "Geographical Information -- Spatial Referencing by Coordinates", -which defines two different classes of *coordinate operations*: +:program:`cct` a 4D equivalent to the :program:`proj` projection program, +performs transformation coordinate systems on a set of input points. The +coordinate system transformation can include translation between projected +and geographic coordinates as well as the application of datum shifts. -*Coordinate Conversions*, which are coordinate operations where input -and output datum are identical (e.g. conversion from geographical to -cartesian coordinates) and -*Coordinate Transformations*, which are coordinate operations where -input and output datums differ (e.g. change of reference frame). +The following control parameters can appear in any order: -``cct``, however, 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 -American Geophysical Union (1991), recipient of the IAG Levallois Medal -(2007), the European Geosciences Union Vening Meinesz Medal (2008), and -of numerous other honours. +.. program:: cct -cct, 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, -comprising more than 250 publications, and by his mentoring and teaching -of the next generations of geodesists. +.. option:: -c -As Christian was an avid Fortran programmer, and a keen Unix connoisseur, -he would have enjoyed to know that his initials would be used to name a -modest Unix style transformation filter, hinting at the tireless aspect -of his personality, which was certainly one of the reasons he accomplished -so much, and meant so much to so many people. + Specify input columns for (up to) 4 input parameters. Defaults to 1,2,3,4. -Hence, in honour of cct (the geodesist) this is cct (the program). +.. option:: -o , --output= + Specify the name of the output file. +.. option:: -t