<p align="center">
  <img src="https://raw.githubusercontent.com/amanchokshi/skyweaver/main/docs/imgs/skyweaver.gif" width="100%">
</p>

[![PyPI](https://img.shields.io/pypi/v/skyweaver.svg?logo=pypi&logoColor=white&label=PyPI&color=2a3573)](https://pypi.org/project/skyweaver/)
[![Python](https://img.shields.io/badge/Python-3.13%2B-34777e?logo=python&logoColor=white)](https://pypi.org/project/skyweaver/)
[![CI](https://img.shields.io/github/actions/workflow/status/amanchokshi/skyweaver/tests.yml?branch=main&logo=github&color=82af74)](https://github.com/amanchokshi/skyweaver/actions/workflows/tests.yml)
[![codecov](https://img.shields.io/codecov/c/github/amanchokshi/skyweaver/main.svg?logo=codecov&logoColor=white&label=Coverage&color=f9dc28)](https://codecov.io/gh/amanchokshi/skyweaver)
[![Docs](https://img.shields.io/readthedocs/skyweaver/latest?logo=Read%20The%20Docs&logoColor=white&color=ea7b17)](https://skyweaver.readthedocs.io/en/latest/)
[![License](https://img.shields.io/github/license/amanchokshi/skyweaver?label-License&color=b72c40&logo=data:image/png;base64, )](https://github.com/amanchokshi/skyweaver/blob/main/LICENSE)
[![Black](https://img.shields.io/badge/Code%20Style-Black-222222.svg?logo=powershell&logoColor=white)](https://black.readthedocs.io)

---

**Simulating how satellite orbits weave across telescope skies.**

---

`skyweaver` is a Python framework for exploring satellite orbits:

- trace **ground tracks** across Earth  
- produce **sky tracks** as seen by observatories  
- segment into **above-horizon passes**  
- accumulate **HEALPix sky coverage maps**
A Python framework for simulating satellite orbits and how they weave tracks across telescope beams

---

`skyweaver` is designed to install cleanly with a single invocation of the standard Python package tool:

```bash
pip install skyweaver
```

Here are some essential project links:

- [Home page and documentation](https://skyweaver.readthedocs.io/en/latest)
- [Installing skyweaver](https://skyweaver.readthedocs.io/en/latest/guides/install)
- [Getting started with skyweaver](https://skyweaver.readthedocs.io/en/latest/guides)
- [skyweaver package on PyPI](https://pypi.org/project/skyweaver)
- [Issue tracker on github](https://github.com/amanchokshi/skyweaver/issues)

---

## License

MIT License — see `LICENSE` file.
