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 - SVG or PNG
- 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, Dutch, French, German, Italian, Lithuanian, Persian, and Spanish
Examples
Zenith chart of the stars from a specific time and place:
Map around the constellation Orion:
Horizon at a specific time and place:
The Pleiades star cluster, as seen through a refractor telescope from a specific time and place:
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,
)
p.constellations()
p.stars(where=[_.magnitude < 4.6])
p.constellation_labels()
p.horizon()
p.export("starchart.svg")
Documentation
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
Metadata
Release files for starplot 0.23.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| starplot-0.23.0.tar.gz | 1.7 MB | Without provenance | Details for starplot-0.23.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| starplot-0.23.0-py3-none-any.whl | Python 3 | none | any | Details for starplot-0.23.0-py3-none-any.whl |
Total release size: 1.9 MB
Release files / starplot-0.23.0.tar.gz
| Download URL | starplot-0.23.0.tar.gz |
|---|---|
| Size | 1.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8a389effdc72a6c6468d1c65cf6db249fb73a9846766b3c1cb6eeac9cc3642f2
|
|
BLAKE2b-256 checksum How to use checksums |
bb5b986fdc7116c430e4644c0e33116368ba7e1aeb3703dca0d31d682459c5f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.34.2
|
Release files / starplot-0.23.0-py3-none-any.whl
| Download URL | starplot-0.23.0-py3-none-any.whl |
|---|---|
| Size | 233.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a35297bba8b5ae3fd1fd93064a124674d746a6c2af93146e56635a89fb902d16
|
|
BLAKE2b-256 checksum How to use checksums |
58870ac368423e66cef68e446ed37bb8fba1e4682a5a369c032636f711dc65e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.34.2
|
Security for starplot 0.23.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.