您可以将标题、轴标签、图例和任意文本添加到现有绘图中。例如
x = -10:0.1:10;
plot (x, sin (x));
title ("sin(x) for x = -10:0.1:10");
xlabel ("x");
ylabel ("sin (x)");
text (pi, 0.7, "arbitrary text");
legend ("sin (x)");
函数grid和box也可以用于将网格和边界线添加到绘图中。默认情况下,栅格处于关闭状态,顺序行处于打开状态。
最后,可以使用annotation作用这些对象被绘制在一个不可见的轴上,在其他轴的顶部。
() ¶command ¶(str1, str2, …) ¶(charmat) ¶({cellstr}) ¶(…, property, value, …) ¶(hobjs, …) ¶("command") ¶(hax, …) ¶(hleg, …) ¶hleg = legend (…) ¶使用指定的字符串作为标签显示当前轴的图例。
图例分量可以指定为单个字符串参数、字符数组或字符串的元胞数组。标签名称可能与图例对象属性混淆时,或者command参数,应该通过将标签指定为字符串的元胞数组来保护标签。
如果第一个参数hax是一个轴句柄,然后向该轴添加图例,而不是从返回的当前轴gca.
如果第一个参数hleg是图例句柄,则对该图例而不是当前轴的图例进行操作。
图例标签与轴的子项相关联;第一个标签指定给在轴上绘制的第一个对象,第二个标签赋值给绘制的下一个对象,等等。要符号特定的数据对象,而不符号所有对象,请在输入中提供其图形句柄hobjs.
以下自定义项可使用command:
"show"在绘图上显示图例
"hide"隐藏绘图上的图例
"toggle"在之间切换"hide"和"show"
"boxon"在图例周围显示一个方框(默认值)
"boxoff"隐藏图例周围的框
"right"将标签文本放置在键的右侧(默认设置)
"left"将标签文本放置在键的左侧
"off"删除图例对象
这里的legend函数创建一个图形对象,该对象具有可以使用操作的各种属性get/set。或者,可以在调用时直接设置属性legend通过包括键/值对。如果使用此调用形式,则必须将标签指定为字符串的元胞数组。图形对象属性详细详见Graphics Object Properties.
以下是支持的图例对象属性的子集:
autoupdate: "off" | {"on"}控制将对象添加到对等轴(或从对等轴删除对象)时是否自动更新图例项的数量。例如
## Create a single plot with its legend.
figure ();
plot (1:10);
legend ("Slope 1");
## Add another plot and specify its displayname so that
## the legend is correctly updated.
hold on;
plot ((1:10) * 2, "displayname", "Slope 2");
## Stop automatic updates for further plots.
legend ("autoupdate", "off");
plot ((1:10) * 3);
box: "off" | {"on"}控制图例是否有环绕框。
location: "best" | "bestoutside" |"east"| "eastoutside"| "none"| "north"|{"northeast"} | "northeastoutside"|"northoutside"| "northwest"| "northwestoutside"|"south"| "southeast"| "southeastoutside"|"southoutside"| "southwest"| "southwestoutside"|"west"| "westoutside"控制图例的位置。
numcolumns: scalar interger, def. 1控制图例项布局中使用的列数。例如
figure ();
plot (rand (30));
legend ("numcolumns", 3);
背景numcolumns也迫使numcolumnsmode属性设置为"manual".
orientation: "horizontal" | {"vertical"}控制图例项是垂直排列(按列排列)还是水平排列(按行排列)。
string: string | cell array of strings图例项的标签列表。例如
figure (); plot (rand (20)); ## Let legend choose names automatically hl = legend (); ## Selectively change some names str = get (hl, "string"); str(1:5:end) = "Garbage"; set (hl, "string", str);
textcolor: colorspec, def. [0 0 0]控制图例项的文本字符串的颜色。
支持的图例特定属性的完整列表可在Legend Properties.
图例被实现为具有的附加轴对象tag属性设置为"legend"。图例对象的属性可以直接通过使用set.
可选输出值hleg是图例对象的句柄。
支持说明:图例标签文本在对的调用中提供legend或取自DisplayName图形对象的属性。只有数据对象(如线、补丁和曲面)才具有此属性,而轴、图形等则没有,因此它们永远不会出现在图例中。如果没有标签或DisplayName属性可用,则标签文本只是"data1", "data2", …,"dataN".
传说FontSize属性最初设置为轴的90%FontSize它连接到其上。使用set以在必要时覆盖它。
(x, y, string) ¶(x, y, z, string) ¶(…, prop, val, …) ¶(hax, …) ¶h = text (…) ¶使用文本创建文本对象string在位置x, y,(z)在当前轴上。
如果x, y, (z)arevectors。可以使用字符串的字符矩阵或元胞数组指定多个字符串。
可选的键/值对可用于控制文本的外观。
如果第一个参数hax是一个轴句柄,然后将文本添加到此轴,而不是从返回的当前轴gca.
可选返回值h是已创建文本对象的图形句柄的向量。
示例1:通过3种不同方法的多行文本
text (0.5, 0.8, {"Line 1", "Line 2"})
text (0.5, 0.6, ["Line 1"; "Line 2"])
text (0.5, 0.4, "Line 1\nLine 2")
示例2:多个位置的文本
text ([0.2, 0.2], [0.8, 0.6], "Same text at two locations")
text ([0.4, 0.4], [0.8, 0.6], {"Point 1 Text", "Point 2 text"})
text ([0.6, 0.6], [0.8, 0.6], {{"Point 1 Line 1", "Point 1 Line 2},
"Point 2 text"})
示例2:使用文本对象属性调整外观
ht = text (0.5, 0.5, "Hello World", "fontsize", 20); set (ht, "color", "red");
编程说明:属性的完整列表详见Text Properties.
元胞数组中的任何数字分量都将使用转换为文本sprintf ("%g")。为了更精确地控制外观,请使用将任何数字分量转换为字符串num2str, sprintf,等等,然后再调用text.
(string) ¶(string, property, val, …) ¶(hax, …) ¶h = xlabel (…) ¶指定用于符号当前轴的x轴的字符串。
的可选列表键/值对可以用于更改创建的文本标签的属性。
文本对象属性的完整列表详见Text Properties.
如果第一个参数hax是一个轴句柄,然后在该轴上操作,而不是在返回的当前轴上操作gca.
可选返回值h是创建的文本对象的图形句柄。
(string) ¶(string, property, val, …) ¶(hax, …) ¶h = ylabel (…) ¶指定用于符号当前轴的y轴的字符串。
如果hax则符号从定义的轴hax.
的可选列表键/值对可以用于更改创建的文本标签的属性。
文本对象属性的完整列表详见Text Properties.
如果第一个参数hax是一个轴句柄,然后在该轴上操作,而不是在返回的当前轴上操作gca.
可选返回值h是创建的文本对象的图形句柄。
(string) ¶(string, property, val, …) ¶(hax, …) ¶h = zlabel (…) ¶指定用于符号当前轴的z轴的字符串。
的可选列表键/值对可以用于更改创建的文本标签的属性。
文本对象属性的完整列表详见Text Properties.
如果第一个参数hax是一个轴句柄,然后在该轴上操作,而不是在返回的当前轴上操作gca.
可选返回值h是创建的文本对象的图形句柄。
(c, h) ¶(c, h, v) ¶(c, h, "manual") ¶(c) ¶(…, prop, val, …) ¶hlabels = clabel (…) ¶为等高线图的等高线添加标签。
轮廓级别从轮廓矩阵指定c从恢复contour, contourc, contourf和contour3。旋转等高线标签以匹配局部线方向,并以线为中心。标签沿行的位置是随机选择的。
如果参数h是等高线图对象的句柄,则符号此绘图,而不是从返回的当前轴中的那个gca.
默认情况下,会符号所有轮廓。但是,要符号的轮廓可以从向量指定v。如果"manual"参数,然后可以用鼠标选择要符号的轮廓。
可以提供作为文本对象的有效属性的附加键/值对,并将其传递给基础文本对象。此外,轮廓群属性"LabelSpacing"可用于确定要指定的轮廓上标签之间的间距。默认值为144点,即2英寸。
可选返回值hlabels是表示每个标签的文本对象的图形句柄的向量。这里的"userdata"文本对象的属性包含轮廓标签的数字值。
文本对象属性的完整列表详见Text Properties.
[c, h] = contour (peaks (), -4 : 6); clabel (c, h, -4:2:6, "fontsize", 12);
on ¶off ¶(hax, …) ¶控制轴边界的显示。
参数可能是"on"或"off"。如果它被禁用,则当前框状态被切换。
如果第一个参数hax是一个轴句柄,然后在此轴上操作,而不是从返回的当前轴gca.
on ¶off ¶minor ¶minor on ¶minor off ¶(hax, …) ¶控制打印轴线的显示。
函数状态输入可以是"on"或"off"如果省略,则切换当前电网状态。
当第一个参数为"minor"所有后续命令都会修改次要网格,而不是主要网格。
如果第一个参数hax是一个轴句柄,然后在该轴上操作,而不是在返回的当前轴上操作gca.
要控制单个轴的轴线,请使用set作用例如
set (gca, "ygrid", "on");
(…, loc) ¶(delete_option) ¶(hcb, …) ¶(hax, …) ¶(…, "peer", hax, …) ¶(…, "location", loc, …) ¶(…, prop, val, …) ¶h = colorbar (…) ¶将颜色条添加到当前轴。
颜色条显示当前颜色图以及数字规则,以便可以解释色标。
可选输入loc确定颜色栏的位置。如果存在,它必须是的最后一个参数colorbar。的有效值loc是
"EastOutside"将颜色栏放置在绘图外的右侧。这是默认设置。
"East"将颜色栏放置在绘图内的右侧。
"WestOutside"将颜色栏放置在绘图外部的左侧。
"West"将颜色栏放置在绘图的左侧。
"NorthOutside"将颜色栏放置在绘图上方。
"North"将颜色栏放置在绘图的顶部。
"SouthOutside"将颜色栏放在绘图下方。
"South"将颜色栏放置在绘图的底部。
要从绘图中删除颜色条,请使用以下任意一个关键字delete_option: "off", "delete", "hide".
如果第一个参数hax是一个轴句柄,则颜色条被添加到此轴,而不是从返回的当前轴gca。或者,如果参数"peer"则以下参数被视为添加颜色条的轴句柄。这里的"peer"调用语法将来可能会被删除,不推荐使用。
如果第一个参数hcb是一个颜色条对象的句柄,然后直接在此颜色条上操作。
其他键/值对直接传递给基础axesobject。完整的属性清单详见Axes Properties.
可选返回值h是createdcolorbar对象的图形句柄。
实现说明:使用"tag"属性设置为"colorbar"。createdobject具有额外的属性"location"其控制颜色条的位置。
详见: colormap.
(type) ¶("line", x, y) ¶("arrow", x, y) ¶("doublearrow", x, y) ¶("textarrow", x, y) ¶("textbox", pos) ¶("rectangle", pos) ¶("ellipse", pos) ¶(…, prop, val) ¶(hf, …) ¶h = annotation (…) ¶绘制注释以强调图形的各个部分。
您可以通过仅指定type注释的。
否则,可以选择注释的类型,然后使用x和y基于线的注释或变位向量的坐标pos为其他人。在任何一种情况下,都会使用"units"注释对象的属性。默认为"normalized",这意味着图形的左下角有坐标[0 0]和右上角[1 1]’.
如果第一个参数hf是一个图形句柄,然后绘制到此图形中,而不是返回的当前图形gcf.
可以以以下形式提供进一步的参数prop/valpair可自定义注释外观。
可选返回值h是createdannotation对象的图形句柄。这可以与一起使用set函数可自定义现有的注释对象。
所有注释对象共享两个属性:
"units":解释坐标的单位。"centimeters"| "characters"|"inches"| "{normalized}"| "pixels"|"points".
"position":四元素向量[x0-y0 width-height]。有效的注释类型及其特定属性如下所述:
"line"构造一条线。x和y必须是指定直线两端的x和y坐标的两个元素向量。
可以使用自定义行"linewidth", "linestyle"和"color"属性的方式与相同line物体。
"arrow"构造一个箭头。向量中的第二个点x和y指定箭头坐标。
除了线对象属性外,箭头还可以使用自定义"headlength", "headwidth"和"headstyle"属性。支持的值"headstyle"属性为:["diamond"| "ellipse"| "plain"|"rectangle"| "vback1"| "{vback2}"|"vback3"]
"doublearrow"构造一个双箭头。向量x和y指定箭头坐标。
线和箭头可以自定义为箭头标注,但某些属性名称是重复的:"head1length"/"head2length","head1width"/"head2width"等。索引1符号中第一个点的箭头的属性x和y协调。
"textarrow"在箭头的另一端构造一个文本标签的箭头。
使用"string"属性来更改文本字符串。线和箭头可以自定义为箭头批注,文本可以使用与相同的属性进行自定义text图形对象。但是,请注意,某些文本对象属性名称的前缀是“text”,以将其与箭头属性区分开来:"textbackgroundcolor", "textcolor","textedgecolor", "textlinewidth","textmargin", "textrotation".
"textbox"构造一个包含文本的框。pos指定"position"属性。
使用"string"属性来更改文本字符串。您可以使用"backgroundcolor", "edgecolor","linestyle"和"linewidth"属性来自定义框的背景颜色和边缘外观。一组有限的text对象属性也可用;此外"font…"属性,您也可以使用"horizontalalignment"和"verticalalignment"以将文本定位在框内。
最后"fitboxtotext"属性控制长方体的实际范围。如果"on"(默认情况下)框限值符合文本范围。
"rectangle"构造一个矩形。pos指定"position"注释的属性。
您可以使用"facecolor", "color", "linestyle"和"linewidth"属性来自定义矩形背景颜色和边缘外观。
"ellipse"构造一个椭圆。pos指定"position"注释的属性。
详见"rectangle"用于自定义的注释。
详见: xlabel, ylabel, zlabel, title, text, gtext, legend, colorbar.
版权所有 © 2024-2025 Octave中文网
ICP备案/许可证号：黑ICP备2024030411号-2