astrox-python

astrox-python 是 ASTROX Web API 的 Python SDK。

安装

需要 Python 3.10 或更高版本。

pip install astrox-python

一分钟示例

用一组开普勒根数做 J2 传播：

import astrox
from astrox import orbits, propagator

astrox.configure(base_url="http://astrox.cn:8765")

orbit = orbits.keplerian(
    semi_major_axis_m=6778137.0,
    eccentricity=0.001,
    inclination_deg=51.6,
    argument_of_periapsis_deg=0.0,
    raan_deg=120.0,
    true_anomaly_deg=45.0,
)

period_s, position = propagator.j2(
    start="2024-01-01T00:00:00.000Z",
    stop="2024-01-01T00:10:00.000Z",
    orbit_epoch="2024-01-01T00:00:00.000Z",
    orbit=orbit,
)

print(f"轨道周期: {period_s:.3f} s")
print(f"位置/速度采样数: {len(position.cartesian_velocity)}")

完整首次运行流程见快速上手。

文档

完整文档导航：docs/README.md
可运行示例：examples/
英文快照：docs/i18n/en/README.md

参与开发

开发环境搭建与构建步骤见 CONTRIBUTING.md。

许可

MIT 许可证，详见 LICENSE。

本项目目前处于 Alpha 阶段。

Metadata

Release files for astrox-python 1.2.1

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

Source distribution (sdist)

Source distribution for astrox-python 1.2.1
File	Size	Uploaded
astrox_python-1.2.1.tar.gz	715.7 kB	Sep 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for astrox-python 1.2.1
File	Interpreter	ABI	Platform	Reset
astrox_python-1.2.1-py3-none-any.whl 74.1 kB Sep 9, 2026	Python 3	none	any	Details

Total release size: 789.7 kB

Release files / astrox_python-1.2.1.tar.gz

Download URL	astrox_python-1.2.1.tar.gz
Size	715.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`24eba244a71c9a5b95dbdba306b673c8551de45b7ca847c5ea9cae7e5bcb9aed`
BLAKE2b-256 checksum How to use checksums	`16a80d6791b1e209da5152d4154a8ab114289c17964ce96f05e9d4a2a0906710`
Upload date	Sep 9, 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/Mtrya/astrox-python
Publishing commit: github.com/Mtrya/astrox-python/tree/8194a85680153f4028d0388ea46f01b6d37b1c12

Workflow

Publishing configuration: github.com/Mtrya/astrox-python/blob/8194a85680153f4028d0388ea46f01b6d37b1c12/.github/workflows/publish.yml
Publishing logs: github.com/Mtrya/astrox-python/actions/runs/34327081393/attempts/1

Artifact

Subject: astrox_python-1.2.1.tar.gz
SHA-256 checksum: 24eba244a71c9a5b95dbdba306b673c8551de45b7ca847c5ea9cae7e5bcb9aed Verifying attestations

Release files / astrox_python-1.2.1-py3-none-any.whl

Download URL	astrox_python-1.2.1-py3-none-any.whl
Size	74.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`10fe974e127d73117d89e221d025ac7a0370f135df18996eb1b352ce2121da82`
BLAKE2b-256 checksum How to use checksums	`19ecf9df6c9af5fa7b4d9605ff0d679032ceeb3ba5cf93286fb97b0ff6e2a4f0`
Upload date	Sep 9, 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/Mtrya/astrox-python
Publishing commit: github.com/Mtrya/astrox-python/tree/8194a85680153f4028d0388ea46f01b6d37b1c12

Workflow

Publishing configuration: github.com/Mtrya/astrox-python/blob/8194a85680153f4028d0388ea46f01b6d37b1c12/.github/workflows/publish.yml
Publishing logs: github.com/Mtrya/astrox-python/actions/runs/34327081393/attempts/1

Artifact

Subject: astrox_python-1.2.1-py3-none-any.whl
SHA-256 checksum: 10fe974e127d73117d89e221d025ac7a0370f135df18996eb1b352ce2121da82 Verifying attestations