1
2.. (comment): DO NOT EDIT this file.
3.. It is auto-generated by running : cartopy/docs/make_projection.py
4.. Please adjust by making changes there.
5.. It is included in the repository only to aid detection of changes.
6
7.. _cartopy_projections:
8
9Cartopy projection list
10=======================
11
12PlateCarree
13-----------
14
15.. autoclass:: cartopy.crs.PlateCarree
16
17.. plot::
18
19    import matplotlib.pyplot as plt
20    import cartopy.crs as ccrs
21
22    nplots = 2
23
24    fig = plt.figure(figsize=(6, 6))
25
26    for i in range(0, nplots):
27        central_longitude = 0 if i == 0 else 180
28        ax = fig.add_subplot(
29            nplots, 1, i+1,
30            projection=ccrs.PlateCarree(central_longitude=central_longitude))
31        ax.coastlines(resolution='110m')
32        ax.gridlines()
33
34
35AlbersEqualArea
36---------------
37
38.. autoclass:: cartopy.crs.AlbersEqualArea
39
40.. plot::
41
42    import matplotlib.pyplot as plt
43    import cartopy.crs as ccrs
44
45    plt.figure(figsize=(5.1299, 3))
46    ax = plt.axes(projection=ccrs.AlbersEqualArea())
47    ax.coastlines(resolution='110m')
48    ax.gridlines()
49
50
51AzimuthalEquidistant
52--------------------
53
54.. autoclass:: cartopy.crs.AzimuthalEquidistant
55
56.. plot::
57
58    import matplotlib.pyplot as plt
59    import cartopy.crs as ccrs
60
61    plt.figure(figsize=(3, 3))
62    ax = plt.axes(projection=ccrs.AzimuthalEquidistant(
63                            central_latitude=90))
64    ax.coastlines(resolution='110m')
65    ax.gridlines()
66
67
68EquidistantConic
69----------------
70
71.. autoclass:: cartopy.crs.EquidistantConic
72
73.. plot::
74
75    import matplotlib.pyplot as plt
76    import cartopy.crs as ccrs
77
78    plt.figure(figsize=(4.9603, 3))
79    ax = plt.axes(projection=ccrs.EquidistantConic())
80    ax.coastlines(resolution='110m')
81    ax.gridlines()
82
83
84LambertConformal
85----------------
86
87.. autoclass:: cartopy.crs.LambertConformal
88
89.. plot::
90
91    import matplotlib.pyplot as plt
92    import cartopy.crs as ccrs
93
94    plt.figure(figsize=(4.2897, 3))
95    ax = plt.axes(projection=ccrs.LambertConformal())
96    ax.coastlines(resolution='110m')
97    ax.gridlines()
98
99
100LambertCylindrical
101------------------
102
103.. autoclass:: cartopy.crs.LambertCylindrical
104
105.. plot::
106
107    import matplotlib.pyplot as plt
108    import cartopy.crs as ccrs
109
110    plt.figure(figsize=(9.4248, 3))
111    ax = plt.axes(projection=ccrs.LambertCylindrical())
112    ax.coastlines(resolution='110m')
113    ax.gridlines()
114
115
116Mercator
117--------
118
119.. autoclass:: cartopy.crs.Mercator
120
121.. plot::
122
123    import matplotlib.pyplot as plt
124    import cartopy.crs as ccrs
125
126    plt.figure(figsize=(3.5091, 3))
127    ax = plt.axes(projection=ccrs.Mercator())
128    ax.coastlines(resolution='110m')
129    ax.gridlines()
130
131
132Miller
133------
134
135.. autoclass:: cartopy.crs.Miller
136
137.. plot::
138
139    import matplotlib.pyplot as plt
140    import cartopy.crs as ccrs
141
142    plt.figure(figsize=(4.0917, 3))
143    ax = plt.axes(projection=ccrs.Miller())
144    ax.coastlines(resolution='110m')
145    ax.gridlines()
146
147
148Mollweide
149---------
150
151.. autoclass:: cartopy.crs.Mollweide
152
153.. plot::
154
155    import matplotlib.pyplot as plt
156    import cartopy.crs as ccrs
157
158    plt.figure(figsize=(6, 3))
159    ax = plt.axes(projection=ccrs.Mollweide())
160    ax.coastlines(resolution='110m')
161    ax.gridlines()
162
163
164Orthographic
165------------
166
167.. autoclass:: cartopy.crs.Orthographic
168
169.. plot::
170
171    import matplotlib.pyplot as plt
172    import cartopy.crs as ccrs
173
174    plt.figure(figsize=(3, 3))
175    ax = plt.axes(projection=ccrs.Orthographic())
176    ax.coastlines(resolution='110m')
177    ax.gridlines()
178
179
180Robinson
181--------
182
183.. autoclass:: cartopy.crs.Robinson
184
185.. plot::
186
187    import matplotlib.pyplot as plt
188    import cartopy.crs as ccrs
189
190    plt.figure(figsize=(5.915, 3))
191    ax = plt.axes(projection=ccrs.Robinson())
192    ax.coastlines(resolution='110m')
193    ax.gridlines()
194
195
196Sinusoidal
197----------
198
199.. autoclass:: cartopy.crs.Sinusoidal
200
201.. plot::
202
203    import matplotlib.pyplot as plt
204    import cartopy.crs as ccrs
205
206    plt.figure(figsize=(6.0101, 3))
207    ax = plt.axes(projection=ccrs.Sinusoidal())
208    ax.coastlines(resolution='110m')
209    ax.gridlines()
210
211
212Stereographic
213-------------
214
215.. autoclass:: cartopy.crs.Stereographic
216
217.. plot::
218
219    import matplotlib.pyplot as plt
220    import cartopy.crs as ccrs
221
222    plt.figure(figsize=(3, 3))
223    ax = plt.axes(projection=ccrs.Stereographic())
224    ax.coastlines(resolution='110m')
225    ax.gridlines()
226
227
228TransverseMercator
229------------------
230
231.. autoclass:: cartopy.crs.TransverseMercator
232
233.. plot::
234
235    import matplotlib.pyplot as plt
236    import cartopy.crs as ccrs
237
238    plt.figure(figsize=(6, 3))
239    ax = plt.axes(projection=ccrs.TransverseMercator(
240                            approx=False))
241    ax.coastlines(resolution='110m')
242    ax.gridlines()
243
244
245UTM
246---
247
248.. autoclass:: cartopy.crs.UTM
249
250.. plot::
251
252    import matplotlib.pyplot as plt
253    import cartopy.crs as ccrs
254
255    nplots = 60
256
257    fig = plt.figure(figsize=(10, 3))
258
259    for i in range(0, nplots):
260        ax = fig.add_subplot(1, nplots, i+1,
261                             projection=ccrs.UTM(zone=i+1,
262                                                 southern_hemisphere=True))
263        ax.coastlines(resolution='110m')
264        ax.gridlines()
265
266
267InterruptedGoodeHomolosine
268--------------------------
269
270.. autoclass:: cartopy.crs.InterruptedGoodeHomolosine
271
272.. plot::
273
274    import matplotlib.pyplot as plt
275    import cartopy.crs as ccrs
276
277    plt.figure(figsize=(6.9228, 3))
278    ax = plt.axes(projection=ccrs.InterruptedGoodeHomolosine())
279    ax.coastlines(resolution='110m')
280    ax.gridlines()
281
282
283RotatedPole
284-----------
285
286.. autoclass:: cartopy.crs.RotatedPole
287
288.. plot::
289
290    import matplotlib.pyplot as plt
291    import cartopy.crs as ccrs
292
293    plt.figure(figsize=(6, 3))
294    ax = plt.axes(projection=ccrs.RotatedPole(
295                            pole_latitude=37.5,
296                            pole_longitude=177.5))
297    ax.coastlines(resolution='110m')
298    ax.gridlines()
299
300
301OSGB
302----
303
304.. autoclass:: cartopy.crs.OSGB
305
306.. plot::
307
308    import matplotlib.pyplot as plt
309    import cartopy.crs as ccrs
310
311    plt.figure(figsize=(1.6154, 3))
312    ax = plt.axes(projection=ccrs.OSGB(
313                            approx=False))
314    ax.coastlines(resolution='50m')
315    ax.gridlines()
316
317
318EuroPP
319------
320
321.. autoclass:: cartopy.crs.EuroPP
322
323.. plot::
324
325    import matplotlib.pyplot as plt
326    import cartopy.crs as ccrs
327
328    plt.figure(figsize=(2.6154, 3))
329    ax = plt.axes(projection=ccrs.EuroPP())
330    ax.coastlines(resolution='50m')
331    ax.gridlines()
332
333
334Geostationary
335-------------
336
337.. autoclass:: cartopy.crs.Geostationary
338
339.. plot::
340
341    import matplotlib.pyplot as plt
342    import cartopy.crs as ccrs
343
344    plt.figure(figsize=(3, 3))
345    ax = plt.axes(projection=ccrs.Geostationary())
346    ax.coastlines(resolution='110m')
347    ax.gridlines()
348
349
350NearsidePerspective
351-------------------
352
353.. autoclass:: cartopy.crs.NearsidePerspective
354
355.. plot::
356
357    import matplotlib.pyplot as plt
358    import cartopy.crs as ccrs
359
360    plt.figure(figsize=(3, 3))
361    ax = plt.axes(projection=ccrs.NearsidePerspective(
362                            central_latitude=50.72,
363                            central_longitude=-3.53,
364                            satellite_height=10000000.0))
365    ax.coastlines(resolution='110m')
366    ax.gridlines()
367
368
369EckertI
370-------
371
372.. autoclass:: cartopy.crs.EckertI
373
374.. plot::
375
376    import matplotlib.pyplot as plt
377    import cartopy.crs as ccrs
378
379    plt.figure(figsize=(6, 3))
380    ax = plt.axes(projection=ccrs.EckertI())
381    ax.coastlines(resolution='110m')
382    ax.gridlines()
383
384
385EckertII
386--------
387
388.. autoclass:: cartopy.crs.EckertII
389
390.. plot::
391
392    import matplotlib.pyplot as plt
393    import cartopy.crs as ccrs
394
395    plt.figure(figsize=(6, 3))
396    ax = plt.axes(projection=ccrs.EckertII())
397    ax.coastlines(resolution='110m')
398    ax.gridlines()
399
400
401EckertIII
402---------
403
404.. autoclass:: cartopy.crs.EckertIII
405
406.. plot::
407
408    import matplotlib.pyplot as plt
409    import cartopy.crs as ccrs
410
411    plt.figure(figsize=(6, 3))
412    ax = plt.axes(projection=ccrs.EckertIII())
413    ax.coastlines(resolution='110m')
414    ax.gridlines()
415
416
417EckertIV
418--------
419
420.. autoclass:: cartopy.crs.EckertIV
421
422.. plot::
423
424    import matplotlib.pyplot as plt
425    import cartopy.crs as ccrs
426
427    plt.figure(figsize=(6, 3))
428    ax = plt.axes(projection=ccrs.EckertIV())
429    ax.coastlines(resolution='110m')
430    ax.gridlines()
431
432
433EckertV
434-------
435
436.. autoclass:: cartopy.crs.EckertV
437
438.. plot::
439
440    import matplotlib.pyplot as plt
441    import cartopy.crs as ccrs
442
443    plt.figure(figsize=(6, 3))
444    ax = plt.axes(projection=ccrs.EckertV())
445    ax.coastlines(resolution='110m')
446    ax.gridlines()
447
448
449EckertVI
450--------
451
452.. autoclass:: cartopy.crs.EckertVI
453
454.. plot::
455
456    import matplotlib.pyplot as plt
457    import cartopy.crs as ccrs
458
459    plt.figure(figsize=(6, 3))
460    ax = plt.axes(projection=ccrs.EckertVI())
461    ax.coastlines(resolution='110m')
462    ax.gridlines()
463
464
465EqualEarth
466----------
467
468.. autoclass:: cartopy.crs.EqualEarth
469
470.. plot::
471
472    import matplotlib.pyplot as plt
473    import cartopy.crs as ccrs
474
475    plt.figure(figsize=(6.1637, 3))
476    ax = plt.axes(projection=ccrs.EqualEarth())
477    ax.coastlines(resolution='110m')
478    ax.gridlines()
479
480
481Gnomonic
482--------
483
484.. autoclass:: cartopy.crs.Gnomonic
485
486.. plot::
487
488    import matplotlib.pyplot as plt
489    import cartopy.crs as ccrs
490
491    plt.figure(figsize=(3, 3))
492    ax = plt.axes(projection=ccrs.Gnomonic())
493    ax.coastlines(resolution='110m')
494    ax.gridlines()
495
496
497LambertAzimuthalEqualArea
498-------------------------
499
500.. autoclass:: cartopy.crs.LambertAzimuthalEqualArea
501
502.. plot::
503
504    import matplotlib.pyplot as plt
505    import cartopy.crs as ccrs
506
507    plt.figure(figsize=(3.0066, 3))
508    ax = plt.axes(projection=ccrs.LambertAzimuthalEqualArea())
509    ax.coastlines(resolution='110m')
510    ax.gridlines()
511
512
513NorthPolarStereo
514----------------
515
516.. autoclass:: cartopy.crs.NorthPolarStereo
517
518.. plot::
519
520    import matplotlib.pyplot as plt
521    import cartopy.crs as ccrs
522
523    plt.figure(figsize=(3, 3))
524    ax = plt.axes(projection=ccrs.NorthPolarStereo())
525    ax.coastlines(resolution='110m')
526    ax.gridlines()
527
528
529OSNI
530----
531
532.. autoclass:: cartopy.crs.OSNI
533
534.. plot::
535
536    import matplotlib.pyplot as plt
537    import cartopy.crs as ccrs
538
539    plt.figure(figsize=(2.4323, 3))
540    ax = plt.axes(projection=ccrs.OSNI(
541                            approx=False))
542    ax.coastlines(resolution='10m')
543    ax.gridlines()
544
545
546SouthPolarStereo
547----------------
548
549.. autoclass:: cartopy.crs.SouthPolarStereo
550
551.. plot::
552
553    import matplotlib.pyplot as plt
554    import cartopy.crs as ccrs
555
556    plt.figure(figsize=(3, 3))
557    ax = plt.axes(projection=ccrs.SouthPolarStereo())
558    ax.coastlines(resolution='110m')
559    ax.gridlines()
560
561
562