Zurück nach oben

`mpl_toolkits.basemap`¶

class mpl_toolkits.basemap.Basemap(llcrnrlon=None, llcrnrlat=None, urcrnrlon=None, urcrnrlat=None, llcrnrx=None, llcrnry=None, urcrnrx=None, urcrnry=None, width=None, height=None, projection='cyl', resolution='c', area_thresh=None, rsphere=6370997.0, ellps=None, lat_ts=None, lat_1=None, lat_2=None, lat_0=None, lon_0=None, lon_1=None, lon_2=None, o_lon_p=None, o_lat_p=None, k_0=None, no_rot=False, suppress_ticks=True, satellite_height=35786000, boundinglat=None, fix_aspect=True, anchor='C', celestial=False, round=False, epsg=None, ax=None)[Quelle]¶

__init__(llcrnrlon=None, llcrnrlat=None, urcrnrlon=None, urcrnrlat=None, llcrnrx=None, llcrnry=None, urcrnrx=None, urcrnry=None, width=None, height=None, projection='cyl', resolution='c', area_thresh=None, rsphere=6370997.0, ellps=None, lat_ts=None, lat_1=None, lat_2=None, lat_0=None, lon_0=None, lon_1=None, lon_2=None, o_lon_p=None, o_lat_p=None, k_0=None, no_rot=False, suppress_ticks=True, satellite_height=35786000, boundinglat=None, fix_aspect=True, anchor='C', celestial=False, round=False, epsg=None, ax=None)[Quelle]¶

Richtet eine Basiskarte mit der angegebenen Kartenprojektion ein. und erstellt die Küstenlinien-Datenstrukturen in Kartenprojektionskoordinaten.

Wenn eine Instanz der Basemap-Klasse mit den Argumenten lon, lat aufgerufen wird, werden lon/lat (in Grad) in x/y-Kartenprojektionskoordinaten (in Metern) umgewandelt. Die umgekehrte Transformation wird durchgeführt, wenn das optionale Schlüsselwort inverse auf True gesetzt ist.

Die gewünschte Projektion wird mit dem Schlüsselwort projection eingestellt. Standard ist cyl. Unterstützte Werte für das Schlüsselwort projection sind

Wert	Beschreibung
cyl	Zylindrische äquidistante Projektion
merc	Mercator-Projektion
tmerc	Transversale Mercator-Projektion
omerc	Schräge Mercator-Projektion
mill	Miller-Zylinderprojektion
gall	Gall-Stereografische Zylinderprojektion
cea	Zylindrische flächentreue Projektion
lcc	Lambert-konforme Kegelprojektion
laea	Lambert-azimutale flächentreue Projektion
nplaea	Lambert-azimutale Nordpolprojektion
splaea	Lambert-azimutale Südpolprojektion
eqdc	Äquidistante Kegelprojektion
aeqd	Azimutale äquidistante Projektion
npaeqd	Azimutale äquidistante Nordpolprojektion
spaeqd	Azimutale äquidistante Südpolprojektion
aea	Albers-Flächentreue Projektion
stere	Stereografische Projektion
npstere	Stereografische Nordpolprojektion
spstere	Stereografische Südpolprojektion
cass	Cassini-Soldner-Projektion
poly	Polykonische Projektion
ortho	Orthographische Projektion
geos	Geostationäre Projektion
nsper	Perspektivische Ansicht von nahem Standpunkt
sinu	Sinusoidale Projektion
moll	Mollweide-Projektion
hammer	Hammer-Projektion
robin	Robinson-Projektion
kav7	Kavrayskiy VII
eck4	Eckert IV
vandg	van der Grinten
mbtfpq	McBryde-Thomas Flat-Polar Quartic
gnom	Gnomonische Projektion
rotpole	Rotierte Pole

Für die meisten Kartenprojektionen kann der Kartenprojektionsbereich entweder durch Festlegen dieser Schlüsselwörter angegeben werden

Schlüsselwort	Beschreibung
llcrnrlon	Längengrad der unteren linken Ecke des gewünschten Kartenbereichs (Grad).
llcrnrlat	Breitengrad der unteren linken Ecke des gewünschten Kartenbereichs (Grad).
urcrnrlon	Längengrad der oberen rechten Ecke des gewünschten Kartenbereichs (Grad).
urcrnrlat	Breitengrad der oberen rechten Ecke des gewünschten Kartenbereichs (Grad).

oder diese

Schlüsselwort	Beschreibung
width	Breite des gewünschten Kartenbereichs in Projektionskoordinaten (Meter).
Höhe	Höhe des gewünschten Kartenbereichs in Projektionskoordinaten (Meter).
lon_0	Mittelpunkt des gewünschten Kartenbereichs (in Grad).
lat_0	Mittelpunkt des gewünschten Kartenbereichs (in Grad).

Für sinu, moll, hammer, npstere, spstere, nplaea, splaea, npaeqd, spaeqd, robin, eck4, kav7 oder mbtfpq werden die Werte von llcrnrlon, llcrnrlat, urcrnrlon, urcrnrlat, width und height ignoriert (da sie entweder intern berechnet werden oder die gesamte Kugel gezeichnet wird).

Für die zylindrischen Projektionen (cyl, merc, mill, cea und gall) wird standardmäßig llcrnrlon=-180,llcrnrlat=-90, urcrnrlon=180 und urcrnrlat=90 verwendet. Für alle anderen Projektionen außer ortho, geos und nsper müssen entweder die Längen-/Breitenwerte der Ecken oder die Breite und Höhe vom Benutzer angegeben werden.

Für ortho, geos und nsper können die Längen-/Breitenwerte der Ecken oder die x/y-Werte der Ecken (llcrnrx,llcrnry,urcrnrx,urcrnry) im Koordinatensystem der globalen Projektion angegeben werden (mit x=0,y=0 in der Mitte der globalen Projektion). Wenn die Ecken nicht angegeben werden, wird die gesamte Kugel gezeichnet.

Für rotpole können die Längen-/Breitenwerte der Ecken auf der ungedrehten Kugel als llcrnrlon,llcrnrlat,urcrnrlon,urcrnrlat oder die Längen-/Breitenwerte der Ecken auf der gedrehten Kugel als llcrnrx,llcrnry,urcrnrx,urcrnry angegeben werden.

Andere Schlüsselwortargumente

Schlüsselwort	Beschreibung
resolution	Auflösung der zu verwendenden Datenbank für Grenzen. Kann sein `c` (grob), `l` (niedrig), `i` (mittel), `h` (hoch), `f` (vollständig) oder None. Wenn None, werden keine Grenzdaten gelesen (und Klassenmethoden wie drawcoastlines lösen eine Ausnahme aus, wenn sie aufgerufen werden). Die Auflösung nimmt zwischen den Datensätzen um etwa 80 % ab. Höher aufgelöste Datensätze sind langsamer zu zeichnen. Standard `c`. Küstenlinien-Daten stammen von GSHHS (http://www.soest.hawaii.edu/wessel/gshhs/gshhs.html). Staats-, Länder- und Flussdatensätze von den Generic Mapping Tools (http://gmt.soest.hawaii.edu).
area_thresh	Küstenlinien oder Seen mit einer Fläche kleiner als area_thresh in km^2 werden nicht gezeichnet. Standard 10000,1000,100,10,1 für Auflösung `c`, `l`, `i`, `h`, `f`.
rsphere	Radius der für die Kartenprojektion verwendeten Kugel (Standard 6370997 Meter, nahe dem arithmetischen Mittelradius der Erde). Wenn als Sequenz angegeben, werden die ersten beiden Elemente als Radien der großen und kleinen Achsen eines Ellipsoids interpretiert. Hinweis: Manchmal wird ein Ellipsoid durch die große Achse und einen inversen Abflachungsparameter (if) spezifiziert. Die kleine Achse (b) kann aus der großen Achse (a) und dem inversen Abflachungsparameter mit der Formel if = a/(a-b) berechnet werden.
ellps	Zeichenkette, die den Ellipsoid beschreibt („GRS80“ oder „WGS84“, zum Beispiel). Wenn sowohl rsphere als auch ellps angegeben sind, wird rsphere ignoriert. Standard None. Siehe pyproj.pj_ellps für erlaubte Werte.
suppress_ticks	unterdrückt das automatische Zeichnen von Achsen-Ticks und Beschriftungen in Kartenprojektionskoordinaten. Standard True, sodass Parallelen und Meridiane stattdessen beschriftet werden können. Wenn eine Beschriftung von Parallelen oder Meridianen angefordert wird (mit den Methoden drawparallels und drawmeridians), wird die automatische Tick-Beschriftung auch dann unterdrückt, wenn suppress_ticks=False ist. suppress_ticks=False ist nützlich, wenn Sie Ihren eigenen benutzerdefinierten Tick-Formatierer verwenden möchten oder wenn Sie möchten, dass Matplotlib die Achsen in Metern unter Verwendung von Kartenprojektionskoordinaten beschriftet.
fix_aspect	Fixiert das Seitenverhältnis des Plots so, dass es dem Seitenverhältnis des Kartenprojektionsbereichs entspricht (Standard True).
anchor	bestimmt, wie die Karte im Achsenrechteck platziert wird (weitergegeben an axes.set_aspect). Standard ist `C`, was bedeutet, dass die Karte zentriert ist. Erlaubte Werte sind `C`, `SW`, `S`, `SE`, `E`, `NE`, `N`, `NW` und `W`.
celestial	verwendet astronomische Konventionen für den Längengrad (d.h. negative Längengrade östlich von 0). Standard False. Impliziert resolution=None.
ax	legt die Standard-Achseninstanz fest (Standard None - matplotlib.pyplot.gca() kann verwendet werden, um die aktuelle Achseninstanz abzurufen). Wenn Sie matplotlib.pyplot nicht importieren möchten, können Sie entweder diese auf eine vordefinierte Achseninstanz setzen oder das Schlüsselwort `ax` in jedem Basemap-Methodenaufruf verwenden, der zeichnet. Im ersten Fall werden alle Basemap-Methodenaufrufe auf dieselbe Achseninstanz zeichnen. Im zweiten Fall können Sie mit demselben Basemap-Instanz auf verschiedene Achsen zeichnen. Sie können auch das Schlüsselwort `ax` in einzelnen Methodenaufrufen verwenden, um die Standard-Achseninstanz selektiv zu überschreiben.

Die folgenden Schlüsselwörter sind Kartenprojektionsparameter, die alle standardmäßig None sind. Nicht alle Parameter werden von allen Projektionen verwendet, einige werden ignoriert. Die Modulvariable projection_params ist ein Wörterbuch, das auflistet, welche Parameter für welche Projektionen gelten.

Schlüsselwort	Beschreibung
lat_ts	Breitengrad der wahren Skalierung. Optional für stereografische, zylindrische flächentreue und Mercator-Projektionen. Standard ist lat_0 für stereografische Projektion. Standard ist 0 für Mercator- und zylindrische flächentreue Projektionen.
lat_1	erster Standardparallele für Lambert-konforme, Albers-flächentreue und äquidistante Kegelprojektionen. Breitengrad eines der beiden Punkte auf der Projektionsmittellinie für schräge Mercator-Projektionen. Wenn lat_1 nicht gegeben ist, aber lat_0, wird lat_1 auf lat_0 für Lambert-konforme, Albers-flächentreue und äquidistante Kegelprojektionen gesetzt.
lat_2	zweite Standardparallele für Lambert-konforme, Albers-flächentreue und äquidistante Kegelprojektionen. Breitengrad eines der beiden Punkte auf der Projektionsmittellinie für schräge Mercator-Projektionen. Wenn lat_2 nicht gegeben ist, wird sie für Lambert-konforme, Albers-flächentreue und äquidistante Kegelprojektionen auf lat_1 gesetzt.
lon_1	Längengrad eines der beiden Punkte auf der Projektionsmittellinie für schräge Mercator-Projektionen.
lon_2	Längengrad eines der beiden Punkte auf der Projektionsmittellinie für schräge Mercator-Projektionen.
k_0	Skalierungsfaktor am natürlichen Ursprung (verwendet für „tmerc“, „omerc“, „stere“ und „lcc“).
no_rot	nur verwendet für schräge Mercator-Projektionen. Wenn auf True gesetzt, werden die Kartenprojektionskoordinaten nicht nach Norden ausgerichtet. Standard ist False (Projektionskoordinaten werden automatisch gedreht).
lat_0	zentraler Breitengrad (y-Achsenursprung) - wird für alle Projektionen verwendet.
lon_0	zentraler Längengrad (x-Achsenursprung) - wird für alle Projektionen verwendet.
o_lat_p	Breitengrad des gedrehten Pols (nur verwendet für „rotpole“)
o_lon_p	Längengrad des gedrehten Pols (nur verwendet für „rotpole“)
boundinglat	Begrenzungsbreitengrad für Pol-zentrierte Projektionen (npstere,spstere,nplaea,splaea,npaeqd,spaeqd). Diese Projektionen sind quadratische Regionen, die auf dem Nord- oder Südpol zentriert sind. Der Längengrad lon_0 liegt bei 6 Uhr, und der Breitengradkreis boundinglat berührt den Rand der Karte bei lon_0.
round	schneidet die Pol-zentrierte Projektion bei boundinglat ab (sodass das Diagramm ein Kreis und kein Quadrat ist). Nur relevant für npstere,spstere,nplaea,splaea,npaeqd oder spaeqd Projektionen. Standard False.
satellite_height	Höhe des Satelliten (in m) über dem Äquator - nur relevant für geostationäre und perspektivische Projektionen von nahem Standpunkt (`geos` oder `nsper`). Standard 35.786 km.

Nützliche Instanzvariablen

Variablenname	Beschreibung
projection	Kartenprojektion. Geben Sie die Modulvariable `supported_projections` aus, um eine Liste der erlaubten Werte anzuzeigen.
epsg	EPSG-Code, der die Projektion definiert (siehe http://spatialreference.org für eine Liste von EPSG-Codes und deren Definitionen).
aspect	Karten-Seitenverhältnis (Größe der y-Dimension / Größe der x-Dimension).
llcrnrlon	Längengrad der unteren linken Ecke des ausgewählten Kartenbereichs.
llcrnrlat	Breitengrad der unteren linken Ecke des ausgewählten Kartenbereichs.
urcrnrlon	Längengrad der oberen rechten Ecke des ausgewählten Kartenbereichs.
urcrnrlat	Breitengrad der oberen rechten Ecke des ausgewählten Kartenbereichs.
llcrnrx	x-Wert der unteren linken Ecke des ausgewählten Kartenbereichs in Kartenprojektionskoordinaten.
llcrnry	y-Wert der unteren linken Ecke des ausgewählten Kartenbereichs in Kartenprojektionskoordinaten.
urcrnrx	x-Wert der oberen rechten Ecke des ausgewählten Kartenbereichs in Kartenprojektionskoordinaten.
urcrnry	y-Wert der oberen rechten Ecke des ausgewählten Kartenbereichs in Kartenprojektionskoordinaten.
rmajor	äquatorialer Radius des verwendeten Ellipsoids (in Metern).
rminor	polarer Radius des verwendeten Ellipsoids (in Metern).
resolution	Auflösung des verwendeten Grensdatensatzes (`c` für grob, `l` für niedrig usw.). Wenn None, ist kein Grensdatensatz mit der Basemap-Instanz verknüpft.
proj4string	die Zeichenkette, die die von PROJ.4 verwendete Kartenprojektion beschreibt.

Konvertierung von geografischen (lon/lat) zu Kartenprojektions- (x/y) Koordinaten

Wenn eine Instanz der Basemap-Klasse mit den Argumenten lon, lat aufgerufen wird, werden lon/lat (in Grad) in x/y-Kartenprojektionskoordinaten (in Metern) umgewandelt. Wenn das optionale Schlüsselwort inverse True ist (Standard ist False), wird die umgekehrte Transformation von x/y zu lon/lat durchgeführt.

Für die zylindrische äquidistante Projektion (cyl) hat dies keine Auswirkung (d.h. x,y == lon,lat).

Für nicht-zylindrische Projektionen gibt die umgekehrte Transformation immer Längengrade zwischen -180 und 180 Grad zurück. Für zylindrische Projektionen (self.projection == cyl, mill, cea, gall oder merc) gibt die umgekehrte Transformation Längengrade zwischen self.llcrnrlon und self.llcrnrlat zurück.

Die Eingabeargumente lon, lat können entweder skalare Gleitkommazahlen, Sequenzen oder NumPy-Arrays sein.

Beispielhafte Verwendung

>>> from mpl_toolkits.basemap import Basemap
>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> # read in topo data (on a regular lat/lon grid)
>>> etopo = np.loadtxt('etopo20data.gz')
>>> lons  = np.loadtxt('etopo20lons.gz')
>>> lats  = np.loadtxt('etopo20lats.gz')
>>> # create Basemap instance for Robinson projection.
>>> m = Basemap(projection='robin',lon_0=0.5*(lons[0]+lons[-1]))
>>> # compute map projection coordinates for lat/lon grid.
>>> x, y = m(*np.meshgrid(lons,lats))
>>> # make filled contour plot.
>>> cs = m.contourf(x,y,etopo,30,cmap=plt.cm.jet)
>>> m.drawcoastlines() # draw coastlines
>>> m.drawmapboundary() # draw a line around the map region
>>> m.drawparallels(np.arange(-90.,120.,30.),labels=[1,0,0,0]) # draw parallels
>>> m.drawmeridians(np.arange(0.,420.,60.),labels=[0,0,0,1]) # draw meridians
>>> plt.title('Robinson Projection') # add a title
>>> plt.show()

[Dieses Beispiel (simpletest.py) sowie viele andere finden Sie im Verzeichnis examples der Quellcode-Distribution. Die „OO“-Version dieses Beispiels (die matplotlib.pyplot nicht verwendet) heißt „simpletest_oo.py“.]

arcgisimage(server='http://server.arcgisonline.com/ArcGIS', service='World_Imagery', xpixels=400, ypixels=None, dpi=96, cachedir=None, verbose=False, **kwargs)[Quelle]¶

Hintergrundbild mit der ArcGIS Server REST API anzeigen.

Um diese Methode zu verwenden, muss die Instanz Basemap mit dem Schlüsselwort epsg zur Definition der Kartenprojektion erstellt werden, es sei denn, die „cyl“-Projektion wird verwendet (in diesem Fall wird der EPSG-Code 4326 angenommen).

Parameter:

server (str, optional) – Basis-URL des Web-Karten-Servers
service (str, optional) – vom Server gehosteter Dienst (Bildtyp)
xpixels (int, optional) – angeforderte Anzahl von Bildpixeln in der x-Richtung
ypixels (int, optional) – angeforderte Anzahl von Bildpixeln in der y-Richtung; wenn nicht angegeben, wird sie aus xpixels und dem Seitenverhältnis des Kartenprojektionsbereichs abgeleitet
dpi (int, optional) – Geräteauflösung des exportierten Bildes
cachedir (str, optional) – wenn angegeben, Verzeichnis, das als Cache-Ordner für vom Server abgerufene Bilder verwendet werden soll
verbose (bool, optional) – wenn True, Debugging-Informationen ausgeben
**kwargs (dict, optional) – nur Schlüsselwortargumente; derzeit wird nur ax unterstützt, um die Standard-Instanz von matplotlib.axes.Axes zu überschreiben

Gibt zurück:

aximg (matplotlib.image.AxesImage) – Bildachsen-Instanz

barbs(x, y, u, v, *args, **kwargs)[source]¶

Erstellt ein Windbarben-Diagramm (u, v) auf der Karte. (siehe Dokumentation von matplotlib.pyplot.barbs).

Wenn das Schlüsselwort latlon auf True gesetzt ist, werden x,y als Längen- und Breitengrad in Grad interpretiert. Daten und Längengrade werden automatisch verschoben, um die Kartenprojektionsregion für zylindrische und pseudozylindrische Projektionen anzupassen, und x,y werden in Kartenprojektionskoordinaten umgewandelt. Wenn latlon False (Standard) ist, werden x und y als Kartenprojektionskoordinaten angenommen.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere *args und **kwargs werden an matplotlib.pyplot.barbs weitergegeben

Gibt zwei matplotlib.axes.Barbs-Instanzen zurück, eine für die Nordhalbkugel und eine für die Südhalbkugel.

bluemarble(ax=None, scale=None, **kwargs)[source]¶

Zeigt das Blue Marble-Bild als Kartenhintergrund an.

Das Originalbild ist verfügbar unter

https://visibleearth.nasa.gov/

Die Standardbildgröße ist 5400x2700, was speicherintensiv sein kann. Das Schlüsselwort scale ermöglicht das Herunterskalieren des Bildes (z.B. scale=0.5 skaliert auf 2700x1350).

Parameter:

ax (matplotlib.image.AxesImage, optional) – wenn angegeben, alternative Achsen-Instanz, auf der das Bild gezeichnet wird
scale (float, optional) – wenn angegeben, skaliert das Bild um den gegebenen Faktor
**kwargs (dict, optional) – Schlüsselwortargumente, die an Basemap.imshow() weitergegeben werden.

Gibt zurück:

ax (matplotlib.image.AxesImage) – Achsen-Instanz

colorbar(mappable=None, location='right', size='5%', pad='2%', fig=None, ax=None, **kwargs)[source]¶

Fügt eine Farbleiste zu den Achsen hinzu, die mit einer Karte verbunden sind. Die Farbleisten-Achsen-Instanz wird unter Verwendung des axes_grid-Toolkits erstellt.

Schlüsselwörter	Beschreibung
mappable	das Bild, die Konturmenge usw., auf die sich die Farbleiste bezieht. Standard None, matplotlib.pyplot.gci() wird verwendet, um die aktuelle Bildabbildung abzurufen.
location	wo die Farbleiste platziert werden soll ('top','bottom','left','right') Standard 'right'.
size	Breite der Farbleisten-Achsen (String 'N%', wobei N eine ganze Zahl ist, die die relative Breite der übergeordneten Achsen beschreibt). Standard '5%'.
pad	Abstand zwischen übergeordneten Achsen und Farbleisten-Achsen in den gleichen Einheiten wie size. Standard '2%'.
fig	Figuren-Instanz, mit der die Kartenachsen-Instanz verknüpft ist. Standard None, und matplotlib.pyplot.gcf() wird verwendet, um die aktuelle aktive Figuren-Instanz abzurufen.
ax	Die Achsen-Instanz, mit der die Farbleiste verknüpft wird. Standard None, sucht nach self.ax, und wenn None ist, wird matplotlib.pyplot.gca() verwendet.
**kwargs	zusätzliche Schlüsselwortargumente, die an die Farbleistenmethode der Figuren-Instanz weitergegeben werden.

Gibt eine matplotlib Farbleisten-Instanz zurück.

contour(x, y, data, *args, **kwargs)[source]¶

Erstellt ein Konturdiagramm auf der Karte (siehe Dokumentation von matplotlib.pyplot.contour).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Wenn tri auf True gesetzt ist, wird ein unstrukturiertes Gitter angenommen (x,y,data müssen 1-dimensional sein) und matplotlib.pyplot.tricontour wird verwendet.

Andere *args und **kwargs werden an matplotlib.pyplot.contour (oder tricontour, wenn tri=True) weitergegeben.

contourf(x, y, data, *args, **kwargs)[source]¶

Erstellt ein gefülltes Konturdiagramm auf der Karte (siehe Dokumentation von matplotlib.pyplot.contourf).

Wenn x oder y außerhalb des Projektionsrands liegen (d.h. sie Werte > 1.e20 haben), werden die entsprechenden Datenelemente maskiert.

Das zusätzliche Schlüsselwort 'ax' kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Wenn tri auf True gesetzt ist, wird ein unstrukturiertes Gitter angenommen (x,y,data müssen 1-dimensional sein) und matplotlib.pyplot.tricontourf wird verwendet.

Andere *args und **kwargs werden an matplotlib.pyplot.contourf (oder tricontourf, wenn tri=True) weitergegeben.

drawcoastlines(linewidth=1.0, linestyle='solid', color='k', antialiased=1, ax=None, zorder=None)[source]¶

Zeichnet Küstenlinien.

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Breite der Küstenlinie (Standard 1.)
Linienstil (linestyle)	Linienstil der Küstenlinie (Standard solid)
color	Farbe der Küstenlinie (Standard schwarz)
antialiased	Schalter für Kantenglättung für Küstenlinien (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
zorder	legt die zorder für die Küstenlinien fest (wenn nicht angegeben, wird die Standard-zorder für matplotlib.patches.LineCollections verwendet).

Gibt ein matplotlib.patches.LineCollection-Objekt zurück.

drawcounties(linewidth=0.1, linestyle='solid', color='k', antialiased=1, facecolor='none', ax=None, zorder=None, drawbounds=False)[source]¶

Zeichnet Landkreisgrenzen in den USA. Die Shapefile-Daten für Landkreisgrenzen stammen vom NOAA Coastal Geospatial Data Project (http://coastalgeospatial.noaa.gov/data_gis.html).

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Breite der Landkreisgrenzen (Standard 0.1)
Linienstil (linestyle)	Linienstil der Küstenlinie (Standard solid)
color	Farbe der Landkreisgrenzen (Standard schwarz)
Füllfarbe (facecolor)	Füllfarbe des Landkreises (Standard ist keine Füllung)
antialiased	Schalter für Kantenglättung für Landkreisgrenzen (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
zorder	legt die zorder für die Landkreisgrenzen fest (wenn nicht angegeben, wird die Standard-zorder für matplotlib.patches.LineCollections verwendet).

Gibt ein matplotlib.patches.LineCollection-Objekt zurück.

drawcountries(linewidth=0.5, linestyle='solid', color='k', antialiased=1, ax=None, zorder=None)[source]¶

Zeichnet Ländergrenzen.

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Breite der Ländergrenzen (Standard 0.5)
Linienstil (linestyle)	Linienstil der Küstenlinie (Standard solid)
color	Farbe der Ländergrenzen (Standard schwarz)
antialiased	Schalter für Kantenglättung für Ländergrenzen (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
zorder	legt die zorder für die Ländergrenzen fest (wenn nicht angegeben, wird die Standard-zorder für matplotlib.patches.LineCollections verwendet).

Gibt ein matplotlib.patches.LineCollection-Objekt zurück.

drawgreatcircle(lon1, lat1, lon2, lat2, del_s=100.0, **kwargs)[source]¶

Zeichnet einen Großkreis auf der Karte vom Längen-Breitengrad-Paar lon1,lat1 nach lon2,lat2

Schlüsselwort	Beschreibung
del_s	Punkte auf dem Großkreis, die alle del_s Kilometer berechnet werden (Standard 100).
**kwargs	andere Schlüsselwortargumente werden an die `plot()`-Methode der Basemap-Instanz weitergegeben.

Gibt eine Liste mit einem einzelnen matplotlib.lines.Line2D-Objekt zurück, ähnlich wie bei einem Aufruf von pyplot.plot().

drawlsmask(land_color='0.8', ocean_color='w', lsmask=None, lsmask_lons=None, lsmask_lats=None, lakes=True, resolution='l', grid=5, **kwargs)[source]¶

Zeichnet eine Land-Meer-Maskenbild.

Hinweis

Das Land-Meer-Maskenbild kann aufgrund von Einschränkungen in der matplotlib Bildhandhabung nicht über anderen Bildern überlagert werden (die zorder eines Bildes kann nicht angegeben werden).

Schlüsselwörter	Beschreibung
land_color	gewünschte Landfarbe (Farbname oder RGBA-Tupel). Standard Grau ("0.8").
ocean_color	gewünschte Wasserfarbe (Farbname oder RGBA-Tupel). Standard Weiß.
lsmask	Ein Array von 0 für Ozeanpixel, 1 für Landpixel und 2 für See-/Teichpixel. Standard ist None (Standard-Land-Meer-Maske mit 5-Minuten-Auflösung wird verwendet).
lakes	Zeichnet Seen und Teiche (Standard True)
lsmask_lons	1D-Array von Längengraden für lsmask (ignoriert, wenn lsmask None ist). Längengrade müssen von -180 W nach Osten geordnet sein.
lsmask_lats	1D-Array von Breitengraden für lsmask (ignoriert, wenn lsmask None ist). Breitengrade müssen von -90 S nach Norden geordnet sein.
resolution	GSHHS-Küstenlinien-Auflösung, die zur Definition der Land-/Meer-Maske verwendet wird (Standard 'l', verfügbar 'c','l','i','h' oder 'f')
grid	Rasterabstand der Land-/Meer-Maske in Minuten (Standard 5; 10, 2,5 und 1,25 sind ebenfalls verfügbar).
**kwargs	zusätzliche Schlüsselwortargumente, die an `imshow()` weitergegeben werden

Wenn eines der Schlüsselwörter lsmask, lsmask_lons oder lsmask_lats nicht gesetzt ist, werden die integrierten GSHHS-Land-Meer-Maskendatenbanken verwendet.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Gibt eine matplotlib.image.AxesImage-Instanz zurück.

drawmapboundary(color='k', linewidth=1.0, fill_color=None, zorder=None, ax=None)[source]¶

Zeichnet eine Grenze um den Kartenprojektionsbereich und füllt optional das Innere des Bereichs.

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Linienbreite für die Grenze (Standard 1.)
color	Farbe der Begrenzungslinie (Standard schwarz)
fill_color	füllt den Hintergrund des Kartenbereichs mit dieser Farbe (Standard ist das Füllen mit der Hintergrundfarbe der Achsen). Wenn auf den String 'none' gesetzt, wird keine Füllung vorgenommen.
zorder	legt die zorder für die Füllung des Kartenhintergrunds fest (Standard 0).
ax	Achsen-Instanz, die verwendet werden soll (Standard None, verwendet die Standard-Achsen-Instanz).

Gibt eine matplotlib.collections.PatchCollection zurück, die die Kartenbegrenzung darstellt.

drawmapscale(lon, lat, lon0, lat0, length, barstyle='simple', units='km', fontsize=9, yoffset=None, labelstyle='simple', fontcolor='k', fillcolor1='w', fillcolor2='k', ax=None, format='%d', zorder=None, linecolor=None, linewidth=None)[source]¶

Zeichnet eine Maßstabsleiste an lon,lat mit einer Länge von length, die die Entfernung in den Kartenprojektionskoordinaten bei lon0,lat0 darstellt.

Schlüsselwörter	Beschreibung
units	die Einheiten des Längenarguments (Standard km).
barstyle	`simple` oder `fancy` (ungefähr entsprechend den von Generic Mapping Tools bereitgestellten Stilen). Standard `simple`.
Schriftgröße	für Kartenmaßstabsanmerkungen, Standard 9.
fontcolor	für Kartenmaßstabsanmerkungen, Standard schwarz.
labelstyle	`simple` (Standard) oder `fancy`. Für `fancy` werden auch der Kartenmaßstabsfaktor (Verhältnis zwischen der tatsächlichen Entfernung und der Kartenprojektionsentfernung bei lon0,lat0) und der Wert von lon0,lat0 oberhalb der Maßstabsleiste angezeigt. Für `simple` werden nur die Einheiten oben und die Entfernung unterhalb der Maßstabsleiste angezeigt. Wenn gleich False, wird eine leere Beschriftung gezeichnet.
format	ein String-Formatierer zum Formatieren numerischer Werte
yoffset	yoffset steuert die Höhe der Maßstabsleiste und den Abstand der Anmerkungen von der Maßstabsleiste. Standard ist 0,02 mal die Höhe der Karte (0,02*(self.ymax-self.ymin)).
fillcolor1(2)	Farben der abwechselnden gefüllten Bereiche (Standard weiß und schwarz). Nur relevant für 'fancy' barstyle.
zorder	legt die zorder für den Kartenmaßstab fest.
linecolor	legt die Farbe des Maßstabs fest, standardmäßig wird fontcolor verwendet
Linienbreite (linewidth)	Linienbreite für Maßstab und Ticks

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

drawmeridians(meridians, color='k', textcolor='k', linewidth=1.0, zorder=None, dashes=[1, 1], labels=[0, 0, 0, 0], labelstyle=None, fmt='%g', xoffset=None, yoffset=None, ax=None, latmax=None, **text_kwargs)[source]¶

Zeichnet und beschriftet Meridiane (Längengradlinien) für Werte (in Grad), die in der Sequenz meridians angegeben sind.

Schlüsselwort	Beschreibung
color	Farbe zum Zeichnen von Meridianen (Standard schwarz).
textcolor	Farbe zum Zeichnen von Beschriftungen (Standard schwarz).
Linienbreite (linewidth)	Linienbreite für Meridiane (Standard 1.)
zorder	legt die zorder für Meridiane fest (wenn nicht angegeben, wird die Standard-zorder für matplotlib.lines.Line2D-Objekte verwendet).
dashes	Strichmuster für Meridiane (Standard [1,1], d.h. 1 Pixel an, 1 Pixel aus).
labels	Liste mit 4 Werten (Standard [0,0,0,0]), die steuern, ob Meridiane dort beschriftet werden, wo sie den linken, rechten, oberen oder unteren Rand des Diagramms schneiden. Zum Beispiel werden mit labels=[1,0,0,1] Meridiane dort beschriftet, wo sie den linken und unteren Rand des Diagramms schneiden, aber nicht den rechten und oberen.
labelstyle	wenn auf "+/-" gesetzt, werden östliche und westliche Längengrade mit "+" und "-" beschriftet, andernfalls mit "E" und "W".
fmt	ein Formatstring zum Formatieren der Meridianbeschriftungen (Standard '%g') oder eine Funktion, die einen Längengradwert in Grad als einziges Argument nimmt und einen formatierten String zurückgibt.
xoffset	Beschriftungsabstand vom Kartenrand in x-Richtung (Standard ist 0,01 mal die Kartenbreite in Kartenprojektionskoordinaten).
yoffset	Beschriftungsabstand vom Kartenrand in y-Richtung (Standard ist 0,01 mal die Kartenhöhe in Kartenprojektionskoordinaten).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
latmax	absoluter Wert der Breite, bis zu der Meridiane gezeichnet werden (Standard ist 80).
**text_kwargs	zusätzliche Schlüsselwortargumente zur Steuerung von Text für Beschriftungen, die an die Textmethode der Achsen-Instanz weitergegeben werden (siehe Dokumentation von matplotlib.pyplot.text).

Gibt ein Wörterbuch zurück, dessen Schlüssel die Meridianwerte sind und dessen Werte Tupel sind, die Listen der matplotlib.lines.Line2D- und matplotlib.text.Text-Instanzen enthalten, die jedem Meridian zugeordnet sind. Das Löschen eines Eintrags aus dem Wörterbuch entfernt den entsprechenden Meridian aus dem Diagramm.

drawparallels(kreise, farbe='k', textfarbe='k', linienbreite=1.0, zorder=None, striche=[1, 1], beschriftungen=[0, 0, 0, 0], beschriftungsstil=None, fmt='%g', xversatz=None, yversatz=None, ax=None, latmax=None, **text_kwargs)[Quelle]¶

Zeichnet und beschriftet Breitengrade (Breitenkreise) für die in der Sequenz kreise angegebenen Werte (in Grad).

Schlüsselwort	Beschreibung
color	Farbe zum Zeichnen der Breitengrade (Standard schwarz).
textcolor	Farbe zum Zeichnen von Beschriftungen (Standard schwarz).
Linienbreite (linewidth)	Linienbreite für Breitengrade (Standard 1.)
zorder	Legt die zorder-Reihenfolge für Breitengrade fest (falls nicht angegeben, wird die Standard-zorder-Reihenfolge für matplotlib.lines.Line2D-Objekte verwendet).
dashes	Strichmuster für Breitengrade (Standard [1,1], d.h. 1 Pixel an, 1 Pixel aus).
labels	Liste von 4 Werten (Standard [0,0,0,0]), die steuern, ob Breitengrade dort beschriftet werden, wo sie den linken, rechten, oberen oder unteren Rand des Plots schneiden. Zum Beispiel bewirkt labels=[1,0,0,1], dass Breitengrade dort beschriftet werden, wo sie den linken und den unteren Rand des Plots schneiden, aber nicht den rechten und oberen.
labelstyle	Wenn auf “+/-” gesetzt, werden nördliche und südliche Breiten mit “+” und “-” beschriftet, andernfalls mit “N” und “S”.
fmt	Ein Formatstring zur Formatierung der Breitengradbeschriftungen (Standard ‘%g’) oder eine Funktion, die einen Breitengradwert in Grad als einziges Argument nimmt und einen formatierten String zurückgibt.
xoffset	Beschriftungsabstand vom Kartenrand in x-Richtung (Standard ist 0,01 mal die Kartenbreite in Kartenprojektionskoordinaten).
yoffset	Beschriftungsabstand vom Kartenrand in y-Richtung (Standard ist 0,01 mal die Kartenhöhe in Kartenprojektionskoordinaten).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
latmax	absoluter Wert der Breite, bis zu der Meridiane gezeichnet werden (Standard ist 80).
**text_kwargs	zusätzliche Schlüsselwortargumente zur Steuerung von Text für Beschriftungen, die an die Textmethode der Achsen-Instanz weitergegeben werden (siehe Dokumentation von matplotlib.pyplot.text).

Gibt ein Wörterbuch zurück, dessen Schlüssel die Breitengradwerte sind und dessen Werte Tupel sind, die Listen der matplotlib.lines.Line2D- und matplotlib.text.Text-Instanzen enthalten, die mit jedem Breitengrad verbunden sind. Das Löschen eines Elements aus dem Wörterbuch entfernt den entsprechenden Breitengrad aus dem Plot.

drawrivers(linienbreite=0.5, linienstil='solid', farbe='k', kantenglättung=1, ax=None, zorder=None)[Quelle]¶

Zeichnet Hauptflüsse.

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Breite der Flussgrenzlinie (Standard 0.5)
Linienstil (linestyle)	Linienstil der Küstenlinie (Standard solid)
color	Farbe der Flussgrenzlinie (Standard schwarz)
antialiased	Schalter für Kantenglättung von Flussgrenzen (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
zorder	Legt die zorder-Reihenfolge für die Flüsse fest (falls nicht angegeben, wird die Standard-zorder-Reihenfolge für matplotlib.patches.LineCollections verwendet).

Gibt ein matplotlib.patches.LineCollection-Objekt zurück.

drawstates(linienbreite=0.5, linienstil='solid', farbe='k', kantenglättung=1, ax=None, zorder=None)[Quelle]¶

Zeichnet Staatsgrenzen in Amerika.

Schlüsselwort	Beschreibung
Linienbreite (linewidth)	Breite der Staatsgrenzlinie (Standard 0.5)
Linienstil (linestyle)	Linienstil der Küstenlinie (Standard solid)
color	Farbe der Staatsgrenzlinie (Standard schwarz)
antialiased	Schalter für Kantenglättung von Staatsgrenzen (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
zorder	Legt die zorder-Reihenfolge für die Staatsgrenzen fest (falls nicht angegeben, wird die Standard-zorder-Reihenfolge für matplotlib.patches.LineCollections verwendet).

Gibt ein matplotlib.patches.LineCollection-Objekt zurück.

etopo(ax=None, skala=None, **kwargs)[Quelle]¶

Zeigt das ETOPO-Reliefbild als Kartenhintergrund an.

Das Originalbild ist verfügbar unter

http://www.ngdc.noaa.gov/mgg/global/global.html

Die Standardbildgröße ist 5400x2700, was speicherintensiv sein kann. Das Schlüsselwort scale ermöglicht das Herunterskalieren des Bildes (z.B. scale=0.5 skaliert auf 2700x1350).

Parameter:

ax (matplotlib.image.AxesImage, optional) – wenn angegeben, alternative Achsen-Instanz, auf der das Bild gezeichnet wird
scale (float, optional) – wenn angegeben, skaliert das Bild um den gegebenen Faktor
**kwargs (dict, optional) – Schlüsselwortargumente, die an Basemap.imshow() weitergegeben werden.

Gibt zurück:

ax (matplotlib.image.AxesImage) – Achsen-Instanz

fillcontinents(farbe='0.8', seefarbe=None, ax=None, zorder=None, alpha=None)[Quelle]¶

Füllt Kontinente.

Schlüsselwort	Beschreibung
color	Farbe zum Füllen der Kontinente (Standard grau).
seefarbe	Farbe zum Füllen von Binnenseen (Standard Hintergrund des Achsenobjekts).
ax	Achseninstanz (überschreibt die Standard-Achseninstanz).
zorder	Legt die zorder-Reihenfolge für die Kontinentpolygone fest (falls nicht angegeben, wird die Standard-zorder-Reihenfolge für ein Polygon-Patch verwendet). Setzen Sie auf null, wenn Sie über die gefüllten Kontinente malen möchten).
alpha	Legt die Alpha-Transparenz für Kontinentpolygone fest.

Nach dem Füllen der Kontinente werden die Seen mit der Hintergrundfarbe der Achsen neu gefüllt.

Gibt eine Liste von matplotlib.patches.Polygon-Objekten zurück.

gcpoints(lon1, lat1, lon2, lat2, npoints)[Quelle]¶

Berechnet npoints Punkte entlang eines Großkreises mit den Endpunkten (lon1,lat1) und (lon2,lat2).

Gibt die Arrays x,y mit Kartenprojektionskoordinaten zurück.

hexbin(x, y, **kwargs)[Quelle]¶

Erstellt ein Sechseck-Histogramm von x gegen y, wobei x und y eindimensionale Sequenzen gleicher Länge N sind. Wenn C None ist (Standard), ist dies ein Histogramm der Anzahl der Vorkommen der Beobachtungen bei (x[i],y[i]).

Wenn C angegeben ist, gibt es Werte an der Koordinate (x[i],y[i]) an. Diese Werte werden für jedes sechseckige Bin akkumuliert und dann gemäß der Funktion reduce_C_function reduziert, die standardmäßig die numpy mean-Funktion (np.mean) ist. (Wenn C angegeben ist, muss es ebenfalls eine eindimensionale Sequenz gleicher Länge wie x und y sein.)

x, y und/oder C können maskierte Arrays sein, in diesem Fall werden nur unmaskierte Punkte geplottet.

(Siehe matplotlib.pyplot.hexbin Dokumentation).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.hexbin weitergegeben werden.

imshow(*args, **kwargs)[Quelle]¶

Zeigt ein Bild über der Karte an (siehe matplotlib.pyplot.imshow Dokumentation).

Die Schlüsselwörter extent und origin werden automatisch gesetzt, sodass das Bild über dem Kartenbereich gezeichnet wird.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.plot weitergegeben werden.

Gibt eine matplotlib.image.AxesImage-Instanz zurück.

is_land(xpt, ypt)[Quelle]¶: Gibt True zurück, wenn der gegebene x,y-Punkt (in Projektionskoordinaten) über Land liegt, andernfalls False. Die Definition von Land basiert auf den GSHHS-Küstenlinienpolygonen, die mit der Klasseninstanz verknüpft sind. Punkte über Seen innerhalb von Landflächen werden nicht als Landpunkte gezählt.

makegrid(nx, ny, returnxy=False)[Quelle]¶

Gibt Arrays der Form (ny,nx) zurück, die lon,lat-Koordinaten eines gleichmäßig verteilten nativen Projektionsrasters enthalten.

Wenn returnxy = True, werden auch die x,y-Werte des Rasters zurückgegeben.

nightshade(datum, farbe='k', delta=0.25, alpha=0.5, ax=None, zorder=2)[Quelle]¶

Schattiert die Regionen der Karte, die zum Zeitpunkt datum in Dunkelheit liegen. datum ist eine datetime-Instanz, die als UTC angenommen wird.

Schlüsselwörter	Beschreibung
color	Farbe zum Schattieren von Nachtregionen (Standard schwarz).
delta	Die Tag/Nacht-Terminatoren werden mit einer Auflösung von `delta` Grad berechnet (Standard 0.25).
alpha	Alpha-Transparenz für die Schattierung (Standard 0.5, sodass der Kartenhintergrund durchscheint).
zorder	zorder für die Schattierung (Standard 2).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Gibt eine matplotlib.contour.ContourSet-Instanz zurück.

pcolor(x, y, daten, **kwargs)[Quelle]¶

Erstellt einen Pseudofarben-Plot über der Karte (siehe matplotlib.pyplot.pcolor Dokumentation).

Wenn x oder y außerhalb des Projektionsrands liegen (d.h. sie haben Werte > 1.e20), werden sie in maskierte Arrays mit diesen maskierten Werten umgewandelt. Dadurch werden diese Werte nicht geplottet.

Wenn tri auf True gesetzt ist, wird ein unstrukturiertes Gitter angenommen (x,y,daten müssen 1D sein) und matplotlib.pyplot.tripcolor wird verwendet.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.pcolor (oder tripcolor, wenn tri=True) weitergegeben werden.

Hinweis: (entnommen aus der Dokumentation von matplotlib.pyplot.pcolor) Idealerweise sollten die Dimensionen von x und y um eins größer sein als die von daten; wenn die Dimensionen gleich sind, werden die letzte Zeile und Spalte von daten ignoriert.

pcolormesh(x, y, daten, **kwargs)[Quelle]¶

Erstellt einen Pseudofarben-Plot über der Karte (siehe matplotlib.pyplot.pcolormesh Dokumentation).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.pcolormesh weitergegeben werden.

plot(*args, **kwargs)[Quelle]¶

Zeichnet Linien und/oder Marker auf der Karte (siehe matplotlib.pyplot.plot Dokumentation).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.plot weitergegeben werden.

quiver(x, y, u, v, *args, **kwargs)[Quelle]¶

Erstellt ein Vektorfeld-Diagramm (u, v) mit Pfeilen auf der Karte.

Argumente können 1D- oder 2D-Arrays oder Sequenzen sein (siehe matplotlib.pyplot.quiver Dokumentation für Details).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere *args und **kwargs, die an matplotlib.pyplot.quiver weitergegeben werden.

readshapefile(shapefile, name, drawbounds=True, zorder=None, linienbreite=0.5, farbe='k', kantenglättung=1, ax=None, default_encoding='utf-8', encoding_errors='strict')[Quelle]¶

Liest eine Shape-Datei ein und zeichnet optional Grenzen auf der Karte.

Hinweis

Geht davon aus, dass Formen 2D sind.
Funktioniert nur für Point-, MultiPoint-, Polyline- und Polygon-Formen.
Eckpunkte/Punkte müssen in geographischen Koordinaten (Breiten-/Längengrad) vorliegen.

Zwingend erforderliche Argumente

Argument	Beschreibung
shapefile	Pfad zu den Shapefile-Komponenten. Beispiel: shapefile=’/home/jeff/esri/world_borders’ geht davon aus, dass world_borders.shp, world_borders.shx und world_borders.dbf in /home/jeff/esri liegen.
name	Name für das Basemap-Attribut, das die Shapefile-Eckpunkte oder Punkte in Kartenprojektionskoordinaten speichert. Der Klassenattributname + ’_info’ ist eine Liste von Wörterbüchern, eines für jede Form, das Attribute jeder Form aus der DBF-Datei enthält. Zum Beispiel ist self.counties eine Liste von x,y-Eckpunkten für jede Form in Kartenprojektionskoordinaten und self.counties_info ist eine Liste von Wörterbüchern mit Formattributen. Ringe in einzelnen Polygonformen werden in separate Polygone aufgeteilt, und zusätzliche Schlüssel ’RINGNUM’ und ’SHAPENUM’ werden dem Formattributwörterbuch hinzugefügt.

Argument

Beschreibung

shapefile

Pfad zu den Shapefile-Komponenten. Beispiel: shapefile=’/home/jeff/esri/world_borders’ geht davon aus, dass world_borders.shp, world_borders.shx und world_borders.dbf in /home/jeff/esri liegen.

name

Name für das Basemap-Attribut, das die Shapefile-Eckpunkte oder Punkte in Kartenprojektionskoordinaten speichert. Der Klassenattributname + ’_info’ ist eine Liste von Wörterbüchern, eines für jede Form, das Attribute jeder Form aus der DBF-Datei enthält. Zum Beispiel ist self.counties eine Liste von x,y-Eckpunkten für jede Form in Kartenprojektionskoordinaten und self.counties_info ist eine Liste von Wörterbüchern mit Formattributen. Ringe in einzelnen Polygonformen werden in separate Polygone aufgeteilt, und zusätzliche Schlüssel ’RINGNUM’ und ’SHAPENUM’ werden dem Formattributwörterbuch hinzugefügt.

Die folgenden optionalen Schlüsselwortargumente sind nur für Polyline- und Polygon-Formtypen relevant, für Point- und MultiPoint-Formen werden sie ignoriert.

Schlüsselwort	Beschreibung
drawbounds	zeichnet Grenzen von Formen (Standard True).
zorder	zorder der Formgrenzen (falls nicht angegeben, wird die Standardeinstellung für mathplotlib.lines.LineCollection verwendet).
Linienbreite (linewidth)	Breite der Formgrenzlinie (Standard 0.5)
color	Farbe der Formgrenzlinie (Standard schwarz)
antialiased	Schalter für Kantenglättung von Formgrenzen (Standard True).
ax	Achsen-Instanz (überschreibt die Standard-Achsen-Instanz)
default_encoding	Codierung, die zum Parsen von Eigenschaften aus .dbf-Dateien verwendet wird (Standard utf-8)
encoding_errors	Fehlerbehandlung der Codierung (Standard strict), andere mögliche Werte: ignore, replace und backslashreplace

Ein Tupel (num_shapes, type, min, max), das Shapefile-Infos enthält, wird zurückgegeben. num_shapes ist die Anzahl der Formen, type ist der Typcode (einer der SHPT*-Konstanten im shapelib-Modul, siehe http://shapelib.maptools.org/shp_api.html) und min und max sind 4-elementige Listen mit den Minimal- und Maximalwerten der Eckpunkte. Wenn drawbounds=True ist, wird ein matplotlib.patches.LineCollection-Objekt an das Tupel angehängt.

rotate_vector(uin, vin, lons, lats, returnxy=False)[Quelle]¶

Rotiert ein Vektorfeld (uin,vin) auf einem rechteckigen Gitter mit Längengraden = lons und Breitengraden = lats von geographischen (Breiten-/Längengrad) in Kartenprojektions- (x/y) Koordinaten.

Unterscheidet sich von transform_vector dadurch, dass keine Interpolation stattfindet. Der Vektor wird auf demselben Gitter zurückgegeben, aber in x,y-Koordinaten rotiert.

Das Eingangsvektorfeld ist in Kugelkoordinaten definiert (es hat östliche und nördliche Komponenten), während das Ausgangsvektorfeld in Kartenprojektionskoordinaten (relativ zu x und y) rotiert wird. Die Magnitude des Vektors bleibt erhalten.

Argumente	Beschreibung
uin, vin	Eingangsvektorfeld auf einem Breiten-/Längengradgitter.
lons, lats	Arrays mit Längengraden und Breitengraden (in Grad) der Eingabedaten in aufsteigender Reihenfolge. Für nicht-zylindrische Projektionen (außer `cyl`, `merc`, `cyl`, `gall` und `mill`) müssen lons im Bereich von -180 bis 180 liegen.

Gibt uout, vout (rotiertes Vektorfeld) zurück. Wenn das optionale Schlüsselwortargument returnxy True ist (Standard ist False), gibt es uout,vout,x,y zurück (wobei x,y die Kartenprojektionskoordinaten des durch lons,lats definierten Gitters sind).

scatter(*args, **kwargs)[Quelle]¶

Plottet Punkte mit Markern auf der Karte (siehe matplotlib.pyplot.scatter Dokumentation).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achseninstanz zu überschreiben.

Andere **kwargs, die an matplotlib.pyplot.scatter weitergegeben werden.

set_axes_limits(ax=None)[Quelle]¶

Letzter Schritt in den Basemap-Methoden-Wrappern für Achsen-Plot-Methoden.

Setzt Achsenlimits, korrigiert das Seitenverhältnis für den Kartenbereich unter Verwendung der aktuellen oder angegebenen Achseninstanz. Dies geschieht nur einmal pro Achseninstanz.

Im interaktiven Modus ruft diese Methode immer draw_if_interactive auf, bevor sie zurückkehrt.

shadedrelief(ax=None, skala=None, **kwargs)[Quelle]¶

Zeigt ein schattiertes Reliefbild als Kartenhintergrund an.

Das Originalbild ist verfügbar unter

https://www.shadedrelief.com/

Die Standardbildgröße ist 5400x2700, was speicherintensiv sein kann. Das Schlüsselwort scale ermöglicht das Herunterskalieren des Bildes (z.B. scale=0.5 skaliert auf 2700x1350).

Parameter:

ax (matplotlib.image.AxesImage, optional) – wenn angegeben, alternative Achsen-Instanz, auf der das Bild gezeichnet wird
scale (float, optional) – wenn angegeben, skaliert das Bild um den gegebenen Faktor
**kwargs (dict, optional) – Schlüsselwortargumente, die an Basemap.imshow() weitergegeben werden.

Gibt zurück:

ax (matplotlib.image.AxesImage) – Achsen-Instanz

shiftdata(lonsin, datain=None, lon_0=None, fix_wrap_around=True)[Quelle]¶

Verschiebt Längengrade (und optional Daten), damit sie mit dem Kartenprojektionsbereich übereinstimmen. Nur gültig für zylindrische/pseudo-zylindrische globale Projektionen und Daten auf regulären Längen-/Breitengradrastern. Längengrade und Daten können 1D oder 2D sein, wenn 2D, wird angenommen, dass Längengrade die zweite (am weitesten rechts liegende) Dimension sind.

Argumente	Beschreibung
lonsin	ursprüngliche 1D- oder 2D-Längengrade.

Schlüsselwörter	Beschreibung
datain	ursprüngliche 1D- oder 2D-Daten. Standard None.
lon_0	Mittelpunkt des Kartenprojektionsbereichs. Standard None, gegeben durch die aktuelle Kartenprojektion.
fix_wrap_around	Wenn True, werden Längengrade (und Daten) neu indiziert (falls erforderlich), um Sprünge zu vermeiden, die durch die Neuzuordnung von Längengraden von Punkten außerhalb des Intervalls [lon_0-180, lon_0+180] in das Intervall verursacht werden. Wenn False, werden Längengrade und Daten nicht neu indiziert, aber es wird sichergestellt, dass die Längengrade im Bereich [lon_0-180, lon_0+180] liegen.

Wenn datain gegeben ist, gibt es lonsout, dataout zurück (Längengrade und Daten, die verschoben wurden, um in das Intervall [lon_0-180, lon_0+180] zu passen); andernfalls wird nur die verschobene Längenangabe zurückgegeben. Wenn transformierte Längengrade außerhalb des Kartenprojektionsbereichs liegen, werden die Daten maskiert und die Längengrade auf 1.e30 gesetzt.

streamplot(x, y, u, v, *args, **kwargs)[Quelle]¶

Zeichnet Stromlinien eines Vektors. (Siehe matplotlib.pyplot.streamplot Dokumentation).

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere *args und **kwargs, die an matplotlib.pyplot.streamplot weitergegeben werden.

tissot(lon_0, lat_0, radius_deg, npts, ax=None, **kwargs)[Quelle]¶

Zeichnet ein Polygon zentriert bei lon_0,lat_0. Das Polygon nähert einen Kreis auf der Erdoberfläche mit einem Radius von radius_deg Grad Breite entlang des Längengrads lon_0 an und besteht aus npts Eckpunkten. Das Polygon stellt eine Tissot-Indikatrix dar (http://en.wikipedia.org/wiki/Tissot’s_Indicatrix), die, wenn sie auf einer Karte gezeichnet wird, die Verzerrung der Kartenprojektion zeigt.

Hinweis

Kann keine Situationen behandeln, in denen das Polygon den Rand der Kartenprojektionsdomäne schneidet und dann wieder in die Domäne eintritt.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Andere **kwargs, die an matplotlib.patches.Polygon weitergegeben werden.

Gibt ein matplotlib.patches.Polygon-Objekt zurück.

transform_scalar(datin, lons, lats, nx, ny, returnxy=False, checkbounds=False, order=1, masked=False)[Quelle]¶

Interpoliert ein Skalarfeld (datin) von einem Längen-/Breitengradgitter mit Längengraden = lons und Breitengraden = lats auf ein ny mal nx Kartenprojektionsgitter. Wird typischerweise verwendet, um Daten in Kartenprojektionskoordinaten zu transformieren, die mit imshow() geplottet werden sollen.

Argument	Beschreibung
datin	Eingabedaten auf einem Längen-/Breitengradgitter.
lons, lats	Rang-1-Arrays mit Längengraden und Breitengraden (in Grad) der Eingabedaten in aufsteigender Reihenfolge. Für nicht-zylindrische Projektionen (außer `cyl`, `merc`, `cea`, `gall` und `mill`) müssen lons im Bereich von -180 bis 180 liegen.
nx, ny	Die Größe des Ausgaberegulargitters in Kartenprojektionskoordinaten.

Schlüsselwort	Beschreibung
returnxy	Wenn True, werden auch die x- und y-Werte des Kartenprojektionsgitters zurückgegeben (Standard False).
checkbounds	Wenn True, werden die Werte von lons und lats überprüft, ob sie innerhalb des Kartenprojektionsbereichs liegen. Standard ist False, und Daten außerhalb des Kartenprojektionsbereichs werden auf Grenzwerte beschnitten.
masked	Wenn True, werden interpolierte Daten als maskiertes Array zurückgegeben, wobei Werte außerhalb des Kartenprojektionsbereichs maskiert sind (Standard False).
order	0 für Nearest-Neighbor-Interpolation, 1 für bilinear, 3 für kubische Spline (Standard 1). Kubische Spline-Interpolation erfordert scipy.ndimage.

Gibt datout (Daten auf dem Kartenprojektionsgitter) zurück. Wenn returnxy=True, gibt es data,x,y zurück.

transform_vector(uin, vin, lons, lats, nx, ny, returnxy=False, checkbounds=False, order=1, masked=False)[source]¶

Rotiert und interpoliert ein Vektorfeld (uin,vin) von einem Gitter aus Längen- und Breitengraden mit Längengraden = lons und Breitengraden = lats auf ein ny mal nx Kartenprojektionsgitter.

Argumente	Beschreibung
uin, vin	Eingangsvektorfeld auf einem Breiten-/Längengradgitter.
lons, lats	Rang-1-Arrays mit Längengraden und Breitengraden (in Grad) der Eingabedaten in aufsteigender Reihenfolge. Für nicht-zylindrische Projektionen (außer `cyl`, `merc`, `cea`, `gall` und `mill`) müssen lons im Bereich von -180 bis 180 liegen.
nx, ny	Die Größe des Ausgaberegulargitters in Kartenprojektionskoordinaten.

Schlüsselwort	Beschreibung
returnxy	Wenn True, werden auch die x- und y-Werte des Kartenprojektionsgitters zurückgegeben (Standard False).
checkbounds	Wenn True, werden die Werte von lons und lats überprüft, ob sie innerhalb des Kartenprojektionsbereichs liegen. Standard ist False, und Daten außerhalb des Kartenprojektionsbereichs werden auf Grenzwerte beschnitten.
masked	Wenn True, werden interpolierte Daten als maskiertes Array zurückgegeben, wobei Werte außerhalb des Kartenprojektionsbereichs maskiert sind (Standard False).
order	0 für Nearest-Neighbor-Interpolation, 1 für bilinear, 3 für kubische Spline (Standard 1). Kubische Spline-Interpolation erfordert scipy.ndimage.

Gibt uout, vout (Vektorfeld auf dem Kartenprojektionsgitter) zurück. Wenn returnxy=True, werden uout,vout,x,y zurückgegeben.

warpimage(image='bluemarble', scale=None, **kwargs)[source]¶

Zeigt ein Bild (Dateiname angegeben durch das Schlüsselwort image) als Kartenhintergrund an. Wenn das Bild eine URL ist (beginnt mit „http“), wird es mit urllib.urlretrieve in eine temporäre Datei heruntergeladen.

Standardmäßig (wenn image nicht angegeben ist) wird das Bild „blue marble next generation“ von http://visibleearth.nasa.gov/ angezeigt.

Das angegebene Bild muss Pixel haben, die den gesamten Globus in einem regelmäßigen Längen-/Breitengradgitter abdecken, beginnend bei -180W und dem Südpol. Funktioniert mit den globalen Bildern von http://earthobservatory.nasa.gov/Features/BlueMarble/BlueMarble_monthlies.php.

Das Schlüsselwort scale kann verwendet werden, um das Bild herunterzuskalieren (zu vergrößern). Werte kleiner als 1.0 beschleunigen die Verarbeitung auf Kosten der Bildauflösung.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

**kwargs werden an imshow() übergeben.

Gibt eine matplotlib.image.AxesImage-Instanz zurück.

wmsimage(server, xpixels=400, ypixels=None, format='png', alpha=None, verbose=False, **kwargs)[source]¶

Ruft ein Bild von einem WMS-Server unter Verwendung der OGC (Open Geospatial Consortium) Standard-Schnittstelle ab und zeigt es auf der Karte an. Erfordert OWSLib (http://pypi.python.org/pypi/OWSLib). Um diese Methode verwenden zu können, muss die Basemap-Instanz mit dem Schlüsselwort epsg zur Definition der Kartenprojektion erstellt werden, es sei denn, die cyl-Projektion wird verwendet (in diesem Fall wird der epsg-Code 4326 angenommen).

Schlüsselwörter	Beschreibung
server	URL des WMS-Servers.
xpixels	angeforderte Anzahl von Bildpixeln in x-Richtung (Standard 400).
ypixels	angeforderte Anzahl von Bildpixeln in y-Richtung. Standardmäßig (None) wird die Anzahl aus xpixels und dem Seitenverhältnis des Kartenprojektionsbereichs abgeleitet.
format	gewünschtes Bildformat (Standard „png“)
alpha	Der Alpha-Blending-Wert, zwischen 0 (transparent) und 1 (opak) (Standard None)
verbose	wenn True, werden WMS-Serverinformationen ausgegeben (Standard False).
**kwargs	zusätzliche Schlüsselwortargumente, die an OWSLib.wms.WebMapService und OWSLib.wms.WebMapService.getmap übergeben werden.

Das zusätzliche Schlüsselwort ax kann verwendet werden, um die Standard-Achsen-Instanz zu überschreiben.

Gibt eine matplotlib.image.AxesImage-Instanz zurück.

mpl_toolkits.basemap.addcyclic(*arr, **kwargs)[source]¶

Fügt zyklische (umlaufende) Punkte im Längengrad zu einem oder mehreren Arrays hinzu, wobei das letzte Array die Längengrade in Grad ist. z. B.

data1out, data2out, lonsout = addcyclic(data1,data2,lons)

Schlüsselwörter

Beschreibung

axis

die Dimension, die den Längengrad darstellt (Standard -1, oder ganz rechts)

zyklisch

Breite des periodischen Bereichs (Standard 360)

Schlüsselwörter	Beschreibung
axis	die Dimension, die den Längengrad darstellt (Standard -1, oder ganz rechts)
zyklisch	Breite des periodischen Bereichs (Standard 360)

mpl_toolkits.basemap.interp(datain, xin, yin, xout, yout, checkbounds=False, masked=False, order=1)[source]¶

Interpoliert Daten (datain) auf einem rechteckigen Gitter (mit x = xin y = yin) auf ein Gitter mit x = xout, y= yout.

Argumente	Beschreibung
datain	ein Rang-2-Array, bei dem die erste Dimension y und die zweite Dimension x entspricht.
xin, yin	Rang-1-Arrays, die x und y des datain-Gitters in aufsteigender Reihenfolge enthalten.
xout, yout	Rang-2-Arrays, die x und y des gewünschten Ausgabegitters enthalten.

Schlüsselwörter	Beschreibung
checkbounds	Wenn True, werden die Werte von xout und yout daraufhin überprüft, ob sie innerhalb des von xin und xin angegebenen Bereichs liegen. Wenn False und xout,yout außerhalb von xin,yin liegen, werden die interpolierten Werte auf die Werte am Rand des Eingabegitters (xin,yin) beschnitten. Standard ist False.
masked	Wenn True, werden Punkte außerhalb des Bereichs von xin und yin maskiert (in einem maskierten Array). Wenn masked auf eine Zahl gesetzt wird, werden Punkte außerhalb des Bereichs von xin und yin auf diesen Wert gesetzt. Standard False.
order	0 für nächstgelegene Nachbarinterpolation, 1 für bilineare Interpolation, 3 für kubische Spline (Standard 1). order=3 erfordert scipy.ndimage.

Hinweis

Wenn datain ein maskiertes Array ist und order=1 (bilineare Interpolation) verwendet wird, werden Elemente von dataout maskiert, wenn einer der vier umliegenden Punkte in datain maskiert ist. Um dies zu vermeiden, führen Sie die Interpolation in zwei Schritten durch: zuerst mit order=1 (ergibt dataout1), dann mit order=0 (ergibt dataout2). Ersetzen Sie dann alle maskierten Werte in dataout1 durch die entsprechenden Elemente in dataout2 (mit numpy.where). Dies verwendet effektiv die nächstgelegene Nachbarinterpolation, wenn einer der vier umliegenden Punkte in datain maskiert ist, und andernfalls bilineare Interpolation.

Gibt dataout zurück, die interpolierten Daten auf dem Gitter xout, yout.

mpl_toolkits.basemap.maskoceans(lonsin, latsin, datain, inlands=True, resolution='l', grid=5)[source]¶

Maskiert Daten (datain), die auf einem Gitter mit Breitengraden latsin und Längengraden lonsin definiert sind, so dass Punkte über Wasser nicht gezeichnet werden.

Argumente	Beschreibung
lonsin, latsin	Rang-2-Arrays, die Längen- und Breitengrade des Gitters enthalten.
datain	Rang-2-Eingabearray auf dem durch `lonsin` und `latsin` definierten Gitter.
inlands	Wenn False, werden nur Meerpunkte und keine Binnenseen maskiert (Standard True).
resolution	GSHHS-Küstenlinien-Auflösung, die zur Definition der Land-/Meer-Maske verwendet wird (Standard 'l', verfügbar 'c','l','i','h' oder 'f')
grid	Rasterabstand der Land-/Meer-Maske in Minuten (Standard 5; 10, 2,5 und 1,25 sind ebenfalls verfügbar).

Gibt ein maskiertes Array mit der gleichen Form wie datain zurück, wobei „nasse“ Punkte maskiert sind.

mpl_toolkits.basemap.shiftgrid(lon0, datain, lonsin, start=True, cyclic=360.0)[source]¶

Verschiebt ein globales Längen-/Breitengradgitter nach Osten oder Westen.

Argumente	Beschreibung
lon0	Startlängengrad für das verschobene Gitter (Endlängengrad, wenn start=False). lon0 muss auf dem Eingabegitter liegen (innerhalb des Bereichs von lonsin).
datain	Originaldaten mit Längengrad als rechtester Dimension.
lonsin	Original-Längengrade.

Schlüsselwörter	Beschreibung
start	Wenn True, repräsentiert lon0 den Startlängengrad des neuen Gitters. Wenn False, ist lon0 der Endlängengrad. Standard True.
zyklisch	Breite des periodischen Bereichs (Standard 360)

Gibt dataout,lonsout (Daten und Längengrade auf dem verschobenen Gitter) zurück.

mpl_toolkits.basemap¶

`mpl_toolkits.basemap`¶