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)[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浮点数
流线和箭头的 Z 轴顺序。Z 轴顺序值较低的图形对象会先绘制。
- 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
带有属性的容器对象
lines
: 流线集合LineCollection
arrows
: 包含表示流线中途箭头的FancyArrowPatch
对象的PatchCollection
。
此容器未来可能会更改,以允许同时更改线条和箭头的颜色映射、透明度等,但这些更改应向后兼容。