chronaxis.results.manifest

定义运行清单和输出清单。运行清单记录配置、实际输入、时间解释、使用的实现及资源统计；输出清单记录发布后的文件和状态。未取得的信息保留为空，不把空值解释为检查通过。

这是模块参考。日常调用先查公开API索引；下划线对象和嵌套函数供维护者查阅。签名来自固定源码，公开类构造签名经实际Python接口核对。

相关类型

AggregationPlan、AnalysisOutcome、CANFrameFormatNotice、CANSourceMetadata、CANUnitCheck、InputDiagnostic、Interval、LegacyCANField、Path、PresetBindingMetadata、PresetRoleMetadata、QualityFlag、RuleOutcome、SignalDefinition、SummaryThresholdDuration、TextCANSourceMetadata、ThresholdDurationMetadata

对象导航

from dataclasses import dataclass, asdict, field, fields
from datetime import datetime
from math import isfinite, isnan
from pathlib import Path
from sys import getsizeof
from .._version import software_version
from ..core.validation import require_text, require_identifier
from ..core.models import Interval
from ..core.binding import SignalDefinition
from ..core.types import QualityFlag
from .binding_metadata import PresetBindingMetadata, PresetRoleMetadata
from .can_metadata import CANSourceMetadata, CANUnitCheck, CANFrameFormatNotice
from .text_can_metadata import TextCANSourceMetadata
from .threshold_metadata import ThresholdDurationMetadata, SummaryThresholdDuration
from .input_diagnostics import InputDiagnostic
from .analysis_outcome import AnalysisOutcome, RuleOutcome
from ..legacy.records import LegacyCANField

RunMetadata

保存一次运行的身份、实际计算后端、时间解释及诊断摘要。通常从仍打开的AnalysisResult.metadata读取，不需要自行构造。来源明细字段是可选模型：只有调用方提供真实读取明细时才有内容。当前AnalysisRunner没有填充can_sources和text_can_sources，两者保持空元组；这不表示没有读取CAN文件，也不表示DBC已经校验。to_dict的摘要与详细模式见下方方法说明。

RunMetadata(run_id: str, input_identity: str | None, plan_hash: str, backend: str, config_version: int, source_time_interpretation: str, session_boundaries: tuple[tuple[str, int, int], ...], started_at: str, mapping_hashes: tuple[str, ...] = (), dbc_hashes: tuple[str, ...] = (), parsing_policy: str = 'decoded-results', worker_config: str = 'single-thread', dependency_versions: tuple[tuple[str, str], ...] = (), limitations: tuple[str, ...] = (), software_version: str = <factory>, device_label: str = 'pending', signal_bindings: tuple[chronaxis.core.binding.SignalDefinition, ...] = (), preset_bindings: tuple[chronaxis.results.binding_metadata.PresetBindingMetadata, ...] = (), can_sources: tuple[chronaxis.results.can_metadata.CANSourceMetadata, ...] = (), session_ids: tuple[str, ...] = (), text_can_sources: tuple[chronaxis.results.text_can_metadata.TextCANSourceMetadata, ...] = (), threshold_durations: tuple[chronaxis.results.threshold_metadata.SummaryThresholdDuration, ...] = (), detailed_diagnostics: bool = False, retain_work: bool = False, input_diagnostics: tuple[chronaxis.results.input_diagnostics.InputDiagnostic, ...] = (), trace_requested: bool = False, integrity_diagnostics: bool = False, frame_format_notices: tuple[tuple[str, chronaxis.results.can_metadata.CANFrameFormatNotice], ...] = (), analysis_outcome: chronaxis.results.analysis_outcome.AnalysisOutcome | None = None, aggregation_definitions: tuple = ()) -> None

属性与数据字段

源码：src/chronaxis/results/manifest.py:29（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

RunMetadata.__post_init__

验证清单文本与明确会话范围，不访问外部输入。

RunMetadata.__post_init__() -> None

参数：无显式参数。

参数说明

无。

返回说明

返回None，不返回额外的计算值。

异常说明

TypeError/ValueError为结构或事实格式错误。

本函数直接报告的具体错误：

• ValueError：结果清单需实际reference/numpy及配置版本1。
• ValueError：started_at必须带时区。
• TypeError：session_boundaries需tuple。
• TypeError：依赖版本需(name,version)tuple。
• TypeError：贡献输出清单需要ContributionOutputMetadata或None。
• TypeError：运行绑定清单需SignalDefinition及PresetBindingMetadata tuple。
• ValueError：运行绑定清单不能重复别名。
• ValueError：运行绑定清单不能重复预设ID。
• ValueError：预设最终角色必须引用本清单实际信号别名。
• TypeError：阈值汇总需ThresholdDurationMetadata tuple。
• ValueError：阈值汇总必须对应本次预设及生成规则，不能重复。
• TypeError：独立会话身份需要无重复tuple。
• TypeError：文本CAN清单需要TextCANSourceMetadata tuple。
• ValueError：文本CAN清单来源重复。
• TypeError：CAN运行清单需要CANSourceMetadata tuple。
• ValueError：CAN运行清单来源重复。
• TypeError：会话边界需(session_id,start,end)。
• TypeError：清单会话边界需原生int纳秒。
• TypeError：清单映射/限制需要非空文本tuple。
• ValueError：文本CAN清单会话错误。
• ValueError：文本CAN单位清单必须覆盖实际绑定。
• ValueError：CAN运行清单会话不属于本次session_boundaries。
• ValueError：CAN单位清单必须恰好覆盖同来源本次实际绑定别名。
• ValueError：CAN单位核对别名/来源/input_unit与本次原声明不同。
• ValueError：CAN帧型提示必须对应本次原信号完整定位。
• ValueError：requested固定解码集合须覆盖本次实际绑定字段及同来源通道。

返回类型：None。

源码：src/chronaxis/results/manifest.py:73（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

RunMetadata.estimated_bytes

在asdict/JSON复制前估算元数据与其临时对象开销。

RunMetadata.estimated_bytes() -> int

参数：无显式参数。

参数说明

无。

返回说明

保守bytes估算。

异常说明

无，类型已经校验。

返回类型：int。

源码：src/chronaxis/results/manifest.py:205（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

RunMetadata.to_dict

返回独立JSON兼容元数据，调用侧必须先预留estimated_bytes。

RunMetadata.to_dict() -> dict

参数：无显式参数。

参数说明

无。

返回说明

独立JSON兼容dict。默认detailed_diagnostics=False只输出运行摘要及适用的可选摘要；即使模型的signal_bindings/preset_bindings/can_sources非空，也不输出这些详细键。True时展开详细模型，空的可选明细仍按规则省略。两种模式及键示例见运行清单。

异常说明

无预期异常；调用方须在复制前承担estimated_bytes预算。

返回类型：dict。

源码：src/chronaxis/results/manifest.py:216（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

_metadata_size

统计已校验元数据树的基础对象大小，不产生转换树。

_metadata_size(value) -> int

参数

返回说明

基础bytes估算。

异常说明

无。

返回类型：int。

源码：src/chronaxis/results/manifest.py:306（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

OutputManifest

保存成功发布目录、清单和固定白名单表行数；legacy只在启用时出现。

OutputManifest(run_id: str, output_dir: pathlib.Path, manifest_path: pathlib.Path, output_files: tuple[pathlib.Path, ...], row_counts: tuple[tuple[str, int], ...], status: str = 'completed') -> None

属性与数据字段

源码：src/chronaxis/results/manifest.py:333（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

OutputManifest.__post_init__

校验返回清单身份，不凭构造调用证明目录已发布。

OutputManifest.__post_init__() -> None

参数：无显式参数。

参数说明

无。

返回说明

返回None，不返回额外的计算值。

异常说明

TypeError/ValueError为字段错误。

本函数直接报告的具体错误：

• ValueError：OutputManifest需completed和Path。
• TypeError：输出路径需tuple Path。
• ValueError：输出行数需固定表及非负原生int。

返回类型：None。

源码：src/chronaxis/results/manifest.py:343（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

ExportManifest

独立信号或原帧导出的实际输出路径；调用者无需猜测时间文件名。

ExportManifest(output_dir: pathlib.Path, manifest_path: pathlib.Path, output_files: tuple[pathlib.Path, ...]) -> None

属性与数据字段

源码：src/chronaxis/results/manifest.py:360（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

ExportManifest.__post_init__

核对实际路径类型和所属目录。

ExportManifest.__post_init__()

参数：无显式参数。

参数说明

无。

返回说明

None。

异常说明

类型或路径错，不访问文件。

源码：src/chronaxis/results/manifest.py:367（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。