动力系统工作流和扩展辅助层#
pyna.topo 在核心拓扑对象之上提供工作流辅助层。主要面向用户的入口是
TopologyWorkflow;低层协议、适配器、构建器、桥接和工厂模块
仍然提供给需要稳定扩展点的下游库。
工作流门面#
TopologyWorkflow 面向 notebook 和日常脚本。它组合系统构造、积分/迭代、显式提升
和截面切割,而不引入新的数学对象类型。
扩展协议#
结构化协议描述外部系统的扩展契约。第三方对象只要实现所需属性和方法即可参与 工作;不强制继承 pyna 类。
数据适配#
适配器将数组、求解器输出和已有 pyna 对象规范化为核心几何表示。它们不会静默地把 采样数据提升为不变对象。
构建器#
构建器编码显式提升规则。例如,只有通过可要求闭合样本的构建器或适配器调用,
轨迹才能被提升为 Cycle。
连续-离散桥接#
桥接层连接连续时间和离散时间对象族:Cycle -> PeriodicOrbit 以及
Tube/TubeChain -> IslandChain。
工厂与注册表#
工厂为系统、几何对象和 Poincare 映射提供稳定构造入口。注册表是显式且防重复 的,因此测试和下游库可以隔离自己的扩展。