# VR Planetarium v2.0 - Enhanced with Real Astronomical Data

## 🌟 What's Included

### Star Data (from HYG Database v4.2)
- **119,626 stars** from Hipparcos, Yale Bright Star, and Gliese catalogs
- **8,920 naked-eye visible stars** (magnitude ≤ 6.5)
- **498 named stars** with proper names (Sirius, Vega, Polaris, etc.)
- Real positions (RA/Dec), magnitudes, and B-V color indices

### Milky Way Panorama (from ESO)
- **6000×3000 pixel** equirectangular panorama
- Real photograph of the night sky
- Licensed for educational use with credit

### NASA 360 Videos (You Upload Separately)
Place these in `assets/videos/`:
- `InsideHurricaneMariain360Meatball.webm`
- `Web_Around_Bennu_360_Small.mp4`
- `13733_orex_360.mp4`
- `Tour_compilation_final.webm`
- `OIB_Alaska_Best_VR_export.webm`
- etc.

---

## 📁 Directory Structure

```
public_html/planetarium/
├── view.html                 ← Student VR view
├── dashboard.html            ← Teacher controls (add later)
├── assets/
│   ├── data/
│   │   ├── bright_stars.json     ← 8,920 visible stars
│   │   ├── named_stars.json      ← 498 named stars
│   │   └── stars_top500.json     ← Quick-load subset
│   ├── images/
│   │   ├── milkyway_panorama.jpg     ← Full res (6MB)
│   │   └── milkyway_panorama_4k.jpg  ← Fast load (2MB)
│   ├── videos/               ← NASA 360 videos (you add)
│   └── exr/                  ← NASA star maps (you add)
├── js/
└── css/
```

---

## 🚀 Deployment

1. **Upload** the `public/` folder contents to your web server
2. **Add videos** to `assets/videos/` folder
3. **Test** by opening `view.html` in a browser

---

## 🎮 Controls

### Desktop/Mobile:
- **Drag** to look around
- Stars render with realistic colors based on spectral type
- Milky Way panorama as background

### VR Mode:
- Click **"Enter VR"** button (appears if WebXR supported)
- Look around with head movement
- Works with Google Cardboard, Meta Quest, etc.

---

## 📊 Star Data Format

`bright_stars.json` structure:
```json
{
  "id": 32349,
  "ra": 6.752481,      // Right Ascension (hours, 0-24)
  "dec": -16.716116,   // Declination (degrees, -90 to +90)
  "mag": -1.44,        // Apparent magnitude
  "ci": 0.009,         // B-V color index
  "name": "Sirius",    // Proper name (if any)
  "bayer": "Alp",      // Bayer designation
  "con": "CMa",        // Constellation
  "spect": "A1V"       // Spectral type
}
```

---

## 🔬 Technical Notes

- Uses **Three.js r128** for 3D rendering
- **WebXR** for VR support
- **Custom shaders** for realistic star glow
- **B-V to RGB conversion** using Ballesteros formula
- **Magnitude scaling** for proper star brightness

---

## 📜 Credits

- **Star Data:** HYG Database v4.2 (CC BY-SA 4.0) - astronexus.com
- **Milky Way:** ESO/S. Brunier - eso.org
- **NASA Videos:** NASA Public Domain

---

## 🎓 For Danville Science Center

Built for immersive astronomy education.
Version 2.0 - December 2024
