# <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
- 🧭 **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(mag=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
- 🗄️ Data optimizations
- 🧮 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/e2/0e/951214466afb48651ef1a95423898b41be6650e1c38f0bd7e687afc74109/starplot-0.14.0.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- \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(mag=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- \ud83d\uddc4\ufe0f Data optimizations\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.14.0",
"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": "e0c0db5b5899a0ca5dc6c60ec9a5719f69848ed559bb9434b71e020c12d3e1f3",
"md5": "4f86c840c73b5e5692cd6e1bfb7a0450",
"sha256": "0394223c53a87764bf12a90c708a83ba9e032e7044f37d260cf319abb16ecbba"
},
"downloads": -1,
"filename": "starplot-0.14.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f86c840c73b5e5692cd6e1bfb7a0450",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 46335144,
"upload_time": "2024-12-31T23:33:32",
"upload_time_iso_8601": "2024-12-31T23:33:32.353782Z",
"url": "https://files.pythonhosted.org/packages/e0/c0/db5b5899a0ca5dc6c60ec9a5719f69848ed559bb9434b71e020c12d3e1f3/starplot-0.14.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e20e951214466afb48651ef1a95423898b41be6650e1c38f0bd7e687afc74109",
"md5": "67134e9f6d4ce4ab48d16716ae2862ea",
"sha256": "a262e95cdb5c3f1bcf1039f37c1bc180cabd34000e6883be7ec826fa8afd047e"
},
"downloads": -1,
"filename": "starplot-0.14.0.tar.gz",
"has_sig": false,
"md5_digest": "67134e9f6d4ce4ab48d16716ae2862ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 46738852,
"upload_time": "2024-12-31T23:33:41",
"upload_time_iso_8601": "2024-12-31T23:33:41.264052Z",
"url": "https://files.pythonhosted.org/packages/e2/0e/951214466afb48651ef1a95423898b41be6650e1c38f0bd7e687afc74109/starplot-0.14.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-31 23:33:41",
"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.9.2"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.0.3"
]
]
},
{
"name": "pydantic",
"specs": [
[
"==",
"2.0.3"
]
]
},
{
"name": "shapely",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "skyfield",
"specs": [
[
"==",
"1.48"
]
]
},
{
"name": "cartopy",
"specs": [
[
"==",
"0.22.0"
]
]
},
{
"name": "geopandas",
"specs": [
[
"==",
"0.14.4"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.0.0"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.1"
]
]
},
{
"name": "pyarrow",
"specs": [
[
"==",
"17.0.0"
]
]
},
{
"name": "fastparquet",
"specs": [
[
"==",
"2023.10.1"
]
]
},
{
"name": "pyogrio",
"specs": [
[
"==",
"0.9.0"
]
]
},
{
"name": "rtree",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
}
],
"lcname": "starplot"
}
JSON
