本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

StackedLineChart 属性

堆叠图的外观和行为

StackedLineChart 属性控制堆叠图的外观和行为。在堆叠图中,您可以在垂直层叠的单独 y 轴中绘制表或时间表的变量或矩阵的列。通过更改属性值,您可以修改堆叠图的特定方面。

您可以使用圆点表示法查询和设置属性。

T = readtable('outages.csv');
s = stackedplot(T);
c = s.Color;
s.Color = 'red';

表数据

全部展开

源表,以表或时间表的形式指定。

您可以使用 table 函数根据工作区变量创建表,也可以使用 readtable 函数以表的形式导入数据。您可以使用 timetable 函数根据工作区变量创建时间表。

注意

当绘制的数据来自数组时,该属性将被忽略并且为只读。

数组数据

全部展开

x 值,指定为向量。向量中的元素数必须等于 YData 属性值中的行数。

注意

当绘制的数据来自表或时间表时,该属性将被忽略并且为只读。

示例: [1:10]

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

y 值,指定为数组。stackedplot 函数在其自己的 y 轴中绘制 YData 值的每列。

注意

当绘制的数据来自表或时间表时,该属性将被忽略并且为只读。

示例: [1:10;5:5:50]

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

堆叠图显示

全部展开

显示的变量,指定为字符向量、字符向量元胞数组、字符串数组、字符串数组、数值数组或逻辑数组。通过设置此属性,您可以绘制输入表或时间表中变量的子集或变量的置换。

如果 DisplayVariables 是元胞数组,它也可以是嵌套的元胞数组。stackedplot 函数在同一 y 轴中绘制嵌套元胞中指定的所有变量。

示例: s.DisplayVariables = [1 3 4] 指定第一个、第三个和第四个变量。

示例: s.DisplayVariables = {{'Temp1','Temp2'},'Pressure'} 使用嵌套元胞数组指定 Temp1Temp2 一起绘制。

示例: s.DisplayVariables = {{1,2},5} 按数字指定变量,并将第一个和第二个变量一起绘制。

层叠的 y 轴上值的标签,指定为字符向量元胞数组或字符串数组。为 DisplayVariables 中的每个值指定一个标签。默认情况下,这些值与 DisplayVariables 中的值相同。

如果您在 DisplayVariables 中添加值、删除值或重新排列值,此属性将相应地更新,以维护值与标签的配对。

示例: s.DisplayLabels = {'Temperature','Humidity','Pressure'}

x 轴的表变量,以下列形式之一指定:

  • 表示一个表变量名称的字符向量或字符串

  • 指示一个表变量的索引的数值标量

  • 包含一个 true 元素的逻辑向量。

注意

当绘制的数据来自数组或时间表时,该属性将被忽略并且为只读。

最小和最大 x 坐标轴范围,指定为 [min max] 形式的二元素向量,其中 max 大于 min。您可以将范围指定为数字、分类、日期时间或持续时间值。但您指定的值类型必须与坐标轴上的值类型匹配。

您可以指定这两个范围,也可以指定一个范围而让坐标区自动计算另一个范围。对于自动计算的最小值或最小值范围,分别使用 -infinf 来表示。

示例: s.XLimits = [0 100]

示例: s.XLimits = [-inf 100]

示例: s.XLimits = [0 inf]

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration

y 轴的属性,指定为 StackedAxesProperties 对象的数组。您可以对 AxesProperties 进行索引以更改堆叠图中一个变量的 y 轴属性。有关详细信息,请参阅StackedAxesProperties 属性

示例: s.AxesProperties(2).YLimits = [0 10] 指定堆叠图中第二个绘图的范围。其他绘图不变。

线条的属性,指定为 StackedLineProperties 对象的数组。您可以对 LineProperties 进行索引以更改堆叠图中一个变量的线条属性。有关详细信息,请参阅StackedLineProperties 属性

示例: s.LineProperties(3).Color = 'red' 更改堆叠图中第三个绘图的线条颜色。其他绘图不变。

网格线的显示,指定为 'on''off'

线条

全部展开

线条颜色,指定为 RGB 三元组、十六进制颜色代码或第一个表中列出的颜色选项之一。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#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'不适用不适用不适用无颜色

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

线型,指定为下表中列出的选项之一。

线型说明表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

标记

全部展开

标记符号,指定为下表中列出的值之一。默认情况下,对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。

说明
'o'圆圈
'+'加号
'*'星号
'.'
'x'叉号
'square''s'方形
'diamond''d'菱形
'^'上三角
'v'下三角
'>'右三角
'<'左三角
'pentagram''p'五角星(五角形)
'hexagram''h'六角星(六角形)
'none'无标记

标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。

标记轮廓颜色,指定为 'none'、RGB 三元组、十六进制颜色代码或第一个表中列出的颜色选项之一。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#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'不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

示例: [0.5 0.5 0.5]

示例: 'blue'

示例: '#D2F9A7'

标记填充颜色,指定为 'none'、RGB 三元组、十六进制颜色代码或第一个表中列出的颜色选项之一。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#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'不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

示例: [0.3 0.2 0.1]

示例: 'green'

示例: '#D2F9A7'

字体

全部展开

字体名称,指定为支持的字体名称或 'FixedWidth'。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 'FixedWidth'。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

字体大小,指定为数值标量。字体大小会影响标题、轴标签和刻度标签。它还会影响与轴相关联的任何图例。字体大小以磅为单位进行测量。

示例: s.FontSize = 12

标签

全部展开

堆叠图的标题,指定为字符向量、字符串标量、数值标量、字符串数组、数值数组、元胞数组或分类数组。

如果 Title 的值是数组,则该数组的元素将垂直堆叠并显示为标题。如果值是元胞数组,则其元素可以是字符向量、字符串或数字。

也可以使用 title 函数添加标题。

title('My Title')

示例: s.Title = 'A Title';

示例: s.Title = 137

示例: s.Title = {'Stacked plot',char(datetime('now'))};

示例: s.Title = {'Stacked plot',137};

x 轴标签的文本,指定为字符向量、字符串标量、数值标量、字符串数组、数值数组、元胞数组或分类数组。

如果 XLabel 的值是数组,则该数组的元素将垂直堆叠并显示为 x 轴标签。如果值是元胞数组,则其元素可以是字符向量、字符串或数字。

也可以使用 xlabel 函数添加 x 轴标签。

xlabel('My x-Axis Label')

示例: s.XLabel = 'An x-axis Label';

示例: s.XLabel = 137

示例: s.XLabel = {'An x-axis Label',char(datetime('now'))};

示例: s.XLabel = {'An x-axis Label',137};

位置

全部展开

大小和位置,包括标签和边距,指定为 [left bottom width height] 形式的四元素向量。默认情况下,MATLAB 按照归一化的容器单位来测量值。要更改单位,请设置 Units 属性。[0 0 1 1] 的默认值包括容器的整个内部。

  • leftbottom 元素定义从容器(通常为图窗、面板或选项卡)左下角到外部位置边界左下角之间的距离。

  • widthheight 元素是外边界尺寸。

下图显示由 OuterPosition 值(蓝色)和 Position 值(红色)定义的区域。

二维坐标区视图三维坐标区视图

有关坐标区位置的详细信息,请参阅控制坐标区布局

绘图在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,指定为 [left bottom width height] 形式的四元素向量。内部位置不包括标题和轴标签。

  • leftbottom 元素定义容器左下角到绘图左下角的距离。

  • widthheight 元素是维度。

大小和位置,不包括标签边距,指定为 [left bottom width height] 形式的四元素向量。默认情况下,MATLAB 按照归一化的容器单位来测量值。要更改单位,请设置 Units 属性。

  • leftbottom 元素定义从容器(通常为图窗、面板或选项卡)左下角到位置边界左下角之间的距离。

  • widthheight 元素是位置边界维度。对于三维视图中的坐标区,Position 属性是包围坐标区的最小矩形。

如果要指定位置并考虑让文本围绕坐标区,请改为设置 OuterPosition 属性。下图显示由 OuterPosition 值(蓝色)和 Position 值(红色)定义的区域。

二维坐标区视图三维坐标区视图

有关坐标区位置的详细信息,请参阅控制坐标区布局

大小调整操作期间的活动位置属性,指定为下列值之一:

  • 'outerposition' - 保存 OuterPosition 属性常量。

  • 'innerposition' - 保存 InnerPosition 属性常量。

  • 'position' - 保存 Position 属性常量。

如果您以交互方式或者在打印或导出操作过程中调整图窗的大小,可能会改变图窗的大小。

位置单位,指定为下列值之一:

Units说明
'normalized'(默认值)根据容器进行归一化,容器通常是图窗或面板。容器的左下角映射到 (0,0),右上角映射到 (1,1)
'inches'英寸。
'centimeters'厘米。
'characters'

基于图形根对象的默认 uicontrol 字体:

  • 字符宽度 = 字母 x 的宽度。

  • 字符高度 = 两个文本行的基线之间的距离。

'points'字体磅数。一磅等于 1/72 英寸。
'pixels'

像素。

从 R2015b 开始,以像素为单位的距离不再依赖 Windows®Macintosh 系统上的系统分辨率。

  • 在 Windows 系统上,一个像素是 1/96 英寸。

  • Macintosh 系统上,一个像素是 1/72 英寸。

  • 在 Linux® 系统上,一个像素的大小由系统分辨率确定。

在对象创建过程中将单位指定为 Name,Value 对组时,您必须先设置 Units 属性,然后再指定要使用这些单位的属性(如 Position)。

交互性

全部展开

可见性状态,指定为下列值之一:

  • 'on' - 显示对象。

  • 'off' - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

父级/子级

全部展开

父级,指定为 FigurePanelTab 对象。有关详细信息,请参阅 Figure 属性Panel 属性Tab 属性

父级的 Children 属性中对象句柄的可见性,指定为下列值之一:

  • 'on' - 对象句柄始终可见。

  • 'off' - 对象句柄始终不可见。该选项用于防止另一函数无意中对 UI 进行更改。将 HandleVisibility 设置为 'off' 可在执行该函数时暂时隐藏句柄。

  • 'callback' - 对象句柄在回调或回调所调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止通过命令行访问对象,但允许回调函数访问对象。

如果父级的 Children 属性中未列出该对象,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。此类函数的示例包括 getfindobjgcagcfgconewplotclaclfclose 函数。

隐藏的对象句柄仍有效。将根 ShowHiddenHandles 属性设置为 'on' 以列出所有对象句柄,而不管其 HandleVisibility 属性设置如何。

在 R2018b 中推出