主要内容

ScatterHistogramChart属性

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

自从R2018b

ScatterHistogramChart控件的外观和行为ScatterHistogramChart对象。通过更改属性值,可以修改图表显示的某些方面。例如,你可以添加一个标题:

S =散点直方图(rand(10,1),rand(10,1));s.Title =“我的名字”

标签

全部展开

图表标题,指定为字符向量、字符串数组、字符向量的单元格数组或分类数组。默认图表没有标题。

若要创建多行标题,请指定字符向量的字符串数组或单元格数组。数组中的每个元素都对应于一行文本。

如果将标题指定为分类数组,MATLAB®使用数组中的值,而不是类别。

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

例子:s.Title =“我的标题文本”

例子:s.Title = {'My','Title'}

标签x-axis,指定为字符向量、字符串数组、字符向量的单元格数组或分类数组。使用没有标签。

若要创建多行标签,请指定字符向量的字符串数组或单元格数组。数组中的每个元素都对应于一行文本。

如果将标签指定为分类数组,MATLAB将使用数组中的值,而不是类别。

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

例子:s.XLabel = '我的标签'

例子:s.XLabel = {'My','Label'}

标签y-axis,指定为字符向量、字符串数组、字符向量的单元格数组或分类数组。使用没有标签。

若要创建多行标签,请指定字符向量的字符串数组或单元格数组。数组中的每个元素都对应于一行文本。

如果将标签指定为分类数组,MATLAB将使用数组中的值,而不是类别。

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

例子:s.YLabel =“我的标签”

例子:s.YLabel = {'My','Label'}

图例标题,指定为字符向量、字符串数组、字符向量的单元格数组或分类数组。使用没有头衔。

若要创建多行标题,请指定字符向量的字符串数组或单元格数组。数组中的每个元素都对应于一行文本。

如果将标题指定为分类数组,MATLAB将使用数组中的值,而不是类别。

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

例子:s.LegendTitle = '我的标题文本'

例子:s.llegendtitle = {'My','Title'}

柱状图

全部展开

直方图容器的数量,指定为正整数标量、2乘1的正整数向量或2乘-n正整数矩阵,其中n分组的数量是多少GroupData

指定值 描述
标量 对象的垃圾箱数量x而且y直方图。
2×1的向量 第一个值是容器的数量x数据,第二个值是容器的数量y数据。
2 -n矩阵 (j)的直方图的箱数x中的数据j集团。类似地,(j)的直方图的箱数y中的数据j集团。

scatterhistogram使用“BinMethod”、“汽车”的名称-值对参数柱状图要确定默认值NumBins而且BinWidths值。

你无法改变NumBins对于分类数据。

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

例子:s.NumBins = [10;15)

直方图容器宽度,指定为正标量、2乘1的正向量或2乘-n正矩阵,其中n分组的数量是多少GroupData

指定值 描述
标量 对象的bin宽度x而且y直方图。
2×1的向量 的容器宽度x数据,第二个值是y数据。
2 -n矩阵 (j)的直方图的仓宽度x中的数据j集团。类似地,(j)的直方图的仓宽度y中的数据j集团。

scatterhistogram使用“BinMethod”、“汽车”的名称-值对参数柱状图要确定默认值NumBins而且BinWidths值。的BinWidths类别数据的值总是0

如果你设置BinWidths,然后scatterhistogram忽略了NumBins价值。

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

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

方向x数据直方图,指定为“了”“下来”.如果XHistogramDirection值是“了”,则x数据直方图有向上的条形。如果XHistogramDirection值是“下来”,则x数据直方图有向下的条形。

例子:s = scatterhistogram(__,'XHistogramDirection','向下')

例子:s.XHistogramDirection = '向下'

方向y数据直方图,指定为“对”“左”.如果YHistogramDirection值是“对”,则y数据直方图有向右的条形。如果YHistogramDirection值是“左”,则y数据直方图有向左的条形。

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

例子:s.YHistogramDirection = '左'

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

显示风格 描述
“楼梯” 显示阶梯图,显示直方图的轮廓而不填充柱状条。
“酒吧” 显示直方图条形图。
“顺利” 显示通过核密度估计生成的平滑图。此选项需要统计和机器学习工具箱™许可证。

scatterhistogram使用“pdf”用于生成直方图的归一化类型。有关更多信息,请参见“归一化”的名称-值对参数柱状图

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

例子:s.HistogramDisplayStyle = 'bar'

直方图线条样式,以下列形式之一指定:

  • 指定一种线条样式的字符向量

  • 字符向量的字符串数组或单元格数组,表示一种或多种行样式

在这些线条样式选项中进行选择。

线条样式 描述 产生的线
“-” 实线

实线样本

”——“ 虚线

虚线样本

”:“ 虚线

虚线样本

“-”。 Dash-dotted线

虚线样例,虚线和点交替使用

“没有” 没有线 没有线

当组的总数超过指定的行样式的数量时,scatterhistogram循环指定的行样式。

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

例子:s.l enestyle = {':','-','-.'}

直方图线宽,用正标量或正向量表示。默认情况下,scatterhistogram的线宽0.5到每个直方图线图。

当组的总数超过指定的行宽时,scatterhistogram循环指定的行宽。

例子:s =散点直方图(__,'LineWidth',0.75)

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

颜色和字体

全部展开

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

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

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

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

在这些预定义的颜色和它们等价的RGB三联中选择。

选项 描述 等效RGB三元组
“红色”“r” 红色的 [10 0 0]
“绿色”‘g’ 绿色 [0 10 0]
“蓝”“b” 蓝色的 [0 0 1]
“黄色”“y” 黄色的 [11 10 0]
“红色”“米” 品红色的 [10 0 1]
“青色”“c” 青色 [0 1 1]
“白色”' w ' 白色 [1 1 1]
“黑”“k” 黑色的 [0 0 0]

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

例子:s = scatterhistogram(__,“颜色”,{“蓝”、“绿色”、红'})

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

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

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

例子:s.FontName = 'Cambria'

字体大小,指定为标量值。字形大小标题、轴标签、图例标题和组名也是如此。默认字体大小取决于特定的操作系统和区域设置。

当你调整绘图元素的大小时,软件会自动更新字体大小。但是,更改字形大小属性禁用此自动调整大小。

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

例子:s.FontSize = 12

标记

全部展开

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

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

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

在这些标记选项中选择。

标记 描述 产生的标志
“o”

圆形记号笔样品

“+” 加号

加号标记的样本

“*” 星号

星号标记样本

“。”

点标样本

“x” 交叉

十字标记样本

“_” 水平线

水平线标记样本

“|” 垂直的线

垂直线标记的样本

“广场” 广场

方形记号笔样本

“钻石” 钻石

钻石线标记的样品

“^” Upward-pointing三角形

向上三角形标记的样本

“v” 向下的三角形

向下指向三角形标记的样本

“>” 三点三角形

右指向三角形标记的样本

" < " 只左向三角形

左指向三角形标记的样本

“五角星形” 五角星形

五角星记号笔样本

“卦” 六角星形

六芒标记的样本

“没有” 没有标记 不适用

默认情况下,scatterhistogram指定标记符号“o”散点图中的每一组。当组的总数超过指定符号的数量时,scatterhistogram循环指定的符号。

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

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

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

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

例子:s.MarkerSize = 40

标记面填充状态,指定为“上”“关闭”.如果MarkerFilled设置为“上”,然后scatterhistogram填充散点图中标记的内部。如果MarkerFilled设置为“关闭”,然后scatterhistogram将散点图标记的内部保留为空。

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

例子:s.MarkerFilled = 'off'

每个散点图组的标记透明度,指定为值在0到1之间的数值标量或数值向量。接近0的值指定更透明的标记,接近1的值指定更不透明的标记。默认情况下,scatterhistogram分配一个MarkerAlpha的价值1散点图上的所有标记。

例子:s =散点直方图(__,' markalpha ',0.75)

例子:s.m akeralpha = [0.2 0.7 0.4]

布局

全部展开

散点图的位置,指定为这些选项之一。

位置 描述
“西南” 在散点图的上方和右侧绘制直方图。
“东南” 在散点图的上方和左侧绘制直方图。
“东北” 在散点图的左边和下面绘制直方图。
“西北” 在散点图的下方和右侧绘制直方图。

例子:s = scatterhistogram(__,'ScatterPlotLocation','东北')

例子:s.ScatterPlotLocation = '东南'

散点图长度与总体图表长度的比值,指定为0到1之间的数值标量。的ScatterPlotProportion价值适用于两者x而且y轴。

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

例子:s.ScatterPlotProportion = 0.6

图例可见性的状态,指定为“上”“关闭”.集LegendVisible“上”显示图例或“关闭”隐藏传说。

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

在传说中,scatterhistogram中首次出现的顺序显示组名GroupData

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

例子:s.LegendVisible = 'off'

位置

全部展开

Position属性,在添加、删除或更改装饰时保持不变,指定为以下值之一:

  • “outerposition”- - -OuterPosition属性在添加、删除或更改标题或轴标签等装饰时保持不变。如果需要任何位置调整,MATLAB调整InnerPosition财产。

  • “innerposition”- - -InnerPosition属性在添加、删除或更改标题或轴标签等装饰时保持不变。如果需要任何位置调整,MATLAB调整OuterPosition财产。

这张图显示了innerposition而且outerposition定义ScatterHistogramChart

例子:s.PositionConstraint = 'outerposition'

请注意

类的父容器时,设置此属性无效TiledChartLayout

图表在父容器(通常是图形、面板或选项卡)中的内部大小和位置,指定为窗体的四元素数字向量[左下宽高].内部位置只包括散点图。

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

  • 宽度而且高度元素是散点图的维度。

有关说明,请参见PositionConstraint

请注意

类的父容器时,设置此属性无效TiledChartLayout

在父容器(通常是图形、面板或选项卡)内的完整散点直方图的外部大小和位置,指定为窗体的四元素数字向量[左下宽高].的默认值[0 0 1 1]包括容器的整个内部。

有关说明,请参见PositionConstraint

请注意

类的父容器时,设置此属性无效TiledChartLayout

图表在父容器(通常是图形、面板或选项卡)中的内部大小和位置,指定为窗体的四元素数字向量[左下宽高].这个属性等价于InnerPosition财产。

请注意

类的父容器时,设置此属性无效TiledChartLayout

定位单位,指定为这些值之一。

单位 描述
“归一化”(默认) 容器(通常是图形或面板)的规范化。容器的左下角映射到(0,0),右上角映射到(1,1)
“英寸” 英寸。
“厘米” 厘米。
“角色”

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

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

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

“点” 字体设计点。1分等于1/72英寸。
“像素”

像素。

从R2015b开始,以像素为单位的距离与Windows上的系统分辨率无关®而且麦金塔电脑系统:

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

  • 麦金塔电脑系统中,一个像素是1/72英寸。

在Linux上®在系统中,像素的大小是由系统分辨率决定的。

在对象创建期间将单位指定为名称-值对时,必须设置单位属性,然后再指定要使用这些单元的属性,例如OuterPosition

布局选项,指定为TiledChartLayoutOptionsGridLayoutOptions对象。当图表处于平铺图表布局或网格布局中时,此属性非常有用。

要在平铺图表布局的网格中定位图表,请设置瓷砖而且TileSpan属性TiledChartLayoutOptions对象。例如,考虑一个3 * 3平铺的图表布局。该布局在中心有一个瓷砖网格,沿外缘有四个瓷砖。在实践中,网格是不可见的,外部的瓷砖不会占用空间,直到您用轴或图表填充它们。

3 × 3平铺图表布局图。

这段代码放置图表c在网格的第三个贴图中。

c.Layout.Tile = 3;

要使图表跨越多个磁块,请指定TileSpan属性作为两元素向量。例如,这个图表跨越了2行和3.瓷砖的柱子。

c.Layout.TileSpan = [2 3];

要将图表放置在其中一个周围的磁贴中,请指定瓷砖财产“北”“南”“东”,或“西方”.例如,将值设置为“东”将图表放置在网格右侧的平铺图中。

c.Layout.Tile =“东”

要将图表放置到应用程序中的布局中,请将此属性指定为GridLayoutOptions对象。有关在应用程序中使用网格布局的更多信息,请参见uigridlayout

如果图表不是平铺图表布局或网格布局的子图(例如,如果它是图形或面板的子图),则此属性为空,不起作用。

对象可见性的状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”-显示ScatterHistogramChart对象。

  • “关闭”-隐藏ScatterHistogramChart对象而不删除它。你仍然可以访问一个无形的属性ScatterHistogramChart对象。

数据和限制

全部展开

源表,指定为表。

方法从工作区变量创建表表格方法将数据作为表导入readtable函数。

请注意

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

表变量为x-axis,以下列形式之一指定:

  • 字符向量或字符串标量,指示其中一个变量名

  • 数值标量,表示表变量索引

  • 包含1的逻辑向量真正的元素

与表变量相关联的值必须是数字类型或分类

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

请注意

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

例子:s.XVariable = '加速度'指定名为“加速”

表变量为y-axis,以下列形式之一指定:

  • 字符向量或字符串标量,指示其中一个变量名

  • 数值标量,表示表变量索引

  • 包含1的逻辑向量真正的元素

与表变量相关联的值必须是数字类型或分类

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

请注意

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

例子:s.YVariable = '马力'指定名为“马力”

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

  • 字符向量或字符串标量,指示其中一个变量名

  • 数值标量,表示表变量索引

  • 包含1的逻辑向量真正的元素

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

GroupVariable将数据拆分为XVariable而且YVariable分成不同的组。每个组在每个轴上都有一个默认颜色和一个独立的直方图。在传说中,scatterhistogram中首次出现的顺序显示组名GroupData

指定组变量时,MATLAB更新GroupData属性值。

请注意

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

例子:s.GroupVariable = 'Origin'

沿x-axis,指定为数字向量或分类数组。

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

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

沿y-axis,指定为数字向量或分类数组。

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

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

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

GroupData将数据拆分为XData而且YData分成不同的组。每个组在每个轴上都有一个默认颜色和一个独立的直方图。在传说中,scatterhistogram中首次出现的顺序显示组名GroupData

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

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

例子:s.GroupData ={“蓝”、“绿色”、“绿色”、“蓝”、“绿色”}

x-轴限制,指定为两元素数值向量或两元素分类向量。默认情况下,这些值派生自XData值。

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

例子:s.XLimits = [10 50]

y-轴限制,指定为两元素数值向量或两元素分类向量。默认情况下,这些值派生自YData值。

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

例子:s.YLimits = [10 50]

父/子

全部展开

父容器,指定为数字面板选项卡TiledChartLayout,或GridLayout对象。

对象句柄的可见性ScatterHistogramChart孩子们属性,指定为以下值之一:

  • “上”-对象句柄始终可见。

  • “关闭”-对象句柄总是不可见的。此选项对于防止另一个函数对UI的意外更改非常有用。要在函数执行期间暂时隐藏句柄,请设置HandleVisibility“关闭”

  • “回调”对象句柄在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行上访问对象,但允许回调函数访问它。

属性中未列出对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数不能返回该对象。这些函数包括得到findobjgcagcfgconewplotclf,关闭

隐藏对象句柄仍然有效。设置根目录ShowHiddenHandles财产“上”列出所有对象句柄,不管它们的HandleVisibility属性设置。

版本历史

在R2018b中引入

全部展开

另请参阅