matplotlib.pyplot.streamplot
- matplotlib.pyplot.streamplot(x, y, u, v, density=1, linewidth=None, color=None, cmap=None, norm=None, arrowsize=1, arrowstyle='-|>', minlength=0.1, transform=None, zorder=None, start_points=None, maxlength=4.0, integration_direction='both', broken_streamlines=True, *, data=None)[исходный код]
-
Рисует линии тока векторного поля.
- Параметры:
-
- x, y1D/2D arrays
-
Равномерно распределённые строго возрастающие массивы для создания сетки. Если массивы двумерные, все строки x должны быть одинаковыми, а все столбцы y — одинаковыми; то есть они должны быть такими, как если бы были сгенерированы
np.meshgrid(x_1d, y_1d). - u, v2D arrays
-
Скорости по осям x и y. Число строк и столбцов должно совпадать с длиной y и x соответственно.
- densityfloat or (float, float)
-
Управляет плотностью расположения линий тока. При значении
density = 1область разбивается на сетку 30x30. Параметр density линейно масштабирует эту сетку. Через каждую ячейку сетки может проходить не более одной линии тока. Чтобы задать разную плотность по каждому направлению, используйте кортеж (density_x, density_y). - linewidthfloat or 2D array
-
Ширина линий тока. Если задан двумерный массив, ширина линий может изменяться по сетке. Массив должен иметь ту же форму, что и u и v.
- colorcolor or 2D array
-
Цвет линий тока. Если задан массив, его значения преобразуются в цвета с помощью cmap и norm. Массив должен иметь ту же форму, что и u и v.
- cmap, norm
-
Параметры нормализации данных и сопоставления цветов для color; используются, только если color — массив вещественных чисел. Подробное описание см. в
imshow. - arrowsizefloat
-
Масштабирующий коэффициент размера стрелок.
- arrowstylestr
-
Описание стиля стрелок. См.
FancyArrowPatch. - minlengthfloat
-
Минимальная длина линии тока в координатах осей.
- start_points(N, 2) array
-
Координаты начальных точек линий тока в координатах данных (в той же системе координат, что и массивы x и y).
- zorderfloat
-
Порядок отрисовки линий тока и стрелок. Объекты Artist с меньшими значениями zorder рисуются первыми.
- maxlengthfloat
-
Максимальная длина линии тока в координатах осей.
- integration_direction{'forward', 'backward', 'both'}, default: 'both'
-
Интегрировать линию тока в прямом, обратном или обоих направлениях.
- dataindexable object, optional
-
Если этот параметр задан, следующие параметры также принимают строку
s, которая интерпретируется какdata[s], еслиsявляется ключом вdata:x, y, u, v, start_points
- broken_streamlinesboolean, default: True
-
Если False, линии тока продолжаются до выхода за пределы области графика. Если True, они могут быть завершены, если подходят слишком близко к другой линии тока.
- Возвращает:
-
- StreamplotSet
-
Контейнерный объект со следующими атрибутами:
-
lines:LineCollectionлиний тока -
arrows:PatchCollection, содержащий объектыFancyArrowPatch, представляющие стрелки, расположенные посередине линий тока.
Вероятно, в будущем этот контейнер будет изменён, чтобы можно было задавать карту цветов, alpha и другие параметры как для линий, так и для стрелок; при этом изменения должны оставаться обратно совместимыми.
-
Примечания
Примечание
Это обёртка pyplot для
axes.Axes.streamplot.
Примеры использования matplotlib.pyplot.streamplot
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.streamplot.html