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', *, data=None)[source]#

绘制矢量流的流线。

参数:
x, y一维/二维数组

用于生成网格的等间距严格递增数组。如果是二维数组，则 x 的所有行必须相等，*y* 的所有列必须相等；即，它们必须如同由 np.meshgrid(x_1d, y_1d) 生成。

u, v二维数组

*x* 和 *y* 方向的速度。行数和列数必须分别与 *y* 和 *x* 的长度匹配。

density浮点数或 (浮点数, 浮点数)

控制流线的密集程度。当 density = 1 时，域被划分为 30x30 的网格。*density* 会线性缩放此网格。网格中的每个单元格最多只能有一条穿过的流线。对于每个方向上不同的密度，请使用元组 (density_x, density_y)。

linewidth浮点数或二维数组

流线的宽度。使用二维数组时，线条宽度可以在网格上变化。数组的形状必须与 *u* 和 *v* 相同。

color颜色或二维数组

流线的颜色。如果给定一个数组，其值将使用 *cmap* 和 *norm* 转换为颜色。数组的形状必须与 *u* 和 *v* 相同。

cmap, norm

*color* 的数据归一化和颜色映射参数；仅当 *color* 是浮点数数组时使用。有关详细说明，请参阅 imshow。

arrowsize浮点数

箭头大小的缩放因子。

arrowstyle字符串

箭头样式规范。请参阅 FancyArrowPatch。

minlength浮点数

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

start_points(N, 2) 数组

流线起始点的数据坐标（与 *x* 和 *y* 数组相同的坐标）。

zorder浮点数

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

maxlength浮点数

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

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

沿向前、向后或两个方向积分流线。

data可索引对象，可选

如果给定，以下参数也接受字符串 s，如果 s 是 data 中的一个键，则将其解释为 data[s]

x, y, u, v, start_points

broken_streamlines布尔值，默认值: True

如果为 False，则强制流线继续直到它们离开绘图区域。如果为 True，如果它们离另一条流线太近，则可能会被终止。

返回:
StreamplotSet

具有以下属性的容器对象

此容器未来可能会更改，以允许更改线条和箭头的颜色映射、透明度等，但这些更改应向后兼容。

备注

注意

这是 pyplot 包装器，用于 axes.Axes.streamplot。

使用 matplotlib.pyplot.streamplot 的示例#

流线图

流线图
在此页