Cartopy projection list#

PlateCarree#

class cartopy.crs.PlateCarree(central_longitude=0.0, globe=None)[source]#

(Source code)

../_images/projections-1.png

AlbersEqualArea#

class cartopy.crs.AlbersEqualArea(central_longitude=0.0, central_latitude=0.0, false_easting=0.0, false_northing=0.0, standard_parallels=(20.0, 50.0), globe=None)[source]#

An Albers Equal Area projection

This projection is conic and equal-area, and is commonly used for maps of the conterminous United States.

(Source code)

../_images/projections-2.png

AzimuthalEquidistant#

class cartopy.crs.AzimuthalEquidistant(central_longitude=0.0, central_latitude=0.0, false_easting=0.0, false_northing=0.0, globe=None)[source]#

An Azimuthal Equidistant projection

This projection provides accurate angles about and distances through the central position. Other angles, distances, or areas may be distorted.

(Source code)

../_images/projections-3.png

EquidistantConic#

class cartopy.crs.EquidistantConic(central_longitude=0.0, central_latitude=0.0, false_easting=0.0, false_northing=0.0, standard_parallels=(20.0, 50.0), globe=None)[source]#

An Equidistant Conic projection.

This projection is conic and equidistant, and the scale is true along all meridians and along one or two specified standard parallels.

(Source code)

../_images/projections-4.png

LambertConformal#

class cartopy.crs.LambertConformal(central_longitude=-96.0, central_latitude=39.0, false_easting=0.0, false_northing=0.0, standard_parallels=(33, 45), globe=None, cutoff=-30)[source]#

A Lambert Conformal conic projection.

(Source code)

../_images/projections-5.png

LambertCylindrical#

class cartopy.crs.LambertCylindrical(central_longitude=0.0, globe=None)[source]#

(Source code)

../_images/projections-6.png

Mercator#

class cartopy.crs.Mercator(central_longitude=0.0, min_latitude=-80.0, max_latitude=84.0, globe=None, latitude_true_scale=None, false_easting=0.0, false_northing=0.0, scale_factor=None)[source]#

A Mercator projection.

(Source code)

../_images/projections-7.png

Miller#

class cartopy.crs.Miller(central_longitude=0.0, globe=None)[source]#

(Source code)

../_images/projections-8.png

Mollweide#

class cartopy.crs.Mollweide(central_longitude=0, globe=None, false_easting=None, false_northing=None)[source]#

A Mollweide projection.

This projection is pseudocylindrical, and equal area. Parallels are unequally-spaced straight lines, while meridians are elliptical arcs up to semicircles on the edges. Poles are points.

It is commonly used for world maps, or interrupted with several central meridians.

(Source code)

../_images/projections-9.png

Orthographic#

class cartopy.crs.Orthographic(central_longitude=0.0, central_latitude=0.0, globe=None)[source]#

(Source code)

../_images/projections-10.png

Robinson#

class cartopy.crs.Robinson(central_longitude=0, globe=None, false_easting=None, false_northing=None)[source]#

A Robinson projection.

This projection is pseudocylindrical, and a compromise that is neither equal-area nor conformal. Parallels are unequally-spaced straight lines, and meridians are curved lines of no particular form.

It is commonly used for “visually-appealing” world maps.

(Source code)

../_images/projections-11.png

Sinusoidal#

class cartopy.crs.Sinusoidal(central_longitude=0.0, false_easting=0.0, false_northing=0.0, globe=None)[source]#

A Sinusoidal projection.

This projection is equal-area.

(Source code)

../_images/projections-12.png

Stereographic#

class cartopy.crs.Stereographic(central_latitude=0.0, central_longitude=0.0, false_easting=0.0, false_northing=0.0, true_scale_latitude=None, scale_factor=None, globe=None)[source]#

(Source code)

../_images/projections-13.png

TransverseMercator#

class cartopy.crs.TransverseMercator(central_longitude=0.0, central_latitude=0.0, false_easting=0.0, false_northing=0.0, scale_factor=1.0, globe=None, approx=False)[source]#

A Transverse Mercator projection.

(Source code)

../_images/projections-14.png

UTM#

class cartopy.crs.UTM(zone, southern_hemisphere=False, globe=None)[source]#

Universal Transverse Mercator projection.

(Source code)

../_images/projections-15.png

InterruptedGoodeHomolosine#

class cartopy.crs.InterruptedGoodeHomolosine(central_longitude=0, globe=None, emphasis='land')[source]#

Composite equal-area projection empahsizing either land or ocean features.

Original Reference:

Goode, J. P., 1925: The Homolosine Projection: A new device for portraying the Earth’s surface entire. Annals of the Association of American Geographers, 15:3, 119-125, DOI: 10.1080/00045602509356949

A central_longitude value of -160 is recommended for the oceanic view.

(Source code)

../_images/projections-16.png

RotatedPole#

class cartopy.crs.RotatedPole(pole_longitude=0.0, pole_latitude=90.0, central_rotated_longitude=0.0, globe=None)[source]#

A rotated latitude/longitude projected coordinate system with cylindrical topology and projected distance.

Coordinates are measured in projection metres.

The class uses proj to perform an ob_tran operation, using the pole_longitude to set a lon_0 then performing two rotations based on pole_latitude and central_rotated_longitude. This is equivalent to setting the new pole to a location defined by the pole_latitude and pole_longitude values in the GeogCRS defined by globe, then rotating this new CRS about it’s pole using the central_rotated_longitude value.

(Source code)

../_images/projections-17.png

OSGB#

class cartopy.crs.OSGB(approx=False)[source]#

(Source code)

../_images/projections-18.png

EuroPP#

class cartopy.crs.EuroPP[source]#

UTM Zone 32 projection for EuroPP domain.

Ellipsoid is International 1924, Datum is ED50.

(Source code)

../_images/projections-19.png

Geostationary#

class cartopy.crs.Geostationary(central_longitude=0.0, satellite_height=35785831, false_easting=0, false_northing=0, globe=None, sweep_axis='y')[source]#

A view appropriate for satellites in Geostationary Earth orbit.

Perspective view looking directly down from above a point on the equator.

In this projection, the projected coordinates are scanning angles measured from the satellite looking directly downward, multiplied by the height of the satellite.

(Source code)

../_images/projections-20.png

NearsidePerspective#

class cartopy.crs.NearsidePerspective(central_longitude=0.0, central_latitude=0.0, satellite_height=35785831, false_easting=0, false_northing=0, globe=None)[source]#

Perspective view looking directly down from above a point on the globe.

In this projection, the projected coordinates are x and y measured from the origin of a plane tangent to the Earth directly below the perspective point (e.g. a satellite).

(Source code)

../_images/projections-21.png

EckertI#

class cartopy.crs.EckertI(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert I projection.

This projection is pseudocylindrical, but not equal-area. Both meridians and parallels are straight lines. Its equal-area pair is EckertII.

(Source code)

../_images/projections-22.png

EckertII#

class cartopy.crs.EckertII(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert II projection.

This projection is pseudocylindrical, and equal-area. Both meridians and parallels are straight lines. Its non-equal-area pair with equally-spaced parallels is EckertI.

(Source code)

../_images/projections-23.png

EckertIII#

class cartopy.crs.EckertIII(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert III projection.

This projection is pseudocylindrical, but not equal-area. Parallels are equally-spaced straight lines, while meridians are elliptical arcs up to semicircles on the edges. Its equal-area pair is EckertIV.

(Source code)

../_images/projections-24.png

EckertIV#

class cartopy.crs.EckertIV(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert IV projection.

This projection is pseudocylindrical, and equal-area. Parallels are unequally-spaced straight lines, while meridians are elliptical arcs up to semicircles on the edges. Its non-equal-area pair with equally-spaced parallels is EckertIII.

It is commonly used for world maps.

(Source code)

../_images/projections-25.png

EckertV#

class cartopy.crs.EckertV(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert V projection.

This projection is pseudocylindrical, but not equal-area. Parallels are equally-spaced straight lines, while meridians are sinusoidal arcs. Its equal-area pair is EckertVI.

(Source code)

../_images/projections-26.png

EckertVI#

class cartopy.crs.EckertVI(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Eckert VI projection.

This projection is pseudocylindrical, and equal-area. Parallels are unequally-spaced straight lines, while meridians are sinusoidal arcs. Its non-equal-area pair with equally-spaced parallels is EckertV.

It is commonly used for world maps.

(Source code)

../_images/projections-27.png

EqualEarth#

class cartopy.crs.EqualEarth(central_longitude=0, false_easting=None, false_northing=None, globe=None)[source]#

An Equal Earth projection.

This projection is pseudocylindrical, and equal area. Parallels are unequally-spaced straight lines, while meridians are equally-spaced arcs.

It is intended for world maps.

Note

To use this projection, you must be using Proj 5.2.0 or newer.

References

Bojan Šavrič, Tom Patterson & Bernhard Jenny (2018) The Equal Earth map projection, International Journal of Geographical Information Science, DOI: 10.1080/13658816.2018.1504949

(Source code)

../_images/projections-28.png

Gnomonic#

class cartopy.crs.Gnomonic(central_latitude=0.0, central_longitude=0.0, globe=None)[source]#

(Source code)

../_images/projections-29.png

LambertAzimuthalEqualArea#

class cartopy.crs.LambertAzimuthalEqualArea(central_longitude=0.0, central_latitude=0.0, false_easting=0.0, false_northing=0.0, globe=None)[source]#

A Lambert Azimuthal Equal-Area projection.

(Source code)

../_images/projections-30.png

NorthPolarStereo#

class cartopy.crs.NorthPolarStereo(central_longitude=0.0, true_scale_latitude=None, globe=None)[source]#

(Source code)

../_images/projections-31.png

OSNI#

class cartopy.crs.OSNI(approx=False)[source]#

(Source code)

../_images/projections-32.png

SouthPolarStereo#

class cartopy.crs.SouthPolarStereo(central_longitude=0.0, true_scale_latitude=None, globe=None)[source]#

(Source code)

../_images/projections-33.png