streamline
基于二维或三维向量数据绘制流线图
语法
说明
streamline(___, 使用指定的选项绘制流线图，定义为一元素向量或二元素向量，其形式为 options)step 或 [step maxvert]，其中 step 是用于对向量数据进行插值的以数据单元表示的步长，maxvert 是流线图中顶点的最大数量。将此参量与上述语法中的任何输入参量组合一起使用。
streamline(___, 使用一个或多个名称-值参量设置流线图的属性。例如，您可以指定流线图的颜色和粗细。有关属性列表，请参阅 Line 属性。 (自 R2024b 起)Name=Value)
streamline( 在指定坐标区中而不是当前坐标区对象 (ax,___)gca) 中绘制流线图。
示例
加载 wind 数据集，其中包含北美地区的气流测量值。
三维数组
x、y和z表示气流测量值的位置。三维数组
u、v和w表示三维向量场中气流的速度。
定义 16 个假想粒子的起始位置。在本例中，粒子都从 x = 80 处开始，起始 y 位置的范围是从 20 到 50，起始 z 位置的范围是从 0 到 15。
load wind
[startX,startY,startZ] = meshgrid(80,20:10:50,0:5:15);在 startX、startY 和 startZ 中的起始位置集合处，计算放入气流中的一个假想粒子的三维流线图顶点数据。
verts = stream3(x,y,z,u,v,w,startX,startY,startZ);
用 streamline 可视化向量场的三维体。返回变量 lineobj 中的线条对象，以便以后可以更改其属性。
lineobj = streamline(verts); view(3)
要更改特定线条的各个方面，请对返回的线条对象之一设置属性。例如，将第十个线条的颜色更改为绿色，将其粗细更改为 3。
lineobj(10).Color = "g";
lineobj(10).LineWidth = 3;
加载 wind 数据集，其中包含北美地区的气流测量值。
三维数组
x和y表示气流测量值的位置。三维数组
u和v表示三维向量场中气流的速度。
使用数组的第五页。定义四个假想粒子的起始位置。在本例中，四个起始位置是 (80, 20)、(80, 30)、(80, 40) 和 (80, 50)。
load wind
x5 = x(:,:,5);
y5 = y(:,:,5);
u5 = u(:,:,5);
v5 = v(:,:,5);
[startX,startY] = meshgrid(80,20:10:50);用 stream2 计算放入气流中的假想粒子的二维流线图顶点数据。
verts = stream2(x5,y5,u5,v5,startX,startY);
通过调用 streamline 可视化二维向量场矩阵。返回变量 lineobj 中的线条对象，以便以后可以更改其属性。
lineobj = streamline(verts);
要更改特定线条的各个方面，请对返回的线条对象之一设置属性。例如，将第二个线条的颜色更改为品红色，将其线型更改为虚线。
lineobj(2).Color = "m"; lineobj(2).LineStyle = "--";
加载 wind 数据集并计算从平面 x = 80 上的等距点开始的流线图的顶点。然后，基于顶点数据绘制流线图。
load wind [startX,startY,startZ] = meshgrid(80,20:10:50,0:5:15); verts = stream3(x,y,z,u,v,w,startX,startY,startZ); streamline(verts) axis tight view(3);
输入参数
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。
示例: streamline(verts,LineWidth=2) 绘制一个线条粗细为两磅的流线图。
注意
此处所列的属性只是一部分。有关完整列表，请参阅 Line 属性。
线条颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]范围内，例如[0.4 0.6 0.7]。十六进制颜色代码是字符串标量或字符向量，以井号 (
#) 开头，后跟三个或六个十六进制数字，范围可以是0到F。这些值不区分大小写。因此，颜色代码"#FF8800"与"#ff8800"、"#F80"与"#f80"是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
线型，指定为下表中列出的选项之一。
| 线型 | 描述 | 表示的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
扩展功能
版本历史记录
在 R2006a 之前推出创建流线图时，MATLAB 会与大多数其他图一样自动分配颜色和线型。例如，用 streamline 创建的第一组线条现在采用柔和的蓝色。
要保留以前的版本的外观，请使用 set 函数将 Color 属性设置为 [0 0 1]。
lineobj = streamline(verts); set(lineobj,Color=[0 0 1])
