Расширенные функции построения графиков Matplotlib


Matplotlib 参考文档Справочная документация Matplotlib

Помимо базовых функций построения графиков, таких как plot() и bar(), Matplotlib также предоставляет множество специализированных функций построения графиков для таких сценариев, как ступенчатые графики, стеб-графики, диаграммы с областями с накоплением и полярные графики.

Обзор функций

ФункцияОписание
step()Построить ступенчатый график (данные изменяются кусочно-постоянными ступенями)
stem()Построить стеб-график (вертикальные линии + верхние маркеры)
eventplot()Построить диаграмму событий (несколько горизонтальных линий, отмечающих позиции событий)
stackplot()Построить диаграмму с областями с накоплением
broken_barh()Построить горизонтальную разрывную столбчатую диаграмму (в стиле диаграммы Ганта)
vlines() / hlines()Построить несколько вертикальных/горизонтальных опорных линий
fill()Построить заполненные многоугольники
polar()Построить график в полярной системе координат
loglog() / semilogx() / semilogy()Линейный график с логарифмическими координатами
grouped_bar()Сгруппированная столбчатая диаграмма (новая в 3.10+)
bar_label() / pie_label()Добавить подписи значений к столбчатым/круговым диаграммам

step() - Ступенчатый график

matplotlib.pyplot.step(x, y, *args, where='pre', **kwargs)
ПараметрОписание
x, yКоординаты точки данных
гдеПоложение шага: 'pre' (до), 'post' (после), 'mid' (середина)

Примеры

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 10, 0.5)
y = np.sin(x)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

# Сравните три режима where
ax.plot(x, y, 'gray', alpha=0.3, label='Оригинал (график)')
ax.step(x, y, where='pre', label='where="pre"', linewidth=2)
ax.step(x, y, where='post', label='where="post"', linewidth=2)
ax.step(x, y, where='mid', label='where="mid"', linewidth=2)

ax.set_title('step() - Ступенчатый график')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

stem() - Стеблевая диаграмма

matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None,
    basefmt=None, bottom=0, orientation='vertical', **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

n = 30
x = np.arange(n)
y = np.random.randn(n) * 2

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
                                 layout='constrained')

# Вертикальная стеблевая диаграмма
ax1.stem(x, y, linefmt='steelblue', markerfmt='o',
         basefmt='gray')
ax1.set_title('Вертикальный stem()')

# Горизонтальная стеблевая диаграмма
ax2.stem(x, y, linefmt='coral', markerfmt='s',
         basefmt='gray', orientation='horizontal')
ax2.set_title('Горизонтальный stem()')

plt.show()

stackplot() - Диаграмма с областями с накоплением

matplotlib.pyplot.stackplot(x, *args, labels=None, colors=None,
    baseline='zero', **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 10, 0.1)
y1 = np.sin(x) + 2
y2 = np.cos(x) + 2
y3 = 0.5 * np.sin(2*x) + 2

fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')

ax.stackplot(x, y1, y2, y3,
             labels=['Сигнал 1', 'Сигнал 2', 'Сигнал 3'],
             colors=['#3498db', '#e74c3c', '#2E7DCC'],
             альфа=0.7)

ax.set_title('stackplot() - Диаграмма с областями с накоплением')
ax.legend(loc='upper right')
plt.show()

vlines() / hlines() - Опорные линии

matplotlib.pyplot.vlines(x, ymin, ymax, colors=None, **kwargs)
matplotlib.pyplot.hlines(y, xmin, xmax, colors=None, **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
y = np.sin(x)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
ax.plot(x, y, 'k-', linewidth=2, alpha=0.7)

# Несколько вертикальных линий (отмечающих кратные π)
pi_x = [np.pi, 2*np.pi, 3*np.пи]
ax.vlines(pi_x, ymin=-1.5, ymax=1.5,
          colors='red', linestyles='--', alpha=0.5,
          label='кратные π')

# Несколько горизонтальных линий (отмечающих ±1)
ax.hlines([-1, 0, 1], xmin=0, xmax=10,
          colors=['gray','gray','gray'],
          linestyles=['--',':','--'], alpha=0.5)

ax.set_title('vlines() и hlines()')
ax.legend()
plt.show()

loglog() / semilogx() / semilogy() - Логарифмические координаты

matplotlib.pyplot.loglog(*args, **kwargs)
matplotlib.pyplot.semilogx(*args, **kwargs)
matplotlib.pyplot.semilogy(*args, **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

x = np.logspace(0, 3, 50)      # от 10^0 до 10^3
y1 = x**2
y2 = x**1.5
y3 = np.exp(x/50)

fig, axes = plt.subplots(1, 3, figsize=(12, 4),
                          layout='constrained')

# Двойной логарифмический
axes[0].loglog(x, y1, 'b-', label='x²')
axes[0].loglog(x, y2, 'r--', label='x¹·⁵')
axes[0].set_title('loglog()')
axes[0].grid(True, alpha=0.3)
axes[0].legend()

# Логарифмическая ось x
axes[1].semilogx(x, y3, 'green', label='exp(x/50)')
axes[1].set_title('semilogx()')
axes[1].grid(True, alpha=0.3)

# Логарифмическая ось y
axes[2].semilogy(x, y3, 'purple', label='exp(x/50)')
axes[2].set_title('semilogy()')
axes[2].grid(True, alpha=0.3)

plt.show()

eventplot() - График событий

matplotlib.pyplot.eventplot(positions, orientation='horizontal',
    lineoffsets=1, linelengths=1, linewidths=None, colors=None, **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)

# Времена событий для трёх каналов
events_A = np.random.rand(20) * 10
events_B = np.random.rand(15) * 10
events_C = np.random.rand(25) * 10

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

ax.eventplot([events_A, events_B, events_C],
             colors=['#e74c3c', '#3498db', '#2E7DCC'],
             lineoffsets=[0, 1, 2],    # Вертикальное положение каждой линии
             linelengths=0.8,
             linewidths=1.5)

ax.set_title('eventplot() - Диаграмма событий во времени')
ax.set_xlabel('Время (s)')
ax.set_yticks([0, 1, 2])
ax.set_yticklabels(['Канал A', 'Канал B', 'Канал C'])
plt.show()

broken_barh() - Диаграмма с разрывами

matplotlib.pyplot.broken_barh(xranges, yrange, **kwargs)

Примеры

import matplotlib.pyplot as plt

# Симуляция диаграммы Ганта
tasks = [
    [(0, 5)],                   # Задача 1: начинается в 0, длится 5
    [(3, 4)],                   # Задача 2: начинается в 3, длится 4
    [(2, 3), (6, 3)],          # Задача 3: два временных периода
    [(5, 4)],                   # Задача 4
    [(1, 2), (4, 2), (8, 2)],  # Задача 5: три временных периода
]

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

colors = ['#3498db', '#e74c3c', '#2E7DCC', '#f39c12', '#9b59b6']
for i, (task, color) in enumerate(zip(tasks, colors)):
    ax.broken_barh(task, (i - 0.4, 0.8), facecolors=color)

ax.set_title('broken_barh() - Диаграмма в стиле Ганта')
ax.set_xlabel('Время')
ax.set_yticks(range(5))
ax.set_yticklabels([f'Task {i+1}' for i in range(5)])
ax.grid(True, alpha=0.3)
plt.show()

fill() - Залитый многоугольник

matplotlib.pyplot.fill(*args, **kwargs)

Примеры

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(layout='constrained')

# Заполнить ромб
x = [1, 2, 1, 0]
y = [0, 1, 2, 1]
ax.fill(x, y, alpha=0.5, color='steelblue',
        edgecolor='black', label='Diamond')

# Заполнить пятиугольник
theta = np.linspace(0, 2*np.pi, 6)
x2 = 2.5 + np.cos(theta)
y2 = 1 + np.sin(theta)
ax.fill(x2, y2, alpha=0.5, color='coral',
        edgecolor='black', label='Пятиугольник')

ax.set_title('fill() - Заполненные многоугольники')
ax.set_aspect('equal')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения