Metadata-Version: 2.4
Name: rotastellar
Version: 0.1.1
Summary: Python SDK for RotaStellar - Space Computing Infrastructure
Project-URL: Homepage, https://rotastellar.com
Project-URL: Documentation, https://rotastellar.com/docs
Project-URL: Repository, https://github.com/rotastellar/rotastellar-python
Project-URL: Issues, https://github.com/rotastellar/rotastellar-python/issues
Project-URL: Changelog, https://github.com/rotastellar/rotastellar-python/blob/main/CHANGELOG.md
Author-email: Subhadip Mitra <subhadipmitra@rotastellar.com>, RotaStellar Research <research@rotastellar.com>
Maintainer-email: Subhadip Mitra <subhadipmitra@rotastellar.com>, RotaStellar Research <research@rotastellar.com>
License: MIT
License-File: LICENSE
Keywords: conjunction-analysis,data-center,orbital,orbital-intelligence,satellite,satellite-tracking,space,space-computing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Python: >=3.9
Provides-Extra: all
Requires-Dist: httpx>=0.25; extra == 'all'
Requires-Dist: pydantic>=2.0; extra == 'all'
Provides-Extra: async
Requires-Dist: httpx>=0.25; extra == 'async'
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Provides-Extra: pydantic
Requires-Dist: pydantic>=2.0; extra == 'pydantic'
Description-Content-Type: text/markdown

# rotastellar

**Python SDK for RotaStellar — Space Computing Infrastructure**

Plan, simulate, and operate orbital data centers and space intelligence systems.

## Installation

```bash
pip install rotastellar
```

## Quick Start

```python
from rotastellar import Position, Orbit, Satellite, TimeRange

# Create a geographic position (e.g., Kennedy Space Center)
ksc = Position(latitude=28.5729, longitude=-80.6490, altitude_km=0.0)
print(f"KSC: {ksc.latitude}°N, {ksc.longitude}°W")

# Define an ISS-like orbit
orbit = Orbit(
    semi_major_axis_km=6778.0,
    eccentricity=0.0001,
    inclination_deg=51.6,
    raan_deg=100.0,
    arg_periapsis_deg=90.0,
    true_anomaly_deg=0.0
)
print(f"Orbital period: {orbit.period_minutes:.1f} minutes")
print(f"Apogee: {orbit.apogee_km:.1f} km, Perigee: {orbit.perigee_km:.1f} km")

# Create a satellite
sat = Satellite(
    id="ISS",
    name="International Space Station",
    norad_id=25544,
    position=Position(latitude=45.0, longitude=-122.0, altitude_km=408.0),
    orbit=orbit
)
```

## Features

- **Position** — Geographic coordinates with altitude
- **Orbit** — Keplerian orbital elements with derived properties
- **Satellite** — Satellite metadata and state
- **TimeRange** — Time window specifications
- **Validation** — Automatic parameter validation

## Related Packages

| Package | Description |
|---------|-------------|
| [rotastellar-intel](https://pypi.org/project/rotastellar-intel/) | Satellite tracking, TLE parsing, conjunction analysis |
| [rotastellar-compute](https://pypi.org/project/rotastellar-compute/) | Thermal, power, latency, and feasibility analysis |
| [rotastellar-distributed](https://pypi.org/project/rotastellar-distributed/) | Federated learning, model partitioning, mesh routing |

## Links

- **Website:** https://rotastellar.com
- **Documentation:** https://docs.rotastellar.com
- **GitHub:** https://github.com/rotastellar/rotastellar-python

## Author

Created by [Subhadip Mitra](mailto:subhadipmitra@rotastellar.com) at [RotaStellar](https://rotastellar.com).

## License

MIT License — Copyright (c) 2026 RotaStellar
