e2m2e.api.spatiography

空间分区接口类：spatiography 五省分区分析（ADR 0043 决策 3）。

Spatiography 是接口层的空间分区类：五个分区分析工具（scales / classify / boundaries / resonance atlas / dynamical map，ADR 0041）。 MCP/CLI/sidecar 经单一工具清单到达这些方法；进程内调用方从 Facade().spatiography 取实例或直接构造（ADR 0043，ADR 0014 决策 2 的类分家）。

Classes

Spatiography

空间分区接口类（ADR 0043 决策 3）：无状态，纯分析入口。

Module Contents

class e2m2e.api.spatiography.Spatiography

空间分区接口类（ADR 0043 决策 3）：无状态，纯分析入口。

spatiography_scales(**params) → e2m2e.api.models.SpatiographyScalesResponse

分区解析尺度计算（spatiography，二档）。/ Spatiography analytic scales (tier 2).

计算地月空间分区（Rosengren et al. 2026 Primer §5）的全部闭式边界 尺度：Laplace 半径（地心/月心）、影响球族（Hill / Laplace-Tisserand / Chebotarev / Battin）、tidal parity、共振梯（Table 1/2）、平动点精确 解与 Jacobi 临界值。Primer 常数口径（SPICE GM + Simon 1994 月根数）。

spatiography_classify(**params) → e2m2e.api.models.SpatiographyClassifyResponse

分区区域分类（spatiography，二档）。/ Spatiography region classification (tier 2).

对会合系状态逐点判定五省分区（terrestrial / cislunar 内带 / cislunar 外带 / circumlunar / translunar / heliocentric，论文 Table 1 或附录 B Table 4 口径），重叠带返回多标签；附 osculating a、Jacobi 值与 Hill 五拓扑 Case 诊断。

spatiography_boundaries(**params) → e2m2e.api.models.SpatiographyBoundariesResponse

分区边界几何（spatiography，二档）。/ Spatiography boundary geometry (tier 2).

输出可视化用边界几何数据：会合系（质心原点，z=0）的 r_L / tidal parity / 双系 Hill 与 SOI 圆族、Battin 非对称闭合曲线、L1–L5，或 (a,e) 根数平面走廊曲线族。前端只做单位归一与绘制，不在界面重算。

spatiography_resonance_atlas(**params) → e2m2e.api.models.SpatiographyAtlasResponse

共振图集（spatiography，二档）。/ Resonance atlas (tier 2).

Primer §4.2–§4.4 / §5.3 的共振与长期解析骨架：Gallardo 半解析 共振半宽包络（式 100–104，计算设置对齐 Fig. 8：共面切片、 Simon 1994 月根数、2ρ_H 近遇截断）、拱线驻定 loci（式 75–78）、 vZLK 相图与时间尺度（式 64–71）。1:1 共振带宽系统性高估 （论文 §5.3 声明），不得当 gateway 边界用。

spatiography_dynamical_map(**params) → e2m2e.api.models.SpatiographyMapResponse

六域两层天图（spatiography，二档）。/ Spatiographic dynamical map (tier 2).

Primer §7.3 (a, e) 天图管线：Table 4 六制图域网格 × 命名场景 （2027-08-02 日全食历元统一初值切片），逐格传播 EM/EMS 点质量 模型，输出 MEGNO Ȳ 场与八类命运场 + 诊断量。大数组建议走 sidecar 二进制帧（E2M2 帧，ADR 0035）。