ASTERISMS
← Back to the sky

Asterisms · source record

Sources

How Asterisms knows what is in the sky.

This is a provenance record, not a claim that every catalogue or observatory service is connected. It separates stored catalogue snapshots from local calculations and the small set of positions requested live.

Current catalogue snapshot

Latest source sync Sep 29, 2026 · built Sep 29, 2026

9,042
catalogue stars
88
official constellation regions
74
Western asterisms
453
curated fixed deep-sky and host-system records

The 453 fixed records comprise 300 OpenNGC objects (all 110 Messier designations included), 15 ATNF pulsars, 10 McGill magnetars, 26 NASA Exoplanet Archive host systems, and 102 curated SIMBAD records. The search-only live list adds 27 natural satellites, 12 comets, and 11 asteroids.

01 / 14

Stars & constellations

The star field and line drawings come from distinct datasets. The IAU names sky regions; it does not prescribe the star-to-star stick figures.

HYG Stellar Database v4.1

CatalogueBuild-time snapshot

Provides J2000 star positions, magnitudes, B−V colour, distance, spectral information, proper motion, HIP and HR/BSC identifiers, Bayer and Flamsteed designations, constellation membership, and its recorded proper/common names. Asterisms keeps pattern-member stars plus the field-star pool at magnitude 6.5 or brighter, not the complete HYG database.

HYG v4.1 is licensed CC BY-SA 4.0. Names in its proper field are shown as HYG records them; they are not all asserted to be IAU-approved. No systematic per-star Working Group on Star Names check has been performed.

HYG v4.1 data and field notes

ConstellationLines — Marc van der Sluys

Line conventionBuild-time snapshot

Provides the chosen stick-figure line convention for the 88 official constellations. Its line sequences reference Bright Star Catalogue (HR) numbers; Asterisms joins those numbers to HYG and turns consecutive stars into line segments. Some figures are intentionally made of separate paths. Source repository.

Copyright © 2005–2023 Marc van der Sluys · CC BY 4.0. Cite ConstellationLines, v1.3 (2023-12-18), DOI 10.5281/zenodo.10401591.

Version 1.3 record and citation

International Astronomical Union

Reference authorityIdentity standard

The IAU standardizes the 88 constellation regions, names, and abbreviations. Asterisms carries those identities through the Stellarium Western sky-culture data below; it does not download IAU boundary polygons. The IAU does not define the line figures used in this app.

Reference authority only; not a separate downloaded production catalogue in Asterisms.

IAU record of the 88 constellations

Yale Bright Star Catalogue, 5th Revised Edition · V/50

Astrometry fallbackBuild-time · 7 records

Asterisms uses seven fixed HR-to-position/brightness crosswalk records from Hoffleit et al. (1991) where a ConstellationLines star did not join to HYG v4.1. The rest of the line stars use HYG values. This is a specific VizieR-hosted catalogue, not a general VizieR import.

The CDS catalogue record provides the source citation; no separate redistribution licence is recorded for these seven rows. Asterisms preserves the catalogue identity and does not describe all of VizieR as an ingested source.

CDS catalogue V/50

02 / 14

Solar system & ephemerides

The Sun, Moon, planets, and selected moving targets do not use permanent background-star coordinates.

Astronomy Engine

Calculation libraryRuntime · local

Version 2.1.19 calculates observer-relative positions for the Sun, Moon, Mercury through Neptune, and Pluto; lunar phase and illumination; local horizon coordinates; rise/set searches; and solar timing used by the nightly sky, guided-find, and Seek views. Asterisms also uses its equatorial-to-horizontal rotation and sidereal-time routines alongside the app's catalogue-star proper-motion transforms. Selected smaller moon orbits use local JPL Horizons vector snapshots.

Astronomy Engine v2.1.19 · MIT License. Calculations run locally; no Astronomy Engine ephemeris dataset is bundled.

Astronomy Engine project

NASA/JPL Horizons

Ephemeris & validationGenerated local state vectors

Asterisms stores Earth-centred ICRF state vectors for 27 selected moons, 12 comets, and 11 asteroids. The sky reads local samples and interpolates position vectors; Horizons is not queried during animation or object selection. Each target carries a validity interval and withheld-sample angular-error report.

Curated target IDs, Horizons solution identifiers, retrieval time, validity, and validation metrics travel with the local snapshot. The API documentation does not state a separate licence for returned ephemerides; Asterisms does not claim one.

JPL Horizons API documentation

03 / 14

Deep sky & distant objects

Fixed deep-sky positions and classifications are curated at build time and shipped with per-record source provenance.

OpenNGC

CatalogueBuild-time snapshot · Sep 29, 2026

Supplies 300 selected NGC/IC and related deep-sky objects, including all 110 Messier designations. Asterisms uses catalogue IDs, cross-identifications, object types, coordinates, constellation labels, magnitudes and angular dimensions/position angles when available. M102 remains a search alias of M101 rather than a second object.

OpenNGC at commit 75ca7ff090e1d0081a5b08be70eb3bc45ccd9e06 · CC BY-SA 4.0. The app keeps a curated subset, not the full NGC/IC database.

Pinned OpenNGC snapshot and licence

04 / 14

Compact & exotic objects

The app combines specialist catalogues for pulsars and magnetars with a tightly selected set of SIMBAD identities and positions.

ATNF Pulsar Catalogue · PSRCAT v2.8.1

CatalogueBuild-time snapshot

Contributes 15 selected pulsars and the available positions, proper motions, spin periods, and binary metadata. Records not present in the selected input are not implied by this count.

ATNF asks users to acknowledge the catalogue and cite Manchester et al. (2005), AJ 129, 1993–2006, plus the catalogue URL; see its usage and citation notes. Its PSRCAT software is documented as GPL-3.0-or-later; the source does not state a separate licence for extracted catalogue records, so Asterisms does not label the data BSD.

ATNF catalogue and usage notes

McGill Online Magnetar Catalog

CatalogueBuild-time snapshot · 17 Nov 2020

Contributes 10 selected magnetar names, positions, and proper motions where present. The curated candidate/confirmed status is retained rather than silently promoting candidates.

The catalogue says its information may be used in publications and asks users to cite Olausen & Kaspi (2014), ApJS 212, 6, and its URL. No separate data licence is stated in the captured source record.

McGill magnetar catalogue

SIMBAD Astronomical Database · CDS

Cross-identification & object dataBuild-time TAP snapshot · Sep 29, 2026

Supplies identifiers, ICRS positions, object types, measured distance records where available, and redshift values for 102 curated records and the selected OpenNGC deep-sky targets. The generated catalogue currently includes 274 SIMBAD sourced distance measurements and 42 redshift-only records. Each distance retains its unit, quality, method, uncertainty, and reference when SIMBAD provides them. Redshift is handled separately; it is never treated as an ordinary Euclidean distance.

SIMBAD service data are under ODbL 1.0 and request the acknowledgement “This research has made use of the SIMBAD database, operated at CDS, Strasbourg, France” plus Wenger et al. (2000), A&AS 143, 9. Asterisms retains source IDs, snapshot dates, measurement methods, and per-record provenance. Where SIMBAD supplies redshift, the app calculates lookback time using the separately cited Planck 2018 cosmology.

SIMBAD at CDS

GRAVITY Collaboration · Galactic-centre distance

Sagittarius A* host-system distancePublished 2022 · curated literature measurement

The study reports a geometric distance to the Galactic Centre of 8.275 ± 0.009 (stat) ± 0.033 (sys) kpc. Asterisms uses the measured host-system distance for Sagittarius A*, combines the uncertainty in quadrature for its technical record, and labels the displayed value approximate.

Citation: GRAVITY Collaboration (2022), *Astronomy & Astrophysics* 657, L12. The article provides the measurement used for the Sagittarius A* host-system distance.

A&A paper · DOI

05 / 14

Exoplanets

A distant system appears at its host star's position; individual exoplanets are not separately resolved on the sky.

NASA Exoplanet Archive · PSCompPars

CatalogueBuild-time TAP snapshot · Sep 29, 2026

Supplies 26 curated host-system records. The selected fields include host coordinates, distance and visual magnitude when available, system multiplicity, and confirmed planet names, radii, masses, and orbital periods. The marker and position belong to the host system, not a fabricated planet offset.

The archive requests an acknowledgement and citation to Christiansen et al. (2025); see its acknowledgement guidance. The snapshot provenance does not include a distinct dataset licence statement.

PS / PSCompPars table definitions

06 / 14

Asteroids, comets & small bodies

Small-body positions use local sampled state vectors with target-specific, finite date ranges.

JPL Horizons positions

Local ephemerisBuild-time sampled data

The searchable list contains 12 comets and 11 asteroids, including Ceres, Vesta, Apophis, Bennu, and Ryugu. Their local vectors cover a bounded four-year window; selected moons use hourly samples across a 28-day window. Requests outside a target's recorded validity are reported unavailable.

Horizons commands are curated in src/data/dynamic-targets.json. Rebuild and withheld-sample validation use npm run data:dynamic. JPL Small-Body Database (SBDB) is not used for orbit solutions or physical metadata.

JPL Horizons API documentation

SIMBAD historical transient positions

Dated event positionsCurated references · 11 historical events

Searchable SIMBAD-referenced events include the supernovae of 1006, 1054, 1572, 1604, 1987A, 2011fe, 2014J, and 2023ixf, plus the GW170817/AT 2017gfo counterpart. Each coordinate identifies a remnant, host/event position, or transient counterpart. These are dated annotations, not persistent bright objects.

SIMBAD-derived records use service data under ODbL 1.0; the requested acknowledgement and citation are listed here. No historical brightness curves are modeled.

SIMBAD at CDS

NASA Science · historical comets

Lifecycle contextTwo dated event markers

The searchable historical-only records cover ISON's 2013 fragmentation and the Shoemaker–Levy 9 impacts on Jupiter in 1994. The second record marks Jupiter's position at the first impacts, not a surviving comet fragment. Both positions are timestamped JPL Horizons vectors; neither comet is propagated as a current body. See NASA's Shoemaker–Levy 9 event summary.

Event lifecycle context is sourced from NASA Science; sky coordinates for each dated marker are separately identified as JPL Horizons positions. No brightness history or live comet trajectory is inferred.

C/2012 S1 (ISON) event summary

07 / 14

Spacecraft

The ISS is a live Earth-orbiting target with a separate orbital-data and local-propagation path.

CelesTrak General Perturbations

Orbital elementsLive cached OMM · NORAD 25544

The same-origin route retrieves OMM JSON for the ISS (ZARYA), NORAD 25544. It caches the set for 30 minutes and serves a dated last-known-good snapshot if the upstream request fails. The browser propagates it locally; observer location is never sent to CelesTrak.

Refresh follows the CelesTrak usage policy: cache GP data and avoid frequent repeat downloads. Fresh means an epoch up to 12 hours old; aging means 12–48 hours; stale means over 48 hours, when the precise marker is suppressed. The selected date must also be within 48 hours of the epoch.

CelesTrak GP data formats

satellite.js 7.1.0

Calculation libraryClient-side SGP4

Parses CelesTrak OMM and propagates the ISS with SGP4. Its returned state is TEME (km and km/s); satellite.js converts the position to Earth-fixed coordinates for local azimuth, altitude, slant range, and Earth-shadow calculations.

Version 7.1.0 · MIT License. The library performs calculations only; it supplies no orbital catalogue.

satellite.js project and licence

08 / 14

Places, time & your location

Place search uses a local index. Device location is a separate, opt-in browser capability, not an astronomy catalogue.

GeoNames populated places

Location dataBuild-time index · local search

Asterisms preprocesses GeoNames' cities5000 extract into its own server-side place index. It supplies place names, city-centre WGS84 coordinates, country/administrative region, population ranking, and the source timezone identifier. Normal searches query Asterisms' own index; no third-party geocoder is called.

GeoNames data is CC BY 4.0 and requests attribution with a link. The city index was retrieved 26 Sep 2026. A city-centre location is approximate; it is not an exact device location.

GeoNames data export and terms

09 / 14

Artwork & sky culture

The app presents the Western sky-culture tradition as one tradition, not as a universal account of the sky.

Stellarium Sky Cultures · Western

Sky-culture dataBuild-time snapshot

Provides Western asterism names/line conventions and constellation identity metadata, along with the HIP anchors used to align the illustrations. Its source description identifies the Western culture's 88 regions as the IAU scheme; asterism figures remain cultural pattern conventions.

Western sky-culture text and data are CC BY-SA, per the source description. Asterisms uses a transformed subset of the source metadata; it does not claim the Western tradition is the only valid one.

Western sky-culture files and licence note

Johan Meuris · Stellarium constellation illustrations

ArtworkBundled files · 85 figures

These are Johan Meuris' original illustrations, not AI-generated images. Asterisms bundles 85 Western constellation figures from the packaged sky-culture source; Puppis, Serpens, and Vela currently have no bundled illustration. The source images remain intact on disk; the renderer removes their black background, applies a monochrome treatment and opacity, and aligns each image to three HIP anchors (with supplied ICRS vectors when an anchor star is absent).

Illustrations are under the Free Art License. Keep the artist credit and licence when reusing them. Constellation names and anchor metadata have the separate CC BY-SA terms above.

Artist's Stellarium artwork credit

10 / 14

How Asterisms uses the data

The sky combines stored coordinates, local calculations, and one cached orbital-elements feed for the ISS.

  • Fixed stars and distant objects: curated coordinates and catalogue fields are generated at build time, shipped locally, and transformed for the selected sky. HYG proper motion is applied to stars where available.
  • Sun, Moon, and planets: Astronomy Engine calculates positions and observer-to-body distances locally for the selected date and observer; the same local calculations drive Moon phase/illumination and rise/set timing.
  • Selected moons, comets, and asteroids: Asterisms interpolates local Earth-centred JPL Horizons state vectors. The sky does not contact JPL during animation or search; target-specific date limits prevent indefinite extrapolation.
  • ISS: CelesTrak supplies cached OMM orbital elements; satellite.js propagates them in TEME and local observer geometry calculates position and range. User coordinates stay in the browser.
  • Historical transients: dated event markers point to source-backed remnants, hosts, or reported counterpart positions. They do not represent current bright objects or use invented brightness histories.
  • Cosmological sources: measured catalogue distances stay labelled as such. For redshift-only objects, the display uses lookback time from numerical flat-ΛCDM integration with Planck 2018 parameters (H₀ = 67.4 km/s/Mpc, Ωm = 0.315, Ωr = 0.000092; ΩΛ is derived by flatness), rather than an unlabeled redshift-distance conversion. Planck Collaboration VI (2020), A&A 641, A6.
  • Place search: the query is matched against Asterisms' preprocessed GeoNames index through this site's route; the browser does not call GeoNames' geocoder.
  • Device location: the browser's opt-in location result is used as the observer input. It is not sent to CelesTrak or JPL.

The normal sky view uses bundled data. Only the ISS orbital-elements route may request a current astronomy source while the ISS is selected.

11 / 14

Celestial events

Event forecasts have their own source dates, precision, importance rules, and local-visibility limits. Calendar completeness and presentation emphasis are recorded separately.

International Meteor Organization — 2027 Meteor Shower Calendar

Visual shower source2027 working list · 453 shower records · retrieved 2026-09-30

The source snapshot imports all named entries in Table 5, the Working List of Visual Meteor Showers. Peak dates are represented as calendar dates and activity ranges; the calendar does not invent a maximum clock time. IMO-highlighted showers can be elevated in importance independently of nominal ZHR.

The broad, time-varying Antihelion Source is not shown as one point-radiant event. Daytime-listed showers remain under All Events with a note about the Sun-adjacent radiant. This credits the IMO calendar without asserting an unverified reuse licence.

IMO 2027 calendar

NASA GSFC Eclipse Catalog

Eclipse times and geometry2027 catalogue · 5 eclipses · retrieved 2026-09-30

The two solar and three lunar eclipses use the NASA Five Millennium Canon-derived 2027 catalogue for type, greatest eclipse, phases where published, duration, magnitude, Saros, and available central-path data. The July 18 event is retained as an exceptionally shallow, minor penumbral eclipse.

The app shows global event facts and clearly says when local eclipse visibility is not calculated. A Sun or Moon above the horizon does not by itself prove local eclipse visibility. Solar eye-safety guidance is shown with solar eclipses.

NASA GSFC 2027 eclipse catalog

NASA GSFC global eclipse maps

Event-page reference images5 locally stored maps · NASA GSFC / Fred Espenak

Five original NASA global maps are bundled alongside eclipse notes so event details do not depend on a third-party image request. Each figure links back to its NASA-hosted original. These maps show worldwide eclipse geometry, not visibility at the selected observer's location.

Credits are shown with each map and here. No separate redistribution licence is asserted for these source files.

NASA 2027 eclipse illustrations

International Meteor Organization — 2026 Calendar

Previous annual peak context16 event notes cite the 2026 calendar

Selected recurring 2027 meteor showers link to the prior calendar-listed peak date from the IMO 2026 calendar. These are published predicted dates, not historical visual counts.

The IMO is linked as the source of the previous calendar date; no additional data licence is inferred.

IMO 2026 calendar

Wikipedia event reading

Optional background links16 links · not used to calculate event data

Selected event pages offer an optional Wikipedia overview. Asterisms uses the cited NASA, IMO, Astronomy Engine, and timeanddate records for event facts and calculations.

Wikipedia is secondary reading and is not an upstream data source for the calendar.

Wikipedia astronomy overview

timeanddate.com — Supermoon definition

Classification rule onlyInformal terminology · strict <360,000 km cutoff

Asterisms classifies a Super Full Moon only when the full Moon is less than 360,000 km from Earth's center. The label is informal and other publishers use different rules.

timeanddate.com supplies the product threshold only. It does not supply the Moon's position or distance used by Asterisms.

Source record

Astronomy Engine

Lunar, seasonal, planetary, and global eclipse calculationsCalculated during the reproducible 12-year data build and locally in the browser for observer visibility

Astronomy Engine calculates all four Moon phase instants, lunar apsides, seasons, Earth perihelion/aphelion, global eclipse peaks, selected conjunctions, oppositions, Mercury/Venus elongations, and apparent retrograde stations. The library model is limited to its supported ephemeris range; dates and methods are recorded on each event.

Astronomy Engine is runtime software under the MIT licence; it is not an ingested lunar-position data file.

Astronomy Engine project

NOAA Space Weather Prediction Center

Live planetary Kp forecasts, alerts, and optional aurora gridFetched through the same-origin API; refreshed on a ten-minute cache

NOAA alert products and planetary Kp forecasts supply recent space-weather entries. The global OVATION grid is only requested when the observer asks for an aurora check; probability lookup is done on the device. Precise observer coordinates are never sent to NOAA.

This notice records the public feed and transformations used; it does not infer a separate reuse licence for the NOAA data products. Forecast probability does not guarantee a visible aurora.

NOAA SWPC

NASA CCMC DONKI

Recent solar flares, CMEs, and geomagnetic storm recordsShort-range live records only; unavailable feeds degrade without blocking the calendar

The application uses the current CCMC DONKI API base for a recent lookback window. Asterisms adapts records into its own event schema and does not manufacture long-range space-weather dates.

No separate data redistribution licence is inferred. The observer's location is not sent to NASA.

NASA CCMC DONKI

OpenNGC and SIMBAD deep-sky snapshot

Messier catalogue identity and ICRS positionCurated local catalogue snapshot; seasonal dates derived by Asterisms

The existing fixed-object catalogue supplies object names, Messier designations, and coordinates. Asterisms estimates the annual season when each selected object is near midnight culmination; the observer's altitude is calculated locally. This does not copy another publisher's event dates or descriptions.

The source catalogue credits and its source-specific terms are documented in their catalogue records and the deep-sky source sections above.

OpenNGC catalogue

In-The-Sky.org · Dominic Ford

Coverage reference onlyEvent taxonomy and completeness cross-check

The rich event calendar helped Asterisms decide which classes to cover. Asterisms uses cited scientific data sources for event facts and does not reproduce In-The-Sky calendar rows, event prose, diagrams, or database exports. This is an attribution of inspiration, not an endorsement.

Used as a reference, not as an event-data source. No licence or endorsement is implied.

In-The-Sky.org

Calendar data snapshot 2026-09-30; generated 2026-09-30T12:20:43.056Z. Source retrieval dates, event-specific source records, and coverage window are shown on the calendar and event detail pages.

12 / 14

Licences & attribution

Upstream materials retain their own terms. The mixed catalogue is not assigned one blanket licence by this page.

CC BY-SA 4.0: HYG and OpenNGC records, and the Stellarium Western text/data. Retain source credit, licence links, and modification notes; share-alike applies to adapted material as described by each source.

CC BY 4.0: ConstellationLines and GeoNames. Credit the source and identify changes.

ODbL 1.0: SIMBAD data. Attribute CDS/SIMBAD and cite Wenger et al. (2000); see the linked database and licence text.

MIT: Astronomy Engine software. Its code is used by the application at runtime.

Free Art License: Johan Meuris' Stellarium illustrations. Keep artist attribution and the licence.

Citation or licence not separately specified in our captured record: the seven Yale BSC fallback rows, extracted ATNF catalogue records, McGill magnetar data, NASA Exoplanet Archive table rows, and live JPL Horizons results each have source-specific citations/usage notes above. We preserve those credits and do not invent a blanket licence for them.

The Asterisms application uses AGPL-3.0-only. That application licence does not replace the upstream terms attached to third-party material.

Full third-party notices

The project notice file records source-specific copyright, licence links, attribution, and transformations. The linked snapshot manifest records exact retrieval URLs, timestamps, byte sizes, and SHA-256 checksums.

Open machine-readable snapshot manifest

13 / 14

Technical provenance

Snapshots, validation state, and items that were evaluated or suggested but are not current inputs.

The generated deep-sky snapshot was built Sep 29, 2026. It contains 453 fixed-object records; its recorded validation result is 0 warnings and 0 failures. Star/pattern validation reports 0 warnings and 0 hard failures. Detailed field mappings and transformations are maintained in docs/DATA_SOURCES.md; snapshot retrieval dates and checksums are available in the linked manifest; per-object source IDs are preserved with catalogue records.

Sources checked but not integrated as current data

These are not credited as production sources. The stated status avoids confusing a candidate service with data actually used by Asterisms.

Names, distances, and limits
  • HYG proper names are not systematically checked against the IAU Working Group on Star Names; Asterisms does not label every displayed name as IAU-approved.
  • Distances are shown only when a source supplies a measurement or a supported ephemeris calculates one. HYG's dist is in parsecs; unit conversion uses 1 pc = 3.26156 light-years. SIMBAD measured distances retain their method, quality, uncertainty, and reference when available. Sagittarius A* uses the separately cited GRAVITY Collaboration geometric distance for its Galactic-centre host system.
  • SIMBAD redshift is kept separate from distance. Redshift-only targets show a calculated lookback time, using numerical flat-ΛCDM integration and the cited Planck 2018 parameters; the redshift and assumed cosmology are both visible in the object details. Missing or unusable measurements are omitted rather than guessed.
  • The app does not ingest IAU boundary polygons. Its constellation lines are an attributed chart convention, not official IAU stick figures.

14 / 14

Cultural / literary work

A public-domain poem presented as a cultural reflection on humanity and cosmic scale, separate from Asterisms’ astronomy data.

Vastness

Poem · Alfred, Lord Tennyson1885

The underlying poem is public domain. Asterisms transcribes its text from the 1889 Macmillan printing of Demeter and Other Poems; the British Library catalogue records Tennyson’s “Vastness” in 1885.

The historical work’s public-domain status does not imply that a modern transcription, digitized scan, or hosting site shares that status. No blanket licence is asserted for those digital materials.

Source data and software retain their upstream attribution and terms. Source links above lead to the original catalogues, services, documentation, artist pages, and literary archives.

made by mukndd · © 2026