# <img src="https://raw.githubusercontent.com/steveberardi/starplot/main/docs/images/favicon.svg" width="48" style="vertical-align:middle"> Starplot
**Starplot** is a Python library for creating star charts and maps of the sky.
- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
- 🗺️ **Map Plots** - including many map projections
- 🌃 **Horizon Plots** - shows the horizon at a specific time and place
- 🔭 **Optic Plots** - shows what you'll see through an optic (e.g. telescope) at a specific time and place
- 🪐 **Planets and Deep Sky Objects (DSOs)** - more than 14,000 objects built-in
- 🎨 **Custom Styles** - for all objects
- 📥 **Export** - png, svg, jpeg
- 🚀 **Data Backend** - powered by DuckDB + Ibis for fast object lookup
- 🧭 **Label Collision Avoidance**
## Examples
*Zenith plot 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](https://en.wikipedia.org/wiki/Palomar_Mountain) in California:
```python
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,
),
resolution=4096,
autoscale=True,
)
p.constellations()
p.stars(where=[_.magnitude < 4.6])
p.constellation_labels()
p.export("starchart.png")
```
## Documentation
[https://starplot.dev](https://starplot.dev)
## Demo
For a demo of Starplot's zenith plots, check out:
[Sky Atlas - Star Chart Creator](https://skyatlas.app/star-charts/)
## Discord
Chat with other starplotters on our Discord server:
https://discord.gg/WewJJjshFu
## Contributing
Contributing to Starplot is welcome and very much appreciated! Please see [here](CONTRIBUTING.md) for details.
## Coming Soon
- 🧮 Coordinate system helpers
- 🌑 Planet moons
- ✴️ Custom markers
- ☄️ Comet model
- 😄 🔭 Clear skies
See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)
## License
[MIT License](https://github.com/steveberardi/starplot/blob/main/LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "starplot",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "astronomy, stars, charts, maps, constellations, sky, plotting",
"author": null,
"author_email": "Steve Berardi <hello@steveberardi.com>",
"download_url": "https://files.pythonhosted.org/packages/22/d2/f3900098a3dfa0efd9d313a2b751f8b711519083930ccd510276b1ab639d/starplot-0.15.5.tar.gz",
"platform": null,
"description": "# <img src=\"https://raw.githubusercontent.com/steveberardi/starplot/main/docs/images/favicon.svg\" width=\"48\" style=\"vertical-align:middle\"> Starplot\n\n\n\n\n\n**Starplot** is a Python library for creating star charts and maps of the sky.\n\n- \u2b50 **Zenith Plots** - shows the entire sky at a specific time and place\n- \ud83d\uddfa\ufe0f **Map Plots** - including many map projections\n- \ud83c\udf03 **Horizon Plots** - shows the horizon at a specific time and place\n- \ud83d\udd2d **Optic Plots** - shows what you'll see through an optic (e.g. telescope) at a specific time and place\n- \ud83e\ude90 **Planets and Deep Sky Objects (DSOs)** - more than 14,000 objects built-in\n- \ud83c\udfa8 **Custom Styles** - for all objects\n- \ud83d\udce5 **Export** - png, svg, jpeg\n- \ud83d\ude80 **Data Backend** - powered by DuckDB + Ibis for fast object lookup\n- \ud83e\udded **Label Collision Avoidance**\n\n## Examples\n*Zenith plot of the stars from a specific time/location:*\n\n\n*Map around the constellation Orion:*\n\n\n*The Pleiades star cluster, as seen through a refractor telescope from a specific time and location:*\n\n\n## Basic Usage\n\nTo create a star chart for tonight's sky as seen from [Palomar Mountain](https://en.wikipedia.org/wiki/Palomar_Mountain) in California:\n\n```python\nfrom datetime import datetime\nfrom pytz import timezone\nimport starplot as sp\n\ntz = timezone(\"America/Los_Angeles\")\n\np = sp.MapPlot(\n projection=sp.Projection.ZENITH,\n lat=33.363484,\n lon=-116.836394,\n dt=datetime.now(tz).replace(hour=22),\n style=sp.styles.PlotStyle().extend(\n sp.styles.extensions.BLUE_MEDIUM,\n ),\n resolution=4096,\n autoscale=True,\n)\np.constellations()\np.stars(where=[_.magnitude < 4.6])\np.constellation_labels()\np.export(\"starchart.png\")\n```\n\n## Documentation\n\n[https://starplot.dev](https://starplot.dev)\n\n\n## Demo\nFor a demo of Starplot's zenith plots, check out: \n\n[Sky Atlas - Star Chart Creator](https://skyatlas.app/star-charts/)\n\n## Discord\n\nChat with other starplotters on our Discord server:\n\nhttps://discord.gg/WewJJjshFu\n\n## Contributing\n\nContributing to Starplot is welcome and very much appreciated! Please see [here](CONTRIBUTING.md) for details.\n\n## Coming Soon\n- \ud83e\uddee Coordinate system helpers\n- \ud83c\udf11 Planet moons\n- \u2734\ufe0f Custom markers\n- \u2604\ufe0f Comet model\n- \ud83d\ude04 \ud83d\udd2d Clear skies\n\nSee more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)\n\n## License\n[MIT License](https://github.com/steveberardi/starplot/blob/main/LICENSE)\n",
"bugtrack_url": null,
"license": null,
"summary": "Star charts and maps of the sky",
"version": "0.15.5",
"project_urls": {
"Documentation": "https://starplot.dev",
"Home": "https://starplot.dev",
"Source": "https://github.com/steveberardi/starplot"
},
"split_keywords": [
"astronomy",
" stars",
" charts",
" maps",
" constellations",
" sky",
" plotting"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "57b02846ab9eaccb032345182d4d98b5b88f8addc9b7ec14c97a4c102bedec31",
"md5": "2ac3c5ea1de69935e9db371b72b75008",
"sha256": "427bf7f8a815373f67827825cca3eb4a4f9f76fb249bec0469b2bd46eaaf31f4"
},
"downloads": -1,
"filename": "starplot-0.15.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "2ac3c5ea1de69935e9db371b72b75008",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 40285584,
"upload_time": "2025-02-09T22:02:33",
"upload_time_iso_8601": "2025-02-09T22:02:33.937307Z",
"url": "https://files.pythonhosted.org/packages/57/b0/2846ab9eaccb032345182d4d98b5b88f8addc9b7ec14c97a4c102bedec31/starplot-0.15.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "22d2f3900098a3dfa0efd9d313a2b751f8b711519083930ccd510276b1ab639d",
"md5": "068404cce37cdba65500038b7b13f9e4",
"sha256": "2a2b844f134cd75d140244bde126d5c7c40c27ae622d5cbddf54d0687de4eb70"
},
"downloads": -1,
"filename": "starplot-0.15.5.tar.gz",
"has_sig": false,
"md5_digest": "068404cce37cdba65500038b7b13f9e4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 43413674,
"upload_time": "2025-02-09T22:02:40",
"upload_time_iso_8601": "2025-02-09T22:02:40.415658Z",
"url": "https://files.pythonhosted.org/packages/22/d2/f3900098a3dfa0efd9d313a2b751f8b711519083930ccd510276b1ab639d/starplot-0.15.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-09 22:02:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "steveberardi",
"github_project": "starplot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "matplotlib",
"specs": [
[
"==",
"3.10.0"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"2.2.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.3"
]
]
},
{
"name": "pydantic",
"specs": [
[
"==",
"2.10.6"
]
]
},
{
"name": "shapely",
"specs": [
[
"==",
"2.0.7"
]
]
},
{
"name": "skyfield",
"specs": [
[
"==",
"1.48"
]
]
},
{
"name": "cartopy",
"specs": [
[
"==",
"0.22.0"
]
]
},
{
"name": "geopandas",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"11.0.0"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.1"
]
]
},
{
"name": "pyarrow",
"specs": [
[
"==",
"17.0.0"
]
]
},
{
"name": "pyogrio",
"specs": [
[
"==",
"0.10.0"
]
]
},
{
"name": "rtree",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "duckdb",
"specs": [
[
"==",
"1.1.3"
]
]
},
{
"name": "ibis-framework",
"specs": [
[
"==",
"10.0.0"
]
]
}
],
"lcname": "starplot"
}
JSON
