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, with M42 marked:
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.ZenithPlot(
lat=33.363484,
lon=-116.836394,
dt=datetime.now(tz).replace(hour=22),
limiting_magnitude=4.6,
resolution=2000,
)
p.export("starchart.png")
Documentation
Demo
For a demo of Starplot's zenith plots, check out:
Sky Atlas - Star Chart Creator
Core Dependencies
- matplotlib
- pandas
- numpy
- geopandas
- cartopy
- skyfield
- pydantic
- adjustText
Coming Soon
- ⚙️ Callables for star sizes/colors/alpha
- ✴️ Custom markers
- 📐 Nebula outlines
- 🌐 More map projection options
- ⚖️ 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.8.4.tar.gz
(37.3 MB
view hashes)
Built Distribution
Close
Hashes for starplot-0.8.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | db116272e606ddb7309ddccf39091bfe77c6519acc0104cd2df77c8102558f2b |
|
MD5 | fed2601e747e823fffd051f669d3a913 |
|
BLAKE2b-256 | 402201bc8bfc8fd263b037dae9e0c830dc30b120d4067bf2bcb0094401698b2b |