# astroz Examples

## Cesium Satellite Visualization

Interactive 3D visualization of the entire near-earth satellite catalog (~13,000 satellites).

**Files:**
- `cesium_fast.py` - Main script (downloads TLEs, propagates, generates HTML)
- `cesium_template.html` - HTML/JS template for the visualization

### Running

```bash
uv run --python 3.12 examples/cesium_fast.py
```

This generates `cesium_fast.html` in the project root. Open it in your browser.

### Features

- Multithreaded SGP4 propagation (~300M propagations/sec on 16 threads with AVX512)
- Color coded constellations (Starlink, OneWeb, Planet, Spire, Iridium, etc.)
- Toggle constellation visibility
- Search satellites by name (auto-labels when ≤10 results)
- Click for orbital details, double-click to track
- Real time mode showing actual current UTC positions

### Keyboard Shortcuts

| Key | Action |
|-----|--------|
| Space | Pause/resume |
| R | Toggle real-time mode |
| Esc | Stop tracking / reset view |

## Other Examples

- `python_sgp4.py` - Basic SGP4 propagation using python-sgp4 compatible API (`astroz.api`)
- `conjunction_screening.py` - Conjunction detection example (Python)
- `propagation.zig` - SGP4/SDP4 propagation with SIMD batch, modular interface, and unified Satellite type
- `orbit_maneuvers.zig` - Hohmann transfer and orbital maneuvers
- `maneuver_planning.zig` - Force model propagation (TwoBody, J2, Composite, Dormand-Prince 8(7))
- `constellation_phasing.zig` - Sun-sync orbit design and constellation RAAN phasing