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

ScatterHistogramChart 属性

控制散点直方图的外观和行为

ScatterHistogramChart 属性可控制 ScatterHistogramChart 对象的外观和行为。通过更改属性值,您可以修改图显示的特定方面。例如,您可以添加标题:

s = scatterhistogram(rand(10,1),rand(10,1));
s.Title = 'My Title';

标签

全部展开

图标题,指定为字符向量或字符串标量。默认图没有标题。

示例: s = scatterhistogram(__,'Title','My Title Text')

示例: s.Title = 'My Title Text'

x 轴的标签,指定为字符向量或字符串标量。使用 '' 表示没有标签。

示例: s = scatterhistogram(__,'XLabel','My Label')

示例: s.XLabel = 'My Label'

y 轴的标签,指定为字符向量或字符串标量。使用 '' 表示没有标签。

示例: s = scatterhistogram(__,'YLabel','My Label')

示例: s.YLabel = 'My Label'

图例标题,指定为字符向量或字符串标量。使用 '' 表示没有标题。

示例: s = scatterhistogram(__,'LegendTitle','My Title Text')

示例: s.LegendTitle = 'My Title Text'

直方图

全部展开

直方图 bin 数量,指定为正整数标量、2×1 正整数向量或 2×n 正整数矩阵,其中 n 为 GroupData 中的组数。

指定的值说明
标量该值是 x 和 y 直方图的 bin 数量。
2×1 向量第一个值是 x 数据的 bin 数量,第二个值是 y 数据的 bin 数量。
2×n 矩阵(1,j) 值是第 j 个组中 x 数据的直方图的 bin 数量。同样,(2,j) 值是第 j 个组中 y 数据的直方图的 bin 数量。

scatterhistogram 使用 histogram'BinMethod','auto' 名称-值对组参数来确定默认 NumBinsBinWidths 值。

您不能更改分类数据的 NumBins

示例: s = scatterhistogram(__,'NumBins',20)

示例: s.NumBins = [10; 15]

直方图 bin 宽度,指定为正标量、2×1 正向量或 2×n 正矩阵,其中 n 是 GroupData 中组的数量。

指定的值说明
标量该值是 x 和 y 直方图的 bin 宽度。
2×1 向量第一个值是 x 数据的 bin 宽度,第二个值是 y 数据的 bin 宽度。
2×n 矩阵(1,j) 值是第 j 个组中 x 数据的直方图的 bin 宽度。同样,(2,j) 值是第 j 个组中 y 数据的直方图的 bin 宽度。

scatterhistogram 使用 histogram'BinMethod','auto' 名称-值对组参数来确定默认 NumBinsBinWidths 值。分类数据的 BinWidths 值始终为 0

如果设置 BinWidths,则 scatterhistogram 将忽略 NumBins 值。

示例: s = scatterhistogram(__,'BinWidths',0.5)

示例: s.BinWidths = [1.5; 2]

x 数据直方图的方向,指定为 'up''down'。如果 XHistogramDirection 值为 'up',则 x 数据直方图的条形向上。如果 XHistogramDirection 值为 'down',则 x 数据直方图的条形向下。

示例: s = scatterhistogram(__,'XHistogramDirection','down')

示例: s.XHistogramDirection = 'down'

y 数据直方图的方向,指定为 'right''left'。如果 YHistogramDirection 值为 'right',则 y 数据直方图的条形向右。如果 YHistogramDirection 值为 'left',则 y 数据直方图的条形向左。

示例: s = scatterhistogram(__,'YHistogramDirection','left')

示例: s.YHistogramDirection = 'left'

直方图显示样式,指定为下列选项之一。

显示样式说明
'stairs'显示阶梯图,该图显示直方图的轮廓而不填充条形。
'bar'显示直方条形图。
'smooth'显示通过核密度估计值生成的平滑图。此选项需要 Statistics and Machine Learning Toolbox™ 许可证。

scatterhistogram 使用 'pdf' 归一化类型来生成直方图。有关详细信息,请参阅 histogram'Normalization' 名称-值对组参数。

示例: s = scatterhistogram(__,'HistogramDisplayStyle','smooth')

示例: s.HistogramDisplayStyle = 'bar'

直方图线型,指定为下列形式之一:

  • 指定一种线型的字符向量

  • 指定一个或多个线型的字符串数组或字符向量元胞数组

从这些线型选项中进行选择。

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

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

当组的总数超过指定的线型数量时,scatterhistogram 将循环使用指定的线型。

示例: s = scatterhistogram(__,'LineStyle',':')

示例: s.LineStyle = {':','-','-.'}

直方图线宽,指定为正标量或正向量,以磅为单位。默认情况下,scatterhistogram 为直方图中的每个线条指定 0.5 的线宽。

当组的总数超过指定的线宽数量时,scatterhistogram 将循环使用指定的线宽。

示例: s = scatterhistogram(__,'LineWidth',0.75)

示例: s.LineWidth = [0.5 0.75 0.5]

颜色和字体

全部展开

组颜色,指定为下列形式之一:

  • 指定颜色名称的字符向量。

  • 指定一个或多个颜色名称的字符串数组或字符向量元胞数组。

  • 范围 [0,1] 内的 RGB 值的三列矩阵。三列分别代表 R 值、G 值和 B 值。

在这些预定义颜色及其等效的 RGB 三元组中进行选择。

选项说明对应的 RGB 三元组
'red''r'红色[1 0 0]
'green''g'绿色[0 1 0]
'blue''b'蓝色[0 0 1]
'yellow''y'黄色[1 1 0]
'magenta''m'品红色[1 0 1]
'cyan''c'青蓝色[0 1 1]
'white''w'白色[1 1 1]
'black''k'黑色[0 0 0]

默认情况下,scatterhistogram 最多分配七种唯一的组颜色。当组的总数超过指定的颜色数量时,scatterhistogram 将循环使用指定的颜色。

示例: s = scatterhistogram(__,'Color',{'blue','green',red'})

示例: s.Color = [0 0 1; 0 0.5 0.5; 0.5 0.5 0.5]

字体名称,指定为系统支持的一种字体名称。标题、轴标签、图例标题和组名称使用相同的字体。默认字体取决于具体操作系统和区域设置。

示例: s = scatterhistogram(__,'FontName','Cambria')

示例: s.FontName = 'Cambria'

字体大小,指定为标量值。FontSize 对于标题、轴标签、图例标题和组名称是相同的。默认字体大小取决于具体操作系统和区域设置。

当您调整绘图元素的大小时,软件会自动更新字体大小。但是,更改 FontSize 属性会禁用这一自动调整大小功能。

示例: s = scatterhistogram(__,'FontSize',12)

示例: s.FontSize = 12

标记

全部展开

每个散点图组的标记符号,指定为下列形式之一:

  • 指定标记样式的字符向量

  • 指定一个或多个标记样式的字符串数组或字符向量元胞数组

从这些标记选项中进行选择。

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

默认情况下,scatterhistogram 为散点图中的每个组指定标记符号 'o'。当组的总数超过指定的符号数量时,scatterhistogram 将循环使用指定的符号。

示例: s = scatterhistogram(__,'MarkerStyle','x')

示例: s.MarkerStyle = {'x','o'}

每个散点图组的标记大小,指定为非负标量或非负向量,其值以磅为单位。默认情况下,scatterhistogram 将散点图中每个组的标记大小指定为 36。当组的总数超过指定的值数量时,scatterhistogram 将循环使用指定的值。

示例: s = scatterhistogram(__,'MarkerSize',30)

示例: s.MarkerSize = 40

标记面的填充状态,指定为 'on''off'。如果 MarkerFilled 设置为 'on',则 scatterhistogram 将填充散点图中标记的内部。如果 MarkerFilled 设置为 'off',则 scatterhistogram 会保留散点图标记的内部为空。

示例: s = scatterhistogram(__,'MarkerFilled','off')

示例: s.MarkerFilled = 'off'

每个散点图组的标记透明度,指定为数值标量或数值向量,值介于 0 和 1 之间。值越接近 0,指定的标记越透明,值越接近 1,指定的标记越不透明。默认情况下,scatterhistogram 为散点图中的所有标记指定 1 作为 MarkerAlpha 值。

示例: s = scatterhistogram(__,'MarkerAlpha',0.75)

示例: s.MarkerAlpha = [0.2 0.7 0.4]

布局

全部展开

散点图的位置,指定为以下选项之一。

位置说明
'SouthWest'在散点图的右上方绘制直方图。
'SouthEast'在散点图的左上方绘制直方图。
'NorthEast'在散点图的左下方绘制直方图。
'NorthWest'在散点图的右下方绘制直方图。

示例: s = scatterhistogram(__,'ScatterPlotLocation','NorthEast')

示例: s.ScatterPlotLocation = 'SouthEast'

散点图长度与整体图长度的比率,指定为 0 和 1 之间的数值标量。ScatterPlotProportion 值同时应用于 xy 轴。

示例: s = scatterhistogram(__,'ScatterPlotProportion',0.7)

示例: s.ScatterPlotProportion = 0.6

图例可见性的状态,指定为 'on''off'。将 LegendVisible 设置为 'on' 会显示图例,设置为 'off' 会隐藏图例。

如果 GroupData 为空 ([]) 或只包含一个组,则 scatterhistogram 不显示图例。否则,scatterhistogram 默认显示图例,除非图例与散点图或边缘直方图重叠。

在图例中,scatterhistogram 按照组在 GroupData 中首次出现的顺序显示其组名称。

示例: s = scatterhistogram(__,'LegendVisible','on')

示例: s.LegendVisible = 'off'

位置

全部展开

在进行调整大小的操作时保持不变的位置属性,指定为 'outerposition''innerposition'。默认值 'outerposition' 表示 OuterPosition 属性保持不变。当父容器的大小、数据或标签改变时,InnerPosition 属性值可能会改变。

以下图窗显示 ScatterHistogramChartinnerpositionouterposition 定义。

示例: s.ActivePositionProperty = 'outerposition'

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

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

  • widthheight 元素是散点图的维度。

有关说明,请参阅ActivePositionProperty

完整散点直方图在父容器(通常为图窗、面板或选项卡)中的外部大小和位置,指定为 [left bottom width height] 形式的四元素数值向量。[0 0 1 1] 的默认值包括容器的整个内部。

有关说明,请参阅ActivePositionProperty

图在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,指定为 [left bottom width height] 形式的四元素数值向量。此属性等同于 InnerPosition 属性。

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

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® 系统上,一个像素的大小由系统分辨率确定。

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

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

  • 'on' - 显示 ScatterHistogramChart 对象。

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

数据和范围

全部展开

源表,指定为表。

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

注意

使用数组而不是表格数据时,该属性将被忽略并且为只读。

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

  • 指示变量名称之一的字符向量或字符串标量。

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

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

与表变量关联的值必须为数值类型或 categorical 类型。

如果设置 XVariable 属性值,则 XData 属性将自动更新为合适的值。

注意

使用数组而不是表格数据时,该属性将被忽略并且为只读。

示例: s.XVariable = 'Acceleration' 指定名为 'Acceleration' 的变量。

y 轴的表变量,指定为下列形式之一:

  • 指示变量名称之一的字符向量或字符串标量。

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

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

与表变量关联的值必须为数值类型或 categorical 类型。

如果设置 YVariable 属性值,则 YData 属性将自动更新为合适的值。

注意

使用数组而不是表格数据时,该属性将被忽略并且为只读。

示例: s.YVariable = 'Horsepower' 指定名为 'Horsepower' 的变量。

用于对数据分组的表变量,指定为下列形式之一:

  • 指示变量名称之一的字符向量或字符串标量。

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

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

与表变量关联的值必须构成一个数值向量、逻辑向量、分类数组、字符串数组或字符向量元胞数组。

GroupVariableXVariableYVariable 中的数据拆分为具有唯一性的组。每个组在每个轴上都有默认颜色和独立的直方图。在图例中,scatterhistogram 按照组在 GroupData 中首次出现的顺序显示其组名称。

当您指定组变量时,MATLAB® 将更新 GroupData 属性值。

注意

使用数组而不是表格数据时,此属性将被忽略并且为只读。

示例: s.GroupVariable = 'Origin'

显示在 x 轴上的值,指定为数值向量或分类数组。

如果使用表格数据,则不能设置此属性。XData 值将根据您使用 XVariable 属性选择的表变量自动填充。

示例: s.XData = [0.5 4.3 2.4 5.6 3.4]

显示在 y 轴上的值,指定为数值向量或分类数组。

如果使用表格数据,则不能设置此属性。YData 值将根据您使用 YVariable 属性选择的表变量自动填充。

示例: s.YData = [0.5 4.3 2.4 5.6 3.4]

散点图和对应的边缘直方图的组值,指定为数值向量、逻辑向量、分类数组、字符串数组或字符向量元胞数组。

GroupDataXDataYData 中的数据拆分为具有唯一性的组。每个组在每个轴上都有默认颜色和独立的直方图。在图例中,scatterhistogram 按照组在 GroupData 中首次出现的顺序显示其组名称。

如果使用表格数据,则不能设置此属性。GroupData 值将根据您使用 GroupVariable 属性选择的表变量自动填充。

示例: s.GroupData = [1 2 1 3 2 1 3]

示例: s.GroupData = {'blue','green','green','blue','green'}

x 坐标轴范围,指定为二元素数值向量或二元素分类向量。默认情况下,这些值派生自 XData 值。

示例: s.XLimits = categorical({'blue','green'})

示例: s.XLimits = [10 50]

y 坐标轴范围,指定为二元素数值向量或二元素分类向量。默认情况下,这些值派生自 YData 值。

示例: s.YLimits = categorical({'blue','green'})

示例: s.YLimits = [10 50]

父级/子级

全部展开

父容器,指定为图窗、面板或选项卡对象。

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

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

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

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

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

隐藏的对象句柄仍有效。将根 ShowHiddenHandles 属性设置为 'on' 可以列出所有对象句柄,而不管它们的 HandleVisibility 属性设置是什么。

在 R2018b 中推出