# SURYA — A Mathematical Journey Through Feeling

An epic Manim animation for Das's SURYA album — 14 tracks of emotional mathematics.

## The Journey

| Track | Title | Emotion | Color | Mathematical Elements |
|-------|-------|---------|-------|----------------------|
| 01 | Skin | Alienation | Pink | Morphing spirographs, identity struggle |
| 02 | U Saved Me | Hope | Cyan | Coalescing fragments, sacred geometry |
| 03 | Nothing | Emptiness | Grey | Voronoi fragmentation, void |
| 04 | Sweet Relief | Haunted | Purple | Ghost spirals, constriction |
| 05 | Tiptoe | Tense | Purple | Lissajous curves, careful movement |
| 06 | Nature's Call | Peaceful | Teal | Fractal trees, golden spiral |
| 07 | Dreamcatcher | Falling | Soft Purple | Sacred web, descent |
| 08 | IDK | Confusion | Pink | Strange attractor, chaos |
| 09 | With U | **THE TURN** | Golden | Binary orbits, two souls, stars |
| 10 | Poor You Poor Me | Bittersweet | Orange | Drifting souls, memories |
| 11 | Wait 4 U | Longing | Purple | Concentric circles, time passing |
| 12 | Run to U | Urgency | Cyan | Speed lines, collision |
| 13 | Medications | Struggle | Red | Chaos attractor, aggressive spirographs |
| 14 | Hollow | Resolution | Golden | Moon, golden spiral, sacred geometry |

## Mathematical Elements Used

- **Spirographs** (hypotrochoid curves) — identity and transformation
- **Golden Spiral** — nature's mathematics, resolution
- **Flower of Life** — sacred geometry, spiritual moments
- **Voronoi Diagrams** — fragmentation and emptiness
- **Lissajous Curves** — tension and caution
- **Strange Attractors** (Lorenz-like) — chaos and confusion
- **Fractal Trees** — nature and growth
- **Particle Systems** — emotions floating, memories drifting

## Rendering

### Quick Preview (720p, 15fps)
```bash
cd /Users/jakeshore/.clawdbot/workspace/surya-manim-journey
manim -pql surya_journey.py SuryaJourney
```

### Medium Quality (1080p, 30fps)
```bash
manim -pqm surya_journey.py SuryaJourney
```

### Full Quality (1080p, 60fps)
```bash
manim -pqh --fps 60 surya_journey.py SuryaJourney
```

### 4K Render
```bash
manim -p --resolution 3840,2160 --fps 60 surya_journey.py SuryaJourney
```

## Individual Track Testing

Each track is also available as a standalone scene:
```bash
manim -pql surya_journey.py Track01_Skin
manim -pql surya_journey.py Track09_WithU
```

## Test Scenes
```bash
manim -pql surya_journey.py TestSoul
manim -pql surya_journey.py TestMathObjects
```

## Output

Videos are saved to:
```
media/videos/surya_journey/{quality}/SuryaJourney.mp4
```

## Duration

- ~30 seconds per track
- Full journey: approximately 7-8 minutes
- Adjust `run_time` values to sync with actual audio

## Dependencies

- Manim Community Edition
- NumPy
- SciPy

```bash
pip install manim numpy scipy
```

---

*"you took my sorrow and flew it to the moon"*

**SURYA — DAS — 2026**
