steveberardi/starplot

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 172 Commits
.github		.github
data		data
docs		docs
examples		examples
hash_checks		hash_checks
scripts		scripts
src/starplot		src/starplot
tests		tests
tutorial		tutorial
.dockerignore		.dockerignore
.gitignore		.gitignore
CITATION.cff		CITATION.cff
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
mkdocs.yml		mkdocs.yml
pyproject.toml		pyproject.toml
requirements-dev.txt		requirements-dev.txt
requirements.txt		requirements.txt

Repository files navigation

Starplot

Python PyPI License GitHub Workflow Status

Starplot is a Python library for creating star charts and maps of the sky

🗺️ Maps - including 10+ customizable projections
⭐ Zenith Charts - shows the entire sky at a specific time and place
🌃 Horizon Charts - shows the horizon at a specific time and place
🔭 Optic Simulations - shows what you'll see through an optic (e.g. telescope) at a specific time and place
🪐 Planets and Deep Sky Objects (DSOs) - with support for plotting their true extent
☄️ Comets and Satellites - easy trajectory plotting
🎨 Custom Styles - for all objects and with 8+ built-in themes
📥 Export - png, svg, jpeg
🚀 Data Backend - powered by DuckDB + Ibis for fast object lookup
📓 Custom Data Catalogs - with helpers for building and optimizing
🧭 Label Collision Avoidance - ensuring all labels are readable
🌐 Localization - label translations for Chinese, French, Lithuanian, Persian, and Spanish

Examples

Zenith chart of the stars from a specific time/location: starchart-blue

Map around the constellation Orion: map-orion

The Pleiades star cluster, as seen through a refractor telescope from a specific time and location: optic-pleiades

Basic Usage

To create a star chart for tonight's sky as seen from Palomar Mountain in California:

from datetime import datetime
from zoneinfo import ZoneInfo
from starplot import ZenithPlot, Observer, styles, _
tz = ZoneInfo("America/Los_Angeles")
dt = datetime.now(tz).replace(hour=22)
observer = Observer(
 dt=dt,
 lat=33.363484,
 lon=-116.836394,
)
p = ZenithPlot(
 observer=observer,
 style=styles.PlotStyle().extend(
 styles.extensions.BLUE_MEDIUM,
 ),
 resolution=4096,
 autoscale=True,
)
p.constellations()
p.stars(where=[_.magnitude < 4.6])
p.constellation_labels()
p.horizon()
p.export("starchart.png")