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, v二维数组
x 和 y 速度。行数和列数必须分别与 y 和 x 的长度匹配。
- 密度float 或 (float, float)
控制流线的紧密程度。当
density = 1
时,域被划分为一个 30x30 的网格。density 线性地缩放这个网格。网格中的每个单元格最多可以有一条穿过的流线。对于每个方向的不同密度,使用元组 (density_x, density_y)。- 行宽浮点数或二维数组
流线的宽度。使用二维数组可以在网格上改变线宽。该数组必须与 u 和 v 具有相同的形状。
- 颜色 : color 或 2D 数组颜色或二维数组
流线颜色。如果给定一个数组,其值将使用 cmap 和 norm 转换为颜色。该数组必须与 u 和 v 具有相同的形状。
- cmap, norm
数据归一化和颜色映射参数用于 color;仅在 color 是浮点数数组时使用。详细描述请参见
imshow
。- arrowsizefloat
箭头大小的缩放因子。
- arrowstylestr
箭头样式规范。参见
FancyArrowPatch
。- 最小长度float
流线在轴坐标中的最小长度。
- 起点(N, 2) 数组
流线起点的坐标,以数据坐标表示(与 x 和 y 数组相同的坐标)。
- zorderfloat
流线和箭头的 zorder。zorder 值较低的艺术家会先绘制。
- maxlengthfloat
流线在轴坐标中的最大长度。
- 集成方向{'forward', 'backward', 'both'}, 默认: 'both'
在正向、反向或双向中集成流线。
- 数据可索引对象,可选
如果给出,以下参数也接受一个字符串
s
,如果s
是data
中的一个键,则解释为data[s]
:x, y, u, v, start_points
- broken_streamlines布尔值,默认:True
如果为 False,强制流线继续延伸直到它们离开绘图区域。如果为 True,当它们过于接近另一条流线时,可能会终止。
- 返回:
- StreamplotSet
带有属性的容器对象
lines
:LineCollection
的流线arrows
: 包含FancyArrowPatch
对象的PatchCollection
,表示沿流线中点的箭头。
这个容器可能在将来会发生变化,以允许对颜色映射、透明度等进行更改,适用于线条和箭头,但这些更改应保持向后兼容。