文档

Binscatter属性

宾撒的外表和行为

Binscatter属性控制分箱散点图的外观和行为。通过更改属性值,可以修改显示的各个方面。使用点表示法来指代特定的对象和属性:

h = binscatter (randn (1100), randn (1100);N = h.NumBins h.NumBins = [3 3]

垃圾箱

全部展开

箱的数量,指定为标量或双元素向量(Nx纽约)

  • 如果NumBins指定为双元素向量(Nx纽约),然后binscatter使用Nx箱子的x维度和纽约箱子的y维度。

  • 如果NumBins指定为标量,那么Nx而且纽约都设置为标量值。

binscatter使用Nx而且纽约箱子的x而且y初始图中的尺寸,当坐标轴未放大时。(坐标轴没有放大XLimMode而且YLimMode属性都是“汽车”)。当缩放,binscatter调整箱的数量,以保持箱的大小,使图形的可见部分大致划分Nx——- - - - - -纽约箱里。

每个维度中的箱子的最大数量是250。默认箱数根据数据大小和标准差计算,不超过100。

例子:20 [10]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

容器数量的选择模式,指定为其中之一“汽车”“手动”.的默认值“汽车”,根据斯科特规则从数据中计算出箱子的数量,[3.5 *性病(X(:)) *元素个数(X) ^(1/4), 3.5 *性病(Y(:)) *元素个数(Y) ^ (1/4)

如果指定箱子的数量,则的值“NumBinsMode”被设置为“手动”

切换以显示空箱子,指定为两者之一“关闭”“上”.指定“上”在绘图图中,为落在箱子限制内但没有数据点的瓦片上色。

此属性是只读的。

本的边缘x-dimension,作为一个向量返回。

数据类型:||datetime|持续时间

此属性是只读的。

本的边缘y维度,作为向量返回。

数据类型:||datetime|持续时间

数据的限制x-dimension,指定为一个双元素向量[Xmin Xmax]

binscatter只显示在指定数据限制范围内的数据点,包括 X 最小值 X X 马克斯

例子:10 [0]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|datetime|持续时间

中数据限制的选择模式x维度,指定为“汽车”“手动”.默认值为“汽车”,使料仓的限制自动调整到数据沿x设在。

如果你显式指定XLimits,然后XLimitsMode自动设置为“手动”.在这种情况下,指定XLimitsMode作为“汽车”要重新调整数据的容器限制。

数据的限制y-dimension,指定为一个双元素向量[Ymin Ymax]

binscatter只显示在指定数据限制范围内的数据点,包括 Y 最小值 Y Y 马克斯

例子:10 [0]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|datetime|持续时间

中数据限制的选择模式y维度,指定为“汽车”“手动”.默认值为“汽车”,使料仓的限制自动调整到数据沿y设在。

如果你显式指定YLimits,然后YLimitsMode自动设置为“手动”.在这种情况下,指定YLimitsMode作为“汽车”要重新调整数据的容器限制。

数据

全部展开

x数据的坐标,指定为向量。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|datetime|持续时间

y数据的坐标,指定为向量。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|datetime|持续时间

此属性是只读的。

Bin值,作为双矩阵返回。的(i, j)th进入指定容器的容器计数x边是[XBinEdges(我),XBinEdges (i + 1)和谁的y边是[YBinEdges (j), YBinEdges (j + 1))

中不同编号的容器的容器包含方案,以及它们的相对方向x设在和y设在,

例如,(1,1)Bin包含位于每个维度第一个边上的值。右下方的最后一个容器包含落在其任何边上的值。

透明度

全部展开

瓷砖的透明度,指定为之间的标量值0而且1包容性。binscatter为所有贴图使用相同的透明度。的值1意思是完全不透明的0意思是完全透明(不可见)。

例子:binscatter (X, Y, FaceAlpha, 0.5)使用半透明的箱子创建一个箱子散点图。

传说

全部展开

图例使用的文本,指定为字符向量。文本出现在binscatter的图标旁边。

例子:的文本描述

对于多行文本,使用sprintf使用新的行字符\ n

例子:sprintf(1 \在线2行)

方法指定图例文本传说函数。

  • 方法的输入参数指定文本传说函数,则图例使用指定的文本并设置DisplayName属性设置为相同的值。

  • 方法的输入参数,则不指定文本传说函数,则图例使用DisplayName财产。的默认值。DisplayName是这些值之一。

    • 数字输入,DisplayName是一个字符向量,表示用于构造直方图的输入数据的变量名。如果输入数据没有变量名,则DisplayName是空的,

    • 对于分类数组输入,DisplayName是空的,

如果DisplayName属性不包含任何文本,则图例生成一个字符向量。字符向量有形式“dataN”,在那里N是根据binscatter对象在图例项列表中的位置分配给它的数字。

如果您交互式地编辑现有图例中的字符向量,那么MATLAB®更新DisplayName属性设置为已编辑的字符向量。

此属性是只读的。

控件,用于从图例中包含或排除对象,该对象作为注释对象。设置底层IconDisplayStyle属性设置为以下值之一:

  • “上”-在图例中包含对象(默认)。

  • “关闭”-图例中不包含该对象。

例如,从图例中排除茎图。

p =情节(1:10“DisplayName的”“折线图”);持有s =茎(1:10“DisplayName的”“茎图”);持有s.Annotation.LegendInformation.IconDisplayStyle =“关闭”;传奇(“显示”

控件控制图例中的项传说函数。将第一个输入参数指定为要包含的图形对象的向量。

p =情节(1:10“DisplayName的”“折线图”);持有s =茎(1:10“DisplayName的”“茎图”);持有传奇(p)

交互性

全部展开

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

  • “上”—显示对象。

  • “关闭”—隐藏对象,不删除对象。你仍然可以访问不可见对象的属性。

上下文菜单,指定为快捷菜单对象。使用此属性可在右键单击对象时显示上下文菜单。方法创建上下文菜单uicontextmenu函数。

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不会出现上下文菜单。

选择状态,指定为以下值之一:

  • “上”——选择。如果您在绘图编辑模式下单击对象,那么MATLAB将设置其选择财产“上”.如果SelectionHighlight属性也设置为“上”,然后MATLAB在对象周围显示选择句柄。

  • “关闭”——而不是选择。

选中时显示选择句柄,指定为以下值之一:

  • “上”-显示选择处理时选择属性设置为“上”

  • “关闭”-从不显示选择句柄,即使当选择属性设置为“上”

回调

全部展开

鼠标点击回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 字符向量,是有效的MATLAB命令或函数,在基本工作区中求值(不推荐)

在单击对象时,使用此属性执行代码。如果使用函数句柄指定此属性,那么MATLAB在执行回调函数时将传递两个参数给回调函数:

  • 被点击对象——从回调函数内部访问被点击对象的属性。

  • 事件数据-空参数。用波浪号字符(),以指示此参数未被使用。

有关如何使用函数句柄定义回调函数的更多信息,请参见回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不执行此回调。

创建回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 字符向量,是有效的MATLAB命令或函数,在基本工作区中求值(不推荐)

在创建对象时,使用此属性执行代码。MATLAB在创建对象并设置其所有属性后执行回调。设置CreateFcn属性对现有对象不起作用。要产生效果,必须指定CreateFcn属性。在对象创建期间指定属性的一种方法是设置对象的默认属性值。看到默认的属性值为更多的信息。

如果你使用函数句柄指定这个回调函数,那么MATLAB在执行回调函数时将传递两个参数给回调函数:

  • 已创建对象——从回调函数内部访问对象的属性。方法也可以访问对象CallbackObject属性,可以使用gcbo函数。

  • 事件数据-空参数。用波浪号字符(),以指示此参数未被使用。

有关如何使用函数句柄定义回调函数的更多信息,请参见回调函数定义

删除回调,指定为以下值之一:

  • 函数处理

  • 包含函数句柄和附加参数的单元格数组

  • 字符向量,是有效的MATLAB命令或函数,在基本工作区中求值(不推荐)

在删除对象时使用此属性执行代码,MATLAB在销毁对象之前执行回调,以便回调可以访问其属性值。

如果你使用函数句柄指定这个回调函数,那么MATLAB在执行回调函数时将传递两个参数给回调函数:

  • 删除对象-从回调函数内部访问对象的属性。方法也可以访问对象CallbackObject属性,可以使用gcbo函数。

  • 事件数据-空参数。用波浪号字符(),以指示此参数未被使用。

有关如何使用函数句柄定义回调函数的更多信息,请参见回调函数定义

回调执行控制

全部展开

回调中断,指定为“上”“关闭”.的可中断属性确定正在运行的回调是否可以中断。

请注意

考虑以下这些回调状态:

  • 运行回调是当前正在执行的回调。

  • 打断回调是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调将试图中断正在运行的回调。的可中断属性的属性确定是否允许中断。如果不允许中断,则BusyAction属性的属性确定是丢弃该中断回调还是将其放入队列中。

可中断属性确定另一个回调是否可以中断ButtonDownFcn回调的Binscatter对象。的可中断属性有两个值:

  • “上”——可中断。中断发生在MATLAB处理队列的下一个点。例如,当您有一个命令,例如drawnow数字getframe等待,或暂停

    • 如果正在运行的回调包含这些命令中的一个,那么MATLAB将在此时停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB继续执行正在运行的回调。有关更多信息,请参见中断执行回调

    • 如果正在运行的回调不包含这些命令中的任何一个,那么MATLAB将不中断地完成回调的执行。

  • “关闭”——而不是可中断。MATLAB完成了运行回调的执行,没有任何中断。

指定为“队列”“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。

考虑以下这些回调状态:

  • 运行回调是当前正在执行的回调。

  • 打断回调是一个试图中断正在运行的回调的回调。

每当MATLAB调用回调时,该回调将试图中断正在运行的回调。的可中断属性的属性确定是否允许中断。如果不允许中断,则BusyAction属性的属性确定是丢弃该中断回调还是将其放入队列中。

的回调函数Binscatter对象试图中断无法中断的正在运行的回调,则BusyAction属性确定它是被丢弃还是被放入队列。指定BusyAction属性作为以下值之一:

  • “队列”—将中断回调放在队列中,待正在运行的回调执行完毕后处理。(默认行为)

  • “取消”—丢弃中断回调。

捕捉鼠标点击的能力,指定为以下值之一:

  • “可见”-捕获鼠标点击仅当可见。的可见属性必须设置为“上”.的HitTest属性确定是否Binscatter对象对单击作出响应,或者如果父对象作出响应。

  • “没有”—无法捕获鼠标单击。单击Binscatter对象将单击传递给图形窗口当前视图中它后面的对象。的HitTest财产的Binscatter对象没有效果。

对捕获的鼠标单击的响应,指定为以下值之一:

  • “上”——触发ButtonDownFcn回调的Binscatter对象。如果您已经定义了UIContextMenu属性,然后调用上下文菜单。

  • “关闭”类的最近祖先触发回调Binscatter对象有:

    • HitTest属性设置为“上”

    • PickableParts属性设置为使祖先能够捕获鼠标单击的值。

请注意

PickableParts属性确定是否Binscatter对象可以捕获鼠标单击。如果不能,那么HitTest财产没有影响。

此属性是只读的。

删除状态,返回为“关闭”“上”.MATLAB设置BeingDeleted财产“上”当对象的delete函数开始执行时(参见DeleteFcn属性)。的BeingDeleted物业仍设为“上”直到对象不再存在。

的值BeingDeleted属性,如果需要在查询或修改对象之前验证该对象是否即将被删除。

父/子

全部展开

父类,指定为对象。

对象没有子对象。您不能设置此属性。

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

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

  • “关闭”对象句柄在任何时候都是不可见的。这个选项对于防止另一个函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在函数执行期间临时隐藏句柄。

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

中未列出的对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获得对象句柄的函数不能返回该属性。例如,当你有一个函数得到findobjgcagcfgconewplotclf,关闭

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

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“binscatter”.使用此属性可在绘图层次结构中查找给定类型的所有对象,例如搜索使用的类型findobj

标记来关联binscatter对象,指定为字符向量或字符串标量。

使用此属性查找binscatter层次结构中的对象。例如,您可以使用findobj函数来找到binscatter对象具有特定的标签属性值。

例子:“1月数据”

数据类型:字符

关联的用户数据binscatter对象,指定为任何MATLAB数据,例如标量、向量、矩阵、单元格数组、字符数组、表或结构。MATLAB不使用这些数据。

要关联多组数据或将字段名附加到数据,请使用getappdata而且setappdata功能。

例子:1:100

另请参阅

介绍了R2017b

这个话题有帮助吗?