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
- 🌌 Galactic Charts - shows a Mollweide projection in galactic coordinates
- 🪐 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, Italian, Lithuanian, Persian, and Spanish
Examples
Zenith chart of the stars from a specific time/location:
Map around the constellation Orion:
The Pleiades star cluster, as seen through a refractor telescope from a specific time and location:
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")
Documentation
Demo
For a demo of Starplot's zenith charts, check out:
Sky Atlas - Star Chart Creator
Getting Help / Updates
- Chat with other starplotters on our Discord server
- Follow us on Bluesky
- Join our newsletter
- See more examples at Starplotting.com
Contributing
Contributing to Starplot is welcome and very much appreciated! Please see here for details.
Coming Soon
- 🧮 Coordinate system helpers
- 🌑 Planet moons
- ✴️ Custom markers
- 😄 🔭 Clear skies
See more details on the Public Roadmap
Related Repositories
- starplot-bigsky
- starplot-constellations
- starplot-ongc
- starplot-hyg
- starplot-gaia-dr3
- starplot-hyperleda
- starplot-milkyway
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file starplot-0.20.5.tar.gz.
File metadata
- Download URL: starplot-0.20.5.tar.gz
- Upload date:
- Size: 3.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.34.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8143d74d8482ad28670e497ea08ebb0e43ad51b0bdc461e532014668639e2553
|
|
| MD5 |
11afbe35976d8488f2ce067ced2f3171
|
|
| BLAKE2b-256 |
748add13d22bcfa92b943f376fac7c2b3fce7609aa4468bc76645cfcb37b9859
|
File details
Details for the file starplot-0.20.5-py3-none-any.whl.
File metadata
- Download URL: starplot-0.20.5-py3-none-any.whl
- Upload date:
- Size: 2.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.34.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e9814bfdc1a242ef44142227b56c24cfdc8771e5ec2e184cd44a7d5cd81b4a6
|
|
| MD5 |
b39e4601fa44118216aa4c0bcd72a727
|
|
| BLAKE2b-256 |
82b7d0e6fd4edeed11d43307e68fb7c4490a7dfb70006111509f98f18db09bee
|
