e2m2e: Earth to Moon, Moon to Earth

e2m2e 是地月空间算法工具集。

安装

用 uv 安装：

uv pip install e2m2e

从源码开发：

git clone https://github.com/cislunarspace/e2m2e.git
cd e2m2e
make dev

Windows 安装 make

Windows 默认不提供 `make`。可使用 [Scoop](https://scoop.sh/) 安装；在 PowerShell 中依次执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
scoop install make

e2m2e 所需的全部星历数据已打包在 GitHub Release 的 kernels-v1 中，make dev 会自动下载到 kernels/；也可手动下载解压到该目录。

快速开始

设计一条地月 L2 Halo 轨道：

from e2m2e.api import Facade

facade = Facade()

result = facade.design_orbit(
    orbit_type="Halo",
    collinear_point=2,
    amplitude=30000.0,
    epoch=[2024, 1, 1, 0, 0, 0.0],
    duration=365.25 * 86400.0,
)

print(result.orbit_type)
print(result.initial_state)

功能介绍

MCP

e2m2e 为 19 个工具设计了 MCP 接口。

安装 MCP：

uv pip install "e2m2e[mcp]"

在 MCP 客户端配置中注册服务器（command 指向安装了 e2m2e 的环境里的可执行文件，多数 MCP 客户端都采用这一 mcpServers 格式）：

{
  "mcpServers": {
    "e2m2e": {
      "command": "/path/to/venv/bin/e2m2e",
      "args": ["mcp-serve"],
      "cwd": "/path/to/e2m2e-repo"
    }
  }
}

配置完成后在客户端直接用自然语言驱动，例如：

设计一条 L2 南族 NRHO，近月点高度 3000 km。

时空系统

坐标系转换：J2000 / ITRF93（SPICE 高精度）/ IAU 2006，GMAT 兼容的原生 ITRF，动态坐标轴 VNB / LVLH。
时空联合转换：TDT+GCRS ↔ TDB+EBCRS（r2s2 后端，含相对论项）。
SPICE 星历与时间管理：内核加载、UTC / TDB / TAI 时间尺度、天体状态与帧旋转查询。

积分器与动力学

Rust 积分器内核：单步 RK（PD45 / PD78 / RK89）、Adams 多步、Störmer–Cowell 二阶积分；状态转移矩阵（STM）传播；事件检测（terminal / direction 语义）。
动力学模型：CR3BP（快速设计）、星历 N 体（SPICE，精确外推）、含太阳解析摄动的 BCR4BP，以及三者之间的转换。
高精度力模型：点质量与第三体引力、球谐重力场（含固体潮）、ECOM 9 系数光压、大气阻力、太阳光压、连续推力。

任务轨道设计

周期轨道族：DRO、Halo、Lyapunov、Lissajous、共振轨道（RO）、DPO、Axial、三角平动点 SPO / LPO、Horseshoe。
数值算法：微分修正、多重打靶、延拓；全链路 CR3BP 初猜 → 星历修正 → 高精度预报。
名义轨道契约（NominalOrbit）：等间距状态表 + Floquet 基 + 投影因子，供轨道保持直接消费。

转移轨道设计

脉冲转移：Lambert 求解与 porkchop 扫描、多脉冲优化（Lawden 主矢量检验）、霍曼直接转移（HMN）。
低能量转移：月球引力辅助（LGA）、WSB 太阳引力辅助弹道捕获、不变流形与庞加莱截面拼接。
低推力转移：Q-law 初猜 + 打靶 / 配点。
网格搜索 + 非线性规划两步法（Rust Rayon 并行）。

轨道控制

三种控制律：特征点、目标点严格、目标点宽松；蒙特卡洛测定轨与推力误差仿真。
角动量管理：姿态发动机联合控制。

文档

设计决策记录（ADR）见 docs/adr/，ADR 0043 起以中文书写，更早条目为英文历史存档。接口字段的权威描述在请求/响应模型的字段描述中，CLI --help 与 MCP schema 与之同源。

测试与代码规范

make test
make check

贡献

见 CONTRIBUTING.md

引用

@software{e2m2e,
  title = {e2m2e: Earth to Moon, Moon to Earth Transfer Orbit Design Library},
  author = {ouyangjiahong},
  email = {ouyangjiahong22@nudt.edu.cn},
  url = {https://github.com/cislunarspace/e2m2e},
  version = {5.9.4},
  year = {2026},
}

许可证

Apache 2.0

Release files for e2m2e 5.9.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for e2m2e 5.9.4
File	Size	Uploaded
e2m2e-5.9.4.tar.gz	5.9 MB	Sep 4, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for e2m2e 5.9.4
File	Interpreter	ABI	Platform	Reset
e2m2e-5.9.4-cp310-abi3-win_amd64.whl 7.9 MB Sep 4, 2026	CPython 3.10	abi3	Windows x86-64	Details
e2m2e-5.9.4-cp310-abi3-manylinux_2_28_x86_64.whl 8.2 MB Sep 4, 2026	CPython 3.10	abi3	Linux glibc 2.28+ x86-64	Details
e2m2e-5.9.4-cp310-abi3-manylinux_2_28_aarch64.whl 8.0 MB Sep 4, 2026	CPython 3.10	abi3	Linux glibc 2.28+ ARM64	Details

Total release size: 30.0 MB

Release files / e2m2e-5.9.4.tar.gz

Download URL	e2m2e-5.9.4.tar.gz
Size	5.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`56a29916e5677b9d8e8cd8501913a0794a03cd36080aaab2dee34b1a361131a1`
BLAKE2b-256 checksum How to use checksums	`868472d8019c0d97c030a718ac4e535c4eaa936c29c50e7ce7680eb44c2cb4f5`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cislunarspace/e2m2e
Publishing commit: github.com/cislunarspace/e2m2e/tree/84b680c2a3825a84eacd71bddaad37bc56f2fc45

Workflow

Publishing configuration: github.com/cislunarspace/e2m2e/blob/84b680c2a3825a84eacd71bddaad37bc56f2fc45/.github/workflows/release.yml
Publishing logs: github.com/cislunarspace/e2m2e/actions/runs/33860127989/attempts/1

Artifact

Subject: e2m2e-5.9.4.tar.gz
SHA-256 checksum: 56a29916e5677b9d8e8cd8501913a0794a03cd36080aaab2dee34b1a361131a1 Verifying attestations

Release files / e2m2e-5.9.4-cp310-abi3-win_amd64.whl

Download URL	e2m2e-5.9.4-cp310-abi3-win_amd64.whl
Size	7.9 MB
Tags	CPython 3.10 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`7d23059dfb8004a4ee4df5a705bea222975a06bc0ce8ecd1d868825be12bf9bc`
BLAKE2b-256 checksum How to use checksums	`6fe6a0e9f7cae75bfe66552b36da869d83e4e0c307316a1177ca782d4c009dda`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cislunarspace/e2m2e
Publishing commit: github.com/cislunarspace/e2m2e/tree/84b680c2a3825a84eacd71bddaad37bc56f2fc45

Workflow

Publishing configuration: github.com/cislunarspace/e2m2e/blob/84b680c2a3825a84eacd71bddaad37bc56f2fc45/.github/workflows/release.yml
Publishing logs: github.com/cislunarspace/e2m2e/actions/runs/33860127989/attempts/1

Artifact

Subject: e2m2e-5.9.4-cp310-abi3-win_amd64.whl
SHA-256 checksum: 7d23059dfb8004a4ee4df5a705bea222975a06bc0ce8ecd1d868825be12bf9bc Verifying attestations

Release files / e2m2e-5.9.4-cp310-abi3-manylinux_2_28_x86_64.whl

Download URL	e2m2e-5.9.4-cp310-abi3-manylinux_2_28_x86_64.whl
Size	8.2 MB
Tags	CPython 3.10 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum How to use checksums	`7a4cd2d63039633fea2d0414f2efdbbcd056f29b577907790785ed63ec06007b`
BLAKE2b-256 checksum How to use checksums	`837d801c034c73f92599bbed9fb5fd6483badf24779876ca5c15491d1c2d1619`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cislunarspace/e2m2e
Publishing commit: github.com/cislunarspace/e2m2e/tree/84b680c2a3825a84eacd71bddaad37bc56f2fc45

Workflow

Publishing configuration: github.com/cislunarspace/e2m2e/blob/84b680c2a3825a84eacd71bddaad37bc56f2fc45/.github/workflows/release.yml
Publishing logs: github.com/cislunarspace/e2m2e/actions/runs/33860127989/attempts/1

Artifact

Subject: e2m2e-5.9.4-cp310-abi3-manylinux_2_28_x86_64.whl
SHA-256 checksum: 7a4cd2d63039633fea2d0414f2efdbbcd056f29b577907790785ed63ec06007b Verifying attestations

Release files / e2m2e-5.9.4-cp310-abi3-manylinux_2_28_aarch64.whl

Download URL	e2m2e-5.9.4-cp310-abi3-manylinux_2_28_aarch64.whl
Size	8.0 MB
Tags	CPython 3.10 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum How to use checksums	`1dc6a9845219ed50d168c40596071ed984bbe5e457518ac4f62b9aff68aef9b4`
BLAKE2b-256 checksum How to use checksums	`eae901d094f1e8c4ce11f7d161055f44c205bca7ee39779f07ea35d1725a8515`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/cislunarspace/e2m2e
Publishing commit: github.com/cislunarspace/e2m2e/tree/84b680c2a3825a84eacd71bddaad37bc56f2fc45

Workflow

Publishing configuration: github.com/cislunarspace/e2m2e/blob/84b680c2a3825a84eacd71bddaad37bc56f2fc45/.github/workflows/release.yml
Publishing logs: github.com/cislunarspace/e2m2e/actions/runs/33860127989/attempts/1

Artifact

Subject: e2m2e-5.9.4-cp310-abi3-manylinux_2_28_aarch64.whl
SHA-256 checksum: 1dc6a9845219ed50d168c40596071ed984bbe5e457518ac4f62b9aff68aef9b4 Verifying attestations