1CCT(1)                               PROJ                               CCT(1)
2
3
4

NAME

6       cct - Coordinate Conversion and Transformation
7

SYNOPSIS

9          cct [-cIostvz [args]] +opt[=arg] ... file ...
10

DESCRIPTION

12       cct  a 4D equivalent to the proj projection program, performs transfor‐
13       mation coordinate systems on a set of input points. The coordinate sys‐
14       tem  transformation  can include translation between projected and geo‐
15       graphic coordinates as well as the application of datum shifts.
16
17       The following control parameters can appear in any order:
18
19       -c <x,y,z,t>
20              Specify input columns for (up to) 4 input  parameters.  Defaults
21              to 1,2,3,4.
22
23       -d <n>
24
25       New in version 5.2.0: Specify the number of decimals in the output.
26
27
28       -I     Do the inverse transformation.
29
30       -o <output file name>, --output=<output file name>
31              Specify the name of the output file.
32
33       -t <time>, --time=<time>
34              Specify a fixed observation time to be used for all input data.
35
36       -z <height>, --height=<height>
37              Specify  a  fixed  observation  height  to be used for all input
38              data.
39
40       -s <n>, --skip-lines=<n>
41              New in version 5.1.0.
42
43
44              Skip the first n lines of input. This applies  to  any  kind  of
45              input,  whether  it comes from STDIN, a file or interactive user
46              input.
47
48       -v, --verbose
49              Write non-essential,  but  potentially  useful,  information  to
50              stderr.  Repeat for additional information (-vv, -vvv, etc.)
51
52       --version
53              Print version number.
54
55       The +opt arguments are associated with coordinate operation parameters.
56       Usage varies with operation.
57
58       cct is an acronym meaning Coordinate Conversion and Transformation.
59
60       The acronym refers to definitions given in the  OGC  08-015r2/ISO-19111
61       standard  "Geographical  Information  -- Spatial Referencing by Coordi‐
62       nates", which defines two different classes of coordinate operations:
63
64       Coordinate Conversions, which are coordinate operations where input and
65       output datum are identical (e.g. conversion from geographical to carte‐
66       sian coordinates) and
67
68       Coordinate Transformations, which are coordinate operations where input
69       and output datums differ (e.g. change of reference frame).
70

EXAMPLES

72       1. The  operator  specs  describe the action to be performed by cct. So
73          the following script
74
75          echo 12 55 0 0 | cct +proj=utm +zone=32 +ellps=GRS80
76
77       will transform the input geographic coordinates into UTM zone 32  coor‐
78       dinates.  Hence, the command
79
80          echo 12 55 | cct -z0 -t0 +proj=utm +zone=32 +ellps=GRS80
81
82       Should give results comparable to the classic proj command
83
84          echo 12 55 | proj +proj=utm +zone=32 +ellps=GRS80
85
86       2. Convert geographical input to UTM zone 32 on the GRS80 ellipsoid:
87
88          cct +proj=utm +ellps=GRS80 +zone=32
89
90       3. Roundtrip accuracy check for the case above:
91
92          cct +proj=pipeline +proj=utm +ellps=GRS80 +zone=32 +step +step +inv
93
94       4. As (2) but specify input columns for longitude, latitude, height and
95          time:
96
97          cct -c 5,2,1,4 +proj=utm +ellps=GRS80 +zone=32
98
99       5. As (2) but specify fixed height and time, hence needing only 2  cols
100          in input:
101
102          cct -t 0 -z 0 +proj=utm +ellps=GRS80 +zone=32
103
104       6. Auxiliary data following the coordinate input is forward to the out‐
105          put stream:
106
107          $ echo 12 56 100 2018.0 auxiliary data | cct +proj=merc
108          1335833.8895   7522963.2411      100.0000     2018.0000 auxiliary data
109

BACKGROUND

111       cct also refers to Carl Christian Tscherning (1942--2014), professor of
112       Geodesy  at the University of Copenhagen, mentor and advisor for a gen‐
113       eration of Danish geodesists, colleague and collaborator for two gener‐
114       ations  of  global  geodesists, Secretary General for the International
115       Association of Geodesy, IAG (1995--2007), fellow of the  American  Geo‐
116       physical Union (1991), recipient of the IAG Levallois Medal (2007), the
117       European Geosciences Union Vening Meinesz Medal (2008), and of numerous
118       other honours.
119
120       cct,  or  Christian,  as he was known to most of us, was recognized for
121       his good mood, his sharp wit, his tireless work, and his great  commit‐
122       ment  to the development of geodesy -- both through his scientific con‐
123       tributions, comprising more than 250 publications, and by his mentoring
124       and teaching of the next generations of geodesists.
125
126       As  Christian  was an avid Fortran programmer, and a keen Unix connois‐
127       seur, he would have enjoyed to know that his initials would be used  to
128       name a modest Unix style transformation filter, hinting at the tireless
129       aspect of his personality, which was certainly one of  the  reasons  he
130       accomplished so much, and meant so much to so many people.
131
132       Hence, in honour of cct (the geodesist) this is cct (the program).
133

SEE ALSO

135       proj(1), cs2cs(1), geod(1), gie(1), projinfo(1)
136

BUGS

138       A      list      of      know      bugs     can     be     found     at
139       https://github.com/OSGeo/PROJ/issues where new bug reports can be  sub‐
140       mitted to.
141

HOME PAGE

143       https://proj.org/
144

AUTHOR

146       Thomas Knudsen
147

COPYRIGHT

149       1983-2020
150
151
152
153
1546.3.2                            Apr 27, 2020                           CCT(1)