动力系统工作流和扩展辅助层#

pyna.topo 在核心拓扑对象之上提供工作流辅助层。主要面向用户的入口是 TopologyWorkflow;低层协议、适配器、构建器、桥接和工厂模块 仍然提供给需要稳定扩展点的下游库。

工作流门面#

TopologyWorkflow 面向 notebook 和日常脚本。它组合系统构造、积分/迭代、显式提升 和截面切割,而不引入新的数学对象类型。

扩展协议#

结构化协议描述外部系统的扩展契约。第三方对象只要实现所需属性和方法即可参与 工作;不强制继承 pyna 类。

数据适配#

适配器将数组、求解器输出和已有 pyna 对象规范化为核心几何表示。它们不会静默地把 采样数据提升为不变对象。

构建器#

构建器编码显式提升规则。例如,只有通过可要求闭合样本的构建器或适配器调用, 轨迹才能被提升为 Cycle

连续-离散桥接#

桥接层连接连续时间和离散时间对象族:Cycle -> PeriodicOrbit 以及 Tube/TubeChain -> IslandChain

工厂与注册表#

工厂为系统、几何对象和 Poincare 映射提供稳定构造入口。注册表是显式且防重复 的,因此测试和下游库可以隔离自己的扩展。