HOWTO · Matplotlib

Wie man in Matplotlib einen Kreis zeichnet

Wir können in Matplotlib mit Patches Circle, Circle Equation und Scatter Plot einen Kreis zeichnen.

Auf dieser Seite

Um in Matplotlib einen geometrischen Kreis zu zeichnen, verwenden Sie matplotlib.patches.Circle und fügen den Patch einer Axes hinzu. Sie können einen Kreis auch anhand seiner Gleichung zeichnen oder für ein einfaches kreisförmiges Symbol einen Streumarker verwenden. Ein Patch ist meist die direkteste Wahl, wenn der Kreis einen Mittelpunkt und einen Radius in Datenkoordinaten haben soll.

Einen Kreis mit matplotlib.patches.Circle zeichnen

matplotlib.patches.Circle erstellt aus einem Mittelpunkt (x, y) und einem Radius einen Patch. Fügen Sie ihn mit add_patch einer Axes hinzu und legen Sie ein gleiches Seitenverhältnis fest, damit eine Einheit auf der x-Achse auf dem Bildschirm dieselbe Länge hat wie eine Einheit auf der y-Achse.

import matplotlib.pyplot as plt
from matplotlib.patches import Circle

fig, ax = plt.subplots()
ax.add_patch(Circle((2, 1), radius=0.75, fill=False, linewidth=2))
ax.set_aspect("equal", adjustable="box")
ax.set_xlim(0, 4)
ax.set_ylim(-1, 3)
ax.set_title("Circle patch")
plt.show()

Gerendertes Ergebnis des Circle-Patch-Beispiels: ein ungefüllter Kreisumriss mit Mittelpunkt (2, 1) und Radius 0,75 auf Achsen von 0 bis 4 und -1 bis 3.

Ändern Sie das erste Argument, um den Mittelpunkt zu verschieben, und radius, um die Größe des Kreises anzupassen. Mit fill=True (dem Standardwert) wird der Kreis gefüllt; mit fill=False zeichnen Sie nur den Umriss. Circle ist ein Artist und kann daher auch mit ax.add_artist(circle) hinzugefügt werden. Wenn bereits ein Diagramm existiert, fügt plt.gcf().gca().add_artist(circle) den Patch der aktuellen Axes der aktuellen Figure hinzu. Bei einer Figure mit mehreren Diagrammen ist die Verwendung einer expliziten Axes übersichtlicher.

Wenn Sie die Achsengrenzen manuell festlegen, muss der gesamte Kreis hinein passen: Bei Mittelpunkt (cx, cy) und Radius r muss der x-Bereich von cx - r bis cx + r und der y-Bereich von cy - r bis cy + r reichen. Grenzen innerhalb dieser Bereiche schneiden einen Teil des Patches oder der anhand einer Gleichung gezeichneten Kurve ab. Lassen Sie außerdem genügend Abstand zum Rand, damit der Umriss dort gut erkennbar bleibt.

Einen Kreis anhand seiner Gleichung zeichnen

Eine Parametergleichung beschreibt Punkte auf einem Kreis. Für den Mittelpunkt (cx, cy) und den Radius r verwenden Sie x = cx + r cos(theta) und y = cy + r sin(theta). Wenn Sie Winkel von null bis 2π abtasten, erhalten Sie die vollständige Kurve.

import numpy as np
import matplotlib.pyplot as plt

center_x, center_y = 2, 1
radius = 0.75
theta = np.linspace(0, 2 * np.pi, 200)
x = center_x + radius * np.cos(theta)
y = center_y + radius * np.sin(theta)

fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_aspect("equal", adjustable="box")
ax.set_title("Circle from a parametric equation")
plt.show()

Gerendertes Ergebnis des Parameterbeispiels: eine aus den abgetasteten Winkeln gezeichnete Kreiskurve mit Mittelpunkt (2, 1) und Radius 0,75.

Die Mittelpunkt-Radius-Gleichung (x - cx)² + (y - cy)² = r² lässt sich alternativ als Kontur auf Höhe null zeichnen. Ziehen Sie r**2 von der linken Seite ab, berechnen Sie den Ausdruck auf einem Meshgrid und zeichnen Sie die Kontur für den Wert null. Wählen Sie Gittergrenzen, die den gesamten Kreis einschließen, und verwenden Sie auf beiden Achsen dieselbe Skalierung. Andernfalls kann die gezeichnete Kurve verzerrt wirken.

import numpy as np
import matplotlib.pyplot as plt

center_x, center_y = 2, 1
radius = 0.75
x = np.linspace(center_x - radius - 0.25, center_x + radius + 0.25, 100)
y = np.linspace(center_y - radius - 0.25, center_y + radius + 0.25, 100)
X, Y = np.meshgrid(x, y)
values = (X - center_x) ** 2 + (Y - center_y) ** 2 - radius ** 2

fig, ax = plt.subplots()
ax.contour(X, Y, values, levels=[0])
ax.set_aspect("equal", adjustable="box")
ax.set_title("Circle from the center-radius equation")
plt.show()

Gerendertes Ergebnis des Konturbeispiels: Die Nullkontur der Mittelpunkt-Radius-Gleichung bildet einen Kreis mit Mittelpunkt (2, 1) und Radius 0,75.

Einen Kreis mit einem Streumarker zeichnen

scatter zeichnet an jedem angegebenen Datenpunkt einen Marker. Mit dem Argument s legen Sie die Markerfläche in Punkten zum Quadrat fest. Das eignet sich für ein kreisförmiges Symbol, dessen sichtbare Größe an die Darstellung gebunden bleibt, im Gegensatz zu einem geometrischen Kreis, dessen Radius in Datenkoordinaten gemessen wird.

import matplotlib.pyplot as plt

fig, ax = plt.subplots()
ax.scatter([2], [1], s=500, marker="o")
ax.set_xlim(0, 4)
ax.set_ylim(-1, 3)
ax.set_aspect("equal", adjustable="box")
ax.set_title("Circular scatter marker")
plt.show()

Gerendertes Ergebnis des Streubeispiels: ein einzelner gefüllter kreisförmiger Marker am Punkt (2, 1); seine Größe legt das Argument s fest, nicht ein Radius in Datenkoordinaten.

Erhöhen oder verringern Sie s, um die angezeigte Fläche des Markers zu ändern. Verwenden Sie einen Circle-Patch, wenn der Radius den Abständen auf den Diagrammachsen entsprechen soll. Ein Streumarker eignet sich, wenn Sie an einem Datenpunkt ein Symbol mit gleichbleibender visueller Größe anzeigen möchten.

Dieses Verhalten ist praktisch, um Messpunkte hervorzuheben, einen Mittelpunkt zu markieren oder Symbole in Diagrammen zu platzieren, die Leser vergrößern können. Der Marker bleibt an typografische Punkte gebunden, auch wenn sich die Skalierung der Achsen ändert. Seine sichtbare Größe steht daher nicht für einen festen Abstand in den dargestellten Daten. Verwenden Sie einen Patch oder eine Gleichungskurve, wenn der Kreis einen Radius darstellen soll, den Leser mit anderen Datenwerten vergleichen können.

Warum ein Kreis wie eine Ellipse aussehen kann

Alle Beispiele oben legen mit set_aspect("equal", adjustable="box") ein gleiches Seitenverhältnis fest. Ohne diese Zeile verwendet Matplotlib das automatische Seitenverhältnis: Die Axes füllt ihren Rahmen aus, und weil dieser Rahmen breiter als hoch ist, wird eine Einheit auf der x-Achse länger dargestellt als eine Einheit auf der y-Achse. Der Patch bleibt in Datenkoordinaten ein Kreis, sieht auf dem Bildschirm aber wie eine Ellipse aus. Das folgende Beispiel verwendet denselben Mittelpunkt und Radius wie das erste Beispiel und lässt nur die Zeile mit dem Seitenverhältnis weg.

import matplotlib.pyplot as plt
from matplotlib.patches import Circle

fig, ax = plt.subplots()
ax.add_patch(Circle((2, 1), radius=0.75, fill=False, linewidth=2))
ax.set_xlim(0, 4)
ax.set_ylim(-1, 3)
ax.set_title("Circle patch without an equal aspect ratio")
plt.show()

Derselbe Circle-Patch ohne gleiches Seitenverhältnis: Der Kreis wird zu einer breiten Ellipse gestreckt, weil der Achsenrahmen breiter als hoch ist.

Die Korrektur besteht darin, ax.set_aspect("equal", adjustable="box") hinzuzufügen, bevor Sie die Grenzen festlegen, so wie in den früheren Beispielen. Gleichungskurven und Konturen verzerren auf dieselbe Weise: Ohne gleiches Seitenverhältnis wirkt jede Methode in diesem Artikel gestreckt. Mit adjustable="box" kann die Axes kleiner werden, damit beide Achsen dieselbe Skalierung erhalten; das ist beabsichtigt und kein Fehler in den Daten.