Metadata-Version: 2.4
Name: persprot
Version: 0.1.0
Summary: A lightweight Python package to assess and correct perspective rotation in Milky Way satellite galaxies.
Author: Marla Geha
Author-email: Andy Hicks <andrew.hicks@yale.edu>
License: MIT
Project-URL: Homepage, https://github.com/YourUsername/persprot
Project-URL: Bug Tracker, https://github.com/YourUsername/persprot/issues
Project-URL: Paper, https://arxiv.org/
Keywords: astronomy,kinematics,galaxies,radial-velocity,milky-way
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.20
Requires-Dist: astropy>=5.0

# persprot: Perspective Rotation Kinematics

**`persprot`** is a lightweight Python package designed to calculate and apply perspective rotation corrections for Milky Way satellite galaxies and globular clusters. 

Perspective rotation is an apparent radial velocity gradient across a stellar system that arises purely from the object's systemic proper motion and finite angular extent on the sky. This package provides tools to assess the magnitude of this effect and correct measured line-of-sight velocities ($v_{los}$) for individual stars, directly implementing the framework presented in **Hicks & Geha (2026)**.

The package seamlessly integrates with the [Local Volume Database (LVDB)](https://github.com/apace7/local_volume_database) to automatically fetch systemic proper motions, distances, and centers. All calculations utilize `astropy` native unit equivalencies to ensure strict numerical precision.

---

## Installation

You can install `persprot` directly from GitHub using `pip`:

```bash
pip install git+[https://github.com/YourUsername/persprot.git](https://github.com/YourUsername/persprot.git)
