chronaxis.planning.backend_selection
依据整个计划的静态类别选择数值后端，不读取输入或试跑计算。
auto 只覆盖已测量的简单积分类别。其他组合沿用 NumPy；显式选择始终优先。 选择结果供校验、说明和运行共用，不保存逐条执行记录，也不在失败后重试。
这是模块参考。日常调用先查公开API索引；下划线对象和嵌套函数供维护者查阅。签名来自固定源码，公开类构造签名经实际Python接口核对。
相关类型
对象导航
| 对象 | 用途 |
|---|---|
BackendSelection |
保存一次静态选择：请求值、实际后端及可读原因，不代表已运行。 |
simple_numeric_expression |
检查首批实测的简单数值表达式。 |
select_backend |
为整个计划选择一次后端。 |
execution_plan |
取得实际执行视图。 |
导入与重导出来源（展开）
from __future__ import annotations
from dataclasses import dataclass, replace
from typing import TYPE_CHECKINGBackendSelection
保存一次静态选择：请求值、实际后端及可读原因，不代表已运行。
class BackendSelection属性与数据字段
| 名称 | 数据类型 | 必填 | 省略时的值 | 用途、取值和效果 |
|---|---|---|---|---|
requested |
str | 是 | 无 | 原配置或调用覆盖。 |
selected |
str | 是 | 无 | reference/numpy；非法 带有明确类型的 声明为 unavailable。 |
reason |
str | 是 | 无 | 解释选择依据，不承诺具体提速比例。 |
源码：src/chronaxis/planning/backend_selection.py:24（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。
simple_numeric_expression
检查首批实测的简单数值表达式。
simple_numeric_expression(expression: StaticExpression | None) -> bool参数
| 名称 | 数据类型 | 必填 | 省略时的值 | 用途、取值和效果 |
|---|---|---|---|---|
expression |
StaticExpression | None | 是 | 无 | 位置或关键字。已经编译的表达式，None或不支持运算返回False；只遍历静态树。 |
返回说明
bool。
异常说明
非法 带有明确类型的 结构。
仅遍历配置树；短路、查表、宿主函数和时序运算留在通用类别。
返回类型：bool。
源码：src/chronaxis/planning/backend_selection.py:32（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。
select_backend
为整个计划选择一次后端。
select_backend(plan: AnalysisPlan) -> BackendSelection参数
| 名称 | 数据类型 | 必填 | 省略时的值 | 用途、取值和效果 |
|---|---|---|---|---|
plan |
AnalysisPlan | 是 | 无 | 位置或关键字。完整且已解析的原计划；保留raw_config和identity，不试读或试跑输入。 |
返回说明
BackendSelection。
异常说明
非法 带有明确类型的 结构的属性错误；未知后端作为 unavailable 交给静态诊断。 不读取 DBC、日志或路径元数据，不修改原计划、身份或用户配置。
返回类型：BackendSelection。
源码：src/chronaxis/planning/backend_selection.py:51（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。
execution_plan
取得实际执行视图。
execution_plan(plan: AnalysisPlan) -> AnalysisPlan参数
| 名称 | 数据类型 | 必填 | 省略时的值 | 用途、取值和效果 |
|---|---|---|---|---|
plan |
AnalysisPlan | 是 | 无 | 位置或关键字。完整且已解析的原计划；保留raw_config和identity，不试读或试跑输入。 |
返回说明
原计划或仅后端变化的视图。
异常说明
未支持后端为 ValueError；不修改 raw_config/identity，不重载来源。
返回类型：AnalysisPlan。
源码：src/chronaxis/planning/backend_selection.py:95（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。