Metadata-Version: 2.4
Name: satnogs-predict
Version: 0.4
Summary: A package for calculating passes and observation windows for satellites.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: skyfield>=1.53
Dynamic: license-file

# satnogs-predict

[![Pipeline Status](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/pipeline.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
[![Coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
[![PyPI version](https://img.shields.io/pypi/v/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/raw/fb6964df5384da584c1dbb92ac157104c8a3948d/pyproject.toml&query=project.requires-python&label=python)
---

## 🚀 Overview

`satnogs-predict` is a Python library for:

- Satellite pass prediction  
- Observation window planning  
- Constraint-based window validation  

It is designed primarily for internal integration within SatNOGS.

---

## 📦 Installation

Requires **Python ≥ 3.11**.

```bash
pip install satnogs-predict
```

## 💻 Usage

`satnogs-predict` exposes its public API at the package top level. Prefer importing public functions and types directly from `satnogs_predict` rather than from internal submodules.

```python
from satnogs_predict import find_observation_windows
```

For more complete examples and usage patterns, see [docs/docs.md](docs/docs.md).

## License

[![license](https://img.shields.io/badge/license-AGPL%203.0-6672D8.svg)](LICENSE)
[![Libre Space Foundation](https://img.shields.io/badge/%C2%A9%202014--2026-Libre%20Space%20Foundation-6672D8.svg)](https://librespacefoundation.org/)
