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 数组

均匀间隔的严格递增数组以形成网格。如果是二维的,所有 x 的行必须相等,所有 y 的列必须相等;即,它们必须像由 np.meshgrid(x_1d, y_1d) 生成的那样。

u, v二维数组

xy 速度。行数和列数必须分别与 yx 的长度匹配。

密度浮点数或 (浮点数, 浮点数)

控制流线的紧密程度。当 density = 1 时,域被划分为一个 30x30 的网格。density 线性地缩放这个网格。网格中的每个单元格最多可以有一条穿过的流线。对于每个方向的不同密度,使用元组 (density_x, density_y)。

行宽浮点数或二维数组

流线的宽度。使用二维数组可以在网格上改变线宽。该数组必须与 uv 具有相同的形状。

颜色 : color 或 2D 数组颜色或二维数组

流线颜色。如果给定一个数组,其值将使用 cmapnorm 转换为颜色。该数组必须与 uv 具有相同的形状。

cmap, norm

数据归一化和颜色映射参数用于 颜色;仅在 颜色 是浮点数数组时使用。详见 imshow 的详细描述。

arrowsize浮动

箭头大小的缩放因子。

arrowstylestr

箭头样式规范。参见 FancyArrowPatch

最小长度浮动

流线在轴坐标中的最小长度。

起点(N, 2) 数组

数据坐标中流线的起始点坐标(与 xy 数组相同的坐标)。

zorder浮动

流线和箭头的zorder。zorder值较低的艺术家会先被绘制。

最大长度浮动

流线在轴坐标中的最大长度。

integration_direction{'forward', 'backward', 'both'}, 默认: 'both'

将流线集成在正向、反向或双向。

数据可索引对象,可选

如果提供,以下参数也接受一个字符串 s,如果 sdata 中的一个键,则解释为 data[s]

x, y, u, v, start_points

broken_streamlines布尔值,默认:True

如果为 False,强制流线继续延伸直到它们离开绘图区域。如果为 True,它们可能会在过于接近另一条流线时终止。

返回:
StreamplotSet

带有属性的容器对象

这个容器可能在将来会发生变化,以允许对颜色映射、透明度等进行更改,适用于线条和箭头,但这些更改应保持向后兼容。

注释

备注

这是 axes.Axes.streamplotpyplot 包装器

使用 matplotlib.pyplot.streamplot 的示例#

流线图

Streamplot