HeatmapChart 属性

图标题，指定为字符向量、字符向量元胞数组、字符串数组或分类数组。

示例: h = heatmap(rand(10,10),'Title','My Title Text')

示例: h.Title = 'My Title Text';

要创建一个多行标题，请指定字符向量元胞数组或字符串数组。数组中的每个元素对应一行文本。

示例: h.Title = {'My','Title'};

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

如果使用表格数据创建图，默认图具有自动生成的标题。如果您不需要标题，请指定 ''。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

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

示例: h = heatmap(rand(10,10),'XLabel','My Label')

示例: h.XLabel = 'My Label';

要创建一个多行标签，请指定字符向量元胞数组或字符串数组。数组中的每个元素对应一行文本。

示例: h.XLabel = {'My','Label'};

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

如果使用表格数据创建图，默认图具有自动生成的标签。如果您不需要标签，请指定 ''。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

y 轴的标签，指定为字符向量、字符向量元胞数组、字符串数组或分类数组。

示例: h = heatmap(rand(10,10),'YLabel','My Label')

示例: h.YLabel = 'My Label';

要创建一个多行标签，请指定字符向量元胞数组或字符串数组。数组中的每个元素对应一行文本。

示例: h.YLabel = {'My','Label'};

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

如果使用表格数据创建图，默认图具有自动生成的标签。如果您不需要标签，请指定 ''。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

缺失数据图标的标签，显示在颜色栏下面，指定为字符向量。如果您不希望显示标签，请使用空字符向量 ''。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

示例: h = heatmap(__,'MissingDataLabel','No data')

示例: h.MissingDataLabel = 'No data'

文本解释器，指定为下列值之一：

MATLAB 在显示图标题、轴标签或任何包含文本或符号的数据时使用解释器。

TeX 标记

默认情况下，MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。

修饰符会一直作用到文本结尾，但上标和下标除外，因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时，支持的修饰符如下所示。

下表列出了 "tex" 解释器所支持的特殊字符。

LaTeX 标记

要使用 LaTeX 标记，请将解释器设置为 "latex"。对于行内模式，用单美元符号 ($) 将标记括起来。对于显示模式，用双美元符号 ($$) 将标记括起来。

"$\int_1^{20} x^2 dx$"

"$$\int_1^{20} x^2 dx$$"

显示的文本将使用默认的 LaTeX 字体样式。要更改字体样式，请使用 LaTeX 标记。

用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本，请在此数量的基础上每行减少约 10 个字符。

MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息，请参阅支持的 LaTeX 命令。有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。

用于为热图单元格着色的颜色图，指定为预定义的颜色图名称或定义 m 种不同颜色的 m×3 RGB（红、绿、蓝）三元组数组。您可以指定一种预定义的颜色图，也可以创建一种自定义的颜色图。

示例: h = heatmap(__,'Colormap',summer)

示例: h.Colormap = parula

用来计算颜色数据值（存储在 ColorData 中）的方法，指定为 'count'、'mean'、'median'、'sum'、'max'、'min' 或 'none'。

如果您不想使用颜色数据表中的第三个变量，则将方法指定为 'count'。当方法为 'count' 时，热图不使用 ColorVariable 属性，而是计算每对 x 和 y 值出现在源表中的次数。当您使用表格数据而没有指定 ColorVariable 参数时，此值为默认值。

如果您要使用颜色数据表中的第三个变量，请将 ColorVariable 属性设置为要使用的变量，并将 ColorMethod 属性指定为下表中列出的方法之一。对于每对 x 和 y 值，这些方法使用源表的 ColorVariable 列中的对应值来计算数据。

如果您要计算自己的合计数据矩阵，请使用 accumarray 函数。指定矩阵作为 heatmap 函数的输入。

示例: h = heatmap(__,'ColorMethod','median')

示例: h.ColorMethod = 'median'

颜色数据与颜色图颜色之间的映射，指定为下列值之一：

确定颜色映射时，热图将忽略 NaN、Inf 和 -Inf 值。

当 ColorScaling 设置为 'scaledcolumns' 或 'scaledrows' 时，颜色栏上的默认刻度标签的范围为从 0 到 1。热图中行或列中的最小值映射到颜色栏上的 0。行或列中的最大值映射到颜色栏上的 1。

示例: h = heatmap(__,'ColorScaling','scaledcolumns')

示例: h.ColorScaling = 'scaledcolumns'

颜色范围，指定为 [min max] 形式的二元素向量。颜色范围指示映射到颜色图中第一种和最后一种颜色的颜色数据值。

示例: h = heatmap(__,'ColorLimits',[0 10])

示例: h.ColorLimits = [0 10]

无数据值的单元格的颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: h = heatmap(__,'MissingDataColor',[0.8 0.8 0.8])

示例: h.MissingDataColor = [0.8 0.8 0.8]

显示颜色栏，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: h = heatmap(__,'ColorbarVisible','off')

示例: h.ColorbarVisible = 'off'

显示网格线，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: h = heatmap(__,'GridVisible','off')

示例: h.GridVisible = 'off'

数据标签的文本颜色，指定为 'auto'、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 'auto' 将根据每个热图单元格的颜色选择一种合适的文本颜色。如果不希望显示标签，请指定 'none'。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: h = heatmap(__,'CellLabelColor','blue')

示例: h.CellLabelColor = 'blue'

数据标签的格式，指定为格式选项字符向量。

该字符向量的大多数元素都是可选的，但百分号和转换字符除外。按以下顺序构造字符向量：

您还可以在格式的开头或末尾指定字面文本。要打印单引号，请使用 ''。要打印百分比字符，请使用 %%。

示例：h.CellLabelFormat = '%.2f' 使用带两个小数位的定点记数法显示值。

示例：h.CellLabelFormat ='$%.2f' 在每个值前面显示美元符号。

示例：h.CellLabelFormat = '%.2f lbs' 在每个值后面显示 lbs。

标题、轴标签和刻度标签的文本颜色，指定为颜色名称或 RGB 三元组。

示例: h = heatmap(__,'FontColor','blue')

示例: h.FontColor = 'blue'

字体名称，指定为系统支持的字体名称。默认字体取决于具体操作系统和区域设置。

示例: h = heatmap(__,'FontName','Cambria')

示例: h.FontName = 'Cambria'

标题、轴标签和单元格标签的字体大小，指定为标量值。默认字体取决于具体操作系统和区域设置。

标题和轴标签使用稍大的字体大小（放大 10%）。如果没有足够的空间显示每个单元格中的文本，文本可能会使用较小的字体大小或者根本不显示。

示例: h = heatmap(__,'FontSize',12)

示例: h.FontSize = 12

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

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

x 轴的表变量，指定为下列形式之一：

与表变量关联的值必须组合为 categorical 函数能够接受的有限离散类别集合。如果这些值没有组合为有限类别集合，请使用 discretize 函数将它们组合在一起。

如果设置 XVariable 属性值，XData 和 XDisplayData 属性将自动更新为合适的值。

x 轴上显示的标签按字母顺序排列。您可以使用 XDisplayData、yDisplayData 或分类数组来自定义标签。有关示例，请参阅基于表格数据创建热图。

示例: h.XVariable = 'Location' 指定名为 'Location' 的变量。

y 轴的表变量，指定为下列形式之一：

与表变量关联的值必须组合为 categorical 函数能够接受的有限离散类别集合。如果这些值没有组合为有限类别集合，请使用 discretize 函数将它们组合在一起。

如果设置 YVariable 属性值，YData 和 YDisplayData 属性将自动更新为合适的值。

y 轴上显示的标签按字母顺序排列。您可以使用分类数组自定义标签。有关示例，请参阅基于表格数据创建热图。

示例: h.YVariable = 'Location' 指定名为 'Location' 的变量。

颜色数据的表变量，指定为下列形式之一：

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

当您指定颜色变量时，MATLAB 将更新 ColorData 属性值。此外，ColorMethod 属性会更改为 'mean'，除非您之前指定了不同的值。

示例: h = heatmap(__,'ColorVariable','Temperature')

示例: h.ColorVariable = 'Temperature'

用于为每个热图单元格着色的数据，指定为数值矩阵。

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

与颜色数据矩阵列关联的 x 值，指定为字符向量元胞数组、字符串数组或分类数组。XDisplayData 属性控制图中沿 x 轴显示值的顺序。

如果更改 XData 属性值，XDisplayData 属性将自动更新为合适的值。

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

示例: h.XData = {'small','large','medium'}

与颜色数据矩阵行关联的 y 值，指定为字符向量元胞数组、字符串数组或分类数组。YDisplayData 属性控制图中沿 y 轴显示值的顺序。

如果更改 YData 属性值，YDisplayData 属性将自动更新为合适的值。

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

示例: h.YData = {'small','large','medium'}

已排序的颜色数据，以值矩阵的形式返回，值的显示方式与在热图中相同。这些值基于 XDisplayData 和 YDisplayData 属性进行排序。

x 轴上值的显示顺序，指定为字符向量元胞数组、字符串数组或分类数组。您可以将此属性设置为 XData 中的值的子集、超集或置换。默认情况下，这些值与 XData 值相同。

如果您指定的值不在 XData 中，热图将显示一行 NaN 值或一行零值。

在创建对象的过程中，要将 XDisplayData 指定为名称-值对组，必须在指定 XDisplayLabels 或 XLimits 属性之前指定 XDisplayData 属性。使用 XDisplayLabels 属性更改显示的文本。

示例: h.XDisplayData = {'small','medium','large'}

y 轴上值的显示顺序，指定为字符向量元胞数组、字符串数组或分类数组。您可以将此属性设置为 YData 中的值的子集、超集或置换。默认情况下，这些值与 YData 值相同。

如果您指定的值不在 YData 中，热图将显示一行 NaN 值或一行零值。

在创建对象的过程中，要将 YDisplayLabels 指定为名称-值对组，必须在指定 YDisplayData 或 YLimits 属性之前指定 YDisplayData 属性。使用 YDisplayLabels 属性更改显示的文本。

示例: h.YDisplayData = {'small','medium','large'}

x 轴值的标签，指定为字符向量元胞数组、字符串数组或分类数组。该数组必须是大小与 XDisplayData 向量相同的列向量。为 XDisplayData 中的每个值指定一个标签。默认情况下，这些值与 XDisplayData 值相同。当您将此属性指定为分类数组时，MATLAB 使用数组中的值，而不是类别。

如果您在 XDisplayData 属性中添加值、删除值或重新排列值，此属性将相应地更新，以维护值与标签的配对。在创建对象的过程中，要将 XDisplayLabels 和 XDisplayData 都指定为名称-值对组，必须先指定 XDisplayData 属性。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

示例: h.XDisplayLabels = {'SM','MED','LG'}

y 轴值的标签，指定为字符向量元胞数组、字符串数组或分类数组。该数组必须是大小与 YDisplayData 向量相同的列向量。为 YDisplayData 中的每个值指定一个标签。默认情况下，这些值与 YDisplayData 值相同。当您将此属性指定为分类数组时，MATLAB 使用数组中的值，而不是类别。

如果您在 YDisplayData 属性中添加值、删除值或重新排列值，此属性将相应地更新，以维护值与标签的配对。在创建对象的过程中，要将 YDisplayLabels 和 YDisplayData 都指定为名称-值对组，必须先指定 YDisplayData 属性。

默认情况下，热图支持对您指定的文本使用某些 TeX 标记。使用 TeX 标记可添加下标和上标，修改字体类型和颜色，并在文本中包括特殊字符。如果要在常规文本中使用 TeX 标记字符，如下划线 (_)，请在要包含的字符前插入反斜杠 (\)。反斜杠是 TeX 转义字符。有关详细信息，请参阅文本对象的Interpreter属性。

示例: h.YDisplayLabels = {'SM','MED','LG'}

x 坐标轴范围，指定为 XDisplayData 形式的二元素行向量。

在创建对象的过程中，要将 XLimits 和 XDisplayData 都指定为名称-值对组，必须先指定 XDisplayData 属性。

示例: h.XLimits = {'small','medium'}

y 坐标轴范围，指定为 YDisplayData 形式的二元素行向量。

在创建对象的过程中，要将 YLimits 和 YDisplayData 都指定为名称-值对组，必须先指定 YDisplayData 属性。

示例: h.YLimits = {'small','medium'}

在增加、删除或更改装饰元素时保持不变的位置属性，指定为下列值之一：

热图在父容器（通常为图窗、面板或选项卡）中的外部大小和位置，指定为 [left bottom width height] 形式的四元素向量。外部位置包括颜色栏、标题和轴标签。

默认值 [0 0 1 1] 涵盖容器的整个内部。单位相对于容器的大小进行归一化。要更改单位，请设置 Units 属性。

热图在父容器（通常为图窗、面板或选项卡）中的内部大小和位置，返回为 [left bottom width height] 形式的四元素向量。内部位置不包括颜色栏、标题和轴标签。

热图在父容器（通常为图窗、面板或选项卡）中的内部大小和位置，返回为 [left bottom width height] 形式的四元素向量。此属性等同于 InnerPosition 属性。

位置单位，指定为下列值之一：

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

布局选项，指定为 TiledChartLayoutOptions 或 GridLayoutOptions 对象。当图采用分块图布局或网格布局时，此属性非常有用。

要在分块图布局的网格中定位图，请设置 TiledChartLayoutOptions 对象的 Tile 和 TileSpan 属性。例如，假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格，外边缘四周各有一个图块。实际上，该网格不可见，外侧图块也不占用空间，除非您用坐标区或图填充它们。

以下代码将图 c 放置在网格的第三个图块中。

c.Layout.Tile = 3;

要使图占据多个图块，请将 TileSpan 属性指定为二元素向量。例如，此图占据了 2 行和 3 列的图块。

c.Layout.TileSpan = [2 3];

要将图放在四周的某个图块中，请将 Tile 属性指定为 "north"、"south"、"east" 或 "west"。例如，将值设置为 "east" 会将图放置在网格右侧的图块中。

c.Layout.Tile = "east";

要将图放入 App 内的一个布局中，请将此属性指定为 GridLayoutOptions 对象。有关在 App 中使用网格布局的详细信息，请参阅 uigridlayout。

如果图不是分块图布局或网格布局的子级（例如，如果它是图窗或面板的子级），则此属性为空且不起作用。

可见性状态，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

父容器，指定为 Figure、Panel、Tab、TiledChartLayout 或 GridLayout 对象。

HeatmapChart 对象句柄在父级的 Children 属性中的可见性，指定为下列值之一：

如果父级的 Children 属性中未列出该对象，则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。这包括 get、findobj、gca、gcf、gco、newplot、cla、clf 和 close。

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