chronaxis.fast.batch.run_batch

from chronaxis.fast.batch import run_batch

`run_batch`

并行执行相互独立的高性能积分任务；连续来源paths不能借此拆成独立文件。

python

run_batch(plan_path, output, *, process_count=None, cancel_event=None, total=False)

名称	类型	必填	默认值	用途
`plan_path`	str \| pathlib.Path	是	无默认值	str或Path：batch_version为1的jobs或template批量配置路径。每个任务都需满足fast能力范围。
`output`	str \| pathlib.Path	是	无默认值	str或Path：批量输出目录，可以复用；任务输出与批量报告使用本次独占名称。
`process_count`	int \| None	否	None	正整数或None。None沿用批量配置；显式正整数覆盖进程上限。布尔值不是合法计数。
`cancel_event`	threading.Event \| None	否	None	`threading.Event`或`None`。调用`set()`请求取消：停止派发尚未启动的任务，并通知在途fast任务停止；协作退出超过5秒时启动进程回收。已完成任务可保留completed状态，其他任务以报告中的status、error_type和error_message为准。只有is_set()方法的其他对象不被接受。
`total`	bool	否	False	布尔值，True请求同模板且定义一致的全批总量；按计算项完整性判定，不把缺失值当0。默认不额外汇总。

pathlib.Path：本次批量报告路径。报告可包含失败或未启动任务；返回路径不代表每个任务成功，须检查报告。

异常

参数或组合错误直接抛出，不返回正常批量报告：total不是bool时抛TypeError；process_count不是正原生int（包括bool）时抛ValueError；cancel_event不是threading.Event或None时抛TypeError；jobs配置请求total=True时抛ValueError，只有同一template展开且计算定义一致的独立文件支持总计。total类型在加载配置前检查，其余覆盖值和组合在配置准备后、任务派发前检查。

配置解析或fast能力检查失败抛PlanValidationError。已派发任务的普通失败记录在报告jobs的status、error_type和error_message中，按fail_fast决定是否继续派发；返回报告路径不代表全部成功。

通信、调度、清理及报告发布等基础设施异常继续传播，可能通过异常的batch_report附带已保存报告，但启动前或报告发布错误不保证有该属性。worker构造期间中断且清理未完成时，原异常还可带batch_worker_cleanup_owner；该worker可能不在报告任务中，需要对实际存在的恢复对象单独close。

执行与资源

创建工作进程、读取每个任务输入并写报告；内部关闭批量资源。Windows脚本必须在if __name__ == "__main__":保护内调用。

高性能积分器教程

源码：src/chronaxis/fast/batch.py:51（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。