starplot 0.12.5__tar.gz → 0.14.0__tar.gz

{starplot-0.12.5 → starplot-0.14.0}/.github/workflows/test.yml

@@ -49,3 +49,10 @@ jobs:
     - uses: actions/checkout@v4
     - name: Run Tests - Python 3.12
       run: make test-3.12 CI=true
+  # Python 3.13 not supported yet, needs investigation!
+  # test-python-3-13:
+  #   runs-on: ubuntu-22.04
+  #   steps:
+  #   - uses: actions/checkout@v4
+  #   - name: Run Tests - Python 3.13
+  #     run: make test-3.13 CI=true

{starplot-0.12.5 → starplot-0.14.0}/.gitignore

@@ -20,6 +20,7 @@ hash_checks/results.html
 temp.py
 temp/
 raw/
+scripts/temp/
 
 # Documentation Generated Files
 examples/*.png

{starplot-0.12.5 → starplot-0.14.0}/Dockerfile

@@ -1,17 +1,11 @@
-ARG PYTHON_VERSION=3.11.7
+ARG PYTHON_VERSION=3.11.11
 FROM python:${PYTHON_VERSION}-bookworm AS base
 
 WORKDIR /starplot
 
+# Install required system libraries (GEOS + GDAL)
 RUN apt-get clean && apt-get update -y && apt-get install -y libgeos-dev libgdal-dev
 
-# Install fonts
-# not required, but make the maps look better (especially greek letters)
-RUN mkdir -p /usr/share/fonts/truetype
-RUN wget https://github.com/google/fonts/raw/main/ofl/gfsdidot/GFSDidot-Regular.ttf -P /tmp/fonts
-RUN install -m644 /tmp/fonts/*.ttf /usr/share/fonts/truetype/
-RUN fc-cache -f
-
 # ---------------------------------------------------------------------
 FROM base as dev
 

{starplot-0.12.5 → starplot-0.14.0}/Makefile

@@ -22,7 +22,7 @@ DOCKER_RUN_PYTHON_TEST=docker run --rm $(DR_ARGS) -v $(shell pwd):/starplot star
 export PYTHONPATH=./src/
 
 # ------------------------------------------------------------------
-build: PYTHON_VERSION=3.11.7
+build: PYTHON_VERSION=3.11.11
 build: DOCKER_BUILD_ARGS=-t starplot-dev
 build:
 	touch -a .env
@@ -82,26 +82,32 @@ version:
 # ------------------------------------------------------------------
 # Python version testing
 # ------------------------------------------------------------------
-test-3.9: PYTHON_VERSION=3.9.18
+test-3.9: PYTHON_VERSION=3.9.21
 test-3.9:
 	$(DOCKER_BUILD_PYTHON)
 	$(DOCKER_RUN_PYTHON_TEST)
 
-test-3.10: PYTHON_VERSION=3.10.13
+test-3.10: PYTHON_VERSION=3.10.16
 test-3.10:
 	$(DOCKER_BUILD_PYTHON)
 	$(DOCKER_RUN_PYTHON_TEST)
 
-test-3.11: PYTHON_VERSION=3.11.7
+test-3.11: PYTHON_VERSION=3.11.11
 test-3.11:
 	$(DOCKER_BUILD_PYTHON)
 	$(DOCKER_RUN_PYTHON_TEST)
 
-test-3.12: PYTHON_VERSION=3.12.1
+test-3.12: PYTHON_VERSION=3.12.8
 test-3.12:
 	$(DOCKER_BUILD_PYTHON)
 	$(DOCKER_RUN_PYTHON_TEST)
 
+# Python 3.13 not supported yet!
+test-3.13: PYTHON_VERSION=3.13.1
+test-3.13:
+	$(DOCKER_BUILD_PYTHON)
+	$(DOCKER_RUN_PYTHON_TEST)
+
 # ------------------------------------------------------------------
 # Docs
 docs-serve: DR_ARGS=-it -p 8000:8000
@@ -134,6 +140,9 @@ hip8:
 scripts:
 	$(DOCKER_RUN) "python ./scripts/$(SCRIPT).py"
 
+allsky:
+	$(DOCKER_RUN) "python ./scripts/temp/allsky.py"
+
 clean:
 	rm -rf __pycache__
 	rm -rf venv

{starplot-0.12.5 → starplot-0.14.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.3
 Name: starplot
-Version: 0.12.5
+Version: 0.14.0
 Summary: Star charts and maps of the sky
-Keywords: astronomy,stars,charts,maps,constellations
+Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: MIT License
@@ -17,7 +17,6 @@ Requires-Dist: pandas >= 1.4.0
 Requires-Dist: pydantic >= 2.0.3
 Requires-Dist: shapely >= 2.0.1
 Requires-Dist: skyfield >= 1.41
-Requires-Dist: adjustText >= 1.0
 Requires-Dist: cartopy >= 0.21.1
 Requires-Dist: geopandas >= 0.13.2
 Requires-Dist: pillow >= 10.0.0
@@ -39,10 +38,11 @@ Project-URL: Source, https://github.com/steveberardi/starplot
 
 **Starplot** is a Python library for creating star charts and maps of the sky.
 
-- ⭐ **Zenith Plots** - showing the stars from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 - 🗺️ **Map Plots** - including many map 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)**
+- 🌃 **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**
@@ -54,7 +54,7 @@ Project-URL: Source, https://github.com/steveberardi/starplot
 *Map around the constellation Orion:*
 ![map-orion](https://starplot.dev/images/examples/map_orion.png)
 
-*Optic plot of The Pleiades through a refractor as seen from a specific time/location:*
+*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
@@ -75,12 +75,13 @@ p = sp.MapPlot(
     dt=datetime.now(tz).replace(hour=22),
     style=sp.styles.PlotStyle().extend(
         sp.styles.extensions.BLUE_MEDIUM,
-        sp.styles.extensions.ZENITH,
     ),
-    resolution=2000,
+    resolution=4096,
+    autoscale=True,
 )
 p.constellations()
 p.stars(mag=4.6)
+p.constellation_labels()
 p.export("starchart.png")
 ```
 
@@ -105,12 +106,11 @@ https://discord.gg/WewJJjshFu
 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
-- 🚀 Plotting Optimizations
 - ☄️ Comet model
-- 🌄 Horizon plots
-- ⚖️ Better auto font-size adjustment
 - 😄 🔭 Clear skies
 
 See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)

{starplot-0.12.5 → starplot-0.14.0}/README.md

@@ -6,10 +6,11 @@
 
 **Starplot** is a Python library for creating star charts and maps of the sky.
 
-- ⭐ **Zenith Plots** - showing the stars from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 - 🗺️ **Map Plots** - including many map 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)**
+- 🌃 **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**
@@ -21,7 +22,7 @@
 *Map around the constellation Orion:*
 ![map-orion](https://starplot.dev/images/examples/map_orion.png)
 
-*Optic plot of The Pleiades through a refractor as seen from a specific time/location:*
+*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
@@ -42,12 +43,13 @@ p = sp.MapPlot(
     dt=datetime.now(tz).replace(hour=22),
     style=sp.styles.PlotStyle().extend(
         sp.styles.extensions.BLUE_MEDIUM,
-        sp.styles.extensions.ZENITH,
     ),
-    resolution=2000,
+    resolution=4096,
+    autoscale=True,
 )
 p.constellations()
 p.stars(mag=4.6)
+p.constellation_labels()
 p.export("starchart.png")
 ```
 
@@ -72,12 +74,11 @@ https://discord.gg/WewJJjshFu
 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
-- 🚀 Plotting Optimizations
 - ☄️ Comet model
-- 🌄 Horizon plots
-- ⚖️ Better auto font-size adjustment
 - 😄 🔭 Clear skies
 
 See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)

{starplot-0.12.5 → starplot-0.14.0}/docs/about.md

@@ -1,6 +1,10 @@
 ![Starplot](images/favicon.svg){ align=right width="128" .off-glb }
 
-**Starplot** is a Python library for creating star charts and maps. It lets you create zenith plots that show the whole sky from a time/place, map plots that show more detail of an area, and optic plots that simulate the field of view from a particular optic (e.g. telescope, binoculars, or a camera).
+**Starplot** is a Python library for creating star charts and maps of the sky. It lets you create zenith plots that show the whole sky from a time/place, map plots that show more detail of an area, and optic plots that simulate the field of view from a particular optic (e.g. telescope, binoculars, or a camera).
+
+👷 **Work In Progress** 🚧 Starplot is still very much a work in progress, and under active development. We try to follow [semantic versioning](https://semver.org/), which means that [_anything_ can change between versions before `1.0.0`](https://semver.org/#spec-item-4).
+
+However, the Starplot API becomes more stable with each new version. We anticipate that version `1.0.0` is still at least a year away. The best way to help us get there faster is to [join as a contributor](https://github.com/steveberardi/starplot/blob/main/CONTRIBUTING.md) 😃 help is wanted and very much appreciated!
 
 Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }](https://discord.gg/WewJJjshFu)
 

{starplot-0.12.5 → starplot-0.14.0}/docs/changelog.md

@@ -1,4 +1,26 @@
+## v0.14.x
+- Adds horizon plots, which show what the sky looks like from the horizon at a specific time and place
+- Improved auto placement of constellation labels
+- Separates styles and functions for constellation lines and labels
+- Plots constellation lines and borders as a `LineCollection` to improve performance
+- Adds option to suppress warnings from dependencies
+- Adds legend labels to shape functions
+
+## v0.13.x
+[Documentation](https://archives.starplot.dev/0.13.0/)
+
+- Adds a `scale` factor to control sizing of all objects/text
+- Adds an "auto" option for label offsets from markers
+- Adds constellation lines to label collision detection
+- Adds a `gid` to plotted objects to make exported SVGs easier to work with in external applications (e.g. Inkscape)
+- Adds Flamsteed numbers to stars
+- Adds all star names from IAU
+- Adds the standard symbol for planetary nebulae
+- Adds a border size/color property to label styles
+- Bundles fonts: Inter & GFS Didot
+
 ## v0.12.x
+[Documentation](https://archives.starplot.dev/0.12.5/)
 
 - Adds Shapely geometry to all sky object models, including support for `intersects` in `where` clauses
 - Adds kwarg to map plots to allow custom clip paths
@@ -12,6 +34,9 @@
 - [**v0.12.2**] Allows tuples for line styles on polygons and adds geometry kwarg to polygon function
 - [**v0.12.3**] Fixes bug with constellation names
 - [**v0.12.4**] Makes labels on markers default to None
+- [**v0.12.5**]
+    - Fixes bug with a few constellation ids
+    - Fixes bug with `zenith()` function on map plots
 
 ## v0.11.x
 [Documentation](https://archives.starplot.dev/0.11.4/)

{starplot-0.12.5 → starplot-0.14.0}/docs/coming-soon.md

@@ -1,10 +1,9 @@
 
+- 🗄️ Data optimizations
+- 🧮 Coordinate system helpers
 - 🌑 Planet moons
 - ☄️ Comet model
-- 🌄 Horizon plots
 - ✴️ Custom markers
-- 🚀 Plotting Optimizations
-- ⚖️ Better auto font-size adjustment
 - 😄 🔭 Clear skies
 
 <br/>

starplot-0.14.0/docs/examples/horizon-sgr.md

@@ -0,0 +1,16 @@
+---
+title: Horizon Plot
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Horizon Plot {.example-header}
+
+![horizon-sgr](/images/examples/horizon_sgr.png)
+
+This plot shows what was in the sky when looking southwest from Lone Pine, California on August 30, 2024 at 9pm PT.
+
+```python
+--8<-- "examples/horizon_sgr.py"
+```
+
+

{starplot-0.12.5 → starplot-0.14.0}/docs/examples/map-canis-major.md

@@ -7,6 +7,8 @@ title: Map of Canis Major
 
 ![map-canis-major](/images/examples/map_canis_major.png)
 
+In this example, we set the plot's `clip_path` to the boundary of Canis Major, so only objects in that constellation are plotted:
+
 ```python
 --8<-- "examples/map_canis_major.py"
 ```

{starplot-0.12.5 → starplot-0.14.0}/docs/examples/map-orion.md

@@ -7,7 +7,7 @@ title: Map of Orion
 
 ![map-orion](/images/examples/map_orion.png)
 
-The following code will create a simple map plot that shows the area around the constellation Orion, including a legend and an ellipse around [Orion's Belt](https://en.wikipedia.org/wiki/Orion%27s_Belt):
+The following code will create a simple map plot that shows the area around the constellation [Orion](https://en.wikipedia.org/wiki/Orion_(constellation)):
 
 ```python
 --8<-- "examples/map_orion.py"

{starplot-0.12.5 → starplot-0.14.0}/docs/examples.md

@@ -57,6 +57,14 @@
             <p class="example-card-title">Milky Way Stars</p>
         </a>
     </li>
+    
+    <li>
+        <a href="/examples/horizon-sgr/">
+            <img src="/images/examples/horizon_sgr-sm.png" alt="Horizon Plot of Sagittarius" class="off-glb" loading="lazy"/>
+
+            <p class="example-card-title">Horizon Plot</p>
+        </a>
+    </li>
 
     <li>
         <a href="/examples/map-big-dipper/">

{starplot-0.12.5 → starplot-0.14.0}/docs/index.md

@@ -12,13 +12,15 @@ title: Star Charts and Maps of the Sky in Python
 Starplot is a Python library for creating star charts and maps of the sky.
 {.text-subtitle}
 
-- ⭐ **Zenith Plots** - showing the stars from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 
-- 🗺️ **Map Plots** - including stereographic and perspective projections
+- 🗺️ **Map Plots** - including many projections
 
-- 🔭 **Optic Plots** - simulates what you'll see through an optic (e.g. telescope) from a time/location
+- 🌃 **Horizon Plots** - shows the horizon at a specific time and place
 
-- 🪐 **Planets and Deep Sky Objects (DSOs)**
+- 🔭 **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
 
@@ -28,6 +30,7 @@ Starplot is a Python library for creating star charts and maps of the sky.
 
 Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }](https://discord.gg/WewJJjshFu)
 
+
 *Example charts and maps created with Starplot:*
 <!-- {.text-subtitle} -->
 
@@ -38,7 +41,7 @@ Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }]
 
 <figure markdown>
   <img src="images/examples/map_orion.png" width="900">
-  <figcaption>Map around the constellation Orion, with an ellipse around Orion's Belt (<a href="/examples/map-orion/">source code</a>)</figcaption>
+  <figcaption>Map around the constellation Orion (<a href="/examples/map-orion/">source code</a>)</figcaption>
 </figure>
 
 

{starplot-0.12.5 → starplot-0.14.0}/docs/installation.md

@@ -28,6 +28,19 @@ apt-get install libgeos-dev libgdal-dev
 pip install starplot
 ```
 
+## Docker
+
+Here's a basic Docker container definition that'll get you up and running:
+
+```docker
+FROM python:3.11.11-bookworm
+
+# Install required system libraries (GEOS + GDAL)
+RUN apt-get clean && apt-get update -y && apt-get install -y libgeos-dev libgdal-dev
+
+RUN pip install starplot
+```
+
 !!! star "What about Windows?"
 
     I haven't tried installing Starplot on Windows, but if you have and would like to share instructions, please feel free to [open a pull request on GitHub](https://github.com/steveberardi/starplot) with an update to this file (`docs/installation.md`). Thanks! :)

starplot-0.14.0/docs/reference-horizonplot.md

@@ -0,0 +1,10 @@
+**Horizon plots show what the sky looks like from the horizon at a specific time and place**. They can help illustrate answers to questions like "what stars will I see in the sky tonight at 9pm when I look directly West from my backyard?"
+
+These plots use the [Lambert azimuthal equal-area projection](https://en.wikipedia.org/wiki/Lambert_azimuthal_equal-area_projection), with the horizon as the central altitude (0 degrees) and the central azimuth is determined by the azimuth range you define when creating the plot.
+
+::: starplot.HorizonPlot
+    options:
+        inherited_members: true
+        merge_init_into_class: true
+        show_root_heading: true
+

{starplot-0.12.5 → starplot-0.14.0}/docs/reference-styling.md

@@ -83,7 +83,7 @@ from starplot import PlotStyle
 style = PlotStyle().extend(
     {
         "bayer_labels": {
-            "font_name": "GFS Didot",
+            "font_name": "Literata",
             "font_size": 10
         }
     }
@@ -92,7 +92,7 @@ style = PlotStyle().extend(
 Alternatively, you can do this:
 ```python
 style = PlotStyle()
-style.bayer_labels.font_name = "GFS Didot"
+style.bayer_labels.font_name = "Literata"
 style.bayer_labels.font_size = 10
 
 ```
@@ -152,8 +152,8 @@ Starplot has a bunch of built-in style extensions (all imported from `starplot.s
     - `GRAYSCALE` - Optimized for printing in grayscale ([details](#extensions-grayscale))
     - `GRAYSCALE_DARK` - Like `GRAYSCALE`, but inverted (white stars, black background) ([details](#extensions-grayscale-dark))
     - `BLUE_LIGHT` - Light and bright colors ([details](#extensions-blue-light))
-    - `BLUE_MEDIUM` - Medium brightness bluish gray colors ([details](#extensions-blue-medium))
-    - `BLUE_DARK` - Dark "Starplot blue" colors ([details](#extensions-blue-dark))
+    - `BLUE_MEDIUM` - Medium brightness blue colors ([details](#extensions-blue-medium))
+    - `BLUE_DARK` - Dark blue and contrasting colors ([details](#extensions-blue-dark))
     - `ANTIQUE` - Antique map inspired colors ([details](#extensions-antique))
     - `NORD` - Nord-inspired colors ([details](#extensions-nord))
 - **Plot types**

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial/02.md

@@ -37,10 +37,19 @@ On line 8, we create a [`MapPlot`][starplot.MapPlot] instance that specifies a f
 - `lat`/`lon`: Observing location
 - `dt`: Observing date/time
 - `resolution`: Resolution (in pixels) of the widest dimension of the plot
+- `scale`: This controls the sizing of all text and markers. At scale `1.0` everything is optimized for a basic map of 1-3 constellations, so if you're plotting a larger area (or just want everything smaller), then it's a good idea to decrease the scale so the plot isn't too crowded.
 
-When you create a plot instance, initially it'll be empty (i.e. it won't have any stars). In Starplot, you have to explicitly plot all objects. So, on line 15 we plot the constellations, which includes lines and labels. Then, we plot stars with a limiting magnitude of 4.6.
+When you create a plot instance, initially it'll be empty (i.e. it won't have any stars or constellations). In Starplot, you have to explicitly plot all objects.
 
-Finally, we export the plot to a PNG file.
+So, on line 16 we start by plotting the constellation lines. We plot these _first_, because Starplot can use the constellation lines to automatically find good places to plot object labels.
+
+Next, we plot stars with a limiting magnitude of 4.6. Notice how none of the star names in the plot cross over a constellation line? That's because we plotted the constellation lines _before_ plotting the stars.
+
+After the stars, we plot the horizon, which is the border around the plot with the cardinal direction labels.
+
+Lastly, we plot the constellation labels. It's good to plot these last because they're area-based labels (vs point-based, like for star names), and area-based labels have more freedom to move around. If you plot area-based labels first, then it would limit the available space for point-based labels.
+
+Once we're done plotting, we export the plot to a PNG file.
 
 *In the [next section](03.md), we'll learn how to add some styles and other objects to the plot...*
 

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial/05.md

@@ -22,7 +22,7 @@ For example, here's how you'd create an optic plot of the Beehive Star Cluster (
 
 The first 13 lines should look familiar from the other plots we've created in this tutorial.
 
-Line 15 is where we create the instance of an `OpticPlot`. Most of the kwargs are the same as the map plot's kwargs, except for the following: 
+Line 14 is where we create the instance of an `OpticPlot`. Most of the kwargs are the same as the map plot's kwargs, except for the following: 
 
 - `ra`: Right ascension of the target
 - `dec`: Declination of the target
@@ -30,7 +30,7 @@ Line 15 is where we create the instance of an `OpticPlot`. Most of the kwargs ar
 
 The `ra`/`dec` you specify for the target will be the center of the plot.
 
-On line 31, we plot stars down to magnitude 14, but we also specify the [star catalog](/reference-data/#starplot.data.stars.StarCatalog) to use. By default, Starplot uses the Hipparcos catalog, but it also has the [Big Sky Catalog](https://github.com/steveberardi/bigsky) built-in which has many more stars.
+On line 31, we plot stars down to magnitude 12, but we also specify the [star catalog](/reference-data/#starplot.data.stars.StarCatalog) to use. By default, Starplot uses the Hipparcos catalog, but it also has the [Big Sky Catalog](https://github.com/steveberardi/bigsky) built-in which has many more stars.
 
 *In the [next section](06.md), we'll learn how to be more selective of objects to plot...*
 

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial/06.md

@@ -20,7 +20,7 @@ p.stars(
     ],
 )
 ```
-When passing the `where` kwarg, the `mag` kwarg will be ignored, and only the stars/DSOs that satisfy ALL the `where` conditions will be plotted. You can reference any field on the model in expressions, and there are also a few functions available for determining if a field is null or is in a list of values. For complete details about selecting objects, see the [reference page](/reference-selecting-objects/).
+When passing the `where` kwarg, the `mag` kwarg will be ignored, and only the stars/DSOs that satisfy ALL the `where` conditions will be plotted. You can reference any field on the [model](/reference-models/) in expressions, and there are also a few functions available for determining if a field is null or is in a list of values. For complete details about selecting objects, see the [reference page](/reference-selecting-objects/).
 
 Here's some code that uses the `where` kwarg extensively to produce the image above:
 <div class="tutorial" markdown>

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial/08.md

@@ -11,7 +11,7 @@ title: 8 - Using Callables
 
 [Callables](/reference-callables/) allow you to define your own functions for calculating a few of the style properties for stars: size, alpha (opacity),  color, and their labels. DSOs support callables for alpha and labels only. Starplot has a few basic callables built-in, but you can also create your own.
 
-Here's an example that uses the built-in callable `color_by_bv` to create an optic plot of [Antares](https://en.wikipedia.org/wiki/Antares) that colorizes the stars based on their B-V index (Antares B-V is 1.83 so it appears red/orange in the sky):
+Here's an example that uses the built-in callable `color_by_bv` to create an optic plot of [Antares](https://en.wikipedia.org/wiki/Antares) that colorizes the stars based on their B-V index (Antares' B-V is 1.83 so it appears red/orange in the sky):
 <div class="tutorial" markdown>
 ```python linenums="1"
 --8<-- "tutorial/tutorial_08.py"

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial/09.md

@@ -14,6 +14,7 @@ The purpose of the tutorial was just to give you an intro to some of Starplot's
 - [Examples](/examples)
 - Code References:
     - [MapPlot](/reference-mapplot/)
+    - [HorizonPlot](/reference-horizonplot/)
     - [OpticPlot](/reference-opticplot/)
     - [Styling](/reference-styling/)
 - [Join other Starplotters on Discord](https://discord.gg/WewJJjshFu)

{starplot-0.12.5 → starplot-0.14.0}/docs/tutorial.md

@@ -15,7 +15,7 @@ Here's an overview of what the tutorial covers:
 8. [Using callables](tutorial/08.md)
 9. [Where to go from here](tutorial/09.md)
 
-Estimated time to complete: 1 hour
+Estimated time to complete: 30 minutes
 
 <br/>
 

{starplot-0.12.5 → starplot-0.14.0}/examples/examples.py

@@ -5,10 +5,15 @@ import glob
 import time
 
 from PIL import Image
-from multiprocessing import Pool, Process
+from multiprocessing import Pool
 
 start = time.time()
 
+skip = [
+    # "map_milky_way_stars.py",
+    # "stuff.py",
+]
+
 
 def thumbnail(filename, max_dimension=900):
     print(filename)
@@ -23,16 +28,17 @@ def get_example_names():
     for filename in glob.iglob("*.py"):
         if filename.endswith("examples.py"):
             continue
+
+        if filename in skip:
+            continue
+
         filenames.append(filename)
 
     return filenames
 
 
 def run_example(filename):
-    import subprocess
-
     print(f"Running {filename}")
-
     subprocess.call(["python", filename])
 
 
@@ -42,16 +48,6 @@ processes = []
 with Pool(5) as pool:
     pool.map(run_example, example_files)
 
-# Run all examples
-# for filename in glob.iglob("*.py"):
-#     if filename.endswith("examples.py"):
-#         continue
-
-#     # if filename != "map_lyra.py":
-#     #     continue
-#     print(f"Running {filename}")
-#     subprocess.call(f"python {filename}", shell=True)
-
 # Create thumbnail images for the examples list page
 image_files = glob.glob("*.png")
 pool = Pool(5)

starplot-0.14.0/examples/horizon_sgr.py

@@ -0,0 +1,39 @@
+from datetime import datetime
+
+from pytz import timezone
+
+from starplot import HorizonPlot, Star, DSO
+from starplot.styles import PlotStyle, extensions
+
+style = PlotStyle().extend(
+    extensions.BLUE_MEDIUM,
+    extensions.MAP,
+    {"figure_background_color": "hsl(212, 27%, 48%)"},
+)
+
+dt = timezone("US/Pacific").localize(datetime(2024, 8, 30, 21, 0, 0, 0))
+
+p = HorizonPlot(
+    altitude=(0, 60),
+    azimuth=(175, 275),
+    lat=36.606111,  # Lone Pine, California
+    lon=-118.079444,
+    dt=dt,
+    style=style,
+    resolution=4000,
+    scale=0.9,
+)
+
+p.constellations()
+p.milky_way()
+
+p.stars(where=[Star.magnitude < 5])
+p.messier(where=[DSO.magnitude < 12], true_size=False, label_fn=lambda d: f"M{d.m}")
+
+p.constellation_labels()
+p.planets()
+p.ecliptic()
+p.horizon()
+p.gridlines()
+
+p.export("horizon_sgr.png", padding=0.2)