46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# 算法输出规范执行通知（转发模板）
|
||
|
||
各位算法同事：
|
||
|
||
为统一平台“算法结果”中的任务号、测量位置、单位、公差和中间数据，从现在起请新交付算法以及存量算法的后续版本遵循：
|
||
|
||
`alg/00_算法交付与输出规范/README.md`
|
||
|
||
目录内同时提供：
|
||
|
||
- `result.schema.json`：完整 JSON Schema；
|
||
- `validate_result.py`：零第三方依赖校验器；
|
||
- `examples/head-car-coupler-and-deflection.result.json`：正确示例；
|
||
- `examples/invalid-legacy-result.json`：禁止的旧写法反例。
|
||
|
||
本次最关键的变化：
|
||
|
||
1. 正式测量结果必须单独返回 `taskNo`，不再把任务号写在 `name` 中；
|
||
2. `name` 只保留纯项目名称；同一任务的左/右等多个结果使用 `position` 区分；
|
||
3. 每个指标必须提供稳定的 `metricCode`；
|
||
4. 头车/中车必须依据输入的检测对象选择任务号，不得默认猜测；
|
||
5. `dx_y`、`dx_z`、拟合残差、法向量等中间量不得进入正式 `measurements`，统一放入 `extra.intermediateMetrics`；
|
||
6. 正式结果只允许 `pass`、`warning`、`fail`，不再用 `info` 表示可交付项；
|
||
7. 交付前请执行：
|
||
|
||
```bash
|
||
python3 alg/00_算法交付与输出规范/validate_result.py /path/to/result.json
|
||
```
|
||
|
||
请各算法负责人先检查自己的输出，并回复以下信息：
|
||
|
||
- 指标与正式业务任务号的映射是否完整；
|
||
- 哪些输出是正式测量值，哪些只是计算中间量；
|
||
- 同一指标是否会因头车/中车等检测对象对应不同任务号；
|
||
- 单位、公差、理论值和换算口径是否与正式任务清单一致；
|
||
- 预计从哪个算法版本开始按新规范交付。
|
||
|
||
车钩与挠度算法请重点确认：
|
||
|
||
- 任务 5 的左梁、右梁作为同一任务的两个 `position` 输出；
|
||
- 头车车钩对应任务 8、10，中车对应任务 9、12；
|
||
- `dx_y`、`dx_z` 仅保留为中间量；
|
||
- “右偏转角”最终交付口径是角度 `°`，还是偏差值/基准长度（例如 `0.073/700 mm`）。
|
||
|
||
平台插件的运行、输入、进度和产物接入仍参考 `docs/algorithm-integration-spec.md`；测量结果字段发生冲突时，以新规范为准。
|