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
- 🧭 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, mag_labels=2.1)
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:
Core Dependencies
- matplotlib
- pandas
- numpy
- geopandas
- cartopy
- skyfield
- pydantic
- adjustText
Coming Soon
- ✴️ Custom markers
- 📋 List of objects plotted
- 📐 More Nebula outline levels
- ⚖️ Better auto font-size adjustment
- ☄️ Better label collision detection and handling
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.9.1.tar.gz
(34.5 MB
view hashes)
Built Distribution
Close
Hashes for starplot-0.9.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab38c0169e0188230112de1d71bfeea27196efd13280ea61e19df1bcac72292c |
|
MD5 | 186059da2860bb3426666f1f7b8bc025 |
|
BLAKE2b-256 | 01be5acae8e5c079e856ff7db975e633739231d3ef8f3a1d6885a24976fd3e57 |