# Nyx -- Product Features

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./deep-dive/features.md), rendered in the docs
> center. This file is its operational companion (service topology, APIs,
> schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).

> **Nyx** is a Cosmic Observatory Platform that combines interactive star
> mapping, high-precision celestial calculations, VR planetarium experiences, AR
> sky identification, telescope control, astrophotography tools, and educational
> features into a complete astronomy ecosystem. This document describes every
> user-facing feature from the perspective of stargazers, educators,
> astrophotographers, and telescope operators.

---

## Table of Contents

1. [Platform Access](#platform-access)
2. [Interactive Star Map](#interactive-star-map)
3. [Celestial Object Database](#celestial-object-database)
4. [Ephemeris and Position Calculations](#ephemeris-and-position-calculations)
5. [Astronomical Events](#astronomical-events)
6. [Observation Planning](#observation-planning)
7. [Telescope Control](#telescope-control)
8. [Astrophotography](#astrophotography)
9. [VR Planetarium](#vr-planetarium)
10. [AR Sky Identification](#ar-sky-identification)
11. [Educational Features](#educational-features)
12. [Constellation Mythology](#constellation-mythology)
13. [Solar System Explorer](#solar-system-explorer)
14. [Satellite Tracking](#satellite-tracking)
15. [Time Travel](#time-travel)
16. [Social and Community](#social-and-community)
17. [Gamification](#gamification)
18. [Search and Discovery](#search-and-discovery)
19. [Audio and Narration](#audio-and-narration)
20. [Offline and Cross-Platform](#offline-and-cross-platform)
21. [Data Catalogs and Sources](#data-catalogs-and-sources)
22. [Developer and API Access](#developer-and-api-access)
23. [Lilith Integration](#lilith-integration)

---

## Platform Access

Nyx is available across multiple platforms, from web browsers to VR headsets.

### Applications

| Application         | Description                                                            |
| ------------------- | ---------------------------------------------------------------------- |
| **Star Map (Web)**  | Interactive WebGL-powered star map in the browser                      |
| **Mobile App**      | iOS and Android app with AR sky identification and observation logging |
| **VR Planetarium**  | Immersive 360-degree VR planetarium for headsets                       |
| **AR Sky (Mobile)** | Augmented reality sky overlay for real-time object identification      |
| **Desktop App**     | Electron desktop application with telescope control integration        |
| **CLI Tools**       | Command-line utilities for ephemeris calculation and chart generation  |
| **API Server**      | REST and GraphQL API for programmatic access to all calculations       |
| **Data Pipelines**  | Automated data ingestion and processing for celestial catalogs         |

### System Requirements

| Platform    | Minimum                        | Recommended                         |
| ----------- | ------------------------------ | ----------------------------------- |
| **Web**     | Chrome 90+, WebGL 2.0, 4GB RAM | Chrome 110+, Dedicated GPU, 8GB RAM |
| **Mobile**  | iOS 15+ / Android 10+          | iPhone 12+ / ARCore device          |
| **VR**      | Quest 2 / SteamVR headset      | Quest 3 / Valve Index               |
| **Desktop** | Any modern OS                  | Dedicated GPU                       |

---

## Interactive Star Map

The centerpiece of Nyx is a real-time, interactive map of the night sky.

### Navigation

| Feature              | Description                                                         |
| -------------------- | ------------------------------------------------------------------- |
| **Pan and Zoom**     | Drag to pan, scroll to zoom from full-sky down to sub-degree fields |
| **Touch Navigation** | Pinch-to-zoom and single-finger pan on mobile and tablet            |
| **Gamepad Support**  | Navigate using game controller with analog stick control            |
| **Center on Object** | Double-click any object to center and zoom to it                    |
| **Coordinate Entry** | Jump to any RA/Dec or Alt/Az coordinates directly                   |
| **Compass Heading**  | Align the map with your real compass heading on mobile              |
| **Horizon Masking**  | Hide objects below your local horizon for realistic sky view        |

### View Modes

| Mode                   | Description                                                     |
| ---------------------- | --------------------------------------------------------------- |
| **2D Flat View**       | Traditional flat sky chart with selectable map projection       |
| **3D Orbital View**    | Interactive 3D view of the solar system with orbiting planets   |
| **Planetarium Mode**   | Hemisphere dome projection simulating a planetarium experience  |
| **Telescope Eyepiece** | Simulated eyepiece view matching your telescope's field of view |
| **Night Mode**         | Red-tinted display to preserve dark adaptation during observing |

### Map Projections

| Projection        | Best For                                   | Field of View   |
| ----------------- | ------------------------------------------ | --------------- |
| **Stereographic** | General viewing and wide-field navigation  | 1 - 180 degrees |
| **Gnomonic**      | Telescope planning with minimal distortion | 1 - 120 degrees |
| **Orthographic**  | Hemisphere view and artistic rendering     | 1 - 180 degrees |
| **Mercator**      | Equatorial belt navigation                 | 1 - 360 degrees |
| **Hammer-Aitoff** | Full-sky survey and overview               | Full sky        |
| **Mollweide**     | Area-accurate full-sky display             | Full sky        |

### Display Layers

| Layer                        | Description                                                  |
| ---------------------------- | ------------------------------------------------------------ |
| **Stars**                    | Stars displayed with accurate magnitude, color, and position |
| **Constellation Lines**      | Stick-figure constellation outlines connecting bright stars  |
| **Constellation Boundaries** | IAU constellation boundary lines                             |
| **Constellation Art**        | Classical constellation artwork overlaid on the sky          |
| **Deep Sky Objects**         | Nebulae, galaxies, and clusters with appropriate symbols     |
| **Planets**                  | Solar system planets shown at their calculated positions     |
| **Moon**                     | Moon with phase illumination and surface detail              |
| **Sun**                      | Sun position with danger warnings for daytime viewing        |
| **Milky Way**                | Milky Way band with adjustable opacity                       |
| **Coordinate Grid**          | RA/Dec or Alt/Az grid overlay for reference                  |
| **Ecliptic Line**            | The ecliptic plane where planets travel                      |
| **Celestial Equator**        | The projection of Earth's equator onto the sky               |
| **Horizon Line**             | Local horizon with cardinal direction labels                 |
| **Satellite Tracks**         | Predicted paths of artificial satellites                     |
| **Meteor Shower Radiants**   | Radiant points for active meteor showers                     |

### Object Interaction

| Feature                     | Description                                                     |
| --------------------------- | --------------------------------------------------------------- |
| **Click for Details**       | Click any object to see its name, magnitude, distance, and type |
| **Info Panel**              | Detailed information panel with physical properties and images  |
| **Wikipedia Links**         | Direct links to Wikipedia articles for further reading          |
| **Object Photos**           | Gallery of professional and community photos of each object     |
| **Rise/Set Times**          | When the object rises, transits, and sets from your location    |
| **Visibility Rating**       | How well you can see this object tonight from your location     |
| **GoTo Telescope**          | Send the object's coordinates to your connected telescope       |
| **Add to Observation List** | Save objects to your personal observation wishlist              |

---

## Celestial Object Database

Nyx provides access to comprehensive astronomical catalogs.

### Star Catalogs

| Catalog              | Stars        | Description                                      |
| -------------------- | ------------ | ------------------------------------------------ |
| **Yale Bright Star** | ~9,100       | All stars visible to the naked eye               |
| **Hipparcos**        | ~118,000     | High-precision positions from ESA satellite      |
| **Tycho-2**          | ~2.5 million | Extended catalog with proper motions             |
| **Gaia DR3**         | ~1.8 billion | State-of-the-art positions from ESA Gaia mission |

### Star Data

| Data Field             | Description                                      |
| ---------------------- | ------------------------------------------------ |
| **Name**               | Common name, Bayer designation, Flamsteed number |
| **Position (RA/Dec)**  | Right Ascension and Declination coordinates      |
| **Magnitude**          | Visual and absolute brightness                   |
| **Spectral Type**      | Stellar classification (O, B, A, F, G, K, M)     |
| **Distance**           | Distance in light-years and parsecs              |
| **Proper Motion**      | Annual motion across the sky                     |
| **Color Index (B-V)**  | Color temperature indicator                      |
| **Luminosity**         | Intrinsic brightness relative to the Sun         |
| **Variable Star Data** | Period, amplitude, and type for variable stars   |

### Deep Sky Object Catalogs

| Catalog      | Objects | Description                                          |
| ------------ | ------- | ---------------------------------------------------- |
| **Messier**  | 110     | Charles Messier's famous catalog of bright DSOs      |
| **NGC**      | ~7,800  | New General Catalogue of nebulae, clusters, galaxies |
| **IC**       | ~5,400  | Index Catalogue extensions to NGC                    |
| **Caldwell** | 109     | Sir Patrick Caldwell-Moore's observing list          |

### Deep Sky Object Data

| Data Field             | Description                                                                |
| ---------------------- | -------------------------------------------------------------------------- |
| **Type**               | Galaxy, nebula (emission, reflection, planetary), cluster (open, globular) |
| **Apparent Size**      | Angular size on the sky                                                    |
| **Surface Brightness** | Brightness per unit area                                                   |
| **Constellation**      | Parent constellation                                                       |
| **Distance**           | Distance in light-years or megaparsecs                                     |
| **Morphology**         | Galaxy type (spiral, elliptical, irregular) or nebula type                 |
| **Best Viewing**       | Optimal season and conditions for observation                              |

### Planet and Moon Data

| Feature                  | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| **Solar System Planets** | Complete data for all 8 planets plus dwarf planets           |
| **Planetary Moons**      | Data for major moons of each planet                          |
| **Physical Properties**  | Mass, radius, density, rotation period, orbital elements     |
| **Atmospheric Data**     | Atmospheric composition and conditions where applicable      |
| **Exoplanet Catalog**    | Database of confirmed exoplanets with habitable zone queries |

### Asteroid and Comet Data

| Feature                   | Description                                                   |
| ------------------------- | ------------------------------------------------------------- |
| **Near-Earth Asteroids**  | Tracking of potentially hazardous near-Earth objects          |
| **Comet Catalog**         | Known comets with orbital elements and visibility predictions |
| **Discovery Information** | Who discovered the object, when, and where                    |
| **Orbital Elements**      | Full Keplerian elements for orbit calculation                 |

---

## Ephemeris and Position Calculations

High-precision astronomical calculations for any date, time, and location.

### Position Calculation

| Feature                 | Description                                                |
| ----------------------- | ---------------------------------------------------------- |
| **Planetary Positions** | Calculate the position of any planet for any date and time |
| **Lunar Position**      | Moon position, phase, illumination, and libration          |
| **Star Positions**      | Current star positions with proper motion and precession   |
| **DSO Positions**       | Positions of deep sky objects corrected for precession     |

### Precision Levels

| Level      | Accuracy       | Speed   | Use Case                        |
| ---------- | -------------- | ------- | ------------------------------- |
| **Low**    | ~1 arcminute   | Fastest | Real-time visualization, gaming |
| **Medium** | ~10 arcseconds | Fast    | Observation planning, education |
| **High**   | ~0.1 arcsecond | Slower  | Telescope pointing, research    |

### Coordinate Systems

| Transformation               | Description                                          |
| ---------------------------- | ---------------------------------------------------- |
| **Equatorial to Horizontal** | Convert RA/Dec to Altitude/Azimuth for your location |
| **Horizontal to Equatorial** | Convert observed Alt/Az back to RA/Dec               |
| **Equatorial to Galactic**   | Transform to galactic longitude and latitude         |
| **Equatorial to Ecliptic**   | Transform to ecliptic longitude and latitude         |
| **Precession**               | Precess coordinates between epochs (J2000 to date)   |
| **Aberration Correction**    | Correct for the motion of the Earth                  |
| **Atmospheric Refraction**   | Correct for atmospheric bending of light             |

### Time Systems

| Time System                  | Description                                                     |
| ---------------------------- | --------------------------------------------------------------- |
| **UTC**                      | Coordinated Universal Time (civil time)                         |
| **Julian Date**              | Continuous day count from 4713 BCE for astronomical calculation |
| **Modified Julian Date**     | JD minus 2,400,000.5 for modern convenience                     |
| **Sidereal Time**            | Local and Greenwich sidereal time for RA calculations           |
| **Terrestrial Time**         | Uniform time scale for ephemeris calculations                   |
| **Barycentric Dynamic Time** | Solar system barycenter time for precise planetary work         |
| **Delta-T**                  | Difference between TT and UT1 for historical calculations       |
| **Besselian Year**           | Tropical year epochs for stellar coordinate reference           |

---

## Astronomical Events

Never miss a celestial event with comprehensive prediction and notification.

### Eclipse Prediction

| Feature                 | Description                                                |
| ----------------------- | ---------------------------------------------------------- |
| **Solar Eclipses**      | Predict total, partial, and annular solar eclipses         |
| **Lunar Eclipses**      | Predict total, partial, and penumbral lunar eclipses       |
| **Eclipse Maps**        | Visual maps showing eclipse paths and visibility zones     |
| **Local Circumstances** | Exact timing and magnitude from your observation location  |
| **Contact Times**       | Precise times for first contact, maximum, and last contact |
| **Historical Eclipses** | Look up past eclipses for any date in history              |

### Planetary Events

| Feature                 | Description                                                 |
| ----------------------- | ----------------------------------------------------------- |
| **Conjunction Finder**  | Find upcoming planetary conjunctions with separation angles |
| **Opposition Dates**    | When outer planets are closest and brightest                |
| **Transit Predictions** | Mercury and Venus transits across the Sun                   |
| **Planetary Groupings** | When multiple planets cluster in the sky                    |
| **Greatest Elongation** | Best viewing dates for Mercury and Venus                    |

### Other Events

| Feature                       | Description                                                |
| ----------------------------- | ---------------------------------------------------------- |
| **Meteor Shower Predictions** | Peak dates, ZHR, and best viewing times for meteor showers |
| **Comet Appearances**         | Upcoming bright comet visibility predictions               |
| **Lunar Phases**              | Calendar of new moon, full moon, and quarter phases        |
| **Supermoons**                | Identify upcoming supermoon events                         |
| **Equinoxes and Solstices**   | Exact times for seasonal markers                           |
| **Event Calendar**            | Unified calendar of all upcoming astronomical events       |
| **Event Notifications**       | Push notifications before significant astronomical events  |

---

## Observation Planning

Plan your observing sessions for maximum productivity and enjoyment.

### Visibility Calculator

| Feature                    | Description                                            |
| -------------------------- | ------------------------------------------------------ |
| **Object Visibility**      | Calculate when an object is visible from your location |
| **Rise/Transit/Set Times** | Precise times objects appear, peak, and disappear      |
| **Darkness Windows**       | Astronomical, nautical, and civil twilight times       |
| **Moon Interference**      | Assess how moonlight affects deep sky observing        |
| **Altitude Chart**         | Graph showing object altitude throughout the night     |

### Session Planner

| Feature                | Description                                                         |
| ---------------------- | ------------------------------------------------------------------- |
| **Observation List**   | Create lists of objects to observe during a session                 |
| **Optimal Ordering**   | Automatically order targets by transit time and altitude            |
| **Session Timeline**   | Visual timeline showing when each target is best placed             |
| **Equipment Matching** | Filter targets by what is visible with your telescope/binoculars    |
| **Difficulty Rating**  | Rate objects by difficulty to observe (easy, moderate, challenging) |

### Weather Integration

| Feature                      | Description                                               |
| ---------------------------- | --------------------------------------------------------- |
| **Cloud Cover Forecast**     | Multi-day cloud cover predictions for your observing site |
| **Seeing Forecast**          | Atmospheric seeing conditions (turbulence) prediction     |
| **Transparency Forecast**    | Atmospheric clarity forecast for deep sky observing       |
| **Humidity and Temperature** | Weather conditions relevant to equipment and comfort      |
| **Go/No-Go Indicator**       | Simple recommendation on whether conditions are suitable  |

### Light Pollution

| Feature                  | Description                                              |
| ------------------------ | -------------------------------------------------------- |
| **Light Pollution Map**  | Global map showing Bortle scale light pollution levels   |
| **Dark Site Finder**     | Find the nearest dark sky observing locations            |
| **Limiting Magnitude**   | Estimated faintest star visible from your location       |
| **Bortle Scale Display** | Your location's Bortle class rating                      |
| **Sky Quality Meter**    | Estimated sky quality in magnitudes per square arcsecond |

---

## Telescope Control

Connect and control your telescope directly from Nyx.

### Supported Protocols

| Protocol  | Description                                              |
| --------- | -------------------------------------------------------- |
| **ASCOM** | ASCOM Alpaca protocol for Windows telescope drivers      |
| **INDI**  | INDI protocol for Linux/Mac telescope and camera drivers |

### Mount Control

| Feature                | Description                                                |
| ---------------------- | ---------------------------------------------------------- |
| **GoTo Slewing**       | Command the telescope to slew to any object or coordinates |
| **Manual Nudging**     | Fine adjustments to pointing via on-screen arrow buttons   |
| **Tracking Rates**     | Set sidereal, lunar, solar, or custom tracking rates       |
| **Park/Unpark**        | Safely park and unpark the telescope mount                 |
| **Sync Coordinates**   | Synchronize the mount's position model with a known star   |
| **Alignment Routines** | Multi-star alignment procedures for accurate pointing      |

### Autoguiding

| Feature                  | Description                                       |
| ------------------------ | ------------------------------------------------- |
| **Autoguider Interface** | Interface for autoguiding cameras and software    |
| **Guide Star Selection** | Automatic or manual guide star selection          |
| **Guide Corrections**    | Real-time guide corrections displayed graphically |

### Camera Control

| Feature                  | Description                                            |
| ------------------------ | ------------------------------------------------------ |
| **Exposure Control**     | Set exposure time, gain, and binning                   |
| **Image Download**       | Download captured images from the camera               |
| **Filter Wheel Control** | Control motorized filter wheels for multi-band imaging |
| **Temperature Control**  | Cooled camera temperature regulation                   |

### Plate Solving

| Feature                       | Description                                                          |
| ----------------------------- | -------------------------------------------------------------------- |
| **Astrometric Plate Solving** | Analyze a photo to determine exactly where the telescope is pointing |
| **Sync After Solve**          | Automatically sync the mount position after solving a plate          |
| **Blind Solving**             | Solve images without any initial position hint                       |
| **Real-Time Solving**         | Continuous plate solving for precise centering                       |

---

## Astrophotography

Tools for planning and executing astrophotography sessions.

### Imaging Workflow

| Feature                 | Description                                                    |
| ----------------------- | -------------------------------------------------------------- |
| **Target Planning**     | Plan imaging targets based on visibility and conditions        |
| **Exposure Calculator** | Calculate optimal exposure times for your equipment            |
| **Framing Preview**     | Preview how a target will look in your camera's field of view  |
| **Mosaic Planner**      | Plan multi-panel mosaics for wide-field imaging                |
| **Sequence Builder**    | Build automated imaging sequences (lights, darks, flats, bias) |

### Image Management

| Feature                 | Description                                                   |
| ----------------------- | ------------------------------------------------------------- |
| **Image Library**       | Organize captured images by target, date, and equipment       |
| **FITS Viewer**         | View FITS astronomical image files with stretch controls      |
| **Metadata Extraction** | Read and display image metadata (exposure, coordinates, etc.) |
| **Image Sharing**       | Share your astrophotography with the Nyx community            |

---

## VR Planetarium

Immerse yourself in the cosmos with a full virtual reality planetarium.

### VR Features

| Feature                        | Description                                                  |
| ------------------------------ | ------------------------------------------------------------ |
| **360-Degree Sky**             | Full immersive sky surrounding you in every direction        |
| **Dome Projection Simulation** | Simulates the experience of a real planetarium dome          |
| **Spatial Audio**              | 3D positional sound for narration and ambient space sounds   |
| **Hand Tracking**              | Point at objects to identify them with hand tracking (Quest) |
| **Controller Navigation**      | Navigate the sky with VR controller input                    |
| **Scale Demonstration**        | Experience the true scale of celestial objects in VR         |
| **Time Control in VR**         | Speed up, slow down, or reverse time while immersed          |

### VR Experiences

| Experience                  | Duration | Description                                                |
| --------------------------- | -------- | ---------------------------------------------------------- |
| **Tonight's Sky**           | 10 min   | Quick tour of what is visible tonight from your location   |
| **Solar System Flythrough** | 20 min   | Fly past each planet and major moon                        |
| **Galaxy Tour**             | 30 min   | Journey through the Milky Way and beyond                   |
| **Deep Space Voyage**       | 45 min   | Visit famous nebulae and star-forming regions              |
| **Cosmic Scale Journey**    | 15 min   | Experience the scale from atoms to the observable universe |

### Multiplayer VR

| Feature                | Description                                            |
| ---------------------- | ------------------------------------------------------ |
| **Shared Viewing**     | Watch the sky together with friends in VR              |
| **Voice Chat in VR**   | Talk to other observers while viewing the sky together |
| **Guided Group Tours** | A guide leads a group through a narrated VR tour       |
| **Pointer System**     | Point at objects and others see your laser pointer     |

### Supported VR Headsets

| Device               | Support Level | Notes                         |
| -------------------- | ------------- | ----------------------------- |
| **Meta Quest 3**     | Full          | Native app with hand tracking |
| **Meta Quest 2**     | Full          | Native app                    |
| **Meta Quest Pro**   | Full          | Enhanced passthrough          |
| **Apple Vision Pro** | Full          | visionOS native               |
| **Valve Index**      | Full          | Via SteamVR                   |
| **HTC Vive Pro 2**   | Full          | Via SteamVR                   |
| **Pico 4**           | Full          | Native app                    |

---

## AR Sky Identification

Point your device at the sky and instantly identify what you see.

### AR Features

| Feature                      | Description                                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------- |
| **Live Sky Overlay**         | Star names, constellation lines, and planet labels overlaid on the live camera view |
| **Point and Identify**       | Point your phone at any part of the sky to identify objects                         |
| **Constellation Drawing**    | See constellation lines drawn on the real sky through your camera                   |
| **Planet Finder**            | Locate planets even during daylight by pointing your device                         |
| **Object Information Cards** | Tap identified objects for detailed information                                     |
| **AR Time Lapse**            | Visualize how the sky changes over hours through AR overlay                         |
| **Compass Calibration**      | Automatic compass calibration for accurate positioning                              |

### AR Supported Devices

| Platform         | Requirements                                          |
| ---------------- | ----------------------------------------------------- |
| **iPhone**       | iPhone 8+ (ARKit), LiDAR recommended for best results |
| **iPad**         | iPad Pro with LiDAR for premium AR experience         |
| **Android**      | ARCore-compatible devices                             |
| **Magic Leap 2** | Enterprise AR with full spatial mapping               |
| **HoloLens 2**   | Experimental enterprise AR support                    |

---

## Educational Features

Nyx is a powerful educational platform for learning astronomy at every level.

### Learning Modes

| Mode         | Description                                                                |
| ------------ | -------------------------------------------------------------------------- |
| **Beginner** | Simplified interface showing only bright stars, large labels, guided hints |
| **Student**  | Coordinate grids, scientific terminology, quiz mode, progress tracking     |
| **Expert**   | Full access to all catalogs, technical data, and professional tools        |

### Guided Tours

| Tour                      | Duration | Level    | Topics                                |
| ------------------------- | -------- | -------- | ------------------------------------- |
| **First Look at the Sky** | 15 min   | Beginner | Basic navigation, bright stars        |
| **The Constellations**    | 30 min   | Beginner | Major constellation identification    |
| **Seasonal Sky**          | 20 min   | Beginner | What to see each season               |
| **Planets Tonight**       | 10 min   | Beginner | Current planetary positions           |
| **The Moon**              | 25 min   | Beginner | Lunar features, phases, craters       |
| **Deep Sky Introduction** | 30 min   | Student  | Nebulae, galaxies, star clusters      |
| **Life of Stars**         | 45 min   | Student  | Stellar evolution from birth to death |
| **The Milky Way**         | 30 min   | Student  | Structure and features of our galaxy  |
| **Exoplanets**            | 40 min   | Student  | Planets orbiting other stars          |
| **Cosmology**             | 60 min   | Advanced | Universe structure, origin, and fate  |

### Interactive Lessons

| Feature                    | Description                                                     |
| -------------------------- | --------------------------------------------------------------- |
| **Concept Explanations**   | Interactive explanations of astronomical concepts               |
| **Visual Demonstrations**  | Animated demonstrations of phenomena (eclipses, seasons, tides) |
| **Quiz Mode**              | Self-testing quizzes after lessons with instant feedback        |
| **Progress Tracking**      | Track completed lessons and earned certifications               |
| **Difficulty Progression** | Lessons build from basic to advanced concepts gradually         |

---

## Constellation Mythology

Explore the stories behind the stars across world cultures.

### Mythology Features

| Feature                       | Description                                               |
| ----------------------------- | --------------------------------------------------------- |
| **Greek Mythology**           | Classical Greek myths for all 88 modern constellations    |
| **Roman Mythology**           | Roman equivalents and variations of constellation stories |
| **Chinese Star Lore**         | Chinese astronomical traditions and asterisms             |
| **Indigenous Sky Stories**    | Stories from indigenous cultures around the world         |
| **Arabian Star Names**        | Origins and meanings of traditional Arabic star names     |
| **Hindu Nakshatras**          | Vedic lunar mansion system and associated mythology       |
| **Multi-Cultural Comparison** | Compare how different cultures see the same stars         |
| **Illustrated Stories**       | Beautiful illustrated retellings of constellation myths   |
| **Audio Narration**           | Professionally narrated mythology stories                 |

---

## Solar System Explorer

Explore our solar neighborhood in interactive 3D.

### 3D Solar System

| Feature                | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| **Interactive Orrery** | 3D model of the solar system with planets orbiting the Sun  |
| **Planet Close-Up**    | Fly to any planet for a close-up view with surface detail   |
| **Moon Explorer**      | Visit moons of each planet with detailed surface maps       |
| **Asteroid Belt**      | Visualize the asteroid belt between Mars and Jupiter        |
| **Kuiper Belt**        | Explore the distant Kuiper Belt and trans-Neptunian objects |
| **Comet Orbits**       | View the highly elliptical orbits of comets                 |

### Scale Modes

| Mode          | Description                                               |
| ------------- | --------------------------------------------------------- |
| **Realistic** | True distances and sizes (planets appear as tiny dots)    |
| **Enhanced**  | Enlarged planets with compressed distances for visibility |
| **Schematic** | Diagrammatic view with labeled orbits for educational use |

### Planet Information

| Feature                 | Description                                                |
| ----------------------- | ---------------------------------------------------------- |
| **Physical Properties** | Mass, radius, density, gravity, rotation period            |
| **Orbital Data**        | Semi-major axis, eccentricity, inclination, orbital period |
| **Atmospheric Data**    | Atmospheric composition, pressure, temperature             |
| **Surface Features**    | Named craters, mountains, plains, and seas                 |
| **Exploration History** | Timeline of space missions that visited each world         |

---

## Satellite Tracking

Track artificial satellites including the ISS in real time.

### Satellite Features

| Feature                    | Description                                                    |
| -------------------------- | -------------------------------------------------------------- |
| **TLE Data Processing**    | Two-Line Element set parsing for satellite orbit prediction    |
| **ISS Tracking**           | Real-time position and pass predictions for the ISS            |
| **Iridium Flares**         | Predict bright Iridium satellite flares for your location      |
| **Starlink Trains**        | Track Starlink satellite trains after recent launches          |
| **Pass Predictions**       | When and where to look for satellite passes from your location |
| **Brightness Predictions** | Predicted visual magnitude for each pass                       |
| **Satellite Map**          | Live map showing satellite positions over the Earth            |

---

## Time Travel

Experience the sky at any point in history or the future.

### Time Control

| Feature                      | Description                                                        |
| ---------------------------- | ------------------------------------------------------------------ |
| **Date/Time Picker**         | Set any date and time to see the sky as it appeared then           |
| **Time Slider**              | Drag a slider to scrub through time and watch the sky change       |
| **Speed Control**            | Speed up or slow down time flow (1x, 10x, 100x, 1000x)             |
| **Play/Pause**               | Play time forward or backward and pause at any moment              |
| **Preset Dates**             | Quick jump to significant astronomical events in history           |
| **Historical Eclipses**      | View solar and lunar eclipses as they appeared centuries ago       |
| **Precession Visualization** | Watch the slow precession of the equinoxes over millennia          |
| **Valid Range**              | High accuracy from 1800 to 2200 CE; acceptable from 500 to 2500 CE |

---

## Social and Community

Share your love of astronomy with fellow stargazers.

### Community Features

| Feature                      | Description                                                   |
| ---------------------------- | ------------------------------------------------------------- |
| **Observation Sharing**      | Share observation logs with photos and notes                  |
| **Community Photo Gallery**  | Browse and contribute astrophotography to a shared gallery    |
| **User Profiles**            | Astronomy profile showing observations, equipment, and badges |
| **Comments and Discussions** | Comment on observations and images from other users           |
| **Observing Groups**         | Join or create local observing groups                         |
| **Star Parties**             | Organize and find local star party events                     |

### Equipment Management

| Feature                       | Description                                                       |
| ----------------------------- | ----------------------------------------------------------------- |
| **Equipment Inventory**       | Catalog your telescopes, eyepieces, cameras, and accessories      |
| **Equipment Reviews**         | Read and write reviews of astronomy equipment                     |
| **Field of View Calculator**  | Calculate the field of view for your telescope/camera combination |
| **Equipment Recommendations** | Get suggestions for equipment based on your observing goals       |

---

## Gamification

Make learning and observing fun with achievements and challenges.

### Achievements

| Feature                   | Description                                             |
| ------------------------- | ------------------------------------------------------- |
| **Messier Marathon**      | Track progress toward observing all 110 Messier objects |
| **Caldwell Challenge**    | Attempt to observe all 109 Caldwell objects             |
| **Planet Collector**      | Observe all visible planets                             |
| **Constellation Spotter** | Identify all 88 constellations                          |
| **Eclipse Chaser**        | Observe solar and lunar eclipses                        |
| **Meteor Counter**        | Log meteor shower observations                          |
| **Dark Sky Explorer**     | Visit and observe from dark sky sites                   |
| **Milestone Badges**      | Earn badges for 10, 50, 100, 500, and 1000 observations |

### Observation Logging

| Feature                  | Description                                                        |
| ------------------------ | ------------------------------------------------------------------ |
| **Observation Log**      | Record every observation with date, time, location, and notes      |
| **Sketch Mode**          | Draw sketches of what you see through the eyepiece                 |
| **Photo Attachment**     | Attach photos to observation log entries                           |
| **Conditions Recording** | Log seeing, transparency, Bortle class, and equipment used         |
| **Personal Statistics**  | Track total observations, unique objects, and time under the stars |

---

## Search and Discovery

Find any object in the sky quickly and accurately.

### Search Features

| Feature                     | Description                                                     |
| --------------------------- | --------------------------------------------------------------- |
| **Name Search**             | Search by common name (e.g., "Orion Nebula", "Vega")            |
| **Catalog Search**          | Search by catalog ID (M42, NGC 7000, HIP 91262, etc.)           |
| **Coordinate Search**       | Search by RA/Dec or Alt/Az coordinates                          |
| **Filter by Type**          | Filter results by type (star, galaxy, nebula, cluster, planet)  |
| **Filter by Magnitude**     | Show only objects brighter than a chosen magnitude              |
| **Filter by Constellation** | Show objects within a specific constellation                    |
| **Nearby Objects**          | Find objects near a given position or another object            |
| **Habitable Zone Query**    | Find exoplanets within the habitable zone of their stars        |
| **What's Up Tonight**       | List all interesting objects visible tonight from your location |

---

## Audio and Narration

Enhance the experience with sound and spoken content.

### Audio Features

| Feature                       | Description                                               |
| ----------------------------- | --------------------------------------------------------- |
| **Guided Tour Narration**     | Professional voice narration for all guided tours         |
| **Ambient Soundscapes**       | Space-themed ambient music for immersive viewing          |
| **Object Audio Descriptions** | Audio descriptions of celestial objects for accessibility |
| **Multi-Language Narration**  | Tours available in multiple languages                     |

---

## Offline and Cross-Platform

Use Nyx anywhere, even without internet connectivity.

### Offline Features

| Feature                    | Description                                               |
| -------------------------- | --------------------------------------------------------- |
| **PWA Installation**       | Install the web app for offline use                       |
| **Offline Star Catalog**   | Bright star catalog available offline                     |
| **Offline Ephemeris**      | Built-in ephemeris data for offline position calculations |
| **Offline Constellations** | Constellation data and boundaries available offline       |
| **Sync When Online**       | Observations and data sync when connectivity is restored  |

### Cross-Platform Sync

| Feature                    | Description                                                   |
| -------------------------- | ------------------------------------------------------------- |
| **Account Sync**           | Observation logs, favorites, and settings sync across devices |
| **Equipment Library Sync** | Your equipment inventory available on all platforms           |
| **Observation List Sync**  | Observation planning lists shared across devices              |

---

## Data Catalogs and Sources

Nyx draws on authoritative astronomical data sources.

### Data Provenance

| Source                                   | Components Used                                         |
| ---------------------------------------- | ------------------------------------------------------- |
| **Jean Meeus (Astronomical Algorithms)** | Planetary positions, coordinate transforms, eclipses    |
| **VSOP87**                               | Planetary orbital theory (Venus, Mars, Jupiter, etc.)   |
| **IAU Standards**                        | Constellation boundaries, obliquity, precession model   |
| **JPL DE440**                            | High-precision planetary and lunar ephemeris (optional) |
| **ESA Gaia DR3**                         | State-of-the-art star positions and parallaxes          |
| **ESA Hipparcos**                        | High-precision star catalog                             |
| **IERS Bulletins**                       | Earth orientation parameters and leap seconds           |

---

## Developer and API Access

### REST API

| Endpoint                     | Description                                   |
| ---------------------------- | --------------------------------------------- |
| `GET /api/v1/ephemeris`      | Calculate position of any celestial object    |
| `GET /api/v1/stars`          | Query star catalogs with filters              |
| `GET /api/v1/constellations` | List all 88 constellations with boundaries    |
| `GET /api/v1/events`         | Upcoming astronomical events                  |
| `GET /api/v1/visibility`     | Object visibility calculations for a location |
| `POST /api/v1/observation`   | Log an observation record                     |

### SDK and Client Libraries

| Library              | Description                                           |
| -------------------- | ----------------------------------------------------- |
| `@nyx/sdk`           | Unified TypeScript SDK for all Nyx features           |
| `@nyx/client`        | HTTP client for the Nyx API                           |
| `@nyx/client-python` | Python client library for scientific and research use |

### Embeddable Widgets

| Widget                | Description                                  |
| --------------------- | -------------------------------------------- |
| **Star Map Widget**   | Embed an interactive star map in any website |
| **Event Calendar**    | Embed an upcoming events calendar            |
| **Sky Tonight**       | Widget showing what is visible tonight       |
| **Moon Phase Widget** | Display current lunar phase                  |

---

## Lilith Integration

Nyx integrates with the Lilith consciousness platform for unique cross-domain
experiences.

### Cross-Domain Features

| Feature                     | Description                                                  |
| --------------------------- | ------------------------------------------------------------ |
| **Cosmic Meditation**       | Meditation sessions set in realistic cosmic environments     |
| **Star-Guided Mindfulness** | Mindfulness exercises linked to celestial events             |
| **Astronomical Journaling** | Journal about observations with Lilith's journaling tools    |
| **Celestial Sound Healing** | Sound healing sessions synchronized with planetary positions |
| **Moon Phase Meditation**   | Meditation recommendations based on the current lunar phase  |

---

## Feature Summary

| Category             | Feature Count | Highlights                                               |
| -------------------- | ------------- | -------------------------------------------------------- |
| Star Map             | 30+           | Interactive WebGL, 6 projections, 15+ display layers     |
| Celestial Database   | 20+           | Gaia DR3 (1.8B stars), Messier, NGC, exoplanets          |
| Ephemeris            | 15+           | Multi-precision, 8 time systems, 7 coordinate transforms |
| Events               | 15+           | Eclipses, conjunctions, meteors, calendar, notifications |
| Observation Planning | 15+           | Visibility, weather, light pollution, session planner    |
| Telescope Control    | 12+           | ASCOM, INDI, GoTo, autoguiding, plate solving            |
| Astrophotography     | 9+            | Exposure calc, framing, mosaics, FITS viewer             |
| VR Planetarium       | 12+           | 360-degree sky, multiplayer, 5+ guided experiences       |
| AR Sky               | 7+            | Live overlay, point-and-identify, planet finder          |
| Education            | 15+           | 3 learning modes, 10 guided tours, quizzes               |
| Mythology            | 9+            | Multi-cultural stories, illustrated, narrated            |
| Solar System         | 10+           | 3D orrery, planet close-ups, moon explorer               |
| Satellite Tracking   | 7+            | TLE parsing, ISS, Starlink, pass predictions             |
| Social               | 10+           | Observation sharing, groups, star parties                |
| Gamification         | 10+           | Messier marathon, achievements, observation logging      |

---

_Nyx: Your window to the cosmos._
