# heatmapchart 属性
热图的外观和行为
heatmapchart 属性控制 heatmapchart 对象的外观和行为。通过更改属性值，您可以修改热图的某些方面。
您可以使用 plt_get 和 plt_set 函数查询和设置属性。
例如：
using TyPlot
h,c = heatmap([1 3 5; 2 4 6]);
t = plt_get(h, "title");
plt_set(h, "title", "My Heatmap Title");
# 标签
title - 图标题字符向量 | 字符串数组
图标题，指定为字符向量、字符串数组。
示例： h,c = heatmap(rand(10,10),title="My Title Text")
示例： plt_set(h,"title","My Title Text")
要创建一个多行标题，请指定字符向量或字符串数组。数组中的每个元素对应一行文本。
示例： plt_set(h,"title",["My","Title"])
xlabel - x 轴的标签字符向量 | 字符串数组
x 轴的标签，指定为字符向量、字符串数组。
示例： h,c = heatmap(rand(10,10),xlabel="My Label")
示例： plt_set(h,"xlabel","My Label")
要创建一个多行标题，请指定字符向量或字符串数组。数组中的每个元素对应一行文本。
示例： plt_set(h,"xlabel",["My","Label"])
ylabel - y 轴的标签字符向量 | 字符串数组
y 轴的标签，指定为字符向量、字符串数组。
示例： h,c = heatmap(rand(10,10),ylabel="My Label")
示例： plt_set(h,"ylabel","My Label")
要创建一个多行标题，请指定字符向量或字符串数组。数组中的每个元素对应一行文本。
示例： plt_set(h,"ylabel",["My","Label"])
missingdatalabel - 缺失数据图标的标签'' (默认) | 字符向量
缺失数据图标的标签，显示在颜色栏下面，指定为字符向量。如果您不希望显示标签，请使用空字符向量 ''。
示例： h,c = heatmap(rand(10,10),missingdatalabel="No data")
示例： plt_set(h,"missingdatalabel","No data")
# 颜色和样式
cmap - 用于为热图单元格着色的颜色图预定义的颜色图名称 |
由 RGB 三元组组成的 m×3 数组
用于为热图单元格着色的颜色图，指定为预定义的颜色图名称或定义 m 种不同颜色的 m×3 RGB（红、绿、蓝）三元组数组。您可以指定一种预定义的颜色图，也可以创建一种自定义的颜色图。
预定义的颜色图 - 以命令形式指定颜色图名称，例如 parula 或 summer。如需完整的选项列表，请参见 colormap；
自定义颜色图 - 指定一个 m×3 RGB 三元组数组。
示例： h,c = heatmap(__,cmap="summer")
示例： plt_set(h,"cmap","parula")
colormethod - 用来计算颜色数据的方法mean | sum | median | nothing(默认)
图标题，指定为字符向量、字符向量数组、字符串数组。
用来计算颜色数据值（存储在 ColorData 中）的方法，指定为 mean、sum、median、nothing。
| 方法 | 说明 |
|---|---|
| "mean" | 计算平均值。如果指定 ColorVariable 属性，则此值为默认值。 |
| "sum" | 计算各值的总和。 |
| "median" | 计算中位数值。 |
| "nothing" | 使用该值本身。每对 x 和 y 值在该表中的实例数不能超过一个。使用矩阵数据时，此值为默认值。 |
如果您要计算自己的合计数据矩阵，请使用 accumarray 函数。指定矩阵作为 heatmap 函数的输入。
示例： h = heatmap(cdata,colormethod="sum")
注意
该属性不支持使用 plt_get、plt_set 函数查询设置。
colorbarvisible - 显示颜色栏"on" (默认) | "off"
显示颜色栏，指定为 "on" 或 "off"。因此，您可以使用此属性的值作为逻辑值。
示例： h,c = heatmap(__,colorbarvisible="off")
示例： plt_set(h,"colorbarvisible","off")
celllabelcolor - 数据标签的文本颜色"auto" | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...
数据标签的文本颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "auto" 将根据每个热图单元格的颜色选择一种合适的文本颜色。如果不希望显示标签，请指定 "none"。 对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]；
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。 这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" |  |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" |  |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" |  |
| "blue" | "b" | [0, 0, 1] | "#0000FF" |  |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" |  |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" |  |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" |  |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" |  |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" |  |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" |  |
| "black" | "k" | [0, 0, 0] | "#000000" |  |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" |  |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" |  |
| [0.8500, 0.3250, 0.0980] | "#D95319" |  |
| [0.9290, 0.6940, 0.1250] | "#EDB120" |  |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" |  |
| [0.4660, 0.6740, 0.1880] | "#77AC30" |  |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" |  |
| [0.6350, 0.0780, 0.1840] | "#A2142F" |  |
celllabelformat - 数值标签的格式"0.4g" （默认） | 字符向量 | 字符串
数值刻度标签的格式，指定为字符向量或字符串。
标识符是可选的，百分比符号和转换字符除外。按以下顺序构造格式:
- 一个或多个标志 - 用来指示在正值之前添加加号之类的选项。要查看完整的选项列表，请参阅可选标志表；
- 字段宽度 - 刻度标签上要打印的最小字符数。请将字段宽度指定为整数值。如果刻度值中的有效位数小于字段宽度，则在标签上用空格填充；
- 精度 - 小数点右侧的位数或有效位数，具体取决于转换字符。将精度指定为一个整数值；
- 转换字符 - 值的类型。要查看完整的选项列表，请参阅转换字符表。如果指定的转换字符不适合数据，Syslab 将覆盖指定的转换字符并使用 %e。
您还可以在格式的开头或末尾指定字面文本。要打印单引号，请使用 ""。要打印百分比字符，请使用 %%。
示例： plt_set(h, "celllabelformat", ".2f") 使用带两个小数位的定点记数法显示值。
可选标志
| 标识符 | 说明 | 数值格式示例 |
|---|---|---|
| + | 为正值打印符号字符 (+)，例如 "+100"。 | "%+4.4g" |
| 0 | 用前导零而不是空格填充字段宽度，例如 "0100"。 | "%04.4g" |
| - | 左对齐，在值的末尾而不是开头用空格填充。例如，如果字段宽度为 4，则此标志将标签格式化为 "100 "(左对齐)，而不是 " 100"(右对齐)。 | "%-4.4g" |
| # | 对于 %f、%e 和 %g 转换字符，即使精度为 0，也会打印小数点，例如 "100."。对于 %g，不会删除尾随零。 | "%#4.4g" |
转换字符
| 标识符 | 说明 | 示例 |
|---|---|---|
| d 或 i | 底数为 10 的有符号整数。精度值指示有效位数。 | "%.4d" 将 π 显示为 0003。 |
| f | 定点记数法。精度值指示小数位数。 | "%.4f" 将 π 显示为 3.1416。 |
| e | 指数记数法。 | "%.4e" 将 π 显示为 3.1416e+00。 |
| g | 精度值指示最大小数位数。 | "%.4g" 将 π 显示为 3.141。 |
fontcolor - 标题、轴标签和刻度标签的文本颜色颜色名称 | RGB 三元组
标题、轴标签和刻度标签的文本颜色，指定为颜色名称或 RGB 三元组。
示例： h,c = heatmap(__,fontcolor="blue")
示例： plt_set(h,"fontcolor","blue")
# 字体
fontname - 字体名称支持的字体名称
字体名称，指定为支持的字体名称。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。
示例： h,c = heatmap(__,fontname="Cambria")
示例： plt_set(h,"fontname","Cambria")
fontsize - 字体大小数值标量
标题、轴标签和单元格标签的字体大小，指定为标量值。默认字体取决于具体操作系统和区域设置。
示例： h,c = heatmap(__,fontsize=10)
示例： plt_set(h,"fontsize",10)
# 显示的数据
xvalues - x 轴上显示的值字符串数组 | 数值数组 | 字符向量数组
x 轴上显示的值，指定为字符串数组、数值数组或字符向量数组。注意要与列数保持一致。
示例： ["small","medium","large"]
yvalues - y 轴上显示的值字符串数组 | 数值数组 | 字符向量数组
y 轴上显示的值，指定为字符串数组、数值数组或字符向量数组。注意要与行数保持一致。
示例： ["Green","Red","Blue","Gray"]
rotation - X 坐标轴的标签旋转角度默认不旋转
rotation 是 X 坐标轴的标签旋转角度。