Documentation & Ethics

About the Cosmic Mythology AR Explorer

Bridging ancient storytelling traditions and modern observational astrophysics across world skies.

1. Credits & Attribution

The Explorer synthesizes observational data and cultural humanities across multiple public institutions and scholarly foundations:

  • Astrometry & Stellar Data: Star positions (α, δ) and distances in this explorer are rounded, hand-entered values compiled from standard astronomical references. They are provided for visual exploration, star-hopping, and casual sky observation rather than scientific citation.
  • Space Science & Observatories: NASA Jet Propulsion Laboratory, Space Telescope Science Institute (Hubble / JWST), European Southern Observatory (ESO VLT), European Space Agency (ESA Euclid), and ISRO (Aditya-L1).
  • Cultural Research & Collections: Sacred Texts Archive, Tufts University Perseus Digital Library, Chinese Text Project (ctext.org), National Museum of Australia (Songlines), and historical manuscripts from the Bodleian and Louvre archives.

2. Astronomical Methods & Coordinate Computing

The application runs zero server-side computation. All calculations run client-side in the user's browser:

  • Local Sidereal Time (LST): Derived from Greenwich Mean Sidereal Time (GMST) at Julian date $JD$, corrected by the user's local geographic longitude $\lambda$: LST = (GMST + λ) % 360°.
  • Hour Angle & Horizon Elevation: Computed using spherical trigonometry: sin(Alt) = sin(φ) · sin(δ) + cos(φ) · cos(δ) · cos(HA), determining whether an asterism is currently above the local horizon tonight.
  • Planisphere Projection: Equidistant polar azimuthal projection mapping Right Ascension to polar angle and Declination linearly to radial distance from the celestial pole.
  • Keplerian Orbits: Solved in real time with circular approximations and concentric elliptical scaling for Mercury through Saturn.
  • Access Architecture: Astrometric calculations run client-side in the browser. The Home celestial canvas, Scientific view, and Myth & Culture story archives are accessible without an account, while cloud synchronization for Journeys quest progression and the Celestial Audiobook requires Stargazer email sign-in.

3. Story Editorial Review & Cultural Heritage Policy

Our research catalog contains 165 curated stories across 10 global traditions. The public release deliberately serves 109 verified stories across 7 traditions, applying strict editorial tiers:

  • Verified (Direct Text Evidence): The referenced digitized page or critical edition explicitly contains the narrative of the constellation or star.
  • Probable (Scholarly Context): The historical work, author, and chapter are confirmed in peer-reviewed catalogues, but the direct full-text reading requires archival access or print borrowing.
  • Pending Community Review Safeguard: Several Indigenous traditions embody sacred living oral knowledge. These are held back in public releases by design pending community review.

Living Oral Traditions Awaiting Community Review

Three living oral traditions—Polynesian and Hawaiian Wayfinding, Indigenous Australian Sky Lore, and Indigenous Americas celestial traditions (comprising 36 stories, 12 each)—are deliberately not published in the public release. In addition, 20 stories across the public traditions are omitted as unverified. These sky narratives belong to living cultures with sacred, community-held custodial protocols. To honor cultural safety and intellectual sovereignty, they remain withheld until recognized cultural custodians and community representatives review and approve their presentation. This exclusion is deliberate and reflects our commitment to cultural respect over rapid publishing.

4. How to Report a Mistake or Cultural Correction

We welcome scholarly reviews, community elder feedback, and corrections regarding astrometry, translations, or cultural representations.

Reporting Guidelines:

  • For stellar coordinate or spectral bugs, cite the relevant catalogue identifier (HIP, HD, or Gaia DR3 source).
  • For cultural heritage adjustments, note the tradition key (e.g., ind, nak, poly) and provide preferred community wording or literature references.
  • Open an issue on the project repository or submit a pull request against data/myth.json or data/citation-audit.csv.

5. Open Source Software & Font Licenses

This software is built entirely with open-source technologies. The 3D graphics engine (Three.js) is released under the MIT License, and the typographic font families (Cormorant Garamond and Space Grotesk) are licensed under the SIL Open Font License (OFL 1.1). Full license texts and copyright notices are available in LICENSES.md.