chronaxis 0.1.0.dev0__py3-none-any.whl

chronaxis/guide/examples/data/timing.asc

@@ -0,0 +1,6 @@
+base hex timestamps absolute
+0 1 100 Rx d 4 00 00 46 00
+1 1 100 Rx d 4 01 00 50 01
+3 1 100 Rx d 4 00 01 50 05
+6 1 100 Rx d 4 00 00 46 0a
+7 1 100 Rx d 4 00 00 46 0a

chronaxis/guide/examples/data/timing.dbc

@@ -0,0 +1,11 @@
+VERSION "synthetic-home"
+NS_ :
+BS_:
+BU_: Node
+BO_ 256 State: 4 Node
+ SG_ Request : 0|8@1+ (1,0) [0|1] "" Node
+ SG_ Response : 8|8@1+ (1,0) [0|1] "" Node
+ SG_ Temperature : 16|8@1+ (1,0) [0|255] "degC" Node
+ SG_ Voltage : 24|8@1+ (1,0) [0|255] "V" Node
+BA_DEF_ BO_ "GenMsgCycleTime" INT 0 65535;
+BA_ "GenMsgCycleTime" BO_ 256 1000;

chronaxis/guide/examples/export-can-minimal.yaml

@@ -0,0 +1,24 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3            # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                     # 设置本次分析名称及可选的对象、会话和时间范围
+  name: can_asc_example      # 命名本次分析数据集；名称写入结果身份字段
+sources:                     # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - dbc_by_channel:          # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/joint.dbc    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+    paths: data/joint.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+signals:                     # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - dtype: float64           # 选择分析值类型；float64小数、int64有符号整数、uint64非负整数、bool真假、enum状态名称
+    field:                   # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: 256          # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Voltage        # 填写DBC中的信号名称，大小写须一致
+    name: voltage            # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 10s           # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+calculations:                # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: voltage_area       # 为这项计算结果取唯一名称；结果表用它区分计算项
+    operation: integral      # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量
+    expr: voltage            # 指定参与计算的数值或信号表达式；引用前面已定义的信号
+outputs:                     # 选择额外导出的数据及格式；默认结果表由运行入口提供
+  can_frames:                # 配置原始或重建CAN帧的额外导出；与信号CSV分别设置
+    format: asc              # 选择输出报文文件格式；asc为文本，blf为二进制
+metadata:                    # 保存说明性信息；字段不会自动校准数据或更改计算公式
+  device_label: home         # 记录产出设备标签；当前独立导出仅接受home/work，普通分析与批量报告规则见对应说明

chronaxis/guide/examples/input-csv-minimal.yaml

@@ -0,0 +1,23 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3              # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                       # 设置本次分析名称及可选的对象、会话和时间范围
+  domain:                      # 限定本次分析请求的起止时间；应与来源采用相同时间基准
+    end: 6s                    # 设置分析终点；连续时长不包含该端点，按希望分析的范围填写
+    start: 0s                  # 设置分析起点，包含该时刻；按希望分析的范围填写
+  name: csv_example            # 命名本次分析数据集；名称写入结果身份字段
+sources:                       # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - path: data/signals.csv     # 指定单个输入文件；相对路径从本配置文件所在目录计算
+    source_type: signal_csv    # 选择数据格式；memory内存记录、signal_csv物理量表、can_blf/can_asc/raw_can_csv原始CAN
+    time:                      # 说明输入时间数值的类型、单位、共同起点和校准偏移
+      unit: s                  # 声明输入时间数值的单位；根据文件说明填写s/ms/us/ns等受支持单位
+    time_column: time          # 填写CSV时间列的实际表头，大小写和文件一致
+signals:                       # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - dtype: float64             # 选择分析值类型；float64小数、int64有符号整数、uint64非负整数、bool真假、enum状态名称
+    field: power               # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+    name: power                # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    unit: W                    # 声明分析值的单位；按物理含义填写，无量纲用字符串"1"；仅标签不执行换算
+    valid_for: 3s              # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+calculations:                  # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: energy               # 为这项计算结果取唯一名称；结果表用它区分计算项
+    operation: integral        # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量
+    expr: power                # 指定参与计算的数值或信号表达式；引用前面已定义的信号

chronaxis/guide/examples/preset-charge-energy.yaml

@@ -0,0 +1,41 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                               # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                        # 设置本次分析名称及可选的对象、会话和时间范围
+  name: preset_example                          # 命名本次分析数据集；名称写入结果身份字段
+sources:                                        # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/preset-charge-energy.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                             # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc                # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                        # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                                      # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x118'                         # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Mode                              # 填写DBC中的信号名称，大小写须一致
+    name: mode                                  # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                              # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+  - field:                                      # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x114'                         # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Current                           # 填写DBC中的信号名称，大小写须一致
+    measurement_location: pack_terminal         # 声明实际测点；pack_terminal表示电池包端，须依据接线和设备定义
+    name: current                               # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    sign_convention: positive_is_charge         # 声明正负值的业务含义；positive_is_charge表示正电流为充电，不执行取反
+    valid_for: 20s                              # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+  - field:                                      # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x11f'                         # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Voltage                           # 填写DBC中的信号名称，大小写须一致
+    measurement_location: pack_terminal         # 声明实际测点；pack_terminal表示电池包端，须依据接线和设备定义
+    name: voltage                               # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                              # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+presets:                                        # 选择预先组合好的规则与计算，并提供角色信号和业务参数
+  - name: demo_preset                           # 给本次预设实例取唯一名称；展开的规则/计算名称使用此前缀
+    parameters:                                 # 提供本预设的业务参数；各预设支持的字段不同，不能互相套用
+      compute_charge: true                      # 选择是否计算电荷量；true生成电流积分并输出Ah，false不生成
+      compute_energy: true                      # 选择是否计算充电能量；true需要电压角色，false不生成能量项
+      current_min: 5                            # 设置充电判断的电流下限；按业务目标填写，单位A
+      minimum_duration: 0s                      # 设置充电条件连续成立多久才确认；按业务要求填写
+      mode_value: 1                             # 指定表示充电的模式代码；从设备状态编码表取得
+    preset_type: charge_session                 # 选择业务任务；charge_session充电、fault_context报警上下文、command_response配对、threshold_excursion阈值
+    role_bindings:                              # 明确指定哪条已有信号担任每个角色；角色名由预设定义
+      current: current                          # 为current角色选择上方已定义的分析信号名；仍须符合该角色要求
+      mode: mode                                # 为mode角色选择上方已定义的分析信号名；仍须符合该角色要求
+      voltage: voltage                          # 为voltage角色选择上方已定义的分析信号名；仍须符合该角色要求
+    version: '1'                                # 选择预设定义版本；当前填写字符串"1"，与config_version的整数3分别使用

chronaxis/guide/examples/preset-charge-minimal.yaml

@@ -0,0 +1,31 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                                # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                         # 设置本次分析名称及可选的对象、会话和时间范围
+  name: preset_example                           # 命名本次分析数据集；名称写入结果身份字段
+sources:                                         # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/preset-charge-minimal.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                              # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc                 # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                         # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                                       # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x118'                          # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Mode                               # 填写DBC中的信号名称，大小写须一致
+    name: mode                                   # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                               # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+  - field:                                       # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x114'                          # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Current                            # 填写DBC中的信号名称，大小写须一致
+    measurement_location: pack_terminal          # 声明实际测点；pack_terminal表示电池包端，须依据接线和设备定义
+    name: current                                # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    sign_convention: positive_is_charge          # 声明正负值的业务含义；positive_is_charge表示正电流为充电，不执行取反
+    valid_for: 20s                               # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+presets:                                         # 选择预先组合好的规则与计算，并提供角色信号和业务参数
+  - name: demo_preset                            # 给本次预设实例取唯一名称；展开的规则/计算名称使用此前缀
+    parameters:                                  # 提供本预设的业务参数；各预设支持的字段不同，不能互相套用
+      current_min: 5                             # 设置充电判断的电流下限；按业务目标填写，单位A
+      minimum_duration: 0s                       # 设置充电条件连续成立多久才确认；按业务要求填写
+      mode_value: 1                              # 指定表示充电的模式代码；从设备状态编码表取得
+    preset_type: charge_session                  # 选择业务任务；charge_session充电、fault_context报警上下文、command_response配对、threshold_excursion阈值
+    role_bindings:                               # 明确指定哪条已有信号担任每个角色；角色名由预设定义
+      current: current                           # 为current角色选择上方已定义的分析信号名；仍须符合该角色要求
+      mode: mode                                 # 为mode角色选择上方已定义的分析信号名；仍须符合该角色要求

chronaxis/guide/examples/preset-fault-context.yaml

@@ -0,0 +1,27 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                               # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                        # 设置本次分析名称及可选的对象、会话和时间范围
+  name: preset_example                          # 命名本次分析数据集；名称写入结果身份字段
+sources:                                        # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/preset-fault-context.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                             # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc                # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                        # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                                      # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x111'                         # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Alarm                             # 填写DBC中的信号名称，大小写须一致
+    name: alarm                                 # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                              # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    choices:                                    # 把输入状态代码转成分析值；每项是[输入代码,结果值]，代码查设备规范
+      - [0, false]
+      - [1, true]
+presets:                                        # 选择预先组合好的规则与计算，并提供角色信号和业务参数
+  - name: demo_preset                           # 给本次预设实例取唯一名称；展开的规则/计算名称使用此前缀
+    parameters:                                 # 提供本预设的业务参数；各预设支持的字段不同，不能互相套用
+      emit_initial: true                        # 控制初始观测为真是否记作新事件；true记录，false等待后续上升沿
+      post: 2s                                  # 设置故障点之后保留的时长；与pre至少一项大于0
+      pre: 1s                                   # 设置故障点之前保留的时长；按需要观察的故障前过程填写
+    preset_type: fault_context                  # 选择业务任务；charge_session充电、fault_context报警上下文、command_response配对、threshold_excursion阈值
+    role_bindings:                              # 明确指定哪条已有信号担任每个角色；角色名由预设定义
+      alarm: alarm                              # 为alarm角色选择上方已定义的分析信号名；仍须符合该角色要求
+    version: '1'                                # 选择预设定义版本；当前填写字符串"1"，与config_version的整数3分别使用

chronaxis/guide/examples/quality.yaml

@@ -0,0 +1,19 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                   # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                            # 设置本次分析名称及可选的对象、会话和时间范围
+  name: power_quality               # 命名本次分析数据集；名称写入结果身份字段
+sources:                            # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/quality.asc     # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                 # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                            # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - name: power                     # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    field:                          # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x100'             # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Power                 # 填写DBC中的信号名称，大小写须一致
+    valid_for: 1s                   # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    invalid_values: [-1e+100]       # 列出解析/解码后、额外换算前表示无效的值；按数据规范匹配实际类型和值
+calculations:                       # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: energy                    # 为这项计算结果取唯一名称；结果表用它区分计算项
+    operation: integral             # 选择计算方法；本例将有效数值乘持续时间后累计，例如功率乘秒得到能量
+    expr: power                     # 指定参与计算的数值或信号表达式；引用前面已定义的信号

chronaxis/guide/examples/sequence-outcomes.yaml

@@ -0,0 +1,39 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                            # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                     # 设置本次分析名称及可选的对象、会话和时间范围
+  name: preset_example                       # 命名本次分析数据集；名称写入结果身份字段
+sources:                                     # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/sequence-outcomes.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                          # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc             # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                     # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                                   # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x11a'                      # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Request                        # 填写DBC中的信号名称，大小写须一致
+    name: request                            # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                           # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    choices:                                 # 把输入状态代码转成分析值；每项是[输入代码,结果值]，代码查设备规范
+      - [0, false]
+      - [1, true]
+  - field:                                   # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x11b'                      # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Response                       # 填写DBC中的信号名称，大小写须一致
+    name: response                           # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                           # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    choices:                                 # 把输入状态代码转成分析值；每项是[输入代码,结果值]，代码查设备规范
+      - [0, false]
+      - [1, true]
+rules:                                       # 列出识别活动或瞬间变化的规则；每项产生有独立ID的事件
+  - condition: request                       # 填写由已定义信号组成的真假条件；按要检测的业务情况设置
+    name: request_edge                       # 为规则取唯一名称；窗口rule和计算scope通过此名选择它的事件
+    rule_type: rising_edge                   # 选择活动或变化识别算法；本例condition由false变为true时产生瞬时事件
+  - condition: response                      # 填写由已定义信号组成的真假条件；按要检测的业务情况设置
+    name: response_edge                      # 为规则取唯一名称；窗口rule和计算scope通过此名选择它的事件
+    rule_type: rising_edge                   # 选择活动或变化识别算法；本例condition由false变为true时产生瞬时事件
+sequences:                                   # 把请求事件与响应事件按允许等待时间配对
+  - name: pair                               # 为请求响应配对取唯一名称；结果通过此名区分配对任务
+    max_delay: 2s                            # 设置响应的最大允许延迟；依据协议或业务要求填写，不能小于min_delay
+    max_pending: 2                           # 限制同时等待响应的请求数量；按峰值并发请求和资源能力选择
+    min_delay: 0s                            # 设置响应的最小允许延迟；依据协议或业务要求填写，包含边界
+    response: response_edge                  # 选择响应事件规则；填写前面rules的name
+    start: request_edge                      # 选择请求事件规则；填写前面rules的name

chronaxis/guide/examples/shared/definitions.yaml

@@ -0,0 +1,14 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+sources:                                 # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - name: bus                            # 给本来源取计划内唯一名称；下方signals.source引用这个名称
+    paths: ../data/can/quickstart.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                      # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': ../data/can/teaching.dbc      # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                 # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - name: power                          # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    field:                               # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x100'                  # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Power                      # 填写DBC中的信号名称，大小写须一致
+derived:                                 # 用已定义信号的表达式生成新信号；先定义再在后续功能中引用
+  double_power:                          # 定义名为double_power的派生信号，后面的计算通过此名称引用
+    expr: power * 2                      # 规定派生值如何由已有信号计算；名称必须先在signals或前面的derived中定义

chronaxis/guide/examples/signal-enum-minimal.yaml

@@ -0,0 +1,19 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                       # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                # 设置本次分析名称及可选的对象、会话和时间范围
+  name: signal_example                  # 命名本次分析数据集；名称写入结果身份字段
+sources:                                # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/signal-types.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                     # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc        # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                              # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x103'                 # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: ModeCode                  # 填写DBC中的信号名称，大小写须一致
+    name: mode                          # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 200ms                    # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    dtype: enum                         # 选择分析值类型；float64小数、int64有符号整数、uint64非负整数、bool真假、enum状态名称
+rules:                                  # 列出识别活动或瞬间变化的规则；每项产生有独立ID的事件
+  - condition: mode == "running"        # 填写由已定义信号组成的真假条件；按要检测的业务情况设置
+    name: activated                     # 为规则取唯一名称；窗口rule和计算scope通过此名选择它的事件
+    rule_type: rising_edge              # 选择活动或变化识别算法；本例condition由false变为true时产生瞬时事件

chronaxis/guide/examples/signal-number-conversion.yaml

@@ -0,0 +1,24 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                       # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                # 设置本次分析名称及可选的对象、会话和时间范围
+  name: signal_example                  # 命名本次分析数据集；名称写入结果身份字段
+sources:                                # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/signal-types.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                     # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc        # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                              # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x101'                 # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: Current_mA                # 填写DBC中的信号名称，大小写须一致
+    invalid_values: [65535.0]           # 列出解析/解码后、额外换算前表示无效的值；按数据规范匹配实际类型和值
+    name: current                       # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 200ms                    # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    valid_range: [-100, 100]            # 检查换算后的值是否在含两端的上下限内；按传感器或业务允许范围填写
+    conversion:                         # 设置读取后额外的单位换算；不重复DBC已执行的缩放和偏移
+      input_unit: mA                    # 声明CSV解析或DBC解码后、额外换算前的单位；查列说明或DBC物理单位
+      scale: 0.001                      # 设置额外数值乘数；按输入与目标单位的合法换算倍率填写，避免重复DBC换算
+    unit: A                             # 声明分析值的单位；按物理含义填写，无量纲用字符串"1"；仅标签不执行换算
+calculations:                           # 列出希望获得的统计或积分结果，每项独立选择范围和算法
+  - name: maximum_current               # 为这项计算结果取唯一名称；结果表用它区分计算项
+    operation: sample_maximum           # 选择计算方法；本例取范围内有效真实样本的最大值
+    expr: current                       # 指定参与计算的数值或信号表达式；引用前面已定义的信号

chronaxis/guide/examples/window-merged.yaml

@@ -0,0 +1,28 @@
+# 合成教学配置；请连同配套输入使用，数值仅用于复现本例。
+config_version: 3                                   # 声明分析文件采用的字段结构版本；当前填写整数3
+dataset:                                            # 设置本次分析名称及可选的对象、会话和时间范围
+  name: rule_example                                # 命名本次分析数据集；名称写入结果身份字段
+sources:                                            # 列出输入来源；每项规定数据位置、格式和时间解释方式
+  - paths: data/can/rule-start_only-extended.asc    # 选择输入文件、连续分卷列表或目录；相对路径基于本配置，目录按自然序读取
+    dbc_by_channel:                                 # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
+      '1': data/can/teaching.dbc                    # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
+signals:                                            # 把输入字段定义为有名称、类型、单位和有效期的分析信号
+  - field:                                          # 指定来源中的原始字段；CSV填表头，CAN填写通道/报文ID/DBC信号名
+      frame_id: '0x113'                             # 选择包含信号的报文ID；从对应DBC取得，可写整数或支持的进制文本
+      signal: ButtonPressed                         # 填写DBC中的信号名称，大小写须一致
+    name: button_pressed                            # 给分析信号取名称；后续表达式和计算通过此名称引用它
+    valid_for: 20s                                  # 设置一次有效更新最多沿用多久；依据采样周期和允许数据陈旧程度填写
+    choices:                                        # 把输入状态代码转成分析值；每项是[输入代码,结果值]，代码查设备规范
+      - [0, false]
+      - [1, true]
+rules:                                              # 列出识别活动或瞬间变化的规则；每项产生有独立ID的事件
+  - condition: button_pressed                       # 填写由已定义信号组成的真假条件；按要检测的业务情况设置
+    name: pressed                                   # 为规则取唯一名称；窗口rule和计算scope通过此名选择它的事件
+    rule_type: rising_edge                          # 选择活动或变化识别算法；本例condition由false变为true时产生瞬时事件
+windows:                                            # 围绕已定义规则的事件选取时间片段，供计算或导出使用
+  - anchor: point                                   # 选择以事件点还是活动区间为基础；point围绕点，activity围绕活动
+    rule: pressed                                   # 选择生成窗口的事件规则；填写前面rules中的name
+    name: context                                   # 为窗口定义取唯一名称；计算或导出通过此名选择产生的片段
+    merge: overlap_and_adjacent                     # 选择片段合并规则；none分别输出，overlap合并重叠，overlap_and_adjacent也合并相邻，exit_delay等待下一活动
+    post: 3s                                        # 设置结束点之后保留多久上下文；0s表示不延长
+    pre: 0s                                         # 设置起点之前保留多久上下文；0s表示不提前