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