HeatmapChart 属性

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

示例: h.MissingDataLabel = 'No data'

TeX 标记

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

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

下表列出了 "tex" 解释器所支持的特殊字符序列。某些符号看起来与它们在 MATLAB 中的样子略有不同。

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 的示例，请参阅图文本中的希腊字母和特殊字符。

示例: h.Colormap = parula

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

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

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

示例: h.ColorMethod = 'median'

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

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

示例: h.ColorScaling = 'scaledcolumns'

示例: h.ColorLimits = [0 10]

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 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]

示例: h.ColorbarVisible = 'off'

示例: h.GridVisible = 'off'

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 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。

示例: h.FontColor = 'blue'

示例: h.FontName = 'Cambria'

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

示例: h.FontSize = 12

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

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

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

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

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

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

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

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

示例: h.ColorVariable = 'Temperature'

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

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

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

数据类型: char | string | cell | categorical

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

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

数据类型: char | string | cell | categorical

此 属性 为只读。

数据类型: double

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

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

数据类型: char | string | cell | categorical

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

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

数据类型: char | string | cell | categorical

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

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

数据类型: char | string | cell | categorical

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

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

数据类型: char | string | cell | categorical

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

数据类型: char | string | cell | categorical

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

数据类型: char | string | cell | categorical

以下代码将图 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。

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

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

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