Skip to content

Add Sky Culture Feature #150

@AndyTza

Description

@AndyTza

Is your feature request related to a problem? Please describe.
Starplot currently only supports IAU-recognized constellations and names in its database. As a user, I want to create constellation maps that reflect the names and line patterns from other parts of the world, such as those used in Hawai'i. The current API does not easily support the integration of custom constellation systems.

Describe the solution you'd like

  1. Add a SkyCulture parameter to constellation methods. Implement a built-in sky culture feature that allows users to specify different cultural constellation systems. For example:
p = MapPlot(
    projection=Projection.ZENITH,
    lat=15.153414,
    lon=-116.83123,
)
p.constellations(SkyCulture='Hawaii')
  1. Add a tutorial explaining how users can customize and add their own constellation systems, including documentation, data format requirements and file structure, and integrating with the current API.

Describe alternatives you've considered
I tried adding a few new stars to src/starplot/data/constellations.py, constellation_stars.py, and constellation_lines.py, but I couldn't get it to work.

Additional context

This feature would be awesome and would significantly expand Starplot's accessibility by supporting multiple astronomical naming systems. I think the main challenge lies in identifying reliable data sources for star names, constellation boundaries, and line patterns across different regions. Stellarium currently has a nice Sky Culture feature (see screenshot), but I wonder if this could be a starting point to scrape all the constellation names, stars, and constellation lines.

Image

Sub-issues

Metadata

Metadata

Assignees

No one assigned

    Labels

    ⭐ on roadmapThis issue is on the roadmap for a future version😃 good first issueGood issue for new contributors because its easy to fix

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions