Star charts and maps
Project description
Starplot
Starplot is a Python library for creating star charts and maps.
- ⭐ Zenith Plots - showing the stars from a specific time/location
- 🗺️ Map Plots - including North/South polar and Mercator projections
- 🔭 Optic Plots - simulates what you'll see through an optic (e.g. binoculars, telescope) from a time/location
- 🪐 Planets and Deep Sky Objects (DSOs)
- 🎨 Custom Styles - for all objects
- 📥 Export - png, svg, jpeg
- 🧭 Label Collision Avoidance
Examples
Zenith plot of the stars from a specific time/location:
Map around the constellation Orion:
Optic plot of The Pleiades through a refractor as seen from a specific time/location:
Basic Usage
To create a star chart for tonight's sky as seen from Palomar Mountain in California:
from datetime import datetime
from pytz import timezone
import starplot as sp
tz = timezone("America/Los_Angeles")
p = sp.MapPlot(
projection=sp.Projection.ZENITH,
lat=33.363484,
lon=-116.836394,
dt=datetime.now(tz).replace(hour=22),
style=sp.styles.PlotStyle().extend(
sp.styles.extensions.BLUE_MEDIUM,
sp.styles.extensions.ZENITH,
),
resolution=2000,
)
p.constellations()
p.stars(mag=4.6)
p.export("starchart.png")
Documentation
Demo
For a demo of Starplot's zenith plots, check out:
Sky Atlas - Star Chart Creator
Discord
Chat with other starplotters on our Discord server:
Contributing
Contributing to Starplot is welcome and very much appreciated! Please see here for details.
Core Dependencies
- matplotlib
- pandas
- numpy
- geopandas
- cartopy
- skyfield
- pydantic
- adjustText
Coming Soon
- 🌑 Planet moons
- ✴️ Custom markers
- 🚀 Plotting Optimizations
- 📐 More Nebula outline levels
- ⚖️ Better auto font-size adjustment
See more details on the Public Roadmap
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
starplot-0.11.1.tar.gz
(65.2 MB
view hashes)
Built Distribution
Close
Hashes for starplot-0.11.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5f5bdd848debaa57139b52a6535033e0131d52d95c8eb28ae4235a10f3c0f154 |
|
MD5 | a6eab5692088741bcc47d0c7e96da62f |
|
BLAKE2b-256 | 971e04371bb32f83a932d53510cb38b9043ae28bf4b203183798e28b952fdca9 |