celestial_data/README.Rmd

---
output: github_document
bibliography: references.bib
link-citations: yes
nocite: '@*'
editor_options: 
  markdown: 
    wrap: 80
---

# Celestial Data

[![DOI](https://img.shields.io/badge/DOI-10.5281/zenodo.7561601-blue)](https://doi.org/10.5281/zenodo.7561601)
![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/dieghernan/celestial_data)

This repository contains several datasets in GeoJSON and GeoPackage format of
celestial objects as of J2000 epoch.

The original files were provided on the [d3-celestial
plugin](https://github.com/ofrohn/d3-celestial/) [@frohn2015] under [BSD
3-Clause](https://opensource.org/licenses/BSD-3-Clause). The datasets on this
repository consists on the same data provided on [d3-celestial
plugin](https://github.com/ofrohn/d3-celestial/) processed with the **R**
package **sf** [@pebesma2018] to ensure its validity:

-   The spatial data objects are bounded to $[-180, -90, 180, 90]$.

-   Date is provided on WGS84 - World Geodetic System 1984
    ([EPSG:4326](https://epsg.io/4326)).

-   All geometries valid as per
    [ST_IsValid](https://postgis.net/docs/ST_IsValid.html) (GEOS **3.9.3**).

## Distribution

The data can be accessed from several API endpoints:

``` html

<!-- From GitHub -->
https://raw.githubusercontent.com/dieghernan/celestial_data/main/data/mw.min.geojson

<!-- From the Website -->
https://dieghernan.github.io/celestial_data/data/mw.min.geojson

<!-- From jsDelivr -->
https://cdn.jsdelivr.net/gh/dieghernan/celestial_data@main/data/mw.min.geojson
```

## Citation

Please cite these datasets as:

Frohn O, Hernangómez D (2023). "Celestial Data." <doi:10.5281/zenodo.7561601>
<https://doi.org/10.5281/zenodo.7561601>,
<https://dieghernan.github.io/celestial_data/>.

A BibTeX entry:

``` bibtex

@misc{frohnhernangomez:2023,
    title        = {Celestial Data},
    author       = {Olaf Frohn and Diego Hernangómez},
    year         = 2023,
    doi          = {10.5281/zenodo.7561601},
    url          = {https://dieghernan.github.io/celestial_data/},
}

```

## Data

Data is provided in GeoJSON (`*.geojson`) and GeoPackage (`*.gpkg`) format.
Additionally, for GeoJSON formats a minified version (`*.min.geojson`) is also
provided.

The data source can be found on
<https://github.com/dieghernan/celestial_data/tree/main/data>.

<details>

<summary>List of files provided</summary>

-   `asterisms.geojson`
-   `asterisms.gpkg`
-   `asterisms.min.geojson`
-   `constellations.borders.cn.geojson`
-   `constellations.borders.cn.gpkg`
-   `constellations.borders.cn.min.geojson`
-   `constellations.borders.geojson`
-   `constellations.borders.gpkg`
-   `constellations.borders.min.geojson`
-   `constellations.bounds.cn.geojson`
-   `constellations.bounds.cn.gpkg`
-   `constellations.bounds.cn.min.geojson`
-   `constellations.bounds.geojson`
-   `constellations.bounds.gpkg`
-   `constellations.bounds.min.geojson`
-   `constellations.cn.csv`
-   `constellations.cn.geojson`
-   `constellations.cn.gpkg`
-   `constellations.cn.min.geojson`
-   `constellations.csv`
-   `constellations.geojson`
-   `constellations.gpkg`
-   `constellations.lines.cn.geojson`
-   `constellations.lines.cn.gpkg`
-   `constellations.lines.cn.min.geojson`
-   `constellations.lines.geojson`
-   `constellations.lines.gpkg`
-   `constellations.lines.min.geojson`
-   `constellations.min.geojson`
-   `dsonames.cn.csv`
-   `dsonames.csv`
-   `dsos.14.geojson`
-   `dsos.14.gpkg`
-   `dsos.14.min.geojson`
-   `dsos.20.geojson`
-   `dsos.20.gpkg`
-   `dsos.20.min.geojson`
-   `dsos.6.geojson`
-   `dsos.6.gpkg`
-   `dsos.6.min.geojson`
-   `dsos.bright.geojson`
-   `dsos.bright.gpkg`
-   `dsos.bright.min.geojson`
-   `lg.geojson`
-   `lg.gpkg`
-   `lg.min.geojson`
-   `messier.geojson`
-   `messier.gpkg`
-   `messier.min.geojson`
-   `mw.geojson`
-   `mw.gpkg`
-   `mw.min.geojson`
-   `starnames.cn.csv`
-   `starnames.csv`
-   `stars.14.geojson`
-   `stars.14.gpkg`
-   `stars.14.min.geojson`
-   `stars.6.geojson`
-   `stars.6.gpkg`
-   `stars.6.min.geojson`
-   `stars.8.geojson`
-   `stars.8.gpkg`
-   `stars.8.min.geojson`

</details>

See additional details on <https://dieghernan.github.io/celestial_data/data>

## Original data sources

For completion, we add the original data sources cited by @frohn2015:

-   `asterisms.*`:

    -   [Saguaro Astronomy Club
        Asterisms](http://saguaroastro.org/sac-downloads/)

-   `constellations.*` and `constellations.lines.*`:

    -   [IAU Constellation
        page](http://www.iau.org/public/themes/constellations/), name positions
        and some line modifications by Olaf Frohn, , names in other languages
        from
        [Wikipedia](https://wiki2.org/en/88_modern_constellations_in_different_languages)

-   `constellations.bounds.*`:

    -   Davenhall, A. C., and S. K. Leggett. 1989. "Catalogue of Constellation
        Boundary Data." <http://vizier.cfa.harvard.edu/viz-bin/Cat?VI/49>.

-   Traditional Chinese Constellations & Stars: `constellations.cn.*`,
    `constellations.bounds.cn.*`, `constellations.lines.cn.*`, `starnames.cn.*`:

    -   [Stellarium skycultures
        data](https://github.com/Stellarium/stellarium/tree/master/skycultures/chinese)

-   `dsos.6.*`, `dsos.8.^*`, `dsos.14.*`:

    -   [Saguaro Astronomy Club Database version
        8.1](http://www.saguaroastro.org/sac-downloads/)

-   `dsos.bright.*`

    -   Frohn, Olaf. 2015. "d3-celestial."
        <https://github.com/ofrohn/d3-celestial/>.

-   `messier.*` Messier objects:

    -   [Messier Objects with Data](http://messier.seds.org/data.html),
        H.Frommert/seds.org

-   `lg.*` Local group and Milky Way halo:

    -   Frohn, Olaf. 2015. "d3-celestial."
        <https://github.com/ofrohn/d3-celestial/>, from different sources: see
        [blog](http://armchairastronautics.blogspot.com/p/milky-way-halo.html),
        [pages](http://armchairastronautics.blogspot.com/p/local-group.html) for
        complete list.

-   `stars.6.*`, `stars.8.^*`, `stars.14.*`:

    -   Anderson, E., and Ch. Francis. 2012. "XHIP: An Extended Hipparcos
        Compilation." *Astronomy Letters* 38 (5): 331--46.
        <https://doi.org/10.1134/S1063773712050015>.

-   `starnames.*` Star names and designations:

    -   Kostjuk, N. D. 2002. "VizieR Online Data Catalog:
        HD-DM-GC-HR-HIP-Bayer-Flamsteed Cross Index." *VizieR Online Data
        Catalog*, IV/27A.
        <https://ui.adsabs.harvard.edu/abs/2004yCat.4027....0K>.

    -   [Stellarium skycultures
        data](https://github.com/Stellarium/stellarium/tree/master/po/stellarium-skycultures)
        for star name translations

## References