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.2

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.2
File	Size	Uploaded
astrox_python-1.2.2.tar.gz	718.3 kB	Sep 21, 2026	Details

Built distribution (wheel)

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

Total release size: 792.4 kB

Release files / astrox_python-1.2.2.tar.gz

Download URL	astrox_python-1.2.2.tar.gz
Size	718.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`90ad585a55b53961f7312e66f4f3bc26e9079c257b911e768f6c226c0358a632`
BLAKE2b-256 checksum How to use checksums	`bfc6744a3f15236500d4f79a99d2cf9fb792b442ccf3c93543384d1c108fc6e6`
Upload date	Sep 21, 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/d704920aa723f6aaa00e862a395b972898668dee

Workflow

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

Artifact

Subject: astrox_python-1.2.2.tar.gz
SHA-256 checksum: 90ad585a55b53961f7312e66f4f3bc26e9079c257b911e768f6c226c0358a632 Verifying attestations

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

Download URL	astrox_python-1.2.2-py3-none-any.whl
Size	74.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5d948c8504919e7ff0398604cf736fed7fa03f75154094a1ddddfb77bcd0cf93`
BLAKE2b-256 checksum How to use checksums	`be717e125b8abcee839315ef68537abe5fb3ce0caa83efbc53bb832c98293eb7`
Upload date	Sep 21, 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/d704920aa723f6aaa00e862a395b972898668dee

Workflow

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

Artifact

Subject: astrox_python-1.2.2-py3-none-any.whl
SHA-256 checksum: 5d948c8504919e7ff0398604cf736fed7fa03f75154094a1ddddfb77bcd0cf93 Verifying attestations