Metadata-Version: 2.4
Name: decay-analyzer
Version: 0.1.2
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

[![PyPI version](https://badge.fury.io/py/decay-analyzer.svg)](https://pypi.org/project/decay-analyzer/)
[![Python versions](https://img.shields.io/pypi/pyversions/decay-analyzer.svg)](https://pypi.org/project/decay-analyzer/)
[![License](https://img.shields.io/github/license/kelarh/decay_analyzer.svg)](https://github.com/kelarh/decay_analyzer/blob/main/LICENSE)

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

## ✨ 特性

- 多种衰减分析方法：DSST、能量法、高斯变分法、Savitzky–Golay 滤波等
- 命令行工具：`decay-analyzer`
- 可作为库导入，支持脚本或 Jupyter Notebook 使用
- 示例数据与脚本，方便快速复现结果

## 📦 安装

```bash
pip install decay-analyzer
```

如需开发模式（可编辑安装）：

```bash
git clone https://github.com/kelarh/decay_analyzer.git
cd decay_analyzer
pip install -e .
```

## 🚀 快速开始

### 命令行使用

```bash
# 查看帮助
decay-analyzer --help

# 使用 DSST 方法分析示例数据
decay-analyzer run --input examples/GFZOP_RSO_L06_G_20090101_100000_20090102_000030_v01.csv --method dsst
```

### 作为库使用

```python
from decay_analyzer import run_sg_filter_analysis

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

## 📂 示例数据

`examples/` 目录包含示例轨道数据（`.sp3` 文件等），可用于验证和复现输出。

## 🧪 运行测试

```bash
pip install pytest
pytest -q
```

## 🤝 贡献

欢迎提交 Issue 和 Pull Request。请遵循仓库中的代码风格并添加必要的测试。

## 📄 许可证

本项目使用 [MIT](LICENSE) 许可证。

## 🔗 相关链接

- [PyPI 项目页](https://pypi.org/project/decay-analyzer/)
- [GitHub 仓库](https://github.com/kelarh/decay_analyzer)
- [问题反馈](https://github.com/kelarh/decay_analyzer/issues)
