# The sky of 30 May 2019

This directory contains self-hosted astronomical data and a computed default preview, not a generated random star field.

## Catalogue

`catalogue.json` is an adaptation of **HYG v4.1**, compiled by **David Nash / Astronomy Nexus**, licensed **CC BY-SA 4.0**:

- Source: https://github.com/astronexus/HYG-Database
- Raw file: https://raw.githubusercontent.com/astronexus/HYG-Database/main/hyg/CURRENT/hygdata_v41.csv
- Licence: https://creativecommons.org/licenses/by-sa/4.0/
- Changes: exclude the Sun; retain apparent magnitude ≤ 6.0; select and round right ascension, declination, magnitude, proper name and proper motion. RA is in hours, declination in degrees; pmRA is mas/year including cos(dec).
- The adapted star data and resulting chart images are also available under **CC BY-SA 4.0**. Original licence notice: `stars-LICENSE.txt`.

Constellation figures and Turkish names are adapted from **Olaf Frohn's d3-celestial**, **BSD-3-Clause**:

- https://github.com/ofrohn/d3-celestial/blob/master/data/constellations.lines.json
- https://github.com/ofrohn/d3-celestial/blob/master/data/constellations.json
- Changes: convert RA degrees to hours; select Turkish names and label anchors. Serpens has two figures, so the file has 89 figures for the 88 constellations.
- The full original copyright, conditions and disclaimer are in `constellations-LICENSE.txt`.

Original download SHA-256 hashes are recorded in `source-hashes.json`. Rebuild the catalogue with `python3 scripts/build-sky-data.py /path/to/sources`; expected source filenames are listed there. Run `node scripts/build-sky-preview.cjs` to regenerate the default chart and social card.

## Calculations

**Astronomy Engine 2.1.19**, by **Don Cross**, **MIT**, is vendored unchanged in `../vendor/astronomy-2.1.19.min.js`, with its original header and `../vendor/astronomy-LICENSE.txt`.

- https://github.com/cosinekitty/astronomy/tree/v2.1.19
- https://github.com/cosinekitty/astronomy/blob/v2.1.19/source/js/README.md

`sky-model.js` applies the catalogue's proper motion from J2000, rotates equatorial vectors into the observer's horizontal frame with date-specific precession and nutation, and renders an azimuthal equidistant projection. North is up, east is LEFT because this is a view looking UP. The centre is the zenith and the edge is the geometrical horizon. Constellation segments are sampled as great-circle arcs and clipped at the horizon. Solar-system positions are topocentric and include light travel time, aberration and parallax through Astronomy Engine.

The default is **Ankara city centre, 30 May 2019 at 22:00 Turkey time (19:00 UTC)**. This is a selectable starting view, not an assertion about the exact time or place of a personal event. Other supported city centres: Konya and Çeşme. Time is fixed to UTC+3 regardless of the viewer's device timezone.

This is a historical sky chart, not a weather or visibility reconstruction. It ignores atmospheric refraction, local obstructions, light pollution and stellar parallax/radial motion. Positions are suitable for this visual map, not precision navigation or telescope pointing.
