aboutsummaryrefslogtreecommitdiff
path: root/operations/projections/qsc.html
blob: 16f2250d40c380c1e993688f620009e85bab5035 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Quadrilateralized Spherical Cube &mdash; PROJ 9.0.0 documentation</title>
      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
    <link rel="shortcut icon" href="../../_static/favicon.png"/>
    <link rel="canonical" href="https://proj.orgoperations/projections/qsc.html"/>
  <!--[if lt IE 9]>
    <script src="../../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
        <script src="../../_static/jquery.js"></script>
        <script src="../../_static/underscore.js"></script>
        <script src="../../_static/doctools.js"></script>
    <script src="../../_static/js/theme.js"></script>
    <link rel="author" title="About these documents" href="../../about.html" />
    <link rel="index" title="Index" href="../../genindex.html" />
    <link rel="search" title="Search" href="../../search.html" />
    <link rel="next" title="Robinson" href="robin.html" />
    <link rel="prev" title="Quartic Authalic" href="qua_aut.html" /> 
</head>

<body class="wy-body-for-nav"> 
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search"  style="background: #353130" >
            <a href="../../index.html">
            <img src="../../_static/logo.png" class="logo" alt="Logo"/>
          </a>
              <div class="version">
                9.0.0
              </div>
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>
        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../about.html">About</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../news.html">News</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../download.html">Download</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../install.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../usage/index.html">Using PROJ</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../apps/index.html">Applications</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Coordinate operations</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html">Projections</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="adams_hemi.html">Adams Hemisphere in a Square</a></li>
<li class="toctree-l3"><a class="reference internal" href="adams_ws1.html">Adams World in a Square I</a></li>
<li class="toctree-l3"><a class="reference internal" href="adams_ws2.html">Adams World in a Square II</a></li>
<li class="toctree-l3"><a class="reference internal" href="aea.html">Albers Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="aeqd.html">Azimuthal Equidistant</a></li>
<li class="toctree-l3"><a class="reference internal" href="airy.html">Airy</a></li>
<li class="toctree-l3"><a class="reference internal" href="aitoff.html">Aitoff</a></li>
<li class="toctree-l3"><a class="reference internal" href="alsk.html">Modified Stereographic of Alaska</a></li>
<li class="toctree-l3"><a class="reference internal" href="apian.html">Apian Globular I</a></li>
<li class="toctree-l3"><a class="reference internal" href="august.html">August Epicycloidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="bacon.html">Bacon Globular</a></li>
<li class="toctree-l3"><a class="reference internal" href="bertin1953.html">Bertin 1953</a></li>
<li class="toctree-l3"><a class="reference internal" href="bipc.html">Bipolar conic of western hemisphere</a></li>
<li class="toctree-l3"><a class="reference internal" href="boggs.html">Boggs Eumorphic</a></li>
<li class="toctree-l3"><a class="reference internal" href="bonne.html">Bonne (Werner lat_1=90)</a></li>
<li class="toctree-l3"><a class="reference internal" href="calcofi.html">Cal Coop Ocean Fish Invest Lines/Stations</a></li>
<li class="toctree-l3"><a class="reference internal" href="cass.html">Cassini (Cassini-Soldner)</a></li>
<li class="toctree-l3"><a class="reference internal" href="cc.html">Central Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="ccon.html">Central Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="cea.html">Equal Area Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="chamb.html">Chamberlin Trimetric</a></li>
<li class="toctree-l3"><a class="reference internal" href="collg.html">Collignon</a></li>
<li class="toctree-l3"><a class="reference internal" href="col_urban.html">Colombia Urban</a></li>
<li class="toctree-l3"><a class="reference internal" href="comill.html">Compact Miller</a></li>
<li class="toctree-l3"><a class="reference internal" href="crast.html">Craster Parabolic (Putnins P4)</a></li>
<li class="toctree-l3"><a class="reference internal" href="denoy.html">Denoyer Semi-Elliptical</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck1.html">Eckert I</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck2.html">Eckert II</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck3.html">Eckert III</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck4.html">Eckert IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck5.html">Eckert V</a></li>
<li class="toctree-l3"><a class="reference internal" href="eck6.html">Eckert VI</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqc.html">Equidistant Cylindrical (Plate Carrée)</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqdc.html">Equidistant Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="eqearth.html">Equal Earth</a></li>
<li class="toctree-l3"><a class="reference internal" href="euler.html">Euler</a></li>
<li class="toctree-l3"><a class="reference internal" href="fahey.html">Fahey</a></li>
<li class="toctree-l3"><a class="reference internal" href="fouc.html">Foucaut</a></li>
<li class="toctree-l3"><a class="reference internal" href="fouc_s.html">Foucaut Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="gall.html">Gall (Gall Stereographic)</a></li>
<li class="toctree-l3"><a class="reference internal" href="geos.html">Geostationary Satellite View</a></li>
<li class="toctree-l3"><a class="reference internal" href="gins8.html">Ginsburg VIII (TsNIIGAiK)</a></li>
<li class="toctree-l3"><a class="reference internal" href="gn_sinu.html">General Sinusoidal Series</a></li>
<li class="toctree-l3"><a class="reference internal" href="gnom.html">Gnomonic</a></li>
<li class="toctree-l3"><a class="reference internal" href="goode.html">Goode Homolosine</a></li>
<li class="toctree-l3"><a class="reference internal" href="gs48.html">Modified Stereographic of 48 U.S.</a></li>
<li class="toctree-l3"><a class="reference internal" href="gs50.html">Modified Stereographic of 50 U.S.</a></li>
<li class="toctree-l3"><a class="reference internal" href="guyou.html">Guyou</a></li>
<li class="toctree-l3"><a class="reference internal" href="hammer.html">Hammer &amp; Eckert-Greifendorff</a></li>
<li class="toctree-l3"><a class="reference internal" href="hatano.html">Hatano Asymmetrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="healpix.html">HEALPix</a></li>
<li class="toctree-l3"><a class="reference internal" href="rhealpix.html">rHEALPix</a></li>
<li class="toctree-l3"><a class="reference internal" href="igh.html">Interrupted Goode Homolosine</a></li>
<li class="toctree-l3"><a class="reference internal" href="igh_o.html">Interrupted Goode Homolosine (Oceanic View)</a></li>
<li class="toctree-l3"><a class="reference internal" href="imw_p.html">International Map of the World Polyconic</a></li>
<li class="toctree-l3"><a class="reference internal" href="isea.html">Icosahedral Snyder Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="kav5.html">Kavrayskiy V</a></li>
<li class="toctree-l3"><a class="reference internal" href="kav7.html">Kavrayskiy VII</a></li>
<li class="toctree-l3"><a class="reference internal" href="krovak.html">Krovak</a></li>
<li class="toctree-l3"><a class="reference internal" href="labrd.html">Laborde</a></li>
<li class="toctree-l3"><a class="reference internal" href="laea.html">Lambert Azimuthal Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="lagrng.html">Lagrange</a></li>
<li class="toctree-l3"><a class="reference internal" href="larr.html">Larrivee</a></li>
<li class="toctree-l3"><a class="reference internal" href="lask.html">Laskowski</a></li>
<li class="toctree-l3"><a class="reference internal" href="lcc.html">Lambert Conformal Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="lcca.html">Lambert Conformal Conic Alternative</a></li>
<li class="toctree-l3"><a class="reference internal" href="leac.html">Lambert Equal Area Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="lee_os.html">Lee Oblated Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="loxim.html">Loximuthal</a></li>
<li class="toctree-l3"><a class="reference internal" href="lsat.html">Space oblique for LANDSAT</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbt_s.html">McBryde-Thomas Flat-Polar Sine (No. 1)</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbt_fps.html">McBryde-Thomas Flat-Pole Sine (No. 2)</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfpp.html">McBride-Thomas Flat-Polar Parabolic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfpq.html">McBryde-Thomas Flat-Polar Quartic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbtfps.html">McBryde-Thomas Flat-Polar Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="merc.html">Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="mil_os.html">Miller Oblated Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="mill.html">Miller Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="misrsom.html">Space oblique for MISR</a></li>
<li class="toctree-l3"><a class="reference internal" href="moll.html">Mollweide</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd1.html">Murdoch I</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd2.html">Murdoch II</a></li>
<li class="toctree-l3"><a class="reference internal" href="murd3.html">Murdoch III</a></li>
<li class="toctree-l3"><a class="reference internal" href="natearth.html">Natural Earth</a></li>
<li class="toctree-l3"><a class="reference internal" href="natearth2.html">Natural Earth II</a></li>
<li class="toctree-l3"><a class="reference internal" href="nell.html">Nell</a></li>
<li class="toctree-l3"><a class="reference internal" href="nell_h.html">Nell-Hammer</a></li>
<li class="toctree-l3"><a class="reference internal" href="nicol.html">Nicolosi Globular</a></li>
<li class="toctree-l3"><a class="reference internal" href="nsper.html">Near-sided perspective</a></li>
<li class="toctree-l3"><a class="reference internal" href="nzmg.html">New Zealand Map Grid</a></li>
<li class="toctree-l3"><a class="reference internal" href="ob_tran.html">General Oblique Transformation</a></li>
<li class="toctree-l3"><a class="reference internal" href="ocea.html">Oblique Cylindrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="oea.html">Oblated Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="omerc.html">Oblique Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="ortel.html">Ortelius Oval</a></li>
<li class="toctree-l3"><a class="reference internal" href="ortho.html">Orthographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="patterson.html">Patterson</a></li>
<li class="toctree-l3"><a class="reference internal" href="pconic.html">Perspective Conic</a></li>
<li class="toctree-l3"><a class="reference internal" href="peirce_q.html">Peirce Quincuncial</a></li>
<li class="toctree-l3"><a class="reference internal" href="poly.html">Polyconic (American)</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp1.html">Putnins P1</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp2.html">Putnins P2</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp3.html">Putnins P3</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp3p.html">Putnins P3’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp4p.html">Putnins P4’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp5.html">Putnins P5</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp5p.html">Putnins P5’</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp6.html">Putnins P6</a></li>
<li class="toctree-l3"><a class="reference internal" href="putp6p.html">Putnins P6’</a></li>
<li class="toctree-l3"><a class="reference internal" href="qua_aut.html">Quartic Authalic</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Quadrilateralized Spherical Cube</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#usage">Usage</a></li>
<li class="toctree-l4"><a class="reference internal" href="#parameters">Parameters</a></li>
<li class="toctree-l4"><a class="reference internal" href="#further-reading">Further reading</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="robin.html">Robinson</a></li>
<li class="toctree-l3"><a class="reference internal" href="rouss.html">Roussilhe Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="rpoly.html">Rectangular Polyconic</a></li>
<li class="toctree-l3"><a class="reference internal" href="s2.html">S2</a></li>
<li class="toctree-l3"><a class="reference internal" href="sch.html">Spherical Cross-track Height</a></li>
<li class="toctree-l3"><a class="reference internal" href="sinu.html">Sinusoidal (Sanson-Flamsteed)</a></li>
<li class="toctree-l3"><a class="reference internal" href="somerc.html">Swiss Oblique Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="stere.html">Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="sterea.html">Oblique Stereographic Alternative</a></li>
<li class="toctree-l3"><a class="reference internal" href="gstmerc.html">Gauss-Schreiber Transverse Mercator (aka Gauss-Laborde Reunion)</a></li>
<li class="toctree-l3"><a class="reference internal" href="tcc.html">Transverse Central Cylindrical</a></li>
<li class="toctree-l3"><a class="reference internal" href="tcea.html">Transverse Cylindrical Equal Area</a></li>
<li class="toctree-l3"><a class="reference internal" href="times.html">Times</a></li>
<li class="toctree-l3"><a class="reference internal" href="tissot.html">Tissot</a></li>
<li class="toctree-l3"><a class="reference internal" href="tmerc.html">Transverse Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="tobmerc.html">Tobler-Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="tpeqd.html">Two Point Equidistant</a></li>
<li class="toctree-l3"><a class="reference internal" href="tpers.html">Tilted perspective</a></li>
<li class="toctree-l3"><a class="reference internal" href="ups.html">Universal Polar Stereographic</a></li>
<li class="toctree-l3"><a class="reference internal" href="urm5.html">Urmaev V</a></li>
<li class="toctree-l3"><a class="reference internal" href="urmfps.html">Urmaev Flat-Polar Sinusoidal</a></li>
<li class="toctree-l3"><a class="reference internal" href="utm.html">Universal Transverse Mercator (UTM)</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg.html">van der Grinten (I)</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg2.html">van der Grinten II</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg3.html">van der Grinten III</a></li>
<li class="toctree-l3"><a class="reference internal" href="vandg4.html">van der Grinten IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="vitk1.html">Vitkovsky I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag1.html">Wagner I (Kavrayskiy VI)</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag2.html">Wagner II</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag3.html">Wagner III</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag4.html">Wagner IV</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag5.html">Wagner V</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag6.html">Wagner VI</a></li>
<li class="toctree-l3"><a class="reference internal" href="wag7.html">Wagner VII</a></li>
<li class="toctree-l3"><a class="reference internal" href="webmerc.html">Web Mercator / Pseudo Mercator</a></li>
<li class="toctree-l3"><a class="reference internal" href="weren.html">Werenskiold I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wink1.html">Winkel I</a></li>
<li class="toctree-l3"><a class="reference internal" href="wink2.html">Winkel II</a></li>
<li class="toctree-l3"><a class="reference internal" href="wintri.html">Winkel Tripel</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../conversions/index.html">Conversions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../transformations/index.html">Transformations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pipeline.html">The pipeline operator</a></li>
<li class="toctree-l2"><a class="reference internal" href="../operations_computation.html">Computation of coordinate operations between two CRS</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../resource_files.html">Resource files</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../geodesic.html">Geodesic calculations</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../development/index.html">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../specifications/index.html">Specifications</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../community/index.html">Community</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../faq.html">FAQ</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../zreferences.html">References</a></li>
</ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #353130" >
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../index.html">PROJ</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="../../index.html" class="icon icon-home"></a> &raquo;</li>
          <li><a href="../index.html">Coordinate operations</a> &raquo;</li>
          <li><a href="index.html">Projections</a> &raquo;</li>
      <li>Quadrilateralized Spherical Cube</li>
      <li class="wy-breadcrumbs-aside">
              <a href="https://github.com/OSGeo/PROJ/edit/8.2/docs/source/operations/projections/qsc.rst" class="fa fa-github"> Edit on GitHub</a>
      </li>
  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
        <a href="qua_aut.html" class="btn btn-neutral float-left" title="Quartic Authalic" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="robin.html" class="btn btn-neutral float-right" title="Robinson" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
  </div>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
             
  <section id="quadrilateralized-spherical-cube">
<span id="qsc"></span><h1>Quadrilateralized Spherical Cube<a class="headerlink" href="#quadrilateralized-spherical-cube" title="Permalink to this headline">¶</a></h1>
<table class="docutils align-default">
<colgroup>
<col style="width: 27%" />
<col style="width: 73%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p><strong>Classification</strong></p></td>
<td><p>Azimuthal</p></td>
</tr>
<tr class="row-even"><td><p><strong>Available forms</strong></p></td>
<td><p>Forward and inverse, ellipsoidal</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Defined area</strong></p></td>
<td><p>Global</p></td>
</tr>
<tr class="row-even"><td><p><strong>Alias</strong></p></td>
<td><p>qsc</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Domain</strong></p></td>
<td><p>2D</p></td>
</tr>
<tr class="row-even"><td><p><strong>Input type</strong></p></td>
<td><p>Geodetic coordinates</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Output type</strong></p></td>
<td><p>Projected coordinates</p></td>
</tr>
</tbody>
</table>
<p>The purpose of the Quadrilateralized Spherical Cube (QSC) projection is to project
a sphere surface onto the six sides of a cube:</p>
<a class="reference internal image-reference" href="../../_images/qsc_concept.jpg"><img alt="Quadrilateralized Spherical Cube" class="align-center" src="../../_images/qsc_concept.jpg" style="width: 500px;" /></a>
<p>For this purpose, other alternatives can be used, notably <a class="reference internal" href="gnom.html#gnom"><span class="std std-ref">Gnomonic</span></a> or
<a class="reference internal" href="healpix.html#healpix"><span class="std std-ref">HEALPix</span></a>. However, QSC projection has the following favorable properties:</p>
<p>It is an equal-area projection, and at the same time introduces only limited angular
distortions. It treats all cube sides equally, i.e. it does not use different
projections for polar areas and equatorial areas. These properties make QSC
projection a good choice for planetary-scale terrain rendering. Map data can be
organized in quadtree structures for each cube side. See <span id="id1">[<a class="reference internal" href="../../zreferences.html#id25" title="Lambers, M. and Kolb, A. Ellipsoidal cube maps for accurate rendering of planetary-scale terrain data. In Bregler, C., Sander, P., and Wimmer, M., editors, Pacific Graphics Short Papers. The Eurographics Association, 2012. doi:10.2312/PE/PG/PG2012short/005-010.">LambersKolb2012</a>]</span> for an example.</p>
<p>The QSC projection was introduced by <span id="id2">[<a class="reference internal" href="../../zreferences.html#id27" title="O'Neill, E. M. and Laubscher, R. E. Extended studies of a quadrilateralized spherical cube earth data base. Tech. Rep. EPRF 3-76 (CSC), Computer Sciences Corporation, System Sciences Division, Silver Spring, Md, 1976. URL: https://archive.org/details/DTIC_ADA026294.">ONeilLaubscher1976</a>]</span>,
building on previous work by <span id="id3">[<a class="reference internal" href="../../zreferences.html#id6" title="Chan, F. K. and O'Neill, E. M. Feasibility study of a quadrilateralized spherical cube earth data base. Tech. Rep. EPRF 2-75 (CSC), Computer Sciences Corporation, System Sciences Division, Silver Spring, Md, 1975. URL: https://archive.org/details/ADA010232.">ChanONeil1975</a>]</span>. For clarity: The
earlier QSC variant described in <span id="id4">[<a class="reference internal" href="../../zreferences.html#id6" title="Chan, F. K. and O'Neill, E. M. Feasibility study of a quadrilateralized spherical cube earth data base. Tech. Rep. EPRF 2-75 (CSC), Computer Sciences Corporation, System Sciences Division, Silver Spring, Md, 1975. URL: https://archive.org/details/ADA010232.">ChanONeil1975</a>]</span> became known as the COBE QSC since it
was used by the NASA Cosmic Background Explorer (COBE) project; it is an approximately
equal-area projection and is not the same as the QSC projection.</p>
<p>See also <span id="id5">[<a class="reference internal" href="../../zreferences.html#id5" title="Calabretta, M. R. and Greisen, E. W. Representations of celestial coordinates in FITS. Astronomy &amp; Astrophysics, 395(3):1077–1122, 2002. doi:10.1051/0004-6361:20021327.">CalabrettaGreisen2002</a>]</span> Sec. 5.6.2 and 5.6.3 for a description of both and
some analysis.</p>
<p>In this implementation, the QSC projection projects onto one side of a circumscribed
cube. The cube side is selected by choosing one of the following six projection centers:</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 56%" />
<col style="width: 44%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=0</span> <span class="pre">+lon_0=0</span></code></p></td>
<td><p>front cube side</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=0</span> <span class="pre">+lon_0=90</span></code></p></td>
<td><p>right cube side</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=0</span> <span class="pre">+lon_0=180</span></code></p></td>
<td><p>back cube side</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=0</span> <span class="pre">+lon_0=-90</span></code></p></td>
<td><p>left cube side</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=90</span></code></p></td>
<td><p>top cube side</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">+lat_0=-90</span></code></p></td>
<td><p>bottom cube side</p></td>
</tr>
</tbody>
</table>
<p>Furthermore, this implementation allows the projection to be applied to ellipsoids.
A preceding shift to a sphere is performed automatically; see <span id="id6">[<a class="reference internal" href="../../zreferences.html#id25" title="Lambers, M. and Kolb, A. Ellipsoidal cube maps for accurate rendering of planetary-scale terrain data. In Bregler, C., Sander, P., and Wimmer, M., editors, Pacific Graphics Short Papers. The Eurographics Association, 2012. doi:10.2312/PE/PG/PG2012short/005-010.">LambersKolb2012</a>]</span> for details.</p>
<section id="usage">
<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
<p>The following example uses QSC projection via GDAL to create the six cube side
maps from a world map for the WGS84 ellipsoid:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84  +lat_0=0 +lon_0=0&quot;        \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff frontside.tiff

gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=90&quot;        \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff rightside.tiff

gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=180&quot;       \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff backside.tiff

gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=0 +lon_0=-90&quot;       \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff leftside.tiff

gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=90 +lon_0=0&quot;        \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff topside.tiff

gdalwarp -t_srs &quot;+wktext +proj=qsc +units=m +ellps=WGS84 +lat_0=-90 +lon_0=0&quot;       \
    -wo SOURCE_EXTRA=100 -wo SAMPLE_GRID=YES -te -6378137 -6378137 6378137 6378137  \
    worldmap.tiff bottomside.tiff
</pre></div>
</div>
<p>Explanation:</p>
<ul class="simple">
<li><p>QSC projection is selected with <code class="docutils literal notranslate"><span class="pre">+wktext</span> <span class="pre">+proj=qsc</span></code>.</p></li>
<li><p>The WGS84 ellipsoid is specified with <code class="docutils literal notranslate"><span class="pre">+ellps=WGS84</span></code>.</p></li>
<li><p>The cube side is selected with <code class="docutils literal notranslate"><span class="pre">+lat_0=...</span> <span class="pre">+lon_0=...</span></code>.</p></li>
<li><p>The <code class="docutils literal notranslate"><span class="pre">-wo</span></code> options are necessary for GDAL to avoid holes in the output maps.</p></li>
<li><p>The <code class="docutils literal notranslate"><span class="pre">-te</span></code> option limits the extends of the output map to the major axis diameter
(from -radius to +radius in both x and y direction). These are the dimensions of one side
of the circumscribing cube.</p></li>
</ul>
<p>The resulting images can be laid out in a grid like below.</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 24%" />
<col style="width: 27%" />
<col style="width: 25%" />
<col style="width: 24%" />
</colgroup>
<tbody>
<tr class="row-odd"><td></td>
<td><p><a class="reference internal" href="../../_images/qsc_topside.jpg"><img alt="Top side" class="align-middle" src="../../_images/qsc_topside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="../../_images/qsc_leftside.jpg"><img alt="Left side" class="align-middle" src="../../_images/qsc_leftside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
<td><p><a class="reference internal" href="../../_images/qsc_frontside.jpg"><img alt="Front side" class="align-middle" src="../../_images/qsc_frontside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
<td><p><a class="reference internal" href="../../_images/qsc_rightside.jpg"><img alt="Right side" class="align-middle" src="../../_images/qsc_rightside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
<td><p><a class="reference internal" href="../../_images/qsc_backside.jpg"><img alt="Back side" class="align-middle" src="../../_images/qsc_backside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><a class="reference internal" href="../../_images/qsc_bottomside.jpg"><img alt="Bottom side" class="align-middle" src="../../_images/qsc_bottomside.jpg" style="width: 128.0px; height: 128.0px;" /></a></p></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
</section>
<section id="parameters">
<h2>Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>All parameters for the projection are optional.</p>
</div>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-lon_0">
<span id="cmdoption-arg-lon-0"></span><span class="sig-name descname"><span class="pre">+lon_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-lon_0" title="Permalink to this definition">¶</a></dt>
<dd><p>Longitude of projection center.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-lat_0">
<span id="cmdoption-arg-lat-0"></span><span class="sig-name descname"><span class="pre">+lat_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-lat_0" title="Permalink to this definition">¶</a></dt>
<dd><p>Latitude of projection center.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-ellps">
<span class="sig-name descname"><span class="pre">+ellps</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-ellps" title="Permalink to this definition">¶</a></dt>
<dd><p>The name of a built-in ellipsoid definition.</p>
<p>See <a class="reference internal" href="../../usage/ellipsoids.html#ellipsoids"><span class="std std-ref">Ellipsoids</span></a> for more information, or execute
<a class="reference internal" href="../../apps/proj.html#cmdoption-proj-le"><code class="xref std std-option docutils literal notranslate"><span class="pre">proj</span> <span class="pre">-le</span></code></a> for a list of built-in ellipsoid names.</p>
<p><em>Defaults to “GRS80”.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-x_0">
<span id="cmdoption-arg-x-0"></span><span class="sig-name descname"><span class="pre">+x_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-x_0" title="Permalink to this definition">¶</a></dt>
<dd><p>False easting.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-arg-y_0">
<span id="cmdoption-arg-y-0"></span><span class="sig-name descname"><span class="pre">+y_0</span></span><span class="sig-prename descclassname"><span class="pre">=&lt;value&gt;</span></span><a class="headerlink" href="#cmdoption-arg-y_0" title="Permalink to this definition">¶</a></dt>
<dd><p>False northing.</p>
<p><em>Defaults to 0.0.</em></p>
</dd></dl>

</section>
<section id="further-reading">
<h2>Further reading<a class="headerlink" href="#further-reading" title="Permalink to this headline">¶</a></h2>
<ol class="arabic simple">
<li><p><a class="reference external" href="https://en.wikipedia.org/wiki/Quadrilateralized_spherical_cube">Wikipedia</a></p></li>
<li><p><a class="reference external" href="https://lambda.gsfc.nasa.gov/product/cobe/skymap_info_new.cfm">NASA</a></p></li>
</ol>
</section>
</section>


           </div>
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="qua_aut.html" class="btn btn-neutral float-left" title="Quartic Authalic" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="robin.html" class="btn btn-neutral float-right" title="Robinson" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; Copyright 1983-2022.
      <span class="lastupdated">Last updated on 22 Mar 2022.
      </span></p>
  </div>

  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    provided by <a href="https://readthedocs.org">Read the Docs</a>.
   

</footer>
        </div>
      </div>
    </section>
  </div>
  <script>
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script> 

</body>
</html>