文档

散射特性

散点图的外观和行为

散射的外观和行为散射对象。通过更改属性值,您可以修改散点图的某些方面。

从R2014b开始,您可以使用点表示法来查询和设置属性。

S =散点(1:10,1:10);m = s;s.Marker = '*';

如果您使用的是较早的版本,请使用得到而且函数来代替。

标记

全部展开

标记符号,指定为该表中列出的选项之一:

价值 描述
“o”
“+” 加号
‘*’ 星号
“。”
“x” 交叉
“广场”“年代” 广场
“钻石”' d ' 钻石
“^” Upward-pointing三角形
“v” 向下的三角形
“>” 三点三角形
“<” 只左向三角形
五角星形的“p” 五角星(五角星)
“卦”“h” 六角星(六角星)
“没有” 没有标记

标记边缘的宽度,指定为正数值,以点为单位。

例子:0.75

标记轮廓颜色,指定“平”、RGB三元组、十六进制颜色编码、颜色名称或短名称。的默认值。“平”使用来自CData财产。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()之后是三个或六个十六进制数字,取值范围从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 1 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [1 1 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1,1 1] “# FFFFFF”

“没有” 不适用 不适用 不适用 没有颜色

这里是RGB三组和十六进制颜色编码的默认颜色MATLAB®在许多类型的情节中使用。

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

例子:[0.5 0.5 0.5]

例子:“蓝”

例子:“# D2F9A7”

标记填充颜色,指定为“平”“汽车”、RGB三元组、十六进制颜色编码、颜色名称或短名称。的“平”选项使用CData值。的“汽车”选项使用与颜色属性。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()之后是三个或六个十六进制数字,取值范围从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 1 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [1 1 0] “# FFFF00”

“黑” “k” [0 0 0] # 000000的

“白色” ' w ' [1,1 1] “# FFFFFF”

“没有” 不适用 不适用 不适用 没有颜色

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

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “# 0072 bd”

[0.8500 0.3250 0.0980] “# D95319”

[0.9290 0.6940 0.1250] “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

[0.4660 0.6740 0.1880] “# 77 ac30”

[0.3010 0.7450 0.9330] “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

例子:[0.3 0.2 0.1]

例子:“绿色”

例子:“# D2F9A7”

标记边缘透明度,指定为范围中的标量[0, 1].值1是不透明的,值0是完全透明的。0和1之间的值是半透明的。

例子:. markeredgealpha = 0.5;

标记面透明度,指定为范围中的一个标量[0, 1].值1是不透明的,值0是完全透明的。0和1之间的值是半透明的。

例子:. markerfacealpha = 0.5;

颜色和尺寸数据

全部展开

标记颜色,指定为以下值之一:

  • RGB三联-使用相同的颜色为所有标记在情节。RGB三元组是一个三元素行向量,其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1],例如,[0.5 0.6 0.7]

  • RGB三组的三列矩阵-在图中每个标记使用不同的颜色。矩阵的每一行定义一种颜色。行数必须等于标记的数量。

  • 矢量-使用不同的颜色为每个标记在情节。指定CData作为长度相同的向量XData.将向量中的值线性映射到当前色度图中的颜色。

例子:[1 0 0;0 1 0;0 0 1]

控制如何CData属性,指定为以下值之一:

  • “汽车”MATLAB控制的值CData属性中的单一颜色ColorOrder轴的性质。

  • “手动”的值CData属性,或者在调用时指定颜色散射scatter3,或通过设置CData上的物业散射对象。

的值CData属性手动,MATLAB改变的值CDataMode财产“手动”

链接到的变量CData,指定为包含MATLAB工作空间变量的字符向量或字符串。MATLAB在基本工作区中计算变量以生成CData

默认情况下,没有链接变量,因此值为空字符向量。如果你链接一个变量,那么MATLAB不会更新CData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

记号笔的尺寸,用以下形式之一指定:

  • 标量——所有标记使用相同的大小。

  • 矢量-为每个标记使用不同的大小。指定SizeData作为长度相同的向量XData

以点为单位指定值,其中点等于1/72英寸。要指定一个面积为一平方英寸的标记,请使用72^2的值。

例子:50

链接到的变量SizeData,指定为包含MATLAB工作空间变量的字符向量或字符串。MATLAB在基本工作区中计算变量以生成SizeData

默认情况下,没有链接变量,因此值为空字符向量。如果你链接一个变量,那么MATLAB不会更新SizeData值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

笛卡尔坐标数据

全部展开

x值,指定为标量或向量。中的每个值的单个标记显示在散点图中XData

输入参数X散射而且scatter3函数设置x值。XData而且YData长度必须相等。

例子:[1 2 4 2 6]

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

链接到的变量XData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成XData

默认情况下,没有链接变量,因此值为空字符向量,.如果你链接一个变量,那么MATLAB不会更新XData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

例子:“x”

y值,指定为标量或向量。中的每个值的单个标记显示在散点图中YData

输入参数Y散射而且scatter3函数设置y值。XData而且YData长度必须相等。

例子:[1 3 3 4 6]

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

链接到的变量YData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成YData

默认情况下,没有链接变量,因此值为空字符向量,.如果你链接一个变量,那么MATLAB不会更新YData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

例子:“y”

z值,指定为标量或向量。

  • 对于二维散点图,ZData默认为空。

  • 对于三维散点图,输入参数Zscatter3函数设置z值。XDataYData,ZData长度必须相等。

例子:[1 2 2 10 0]

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

链接到的变量ZData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成ZData

默认情况下,没有链接变量,因此值为空字符向量,.如果你链接一个变量,那么MATLAB不会更新ZData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

例子:“z”

极坐标数据

全部展开

半径值,指定为矢量。ThetaData而且RData必须是长度相等的向量。

这个性质只适用于极轴。

链接到的变量RData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成RData

默认情况下,没有链接变量,因此值为空字符向量,.如果你链接一个变量,那么MATLAB不会更新RData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

这个性质只适用于极轴。

角度值,指定为向量。ThetaData而且RData必须是长度相等的向量。

这个性质只适用于极轴。

链接到的变量ThetaData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成RData

默认情况下,没有链接变量,因此值为空字符向量,.如果你链接一个变量,那么MATLAB不会更新ThetaData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

这个性质只适用于极轴。

地理坐标数据

全部展开

纬度值,指定为矢量。LatitudeData而且LongitudeData必须是长度相等的向量。

此属性仅适用于地理轴。

链接到的变量LatitudeData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成RData

默认情况下,没有链接变量,因此值为空字符向量,.如果链接一个变量,MATLAB不会更新LatitudeData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

此属性仅适用于地理轴。

经度值,指定为矢量。LongitudeData而且LatitudeData必须是长度相等的向量。

此属性仅适用于地理轴。

链接到的变量LongitudeData,指定为包含MATLAB工作空间变量名的字符向量或字符串。MATLAB在基本工作区中计算变量以生成RData

默认情况下,没有链接变量,因此值为空字符向量,.如果链接一个变量,MATLAB不会更新LatitudeData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图形。

此属性仅适用于地理轴。

传说

全部展开

图例标签,指定为字符向量或字符串标量。方法调用之前,图例不会显示传说命令。如果不指定文本,则传说使用表单设置标签“dataN”

此属性是只读的。

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

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

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

例如,要排除一个图形对象,,从传说中设定IconDisplayStyle财产“关闭”

go.Annotation.LegendInformation.IconDisplayStyle =“关闭”

控件控制图例中的项传说函数。将第一个输入参数指定为要包含的图形对象的向量。如果您没有在第一个输入参数中指定一个现有的图形对象,那么它就不会出现在图例中。然而,在图例创建后添加到坐标轴上的图形对象确实会出现在图例中。考虑在创建所有情节后再创建传说,以避免额外的道具。

交互性

全部展开

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

  • “上”—显示对象。

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

数据提示内容,指定为DataTipTemplate对象。可以通过修改底层的属性来控制出现在数据提示中的内容DataTipTemplate对象。有关属性列表,请参见DataTipTemplate属性

有关修改数据提示的示例,请参见创建自定义数据提示

请注意

DataTipTemplate对象没有返回findobjfindall,它不被复制copyobj

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

请注意

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

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

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

  • “关闭”—未选中。

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

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

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

将对象剪切到坐标轴限制,指定为以下值之一:

  • “上”-不要在坐标轴范围外显示物体的部分。

  • “关闭”-显示整个对象,即使它的部分出现在轴的限制之外。如果您创建一个plot, set,对象的部分可能出现在轴限制之外抓住,冻结轴缩放,然后创建对象,使其比原始的绘图更大。

剪裁属性的值必须设置为“上”.否则,此属性将不起作用。有关剪切行为的更多信息,请参见剪裁轴的性质。

回调

全部展开

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

  • 函数处理

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

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

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

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

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

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

请注意

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

对象创建函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作区中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定MATLAB创建对象时要执行的回调函数。函数执行之前,MATLAB初始化所有属性值CreateFcn回调。如果不指定CreateFcn属性,然后MATLAB执行一个默认的创建函数。

设置CreateFcn属性对现有组件没有影响。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数来访问对象。

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作区中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前调用。如果不指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo函数来访问对象。

回调执行控制

全部展开

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

有两种回调状态需要考虑:

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

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

每当MATLAB调用回调时,该回调将试图中断正在运行的回调(如果存在的话)。的可中断属性的属性确定是否允许中断。的可中断属性有两个可能的值:

  • “上”-允许其他回调函数中断对象的回调函数。中断发生在MATLAB处理队列的下一个点,例如当有drawnow数字uifiguregetframe等待,或暂停命令。

    • 如果正在运行的回调包含这些命令中的一个,那么MATLAB将在该点停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB继续执行正在运行的回调。

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

  • “关闭”—阻断所有中断尝试。的BusyAction属性的属性确定中断回调是被丢弃还是放入队列中。

请注意

回调中断和执行在以下情况下表现不同:

  • 如果中断回调函数是DeleteFcnCloseRequestFcnSizeChangedFcn回调函数,则中断发生而不管可中断属性值。

  • 如果正在运行的回调函数当前正在执行等待函数,则中断发生而不管可中断属性值。

  • 计时器对象根据调度执行,而不考虑可中断属性值。

当中断发生时,MATLAB不会保存属性或显示的状态。方法返回的对象gcagcf命令可能在执行另一个回调时更改。

回调队列,指定为“队列”“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

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

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

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

  • “队列”—在正在运行的回调完成执行后,将中断回调放入队列中进行处理。

  • “取消”—不执行中断回调。

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

  • “可见”-捕捉鼠标点击时可见。的可见属性必须设置为“上”你必须点击一部分散射对象,该对象具有定义的颜色。不能单击已将关联颜色属性设置为的部分“没有”.如果绘图包含标记,那么如果边缘或填充有定义的颜色,则整个标记都是可单击的。的HitTest属性确定是否散射对象对单击作出响应,或者如果父对象作出响应。

  • “没有”—无法捕获鼠标单击。单击散射对象在图形窗口的当前视图中将单击传递到它下面的对象。的HitTest的属性散射对象没有效果。

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

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

  • “关闭”类的最近祖先触发回调散射对象,该对象具有以下内容之一:

    • HitTest属性设置为“上”

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

请注意

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

此属性是只读的。

删除状态,返回为“关闭”“上”.MATLAB设置BeingDeleted财产“上”DeleteFcn回调开始执行。的BeingDeleted物业仍设为“上”直到组件对象不再存在。

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

父/子

全部展开

父类,指定为PolarAxes集团,或变换对象。

儿女,归为空GraphicsPlaceholder数组或DataTip对象数组。使用此属性可查看图表上绘制的数据提示列表。

方法无法添加或删除子节点孩子们财产。若要向此列表添加子对象,请设置的属性DataTip对象添加到图表对象。

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

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

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

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

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

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

标识符

全部展开

此属性是只读的。

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

对象标识符,指定为字符向量或字符串标量。您可以指定一个惟一的标签值作为对象的标识符。当需要访问代码中其他地方的对象时,可以使用findobj方法搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

如果您正在使用App Designer,请在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用程序设计程序中共享数据

R2006a之前介绍过