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  is a 4D equivalent to the proj projection program, performs trans‐
13       formation coordinate systems on a set of input points.  The  coordinate
14       system transformation can include translation between projected and ge‐
15       ographic 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> New in version 5.2.0.
24
25
26              Specify the number of decimals in the output.
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 in‐
45              put, whether it comes from STDIN, a file or interactive user in‐
46              put.
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

USE OF REMOTE GRIDS

72       New in version 7.0.0.
73
74
75       If the PROJ_NETWORK environment variable is set to ON, cct will attempt
76       to use remote grids stored on CDN (Content Delivery  Network)  storage,
77       when they are not available locally.
78
79       More details are available in the network section.
80

EXAMPLES

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

BACKGROUND

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

SEE ALSO

145       proj(1), cs2cs(1), geod(1), gie(1), projinfo(1), projsync(1)
146

BUGS

148       A      list      of      know      bugs     can     be     found     at
149       https://github.com/OSGeo/PROJ/issues where new bug reports can be  sub‐
150       mitted to.
151

HOME PAGE

153       https://proj.org/
154

AUTHOR

156       Thomas Knudsen
157
159       1983-2020
160
161
162
163
1647.2.1                            Dec 25, 2020                           CCT(1)
Impressum