Proj¶
- Proj(name, backend=None, lon0=None, lon_0=None, lat0=None, lat_0=None, lonlim=None, latlim=None, **kwargs)[source]¶
Return a
cartopy.crs.Projection
orBasemap
instance.- Parameters
name (
str
,cartopy.crs.Projection
, orBasemap
) – The projection name or projection class instance. If the latter, it is simply returned. If the former, it must correspond to one of the PROJ projection name shorthands, like in basemap.The following table lists the valid projection name shorthands, their full names (with links to the relevant PROJ documentation), and whether they are available in the cartopy and basemap packages. (added) indicates a projection class that proplot has “added” to cartopy using the cartopy API.
Key
Name
Cartopy
Basemap
'aea'
✓
✓
'aeqd'
✓
✓
'aitoff'
✓ (added)
✗
'cass'
✗
✓
'cea'
✗
✓
'cyl'
✓
✓
'eck1'
✓
✗
'eck2'
✓
✗
'eck3'
✓
✗
'eck4'
✓
✓
'eck5'
✓
✗
'eck6'
✓
✗
'eqdc'
✓
✓
'eqc'
✓
✓
'eqearth'
✓
✗
'europp'
Euro PP (Europe)
✓
✗
'gall'
✗
✓
'geos'
✓
✓
'gnom'
✓
✓
'hammer'
✓ (added)
✓
'igh'
✓
✗
'kav7'
✓ (added)
✓
'laea'
✓
✓
'lcc'
✓
✓
'lcyl'
Lambert Cylindrical
✓
✗
'mbtfpq'
✗
✓
'merc'
✓
✓
'mill'
✓
✓
'moll'
✓
✓
'npaeqd'
North-Polar Azimuthal Equidistant
✓ (added)
✓
'npgnom'
North-Polar Gnomonic
✓ (added)
✗
'nplaea'
North-Polar Lambert Azimuthal
✓ (added)
✓
'npstere'
North-Polar Stereographic
✓
✓
'nsper'
✓
✓
'osni'
OSNI (Ireland)
✓
✗
'osgb'
OSGB (UK)
✓
✗
'omerc'
✗
✓
'ortho'
✓
✓
'pcarree'
✓
✓
'poly'
✗
✓
'rotpole'
Rotated Pole
✓
✓
'sinu'
✓
✓
'spaeqd'
South-Polar Azimuthal Equidistant
✓ (added)
✓
'spgnom'
South-Polar Gnomonic
✓ (added)
✗
'splaea'
South-Polar Lambert Azimuthal
✓ (added)
✓
'spstere'
South-Polar Stereographic
✓
✓
'stere'
✓
✓
'tmerc'
✓
✓
'utm'
✓
✗
'vandg'
✗
✓
'wintri'
✓ (added)
✗
backend (
{'cartopy', 'basemap'}
, default:rc['geo.backend']
='cartopy'
) – Whether to return a cartopyProjection
instance or a basemapBasemap
instance.lon0, lat0 (
float
, optional) – The central projection longitude and latitude. These are translated tocentral_longitude
,central_latitude
for cartopy projections.lon_0, lat_0 (
float
, optional) – Aliases forlon0
,lat0
.lonlim (
2-tuple
offloat
, optional) – The longitude limits. Translated tomin_longitude
andmax_longitude
for cartopy projections andllcrnrlon
andurcrnrlon
for basemap projections.latlim (
2-tuple
offloat
, optional) – The latitude limits. Translated tomin_latitude
andmax_latitude
for cartopy projections andllcrnrlon
andurcrnrlon
for basemap projections.
- Other Parameters
**kwargs – Passed to the cartopy
Projection
or basemapBasemap
class.- Returns
proj (
mpl_toolkits.basemap.Basemap
orcartopy.crs.Projection
) – A cartopy or basemap projection instance.
See also
mpl_toolkits.basemap.Basemap
,cartopy.crs.Projection
,proplot.ui.subplots
,proplot.axes.GeoAxes
References
For more information on map projections, see the wikipedia page and the PROJ documentation.