17-EFT.WP.Methods.Imaging v1.0 | 附录C 清单模板与样例（成像专属）

目录 ／ 文档-技术白皮书（V5.05） ／ 17-EFT.WP.Methods.Imaging v1.0

附录C 清单模板与样例（成像专属）

一句话目标：提供成像链路从采集到发布的标准清单结构、必填键与可选扩展，并给出可直接对照落盘的样例。

I. 范围与对象

• 覆盖对象：Image, Cube, EventStream, ToFDepth 及其派生产物的发布清单 manifest.img.*。
• 适用阶段：实验室标定、生产发布、边缘设备在线服务三类环境的统一清单出口。
• 依赖与前置：设备与模式登记（见第3章）、辐射计量线性域（见第4章）、PSF/OTF/MTF 指标（见第5章）、采样/重建信息（见第6章）、噪声与 FPN（见第7–8章）、几何与色彩（见第9–10章）、HDR 与计算成像（见第11–12章）、时间/路径门控与到达时（见第13章）、质量与审计（见第14章）。

II. 命名与结构约定

• 根命名空间：manifest.img。统一键风格为小写加下划线或驼峰，不混用。
• 版本与配置：manifest.img.version, profile ∈ {Lab, Prod, Edge}。
• 追溯键：TraceID, dataset_id, source.device_id, source.mode_id, firmware.
• 时间语义：同时记录 ts 与 tau_mono，同步项 offset/skew/J，到达时两口径项 T_arr_form1, T_arr_form2, delta_form。
• 单位与量纲：所有可计量字段要求 unit(x), dim(x) 可推断，发布前需通过 check_dim(expr)。
• 合同化指标：所有质量与SLO键以 sli.* 命名，契约断言以 contracts.C20-* 命名，对应附录B。

III. 最小清单模板（MVP）

{

"manifest": {

"family": "img",

"version": "IMG-1.0",

"profile": "Prod",

"created_at": "2025-08-31T12:00:00Z",

"trace_id": "TRACE-xxxxxxxx",

"dataset_id": "DS-xxxxxxxx"

},

"source": {

"device_id": "DEV-xxxx",

"mode_id": "MODE-xxxx",

"firmware": "vX.Y.Z"

},

"images": [

{

"rid": "RID-xxxx",

"ts": "2025-08-31T11:59:59.123Z",

"tau_mono": 1234567890.123456,

"size": {"w": 3840, "h": 2160},

"format": "RAW",

"bit_depth": 12,

"channels": ["R","G","B"],

"space": "linear",

"unit": "DN",

"m": 0,

"q_score": 0.97

}

],

"timing": {

"offset": 2.3e-6,

"skew": 1.0e-6,

"jitter_p99": 5.0e-6,

"arrival": {

"T_arr_form1": 1.234e-9,

"T_arr_form2": 1.233e-9,

"delta_form": 1.0e-12

}

},

"contracts": {

"C20-001": "pass",

"C20-002": "pass",

"C20-1104": "pass"

},

"signing": {

"sha256": "abcdef...1234",

"signature": "sig(...)"

}

}

IV. 完整清单模板（扩展域）

{

"manifest": {"family":"img","version":"IMG-1.0","profile":"Prod","created_at":"<iso8601>","trace_id":"<string>","dataset_id":"<string>"},

"source": {"device_id":"<string>","mode_id":"<string>","firmware":"<string>","lens_id":"<string>","sensor_id":"<string>"},

"images": [

{"rid":"<string>","ts":"<iso8601>","tau_mono":0.0,"size":{"w":0,"h":0},"format":"RAW|RGB|YUV|DEPTH","bit_depth":0,"channels":["..."],"space":"linear|log","unit":"DN|W·sr^-1·m^-2","m":0,"q_score":0.0}

],

"radiometry": {

"linearization": {"gain":1.0,"offset_dn":0.0},

"flat": {"mean":0.0,"stdev":0.0,"unit":"DN"},

"dark": {"mean":0.0,"stdev":0.0,"unit":"DN"},

"response": {"monotonic": true}

},

"optics": {

"psf": {"normalized": true},

"mtf": {"f50":0.0,"f80":0.0,"area":0.0,"unit":"cy/pixel"},

"otf": {"cutoff":0.0,"leakage":0.0}

},

"sampling": {

"pattern":"BayerRGGB|X-Trans|Mono|MultiSpectral",

"demosaic":{"algo":"<string>","version":"<string>"},

"resample":{"algo":"<string>","scale":1.0,"alias_ratio":0.0}

},

"noise": {

"sigma_read":0.0,

"k_shot":0.0,

"nps_band_p95":0.0

},

"fpn": {"prnu":0.0,"dsnu":0.0,"bad_pixel_ratio":0.0},

"geometry": {

"K":[[0,0,0],[0,0,0],[0,0,1]],

"R":[[1,0,0],[0,1,0],[0,0,1]],

"t":[0,0,0],

"dist":{"k1":0.0,"k2":0.0,"p1":0.0,"p2":0.0},

"err_reproj":0.0

},

"color": {

"matrix":[[1,0,0],[0,1,0],[0,0,1]],

"curve":"gamma|log|linear",

"illuminant":"D65|A|F11|custom",

"DeltaE00_p95":0.0,

"DeltaE00_p99":0.0

},

"hdr": {

"exposures":[{"time":0.0,"gain":1.0,"iso":100}],

"ghosting":0.0,

"saturation_ratio":0.0

},

"computational": {

"pipeline":["denoise:NLM","sharpen:USM","deconv:Wiener"],

"params":{"denoise.strength":0.0},

"residual_l2":0.0

},

"timing": {

"offset":0.0,"skew":0.0,"jitter_p99":0.0,

"arrival":{"T_arr_form1":0.0,"T_arr_form2":0.0,"delta_form":0.0}

},

"gating": {

"Delta_t":0.0,

"S_sync":0.0

},

"sli": {

"latency_ms_p99":0.0,"drop_rate":0.0,"rho":0.0,"Wq_p95":0.0

},

"contracts": {

"C20-201":"pass|fail",

"C20-501":"pass|fail",

"C20-701":"pass|fail"

},

"artifacts": {

"demosaic_artifact":0.0,

"ringing":0.0,

"banding":0.0

},

"signing": {"sha256":"<hex>","signature":"<bytes>"}

}

V. 关键字段最小必填清单

• 追溯与版本：manifest.family, manifest.version, profile, trace_id, dataset_id。
• 源信息：source.device_id, source.mode_id, firmware。
• 影像卡片：images[].rid, images[].ts, images[].tau_mono, images[].size, images[].format, images[].space, images[].unit, images[].m, images[].q_score。
• 时基与到达时：timing.offset, timing.skew, timing.jitter_p99, timing.arrival.*。
• 签名与哈希：signing.sha256, signing.signature。

VI. 样例A：单帧 RAW（实验室标定）

{

"manifest":{"family":"img","version":"IMG-1.0","profile":"Lab","created_at":"2025-08-31T10:00:00Z","trace_id":"T-LAB-001","dataset_id":"DS-LAB-001"},

"source":{"device_id":"DEV-DSLR-01","mode_id":"MODE-RAW-12b","firmware":"v1.2.3","lens_id":"LENS-50mm","sensor_id":"SNS-IMXxxx"},

"images":[{"rid":"RID-0001","ts":"2025-08-31T09:59:59.001Z","tau_mono":1714470000.001,"size":{"w":6048,"h":4024},"format":"RAW","bit_depth":12,"channels":["R","G","B"],"space":"linear","unit":"DN","m":0,"q_score":0.99}],

"radiometry":{"linearization":{"gain":1.87,"offset_dn":64.0},"flat":{"mean":1023.4,"stdev":3.2,"unit":"DN"},"dark":{"mean":64.1,"stdev":1.1,"unit":"DN"},"response":{"monotonic":true}},

"optics":{"mtf":{"f50":0.32,"f80":0.21,"area":0.48,"unit":"cy/pixel"},"otf":{"cutoff":0.5,"leakage":0.01}},

"timing":{"offset":1.2e-6,"skew":7.0e-7,"jitter_p99":4.5e-6,"arrival":{"T_arr_form1":1.010e-9,"T_arr_form2":1.009e-9,"delta_form":1.0e-12}},

"contracts":{"C20-001":"pass","C20-101":"pass","C20-201":"pass","C20-1104":"pass"},

"signing":{"sha256":"1a2b...","signature":"sig(...)"}

}

VII. 样例B：HDR 融合（生产环境）

{

"manifest":{"family":"img","version":"IMG-1.0","profile":"Prod","created_at":"2025-08-31T12:34:56Z","trace_id":"T-PROD-042","dataset_id":"DS-PROD-888"},

"source":{"device_id":"DEV-MOBILE-02","mode_id":"MODE-HDRx3","firmware":"v3.4.5"},

"images":[{"rid":"RID-042A","ts":"2025-08-31T12:34:55.900Z","tau_mono":1714471234.900,"size":{"w":4000,"h":3000},"format":"RGB","bit_depth":10,"channels":["R","G","B"],"space":"linear","unit":"DN","m":0,"q_score":0.94}],

"hdr":{"exposures":[{"time":1.0e-3,"gain":1.0,"iso":100},{"time":8.0e-3,"gain":1.0,"iso":100},{"time":0.5e-3,"gain":1.0,"iso":100}],"ghosting":0.02,"saturation_ratio":0.004},

"computational":{"pipeline":["merge:reinhard","denoise:BM3D","tone:local"],"residual_l2":0.008},

"sli":{"latency_ms_p99":22.7,"drop_rate":0.002,"rho":0.61,"Wq_p95":3.1},

"contracts":{"C20-801":"pass","C20-802":"pass","C20-1101":"pass","C20-1102":"pass"},

"signing":{"sha256":"aa55...","signature":"sig(...)"}

}

VIII. 样例C：ToF 深度与强度（时间/路径门控）

{

"manifest":{"family":"img","version":"IMG-1.0","profile":"Edge","created_at":"2025-08-31T08:08:08Z","trace_id":"T-TOF-007","dataset_id":"DS-TOF-007"},

"source":{"device_id":"DEV-ToF-A1","mode_id":"MODE-DCM-4Phase","firmware":"v0.9.9"},

"images":[

{"rid":"RID-D-0007","ts":"2025-08-31T08:08:07.999Z","tau_mono":1714470808.000,"size":{"w":640,"h":480},"format":"DEPTH","bit_depth":16,"channels":["Z"],"space":"linear","unit":"m","m":0,"q_score":0.91},

{"rid":"RID-I-0007","ts":"2025-08-31T08:08:07.999Z","tau_mono":1714470808.000,"size":{"w":640,"h":480},"format":"RAW","bit_depth":12,"channels":["I"],"space":"linear","unit":"DN","m":0,"q_score":0.93}

],

"gating":{"Delta_t":2.5e-9,"S_sync":0.97},

"timing":{"offset":3.0e-6,"skew":8.0e-7,"jitter_p99":6.0e-6,"arrival":{"T_arr_form1":8.33e-10,"T_arr_form2":8.32e-10,"delta_form":1.0e-12}},

"geometry":{"K":[[580,0,320],[0,580,240],[0,0,1]],"R":[[1,0,0],[0,1,0],[0,0,1]],"t":[0,0,0],"dist":{"k1":-0.12,"k2":0.03,"p1":0.0,"p2":0.0},"err_reproj":0.42},

"contracts":{"C20-1001":"pass","C20-1002":"pass","C20-1003":"pass","C20-601":"pass"},

"signing":{"sha256":"deadbeef...","signature":"sig(...)"}

}

IX. 字段与章节的映射关系（便于审计）

• radiometry.* ↔ 第4章；optics.* ↔ 第5章；sampling.* ↔ 第6章。
• noise.* ↔ 第7章；fpn.* ↔ 第8章；geometry.* ↔ 第9章。
• color.* ↔ 第10章；hdr.* ↔ 第11章；computational.* ↔ 第12章。
• gating.*, timing.arrival.* ↔ 第13章；sli.*, contracts.*, signing.* ↔ 第14章与《Methods.Cleaning v1.0》第10章。

X. 实现绑定与落盘不变量

1. 生成流程：
   • I20-112 emit_metrics(img, cfg) -> metrics：汇集本卷章节度量。
   • I20-113 emit_qc_manifest(metrics, policy) -> manifest.img：注入 contracts 与 sli，完成签名与哈希。
2. 不变量：
   • unique(images[].rid)；non_decreasing(images[].ts)；space="linear" 对应辐射域。
   • timing.arrival.delta_form ≤ tol_Tarr；signing.sha256 与 signature 一致可验证。
   • check_dim( y - f(x) ) = 0 对所有跨域表达式成立。

XI. 交叉引用

• 到达时两口径与时间语义：见第13章。
• 契约与策略卡映射：见附录B C20-*。
• 合规与发布冻结：见《Methods.Cleaning v1.0》第10章。
• 背压与SLO字段：见《Methods.Cleaning v1.0》第11章与本卷第14章。