starplot 0.20.5__py3-none-any.whl

starplot-0.20.5.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: starplot
+Version: 0.20.5
+Summary: Star charts and maps of the sky
+Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
+Author-email: Steve Berardi <hello@steveberardi.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: Matplotlib
+License-File: LICENSE
+Requires-Dist: matplotlib <= 3.10.9
+Requires-Dist: numpy >= 1.26.2
+Requires-Dist: pandas <= 2.2.3
+Requires-Dist: pydantic >= 2.10.6
+Requires-Dist: shapely >= 2.0.1
+Requires-Dist: skyfield >= 1.41
+Requires-Dist: cartopy >= 0.21.1
+Requires-Dist: geopandas >= 1.0.1
+Requires-Dist: pillow >= 10.0.0
+Requires-Dist: PyYAML >= 6.0.1
+Requires-Dist: pyarrow >= 14.0.2
+Requires-Dist: pyogrio >= 0.10.0
+Requires-Dist: rtree >= 1.2.0
+Requires-Dist: requests >= 2.31.0
+Requires-Dist: duckdb >= 1.4.4
+Requires-Dist: sqlglot >= 28.9.0
+Requires-Dist: ibis-framework[duckdb, geospatial] >= 11
+Requires-Dist: astropy-healpix >= 1.1.2
+Project-URL: Documentation, https://starplot.dev
+Project-URL: Home, https://starplot.dev
+Project-URL: Source, https://github.com/steveberardi/starplot
+
+# <img src="https://raw.githubusercontent.com/steveberardi/starplot/main/docs/images/starplot-header.svg" width="360" alt="Starplot">
+![Python](https://img.shields.io/pypi/pyversions/starplot?style=for-the-badge&color=6388b0)
+![PyPI](https://img.shields.io/pypi/v/starplot?style=for-the-badge&color=57a8a8)
+![License](https://img.shields.io/github/license/steveberardi/starplot?style=for-the-badge&color=8b63b0)
+![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/steveberardi/starplot/test.yml?style=for-the-badge&color=88b063)
+
+**Starplot** is a Python library for creating star charts and maps of the sky
+
+- 🗺️ **Maps** - including 10+ customizable projections
+- ⭐ **Zenith Charts** - shows the entire sky at a specific time and place
+- 🌅 **Horizon Charts** - shows the horizon at a specific time and place
+- 🔭 **Optic Simulations** - shows what you'll see through an optic (e.g. telescope) at a specific time and place
+- 🌌 **Galactic Charts** - shows a Mollweide projection in galactic coordinates
+- 🪐 **Planets and Deep Sky Objects (DSOs)** - with support for plotting their true extent
+- ☄️ **Comets and Satellites** - easy trajectory plotting
+- 🎨 **Custom Styles** - for all objects and with 8+ built-in themes
+- 📥 **Export** - png, svg, jpeg
+- 🚀 **Data Backend** - powered by DuckDB + Ibis for fast object lookup
+- 📓 **Custom Data Catalogs** - with helpers for building and optimizing
+- 🧭 **Label Collision Avoidance** - ensuring all labels are readable
+- 🌐 **Localization** - label translations for Chinese, French, Italian, Lithuanian, Persian, and Spanish
+
+## Examples
+*Zenith chart of the stars from a specific time/location:*
+![starchart-blue](https://starplot.dev/images/examples/star_chart_basic.png)
+
+*Map around the constellation Orion:*
+![map-orion](https://starplot.dev/images/examples/map_orion.png)
+
+*The Pleiades star cluster, as seen through a refractor telescope from a specific time and location:*
+![optic-pleiades](https://starplot.dev/images/examples/optic_m45.png)
+
+## 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 zoneinfo import ZoneInfo
+
+from starplot import ZenithPlot, Observer, styles, _
+
+tz = ZoneInfo("America/Los_Angeles")
+dt = datetime.now(tz).replace(hour=22)
+
+observer = Observer(
+    dt=dt,
+    lat=33.363484,
+    lon=-116.836394,
+)
+
+p = ZenithPlot(
+    observer=observer,
+    style=styles.PlotStyle().extend(
+        styles.extensions.BLUE_MEDIUM,
+    ),
+    resolution=4096,
+    autoscale=True,
+)
+p.constellations()
+p.stars(where=[_.magnitude < 4.6])
+p.constellation_labels()
+p.horizon()
+p.export("starchart.png")
+```
+
+## Documentation
+
+[https://starplot.dev](https://starplot.dev)
+
+
+## Demo
+For a demo of Starplot's zenith charts, check out: 
+
+[Sky Atlas - Star Chart Creator](https://skyatlas.app/star-charts/)
+
+## Getting Help / Updates
+
+- Chat with other starplotters on our [Discord server](https://discord.gg/WewJJjshFu)
+- [Follow us on Bluesky](https://bsky.app/profile/starplot.dev)
+- [Join our newsletter](https://buttondown.com/starplot)
+- [See more examples at Starplotting.com](https://starplotting.com/)
+
+## 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
+- 😄 🔭 Clear skies
+
+See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)
+
+## Related Repositories
+
+- [starplot-bigsky](https://github.com/steveberardi/starplot-bigsky)
+- [starplot-constellations](https://github.com/steveberardi/starplot-constellations)
+- [starplot-ongc](https://github.com/steveberardi/starplot-ongc)
+- [starplot-hyg](https://github.com/steveberardi/starplot-hyg)
+- [starplot-gaia-dr3](https://github.com/steveberardi/starplot-gaia-dr3)
+- [starplot-hyperleda](https://github.com/steveberardi/starplot-hyperleda)
+- [starplot-milkyway](https://github.com/steveberardi/starplot-milkyway)
+
+## License
+[MIT License](https://github.com/steveberardi/starplot/blob/main/LICENSE)
+

starplot-0.20.5.dist-info/RECORD

@@ -0,0 +1,98 @@
+starplot/__init__.py,sha256=doZeDNu8BXsWo_Rkdufj2KtprSSbw5pxTEaDtujONGU,980
+starplot/callables.py,sha256=k8Ra0nmNfc8vjOpNPdQfAqpNaM2ajCPB3XkgzCqrcQ0,4039
+starplot/cli.py,sha256=lZaENH7x7r2lp6WzeiNKChO0pi0YObc9CarfznHa2AE,662
+starplot/config.py,sha256=U-I5ZjWHVJjsFqGeCpgK0ptRzwVJg1kLlzTR6O-lne0,2940
+starplot/coordinates.py,sha256=sWxiftpcN2QQkifoYuo6S7YCAovOTu4jMnl2cswW1lw,162
+starplot/geometry.py,sha256=sibHbi-SUTPYEBfQ-doLrcF-8WPGYVO6aysUDBxpGO4,8292
+starplot/mixins.py,sha256=XjjxYX65mukzmzafgxXiWFoXBt-trhrDzn5mp7d88IY,10440
+starplot/profile.py,sha256=V5LOZFDdnGo-P8ikWvV3jmUVJIKO3gd4H2bjBlk7aUM,300
+starplot/projections.py,sha256=ShU-l0YtlE3WcOue9dQYO6kpPiFQ2JUi_R4B8FdYlvE,5218
+starplot/utils.py,sha256=esuSZ9b7fGyAH79U0D9Ux72bIywdwSopw2gnzrPvZYU,3693
+starplot/warnings.py,sha256=uKvGSAVpWKZIHMKxxegO5owFJnKvBYLyq3pJatD0qQ4,594
+starplot/data/__init__.py,sha256=GBJw579v-5ZNsKk1RxE7Fdnjf4hDIW2gevQJAZ7-6b0,550
+starplot/data/catalogs.py,sha256=Izf2XjKDIcLA-sM9TEL8Csg5CSizYxmvhHq_UXSHMt0,12010
+starplot/data/constellations.py,sha256=jIAB7zBwc5d73RuIcwi4yd2_5TxM3gGfsVp8-kykpsk,2008
+starplot/data/db.py,sha256=ObIwSIOupy4d18Lmoky8Hz6OtTI2LddemdtoFY2ZZaY,875
+starplot/data/dsos.py,sha256=8rp_Heme3bYFFWUuAPlWMHlfzsMsZ2W_Lq2jwgSWlQ8,2377
+starplot/data/ecliptic.py,sha256=Qre9YdFbTC9mAx-vd2C0Ou4CsnRehIScnTpmEUDDYcM,4638
+starplot/data/stars.py,sha256=C8U29m6pW8L6jwyFqDU1mQgfzeBZjme7OrgYCQ-8ghU,2390
+starplot/data/translations.py,sha256=jLrkpLrtPZbPowPmOTA05U5NSrPqGORAxvnVU33Os04,13575
+starplot/data/utils.py,sha256=W2Su63PA_tKbpCkKAAdjwhBpgiq6hYkCEAVz4cC1y7k,978
+starplot/data/library/constellation_names.parquet,sha256=p4Zbb2t3Swqs4OyReeSu-eQqujrz2fAhDGRtWkb1zJE,14950
+starplot/data/library/dso_names.parquet,sha256=X14OPQ0X8XIIgMeNYDmmQWlidtEoDtDqus1m4MPgMio,27332
+starplot/data/library/readme.md,sha256=sJyJ1EkC5lcwLbvhTF96XlVa8tC6HyuXWWRooMyRNLA,68
+starplot/data/library/star_designations.parquet,sha256=R30IDBcaT9PjmyhcyOZmiZx-BcHU_wM7IZJR6CayPbI,75481
+starplot/models/__init__.py,sha256=jypNZ_41BtVbV4xS7QDAwwey7rTxUTXNKuXIAV3HhE8,468
+starplot/models/base.py,sha256=wIoxP96wPc8glIFUgFhSeCtzU_pz597vWBdveqSoBNY,2175
+starplot/models/comet.py,sha256=4cJuLhB2obT9Dpw3iel0dSCD8GrGWZAx-3yiUyqT7YI,10026
+starplot/models/constellation.py,sha256=aDoh1wWB4za92gHSCwxl86aVhOtXZdcrYblVSAVhrog,4908
+starplot/models/dso.py,sha256=Iehc1VGkpQsZDEVIft7KZyjXUevesg3FgBUsWU_Gc3E,9019
+starplot/models/milky_way.py,sha256=8ll-JV_PH9J0xOUL7R-t3vdcHTrynU0fuZD-R8LiVWI,889
+starplot/models/moon.py,sha256=CVQkaekpWGlphBP17uVd_0qgcANNgQYAhP6cnqXTDpw,3983
+starplot/models/objects.py,sha256=BXwUMT-zPiOYBWYV7L-TRDfPo6lsx_AIk3yxJ3qi0ck,683
+starplot/models/observer.py,sha256=6Fx-rk2YUfxovUSyV5Et5SxGT5F7joNwc4S-RrcPmik,3696
+starplot/models/optics.py,sha256=6quf3Cxga5pjTunchtGe2OKCU6hgsm5yg7NfYWIfoNA,9314
+starplot/models/planet.py,sha256=Ccwx1GGK83YAY-jaiR-3t1WBZKpEZVerl00wpUwA-Go,3784
+starplot/models/satellite.py,sha256=8r0uMpff24Hpx0aRhhua19fvxBwdwPNVjIPiHsM_Ma4,4092
+starplot/models/star.py,sha256=Y1DzS7rIosljZNCuw8QnSA6IUdm-zN3PupE83cmQHBM,7181
+starplot/models/sun.py,sha256=rA5PEkw4fU3PvHq3ep4IBBCxSjMoN2NQv0ZlEiaUGNs,1794
+starplot/plots/__init__.py,sha256=TRAL_-nid3l0DFwDySfSyvU7FsRxXjXkHv8pQgJWgX0,174
+starplot/plots/base.py,sha256=ug4ykigLbCDZFtutovu3GKxykWqiiI9tQGgxV7ygy3s,35863
+starplot/plots/galaxy.py,sha256=wT5Oe4mytHe_nkA_YE8E3U03H2WLekG8ziZX7yUgCYI,13835
+starplot/plots/horizon.py,sha256=fcKKDCICrqQ_78R8HsuRi087-g5sOZFbqq8JDkLdb34,18662
+starplot/plots/map.py,sha256=GAxHqpMn06RRsCfySs9hEQFpM2Ibb9cjtlLzyZSSuqw,19561
+starplot/plots/optic.py,sha256=3PWhvQ9BB787T-cUpyA61JCZLIevZd13Gryhew1ohCg,17662
+starplot/plots/zenith.py,sha256=pt67KoR6RYHEViIAwTrbZJ3Txgr0Sw1i0PaE-3tlDg8,8165
+starplot/plotters/__init__.py,sha256=RzsH2t4PbdsEMBjcgIhQ_ng7fIgjW4CobQcwtGo9oTc,315
+starplot/plotters/arrow.py,sha256=hI2-WGSWjMwK5rax4cMDsjorX2ILylnn1RbWNHbPq5g,6583
+starplot/plotters/constellations.py,sha256=mIqb8XvEskIBonPOs7rd-LhO7S-DzdT4Im98qSHwA4Y,11331
+starplot/plotters/debug.py,sha256=oxD3kceTx2i-EfCshqEETM2tQCFS_QKQcmgAoWW5FTA,688
+starplot/plotters/dsos.py,sha256=sgKOiFHmbkTQ77Ko77APGwINXG3R_Sfx8a2Q_MW0BuQ,11039
+starplot/plotters/experimental.py,sha256=wDNhPUbmK61xkZvTiwTh3ChpCkwzQmUQ0cY4DqDFH7U,15942
+starplot/plotters/gradients.py,sha256=ZonNeIEmbcZZWjFtlPahGtGCgeTCeimp84PZnqj8dXY,5781
+starplot/plotters/legend.py,sha256=PwqhSQkYsxPNLMabL0Ox5eo0F3jMS4Ekhm2aHaHS3W4,8761
+starplot/plotters/milkyway.py,sha256=U5uRE4teoWk2v65RC2SkMKPX1LurR6zw7vzLK5mVxJE,1605
+starplot/plotters/stars.py,sha256=_PWbEvRZh0_8gGB9VoHbuhlPsZmXAstk8WzU5uqDdQU,11842
+starplot/plotters/text.py,sha256=DLy8A0N7XOhdtrrLRuFshIF7WRnBa_beonNZpjwbqVM,26281
+starplot/styles/__init__.py,sha256=HmIDU0cFu4ar8zKet_FEJoNdButQHJMprHnL_4JE2Mc,123
+starplot/styles/base.py,sha256=d3UZIpPStZmj1OwxuA8PuUU8Y2_kImiZmFPJG91txf0,41639
+starplot/styles/extensions.py,sha256=qVNE9DaSvG8BPr6vPfT8v5vyZNBYB0AjkR-e9oPMk1I,2707
+starplot/styles/fonts.py,sha256=wC3cHuFkBUaZM5fKpT_ExV7anrRKMJX46mjEfcSRQMU,379
+starplot/styles/helpers.py,sha256=ZfjEQLCI51o07BWpy6X-AJ7Z3Y1VQRQrEKXd6sz4Xqg,3398
+starplot/styles/markers.py,sha256=gEkKBXP2wL3_GA2skIwg3TP86MnmZqDtbrL3OtEq1lk,9135
+starplot/styles/ext/antique.yml,sha256=hYlFTNHO94dxkaulzvs2fmPZeqKVNqRYbyeY7hsCxFU,3317
+starplot/styles/ext/blue_dark.yml,sha256=oLbXt02KHQV2_P1Yd4bNocKBJjxiimJ65GkGcECnjNU,3037
+starplot/styles/ext/blue_gold.yml,sha256=4e3-h36m2a1gTdqIrI7x8v35-4e1NOk5inMsKaPF_is,2736
+starplot/styles/ext/blue_light.yml,sha256=rrGn2no6Wbtyyt0R4fhrhOJG1L9PiSww5-wVQda6hjs,2122
+starplot/styles/ext/blue_medium.yml,sha256=PlJU0GrmIOXSMBNnpXwWC6q06DMvvoG70fHtTpABpos,2474
+starplot/styles/ext/blue_night.yml,sha256=Cy2tw3-jaD8me-5w2Kbb28LUFnpG9KPLBhdXOSBBg08,3387
+starplot/styles/ext/cb_wong.yml,sha256=AGPXaEgaiqcC-EEDo1iGsl2-knWEubPsmK1VZyfoZjM,2335
+starplot/styles/ext/color_print.yml,sha256=mWzBvA4dagGOvpqhM914zUEpfYZX6WrRHlk72nKyLOU,1808
+starplot/styles/ext/gradient_presets.yml,sha256=VIDwo1-y75AWcdI2UerzHsU9sqEH9kuAltsgvfZO8dw,3238
+starplot/styles/ext/grayscale.yml,sha256=t22oeFZMEomUC9k-JxXSCS4UGKqhhsq81XQt8q8kPcM,1303
+starplot/styles/ext/grayscale_dark.yml,sha256=x8qBtksvtFrNhRfCWjjlY2uE5WQwaJVH-A9113t10E8,2577
+starplot/styles/ext/map.yml,sha256=sN8evxMjmfCwS7zVoFxdrSqfROtO8I9BPc-rLkssb_o,140
+starplot/styles/ext/nord.yml,sha256=ZDJCG57Dd01OstCqI0RATqxjCYe1yvLONlTZh2_CXFk,2624
+starplot/styles/ext/optic.yml,sha256=ZF6YXjVXeSrptd9q8JQDP175GCLHOg6IYEncBmLhyx0,270
+starplot/styles/ext/publication.yml,sha256=nh8oV3CeeVhn0xzMgEiqKZh50dTgIoKiUAYoqVIkIoE,117
+starplot/styles/fonts-library/gfs-didot/DESCRIPTION.en_us.html,sha256=mqYfpdiHL5yrU74_8eBAq70K8JMSB71uqdKX74lQYiM,1160
+starplot/styles/fonts-library/gfs-didot/GFSDidot-Regular.ttf,sha256=T8eEq4JOiGbu74rVWXa5Pn4XD7G4I3_U-HgbW03Sl_k,191168
+starplot/styles/fonts-library/gfs-didot/METADATA.pb,sha256=ANrWV7hje3V4-YfQRowrh8Z6zGZHEracmrxzSrd0vtA,438
+starplot/styles/fonts-library/gfs-didot/OFL.txt,sha256=nhnA0ufnrcvp39B0njTdpB5-NW4PLMCC1h0vybbgzvc,4543
+starplot/styles/fonts-library/inter/Inter-Bold.ttf,sha256=DLG8EzU3LZ46DPb1MRx8zoevkNKnd_3uwYvmBaKnC8E,415072
+starplot/styles/fonts-library/inter/Inter-BoldItalic.ttf,sha256=XmBvgFpxQy1Idd59q3N7-d6hGHCQ8KUZDamxu6sJ9Xw,420068
+starplot/styles/fonts-library/inter/Inter-ExtraBold.ttf,sha256=PBNIe48uugp4ytTO_RknKw9OU9YcIj5rJm3fCzMunxw,416228
+starplot/styles/fonts-library/inter/Inter-ExtraLight.ttf,sha256=lE9lp8bNoTXDcFWenXNHv91FpXn-TdHvi6W8Z5vNlh0,409996
+starplot/styles/fonts-library/inter/Inter-ExtraLightItalic.ttf,sha256=u1SI3v0BjPbOqFtDGkCZHwq4k5w5Al6DXoCRYNzZEqY,415636
+starplot/styles/fonts-library/inter/Inter-Italic.ttf,sha256=0FTZmK4SvjOCCxAODtOSPVE_pcecbU58oZU6_rJi6ps,412848
+starplot/styles/fonts-library/inter/Inter-Light.ttf,sha256=GTbSTLD0znAG4Ixu9CQ9LkKntF8iSfj-VNkvdqMX39E,408364
+starplot/styles/fonts-library/inter/Inter-LightItalic.ttf,sha256=_jcUkmCCrFdkMn47Z65Sy28M9rjEIhwGSmys-CEHlBQ,415024
+starplot/styles/fonts-library/inter/Inter-Regular.ttf,sha256=ZPi-blXDfjLvA9qZcUvzqli48gmb_k91mnV447gpESM,407056
+starplot/styles/fonts-library/inter/Inter-SemiBold.ttf,sha256=DcmOiqWVhTlIgPJauJ5tkVrVE0Ui6WGwRspR-tOhglU,413976
+starplot/styles/fonts-library/inter/Inter-SemiBoldItalic.ttf,sha256=HhKJRT16iVz7c1adSFFjTIsOSdFQxN1S1Ev10gaQgnI,418520
+starplot/styles/fonts-library/inter/LICENSE.txt,sha256=JiSB6ERSGzJvXs0FPlm5jIstp4yO4b27boF0MF5Uk1o,4380
+starplot-0.20.5.dist-info/entry_points.txt,sha256=Sm6jC6h_RcaMGC8saLnYmT0SdhcF9_rMeQIiHneLHyc,46
+starplot-0.20.5.dist-info/licenses/LICENSE,sha256=jcjClHF4BQwhz-kDgia-KphO9Zxu0rCa2BbiA7j1jeU,1070
+starplot-0.20.5.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+starplot-0.20.5.dist-info/METADATA,sha256=ZpNQZindlJ6sTYIFQ7PurJd6KiHQeUPu13ih9j5uKkc,5636
+starplot-0.20.5.dist-info/RECORD,,

starplot-0.20.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.12.0
+Root-Is-Purelib: true
+Tag: py3-none-any

starplot-0.20.5.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+starplot=starplot.cli:main
+

starplot-0.20.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Steve Berardi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.