测量数据模板与字段规范

数据能不能复用，取决于记录时有没有把条件写全。

自动化见自动化测试与数据记录；SOP 见实测 SOP：亮度、对比度与均匀性。

一、三条基本原则（入门）

① 任何影响结果的量都要记录
② 字段命名统一、单位统一
③ 原始数据与计算数据分开存

原则	违反的后果
条件不全	数据无法解释、无法比较
命名不统一	汇总统计困难
原始与计算混存	无法复核

二、字段分组设计（核心）

按"五组"组织字段：

【A. 样品组】——测的是谁
【B. 条件组】——在什么条件下测
【C. 方法组】——用什么方法测
【D. 结果组】——测到了什么
【E. 元数据组】——谁测的、什么时候

A. 样品组

字段	说明
`sample_id`	样品编号
`model`	型号
`serial`	序列号
`fw_version`	固件版本
`panel_type`	面板类型
`use_hours`	累计使用时长（若可得）
`sample_count`	样本数量（单台/多台）

B. 条件组

字段	说明
`mode`	显示器模式名
`brightness_setting`	亮度设置值
`contrast_setting`	对比度设置值
`color_temp_setting`	色温设置
`input_source`	输入源
`resolution`	分辨率
`refresh_rate`	刷新率
`bit_depth`	色深
`chroma_subsampling`	色度抽样
`rgb_range`	RGB 范围
`hdr_mode`	HDR 开关与模式
`metadata`	HDR 元数据设定
`warmup_minutes`	预热时长
`ambient_lux`	环境照度
`ambient_temp_c`	环境温度
`darkroom_verified`	暗室是否验证

C. 方法组

字段	说明
`standard`	依据标准/方法（含版本）
`instrument_model`	仪器型号
`instrument_serial`	仪器序列号
`instrument_cal_due`	校准有效期
`correction_profile`	校正文件标识
`distance_mm`	测量距离
`angle_deg`	测量角度
`probe_spot`	探头口径
`measurement_points`	测点方式（中心/九点）
`pattern_source`	图案源
`pattern_params`	图案参数（码值/窗口面积）
`measurement_order`	测量顺序
`drift_check`	漂移监控结果
`observer`	观察者（2°/10°）
`delta_e_formula`	ΔE 公式
`uniformity_formula`	均匀性计算式

D. 结果组

字段	说明
`luminance_cdm2`	亮度
`x` / `y`	色坐标
`cct_k`	色温
`duv`	相对黑体偏移
`black_level`	黑位
`contrast_static`	静态对比度
`peak_luminance`	峰值亮度（含窗口面积）
`sustained_luminance`	持续亮度
`gamma_fit`	Gamma 拟合结果
`eotf_deviation`	EOTF 偏差
`gamut_coverage`	色域覆盖率（含目标空间）
`gamut_volume`	色域容积
`delta_e_avg`	ΔE 平均值
`delta_e_max`	ΔE 最大值
`delta_e_blocks`	ΔE 色块数
`uniformity_pct`	均匀性百分比
`gtg_avg_ms`	GtG 平均
`gtg_max_ms`	GtG 最差
`overshoot_pct`	过冲幅度

E. 元数据组

字段	说明
`measured_at`	测量时间（含时区）
`operator`	测量人
`script_version`	自动化脚本版本
`notes`	备注（异常、假设）

三、CSV 结构建议（实用）

结构 1：单点测量（宽表）

csv

sample_id,model,serial,mode,brightness_setting,resolution,refresh_rate,instrument_model,correction_profile,ambient_lux,warmup_minutes,luminance_cdm2,x,y,cct_k,measured_at

宽表适合"一行一台机器的一次测量"，便于统计。

结构 2：灰阶扫描（长表）

csv

sample_id,run_id,step_index,pattern_code,luminance_cdm2,x,y,note

长表适合"一次测量产生多条记录"，便于绘图与透视。

结构 3：九点均匀性

csv

sample_id,run_id,point_id,position_label,luminance_cdm2,x,y

关键约定：

约定	建议
编码	UTF-8（避免中文乱码）
分隔符	逗号（字段内避免逗号，或用引号包裹）
时间	ISO 风格（含时区）
单位	写在字段名里（`_cdm2`、`_ms`、`_pct`）
缺失值	统一用空或 `NA`，不要混用
小数位	统一（如亮度 3 位、色坐标 4 位）

四、文件命名与目录规范（进阶）

data/
└── 2026-10-01_<型号>_<用途>/
    ├── README.md              # 本次测量的说明与结论摘要
    ├── settings.md            # 条件快照（人可读）
    ├── conditions.csv         # 条件（机器可读）
    ├── raw/
    │   ├── grayscale.csv      # 原始灰阶数据
    │   ├── gamut.csv
    │   └── uniformity.csv
    ├── processed/
    │   ├── gamma_fit.csv
    │   └── delta_e.csv
    ├── reports/               # 校准软件导出的报告
    └── notes.md               # 异常与假设

命名建议：

元素	说明
日期	`YYYY-MM-DD`
型号	脱敏或通用代号
用途	如 `calibration`、`eval`、`qa`
版本	多次测量加 `_v2`

五、条件快照模板（人可读，必备）

markdown

# 测量条件快照

## 样品
- 型号 / 序列号：
- 固件版本：
- 累计使用时长：

## 显示器设置
- 模式：
- 亮度 / 对比度：
- 色温 / 色彩模式：
- 输入源 / 分辨率 / 刷新率：
- 色深 / 色度抽样 / RGB 范围：
- HDR：开 / 关，模式：____，元数据：____
- 已关闭的动态功能：□动态对比 □节能 □护眼 □自动亮度 □环境光自适应

## 环境
- 暗室验证：□是（关屏反射亮度：____ cd/m²）
- 环境照度：____ lx
- 温度：____ ℃
- 预热：____ 分钟

## 仪器与方法
- 仪器型号 / 序列号 / 校准有效期：
- 校正文件：
- 距离 / 角度 / 探头口径：
- 测点方式：
- 图案源与图案参数：
- 观察者 / ΔE 公式 / 均匀性公式：
- 测量顺序：

## 漂移监控
- R₀：____  R（结束）：____  偏差：____  判定：□可用 □需重测

六、数据质量检查清单（提交前）

□ 样品与固件版本已记录
□ 显示器设置已记录（含关闭了哪些动态功能）
□ 环境条件已记录（含暗室验证结果）
□ 仪器型号/序列号/校准有效期已记录
□ 校正文件标识已记录
□ 几何条件（距离/角度/测点）已记录
□ 图案参数已记录（码值/窗口面积）
□ 观察者与 ΔE 公式已记录
□ 均匀性计算式已记录
□ 漂移监控结果已记录
□ 原始数据与计算数据分开存放
□ 编码为 UTF-8，单位在字段名中
□ 异常与假设已写入 notes

⚠️ 缺少任一项，数据就只能自己用，无法对比或复用。

七、归档与复用（进阶）

做法	价值
按日期+型号分目录	便于检索
保留原始数据	可重新计算
记录软件/脚本版本	可复现
结论与数据同存	避免"有数据不知结论"
定期备份	防丢失
脱敏处理	对外分享时保护信息
建立索引文件	汇总所有测量批次

索引文件示例：

markdown

# 测量数据索引

| 日期 | 样本代号 | 用途 | 目录 | 备注 |
|---|---|---|---|---|
| 2026-10-01 | A-27-4K | 校准 | data/2026-10-01_A-27-4K_calibration/ | 首次校准 |

八、常见误区

误区	事实
"存了结果就够了"	没条件的数据无法复用
"Excel 自动处理就好"	字段不统一无法汇总
"单位不写也知道"	换人/换时间就不知道
"原始数据不用留"	无法复核与重算
"文件名无所谓"	检索成本急剧上升
"样本量不用写"	影响结论强度

关键概念速查

通用术语见统一速查（由统计生成，只在一处维护）。

术语	英文	含义
宽表 / 长表	Wide / Long Table	两种数据结构
原始数据	Raw Data	未经计算的数据
派生数据	Derived Data	计算后的数据
字段规范	Schema	字段定义
脱敏	Anonymization	去除敏感标识
数据索引	Data Index	批次汇总

测量数据模板与字段规范 ​

一、三条基本原则（入门） ​

二、字段分组设计（核心） ​

A. 样品组 ​

B. 条件组 ​

C. 方法组 ​

D. 结果组 ​

E. 元数据组 ​

三、CSV 结构建议（实用） ​

结构 1：单点测量（宽表） ​

结构 2：灰阶扫描（长表） ​

结构 3：九点均匀性 ​

四、文件命名与目录规范（进阶） ​

五、条件快照模板（人可读，必备） ​

六、数据质量检查清单（提交前） ​

七、归档与复用（进阶） ​

八、常见误区 ​

关键概念速查 ​

相关文档 ​

测量数据模板与字段规范

一、三条基本原则（入门）

二、字段分组设计（核心）

A. 样品组

B. 条件组

C. 方法组

D. 结果组

E. 元数据组

三、CSV 结构建议（实用）

结构 1：单点测量（宽表）

结构 2：灰阶扫描（长表）

结构 3：九点均匀性

四、文件命名与目录规范（进阶）

五、条件快照模板（人可读，必备）

六、数据质量检查清单（提交前）

七、归档与复用（进阶）

八、常见误区

关键概念速查

相关文档