Metadata-Version: 2.4
Name: decay-analyzer
Version: 0.1.1
Summary: Satellite orbit decay analysis toolkit
Author-email: huangqinghao <kelar.hm@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: spaceweather
Requires-Dist: orekit
Dynamic: license-file

# decay_analyzer

基于大气阻力分析卫星轨道半长轴衰减的 Python 工具箱 / Satellite orbit decay analysis toolkit

项目版本: 0.1.0

简介
- decay_analyzer 提供用于分析卫星轨道半长轴随时间衰减的工具，包含多种方法（DSST、能量法、高斯变分法、Savitzky–Golay 滤波等），并带有命令行接口与示例数据用于快速复现结果。

主要特性
- 多种衰减分析方法实现（见 `src/decay_analyzer/methods`）
- 命令行工具入口：`decay-analyzer`（由 `pyproject.toml` 中的 `project.scripts` 声明）
- 示例数据和示例脚本位于 `examples/` 目录
- 可作为库导入以在脚本或 Jupyter 中使用公共 API

安装
- 推荐使用可编辑安装（开发环境）：

```bash
python -m pip install -e .
```

- 或安装依赖后直接运行源码（未发布到 PyPI 时）：

```bash
git clone <repo-url>
cd decay_analyzer
python -m pip install -e .
```

快速开始（命令行）
- 查看帮助：

```bash
decay-analyzer --help
```

- 使用示例（将根据项目提供的 CLI 选项运行分析并输出结果）：

```bash
decay-analyzer run --input examples/GFZOP_RSO_L06_G_20090101_100000_20090102_000030_v01.csv --method dsst
```

作为库使用（Python）

```python
from decay_analyzer import run_sg_filter_analysis

# 调用包内 API 运行分析（具体参数请参考 `src/decay_analyzer/data/params_config.py`）
```

示例数据
- 仓库中的 `examples/` 目录包含若干示例轨道与外部数据文件，可用于验证和复现输出（例如 `GRACE-A_2017_09_07.csv`、`.sp3` 文件等）。

测试
- 使用 `pytest` 运行测试：

```bash
pytest -q
```

贡献
- 欢迎提交 issue 与 PR。请遵循仓库中的代码风格并添加必要的测试。

许可证
- 请参见仓库根目录的 `LICENSE` 文件。

