# 指标卡

> 指标卡组件的参考：它的迷你图和分布图、窗口统计量、保留量，以及编辑器里的每一项属性。

**指标卡**把一个数值点位写得很大，下面可以配一张迷你图，旁边可以配所显示窗口的统计量。这张卡片通过工作站的实时序列采集器自己采集采样点，所以它一打开就是一个装满的窗口，而不是一幅空图。点位没有读数时，卡片显示缺口标记（`—`），也不写单位；声明好的区段按读数落在哪里给它上色，没有任何区段认领的读数则完全不上色。`NaN` 是一个读数，不是缺口：卡片把它写成这个词，旁边带着单位；因为 `NaN` 在刻度上没有位置，任何区段都不给它上色，差值显示缺口标记。

## 数据 {#data}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 地址 | 所显示数值点位的带根 Logic 地址。字段从实时点位清单里给建议，过滤为数值点位，指名之后显示该点位当前的读数。 | 地址 | 空 |

## 格式 {#format}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 单位 | 写在数值旁边的可选单位后缀。 | 文本 | 空 |
| 小数位 | 各处读数固定的小数位数（大字读数、统计量和差值都一样）。留空时，类型为整数的点位的大字读数写出来不带小数，其他读数按工作站的小数位数写；窗口的最小值和最大值是同一个点位的读数，跟着大字读数走，参考值和与它的差值也一样（整数不带小数，实数按工作站的小数位数），而平均值按工作站的小数位数写，因为整数的平均值很少是整数。 | 0 到 15 | 留空则用工作站的偏好 |
| 位数 | 大字读数在小数分隔符之前预留多少位；超出的读数会被标记（`####`），完整的自己在提示里。以文字答复的点位（一份工单、一个批次、一个标志位）绝不戴这个标记，哪怕它的文字全是数字也一样：字段容不下的部分以省略号（…）结尾，完整读数在提示里。 | 1 到 20 | 留空则预留 5 位 |
| 字号 | 由单元格决定字号，还是由操作员指定。 | 单元格容得下的最大尺寸 · 我指定的大小 | 单元格容得下的最大尺寸 |
| 磅 | 指定的那个字号，在任何单元格里都照字面绘制。只在指定模式下显示。 | 9 到 144 | 12 |
| 读数形式 | 各处读数用什么方式写出来。 | 数字 · 百分比 · 时长 | 数字 |
| 数值按什么计 | 格式为时长时，一个单位的值表示多少。 | 秒 · 毫秒 · 分钟 | 秒 |
| 显示最小值 | 在统计那一行写出所显示窗口的最小值。 | 开 / 关 | 开 |
| 显示最大值 | 写出所显示窗口的最大值。 | 开 / 关 | 开 |
| 显示平均值 | 写出所显示窗口的平均值。 | 开 / 关 | 关 |
| 显示与参考值的差 | 写出读数离所声明的参考值有多远，作为 `Δ` 写在数值下面，参考值本身在提示里。没有声明参考值时它什么也不说：跟“什么都没有”比出来的差不是一个读数。 | 开 / 关 | 关 |

统计量和差值是同一个值的第二重读数，按卡片自己的那份声明书写；不管大字读数的字号是多少，它们都保持卡片自己那个小尺寸。

统计量用仪表画面所画的最小字号书写，所以卡片即使窄到在这个字号下放不下整行统计量，也绝不会把某个统计量从数字中间截断：这一行退到 `####` 标记后面，所有统计量都在它的提示里。这一行要求的宽度来自声明（**位数** 和 **小数位**），而不是屏幕上的读数。

## 迷你图 {#mini-chart}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 画法 | 卡片在读数下面画什么。不管画的是哪一种，数值、它的质量和它落在哪个区段都一样。 | 窗口上的一条曲线 · 采样点的分布 · 无 | 窗口上的一条曲线 |
| 区间数 | 分布图把观测到的范围切成多少个等宽区间。只在分布图下显示。 | 2 到 40 | 10 |
| 统计范围（采样点） | 分布图统计最新采集的多少个采样点。它给分布图划定范围，就像窗口给迷你曲线划定范围一样；填得比缓冲区装得下的还多时，就统计现有的这些，因为区间分的是观测到的读数，别的什么也不是。 | 2 到 20,000 | 120 |
| 强调色 | 迷你图的颜色从哪里来。它说的是身份，不是含义：分布图各区间的含义仍由区段说了算。 | 普通颜色 · 一种颜色 · 一个颜色点位 | 普通颜色 |
| 浅色 / 深色 | 强调色作为浅色和深色的一对，两个都要写，因为由当前运行的主题决定屏幕上出现哪一半。只在强调色是一种颜色时显示。 | 各写 `#RRGGBB` | 两者都是 `#5470C6` |
| 颜色点位 | 强调色所跟随的那个 Color 点位的带根 Logic 地址。只在强调色是颜色点位时显示。 | 地址 | 空 |

分布图只统计质量良好且有限的采样点，所以质量不可用读起来就是统计到的采样点变少，正如它在曲线上读起来是一个洞。所有统计到的采样点读到的是同一个值时，就只有一个区间装着它们全部。卡片会在分布图上写出它统计了什么。

## 历史 {#history}

两个不同的旋钮，和[折线图](component-line-chart)上的一样：窗口是卡片框住的那一段，保留量是工作站在它背后存下的东西。采样点存在内存里；重启应用，采集就重新开始。

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 保留 | 保留量的那些数字表示什么。 | 只保留窗口内的 · 一段时间 · 一定数量的采样点 | 只保留窗口内的 |
| 保留时长（s） | 保留量按一段时间计时所保留的那段时长。 | 5 到 604,800（7 天） | 600 |
| 保留数量（采样点） | 保留量按采样点数量计时所保留的个数。 | 2 到 20,000 | 2,000 |

工作站在三个上限之内批准保留量：每个点位 20,000 个采样点，每个组件 60,000 个，整个工作站 200,000 个。某个上限没能整份批准的保留量，会写在卡片上，而不只是写在编辑器里，这样只读客户端上的操作员才不会读到一段更短的历史却没有任何解释。工作站自己的上限已经用完时，卡片根本不采集任何数据，并且把这件事说出来：“工作站已经用满了它允许保留的历史，因此这个系列什么也采集不到。请缩短另一张图的保留量来腾出空间。”。

## 高级 {#advanced}

一个折叠起来的分区，装着多数卡片从不去动的那两个字段。

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 窗口（s） | 迷你曲线和统计量覆盖的那个滚动窗口。 | 5 到 86,400（1 天） | 60 |
| 采样间隔（ms） | 这张卡片自己的采样节奏。 | 100（逻辑扫描周期）到 3,600,000（1 小时） | 500 |

## 刻度 {#scale}

共用的**刻度**分区声明各个区段和参考值。

- 每个**区段**从它上面那个区段结束的地方开始，一直覆盖到自己的上限；色调（中性、信息、正常、注意、严重）给大字读数上色，配了说法的区段则把自己的名称写在统计那一行上，那正是颜色说不出来的那件事。
- **参考值**是差值所对照的东西：可以不设、设一个固定值，或者设一个随配方移动的点位。