Chronaxis 0.1.0.dev4

Chronaxis 0.1.0.dev4 开发预览版 / Development preview

本版改善默认 CSV 预算、常见 ASC 输入、默认计算后端与流式计算效率，并更新中英文手册和随包 AI 指南。分析配置使用整数 config_version: 4。

This preview improves CSV resource accounting, common ASC inputs, execution efficiency, and bilingual documentation. Analysis configurations use integer config_version: 4.

• 中文发行说明
• English release notes
• 中文用户手册 · English manual

附件包含纯净源码、可离线阅读的双语手册及 AI 指南、wheel、sdist 和 SHA-256 校验表。支持范围、依赖条件及已知限制见发行说明。

Release assets include the clean source, offline bilingual manual with AI guides, wheel, sdist, and SHA-256 checksums. See release notes for supported environments and limitations.

Install / 安装：

python -m pip install "chronaxis==0.1.0.dev4"
python -m chronaxis guide

PyPI 0.1.0.dev4

Chronaxis 0.1.0.dev3

Chronaxis 0.1.0.dev3

本版改进持续条件和配置诊断，增加连续 ASC/BLF 分卷的多进程运行支持，并完成中英文手册和 AI 指南的复审修订。适用于 Windows、Python 3.12，仍为开发预览版。

主要变化

• 持续条件必须显式填写 duration_comparison: ">="（达到）或 ">"（严格超过）。从 dev2 升级时，请按每条规则的业务含义补齐，避免临界区间被错误选入。
• 配置错误先报告缺失的操作类型，避免连带要求填写无关字段；标准校验器错误转换为用户可读的诊断。
• 普通分析支持连续 ASC/BLF 文件的并行读取和解码；高性能积分器支持同一会话分卷的并行读取、解码和同帧求值。execution.process_count 是工作进程上限，实际执行取决于输入和归并方式。
• 手册、字段/API 参考、英文资料和随包 AI 指南同步修订，示例路径已在安装环境核验。

安装或升级：

python -m pip install --upgrade "chronaxis==0.1.0.dev3"
python -m chronaxis guide

完整发行说明 · 中文手册 · 英文手册 · PyPI

分析配置仍为整数 config_version: 4。性能取决于分析任务和输入；既有性能及内存目标的限制继续保留，详见手册高性能积分器章节。依赖限制见安全说明。

---

Chronaxis 0.1.0.dev3

This development preview improves sustained-condition validation and configuration diagnostics, supports multiprocessing for continuous ASC/BLF recordings, and incorporates the reviewed Chinese and English manuals and bundled AI guide. It targets Windows and Python 3.12.

• Sustained conditions now require an explicit duration_comparison: ">=" for at least the threshold, or ">" for strictly more. When upgrading from dev2, choose according to each rule's intended meaning.
• Missing operation types are reported without cascading demands for unrelated fields. Schema errors are converted into readable diagnostics.
• Ordinary analysis supports parallel reading and decoding across continuous ASC/BLF files. The fast integrator also parallelizes same-frame evaluation. execution.process_count is an upper bound, not a guaranteed number of workers.
• Manuals, API references, and the AI guide were reviewed together. English example paths were verified from the documented working directory in an installed package.

python -m pip install --upgrade "chronaxis==0.1.0.dev3"
python -m chronaxis guide --language en

Release notes · English manual · PyPI

Analysis configurations use integer config_version: 4. Performance depends on the workload; existing performance and memory limitations remain documented. See the security notes for dependency limitations.

Maintainer / 维护者: liuyaoze, work@liuyaoze.com.

Chronaxis 0.1.0.dev2

Chronaxis 0.1.0.dev2

English

本版扩展配置校验、表达式与统计计算，增加高性能积分器，并同步中英文手册和随包 AI 指南。它仍属于开发预览版，运行环境为 Windows、Python 3.12。

安装或升级：

python -m pip install --upgrade "chronaxis==0.1.0.dev2"
python -m chronaxis guide

相比 0.1.0.dev1 的变化

功能	本版行为
配置诊断	一次返回多个可独立定位的配置错误，给出字段位置；依赖错误字段的后续检查仍可能需要先修正前置错误。
结果发布	可以重复使用输出目录；同次输出采用统一时间后缀，不覆盖已有文件，完成清单最后发布。
单位与表达式	分析配置使用版本 4，支持兼容单位自动换算、带单位常量、条件分支、数值与位运算、一维标定查表。
统计与时序变换	增加计数、方差、标准差、均方根、分位数和中位数，以及结果聚合、滚动统计和变化率。
自定义分析算子	宿主 Python 程序可显式注册表达式、统计和时序算子，配置按注册名称使用。
高性能积分器	使用独立的 fast validate/explain/run 和 fast batch 入口，对独立 ASC/BLF 文件中的同帧公式逐报文累计；批量任务支持按文件并行。它有明确的支持范围，不会自动替换通用分析。
使用资料	完善功能说明、配置示例及实际结果解释，提供中英文手册和可直接阅读的 AI 指南；教学结果在各分发形式中保留原始字节，并核对摘要。

高性能积分器直接累计每条匹配报文的表达式结果。由功率求能量时，表达式需要包含相应时间因子；如果输入已经是每条报文的能量贡献，则直接累计。性能取决于任务和输入，不能把该入口的测量结果推广到所有分析。

已完成真实数据数值和功能核对，但部分耗时、内存目标仍未达到。请按任务和可用资源选择高性能积分器；本次发布不表示全部性能目标已通过。

从旧版升级

本版只接受整数 config_version: 4。 版本 3 分析配置、旧 INI 专用导入入口及其映射配置已移除。独立批量清单仍使用 batch_version: 1；它与分析配置的版本号分别管理。

请参照当前示例核对旧分析配置，不能只把 3 改成 4 就认为结果含义不变：

1. 核对信号的输入单位、目标单位和换算系数。conversion.scale 与 conversion.offset 都未填写时，程序按已登记的兼容单位自动换算；显式填写任一个系数时会校验完整换算，不再额外叠加一次自动换算。
2. 核对表达式中的常量单位、比较与计算输出单位，按当前字段规则处理报错。先用已知输入和结果运行小例，再处理实际日志。
3. 旧 INI 任务需要按当前分析配置重新表达。YAML／JSON 格式转换命令只转换文件格式，不会自动迁移配置版本或旧业务含义。
4. 若其他程序读取输出文件，不要依赖固定文件名；使用本次返回的运行清单定位带时间后缀的结果。

字段和示例见信号绑定、表达式、统计与积分、时序变换、自定义分析算子及高性能积分器。

在线中文手册和英文手册对应当前发布版；历史版本手册保存在对应 GitHub Release 中。默认运行依赖与 0.1.0.dev1 相同，CAN 依赖无需额外安装组。

维护者：liuyaoze，work@liuyaoze.com。

---

Chronaxis 0.1.0.dev2

简体中文

This release expands configuration diagnostics, expressions and statistical calculations, adds the high-performance integrator, and updates the Chinese and English manuals and bundled AI guide. It remains a development preview for Windows and Python 3.12.

Install or upgrade:

python -m pip install --upgrade "chronaxis==0.1.0.dev2"
python -m chronaxis guide --language en

Changes since 0.1.0.dev1

Feature	Behavior in this release
Configuration diagnostics	Reports multiple independently identifiable configuration errors with field locations. Checks that depend on an invalid field may still require that error to be fixed first.
Result publication	Reuses output directories, gives files from one publication a common timestamp suffix, preserves existing files, and publishes the completion manifest last.
Units and expressions	Uses analysis configuration version 4, with automatic conversion of compatible units, unit-bearing constants, conditional expressions, numeric and bitwise operations, and one-dimensional calibration lookup.
Statistics and temporal transforms	Adds counts, variance, standard deviation, RMS, quantiles and medians, as well as result aggregation, rolling statistics and rates of change.
Custom analysis operators	A host Python program can explicitly register expression, statistical and temporal operators, then reference their registered names in configuration.
High-performance integrator	Provides separate fast validate/explain/run and fast batch entries for same-frame per-message accumulation in independent ASC/BLF files. Batch tasks can process files in parallel. This entry has a defined supported scope and does not automatically replace general analysis.
User documentation	Improves feature explanations, configuration examples and actual result interpretation, with bilingual manuals and an AI guide that can be read directly. Teaching results retain their original bytes across distribution formats and are checked against their summaries.

The high-performance integrator adds the expression result from each matching message. Calculating energy from power requires the appropriate time factor in the expression. Inputs that already represent per-message energy contributions are added directly. Performance depends on the task and input; measurements of this entry do not establish performance for all analyses.

Real-data numerical and functional checks are complete, but some runtime and memory targets remain unmet. Select this integrator according to the task and available resources; this release does not establish that all performance targets have passed.

Upgrading from an earlier version

This release accepts only the integer config_version: 4. Version 3 analysis configurations, the dedicated legacy INI import entry points and their mapping configurations have been removed. Independent batch manifests continue to use batch_version: 1, a separate version from analysis configuration.

Review older analysis configurations against the current examples. Changing 3 to 4 alone does not establish that the analysis retains the same meaning:

1. Check input units, target units and conversion coefficients. When both conversion.scale and conversion.offset are omitted, registered compatible units are converted automatically. Supplying either coefficient makes the program validate the complete conversion; it does not apply a second automatic conversion.
2. Check units on expression constants, comparisons and calculation outputs. Resolve errors using the current field rules, then run a small case with known inputs and results before processing actual logs.
3. Express legacy INI tasks in the current analysis format. The YAML/JSON conversion command changes file format only; it does not migrate configuration versions or old business rules.
4. If another program reads output files, locate the timestamped files through the returned run manifest instead of relying on fixed filenames.

See signal binding, expressions, statistics and integration, temporal transforms, custom analysis operators, and the high-performance integrator.

The online Chinese manual and English manual cover the current release. Manuals for earlier versions remain attached to their GitHub Releases. Default runtime dependencies are unchanged from 0.1.0.dev1, and CAN support needs no extra dependency group.

Maintainer: liuyaoze, work@liuyaoze.com.

Chronaxis 0.1.0.dev1

Chronaxis 0.1.0.dev1

English

本次修正发布资料与文档入口。PyPI 的 Documentation 链接直接打开在线 HTML 手册，英文手册位于English。中英文 README、安装说明、随包 AI 指南和结果中的软件版本号同步为 0.1.0.dev1。

安装：python -m pip install "chronaxis==0.1.0.dev1"。运行环境仍为 Windows、Python 3.12；计算算法、配置语义和运行依赖与 0.1.0.dev0 相同。

此前发布的 0.1.0.dev0 保留。各版本的离线 HTML 手册可从对应 GitHub Release 下载；在线入口提供当前发布版手册。

维护者：liuyaoze，work@liuyaoze.com。

PyPI 0.1.0.dev1 已发布；独立新环境安装及能量示例验证通过。
PyPI publication and a fresh installation with the energy example have been verified.

Chronaxis 0.1.0.dev0

Chronaxis 0.1.0.dev0

这是Chronaxis的首个开发预览版。项目将日志读取、条件筛选和指标计算整理为可复用的Python分析库，可通过YAML/JSON配置或Python API运行。

主要功能

• BLF、ASC、原始报文CSV、已解码信号CSV和内存数据输入。
• 连续条件、迟滞去抖、请求响应与超时、事件前后窗口等分析。
• 积分、能量、时长与统计指标；按需生成可读结果表、贡献明细或原始报文片段。
• 连续多文件分析、独立批量任务、DBC信号绑定和按需解码。
• 中英文用户手册、字段/API参考和可直接阅读的AI指南；安装自动带入CAN依赖。

使用与验证范围

当前验证环境为Windows、Python3.12。配置格式为config_version: 3；软件版本号与配置格式版本独立。开发预览版的接口可能调整，升级前参阅版本规则。

本次发行经过干净源码构建、包元数据、独立环境安装和合成任务检查。详细结果随交付清单提供；其他操作系统、浏览器视觉及独立AI试读不在本次已验证范围。已有diskcache依赖限制保留，Chronaxis未启用其磁盘缓存。

项目采用MIT许可证；维护者liuyaoze，work@liuyaoze.com。

English

This is the first development preview of Chronaxis, a reusable Python library for reading logs, selecting conditions and computing metrics through YAML/JSON configurations or a Python API.

• Inputs: BLF, ASC, raw CAN CSV, decoded signal CSV, and in-memory data.
• Analysis: sustained conditions, hysteresis/debounce, request/response and timeout rules, and event windows.
• Results: integrals, energy, durations and statistics, with readable tables, contributions or raw CAN excerpts when requested.
• Continuous multi-file analysis, independent batch jobs, DBC bindings and decoding of required messages.
• Chinese and English manuals, field/API references, and directly readable AI guides. Normal installation includes CAN dependencies.

Verified on Windows with Python 3.12. Configuration format config_version: 3 is independent of the software version. Preview interfaces may change; see the version policy. Checks cover clean-source builds, package metadata, isolated installation and synthetic tasks; other operating systems, visual browser review and independent AI usability testing are not claimed. The documented diskcache limitation remains; Chronaxis does not enable that disk cache.

MIT license. Maintainer: liuyaoze, work@liuyaoze.com.