Ecliptic + RA/DEC labels + DSOs + more (#23)

* ideas

* start end points

* smoother curve via threshold

* style

* celestial equator

* labels

* visible

* angle

* constants

* gridline styles

* use bookworm

* canonical url

* tick formatters

* radec labels

* comment

* padding to exports

* bg color and map chalk style initial

* styling docs

* refactor style extensions

* open cluster test

* plot dsos

* cleanup

* planets

* ecliptic for zenith plots

* md5 hash files

* abstract planet plotting

* prep for v3

* start cleaning up styles and docs

* format

* fix ecliptic values

* move

* styling docs

* docs

* docs

* styling refactor

* lint

* remove

* float

Author: steveberardi

.gcp/docker.yml

@@ -1,8 +1,8 @@
-FROM python:3.9.17-bullseye as base
+FROM python:3.10.12-bookworm as base
 
 WORKDIR /starplot
 
-RUN apt-get update -y && apt-get install  -y libgeos-dev libgdal-dev
+RUN apt-get update -y && apt-get install -y libgeos-dev libgdal-dev
 
 # Install shapely from source to avoid cartopy segfault
 # https://stackoverflow.com/questions/52374356/

Dockerfile

@@ -16,7 +16,7 @@ lint:
 	$(DOCKER_RUN) "ruff check src/ tests/"
 
 format:
-	$(DOCKER_RUN) "python -m black src/ tests/ scripts/ example.py $(ARGS)"
+	$(DOCKER_RUN) "python -m black src/ tests/ scripts/ examples/ $(ARGS)"
 
 test:
 	$(DOCKER_RUN) "python -m pytest --cov=src/ --cov-report=term --cov-report=html ."
@@ -41,8 +41,11 @@ bash:
 shell:
 	$(DOCKER_RUN) python
 
-example:
-	$(DOCKER_RUN) "python example.py"
+scratchpad:
+	$(DOCKER_RUN) "python scripts/scratchpad.py"
+
+examples:
+	$(DOCKER_RUN) "cd examples && python examples.py"
 
 # ------------------------------------------------------------------
 # Docs
@@ -73,11 +76,14 @@ ephemeris:
 hip8:
 	$(DOCKER_RUN) "python ./scripts/hip.py hip_main.dat hip8.dat"
 
+scripts:
+	$(DOCKER_RUN) "python ./scripts/$(SCRIPT).py"
+
 clean:
 	rm -rf __pycache__
 	rm -rf venv
 	rm -rf dist
 	rm -rf site
 	rm -rf htmlcov
 
-.PHONY: install shell build publish clean example
+.PHONY: install test shell build publish clean ephemeris hip8 scratchpad examples scripts

Makefile

@@ -13,10 +13,10 @@
 
 ## Examples
 *Zenith plot of the stars from a specific time/location:*
-![starchart-blue](https://github.com/steveberardi/starplot/blob/main/examples/starchart-blue.png?raw=true)
+![starchart-blue](https://github.com/steveberardi/starplot/blob/main/examples/01_star_chart.png?raw=true)
 
 *Map around the constellation Orion, with M42 marked:*
-![map-orion](https://github.com/steveberardi/starplot/blob/main/examples/mercator-orion.png?raw=true)
+![map-orion](https://github.com/steveberardi/starplot/blob/main/examples/03_map_orion.svg?raw=true)
 
 
 ## Basic Usage
@@ -58,9 +58,6 @@ p.export("starchart.png")
 ## Coming Soon
 
 - 🔭 Scope plots - that will simulate what you'll see through a telescope eyepiece
-- 🪐 More objects - including planets, and a base library of deep sky objects (DSOs)
-- 💫 Plotting ecliptic
-- 🌐 RA/DEC Labels
 - ⚖️ Better auto font-size adjustment
 - ☄️ Better label collision detection and handling
 

README.md

@@ -28,6 +28,18 @@
 .doc-object.doc-class {
     border-top: 2px solid rgba(200, 200, 200, 0.6);
 }
+.doc-object.doc-class h2.doc-heading span:nth-child(3) {
+    color:hsl(209, 53%, 37%);
+}
+.doc-object.doc-class h2.doc-heading span:nth-child(n+4) {
+    font-size: .65rem;
+    font-weight: 400;
+}
+.doc-object.doc-class h2.doc-heading span:nth-child(n+4).n {
+    font-weight: 600;
+}
+
+
 .doc-contents.first {
     /* border-top: 2px solid rgba(200, 200, 200, 0.6);
     margin-left: 1rem;
@@ -52,6 +64,13 @@
 .doc-object .doc-attribute .doc-heading {
     margin-top: 0;
 }
+.doc-object.doc-attribute h3.doc-heading span:nth-child(3) {
+    color:hsl(209, 53%, 37%);
+}
+.doc-object.doc-attribute h3.doc-heading span:nth-child(n+4) {
+    font-size: .65rem;
+    font-weight: 400;
+}
 .doc-object .doc-attribute .doc-contents {
     margin-bottom: 0;
     padding-bottom: 1rem;

docs/stylesheets/extra.css renamed to docs/css/extra.css

@@ -1,10 +1,11 @@
 
 ### **Stars**
-- XHIP: An Extended Hipparcos Compilation; Anderson E., Francis C. (2012) [VizieR V/137D](http://cdsarc.u-strasbg.fr/viz-bin/Cat?V/137D) 
+- An Extended Hipparcos Compilation (XHIP); Anderson E., Francis C. (2012) [VizieR V/137D](http://cdsarc.u-strasbg.fr/viz-bin/Cat?V/137D) 
 
 
 ### **Constellation Lines**
 - [IAU Constellation page](http://www.iau.org/public/themes/constellations/) (via [d3-celestial](https://github.com/ofrohn/d3-celestial))
+- [Stellarium](https://github.com/Stellarium/stellarium/tree/master/skycultures/modern_st) (via [Sky & Telescope](https://www.skyandtelescope.com))
 
 
 ### **Constellation Borders**

docs/data-sources.md

@@ -15,14 +15,14 @@ import starplot as sp
 tz = timezone("America/Los_Angeles")
 
 p = sp.ZenithPlot(
-    lat=33.363484, 
+    lat=33.363484,
     lon=-116.836394,
     dt=tz.localize(datetime.now().replace(hour=22)),
     limiting_magnitude=4.6,
-    style=sp.styles.BLUE,
+    style=sp.styles.ZENITH_BLUE_MEDIUM,
     resolution=2000,
 )
-p.export("starchart.png")
+p.export("01_star_chart.png")
 ```
 The created file should look something like this:
 
@@ -49,7 +49,7 @@ p = sp.ZenithPlot(
     lon=-117.038611,
     dt=tz.localize(datetime.now().replace(hour=22)),
     limiting_magnitude=4.6,
-    style=sp.styles.GRAYSCALE,
+    style=sp.styles.ZENITH_GRAYSCALE,
     resolution=2000,
 )
 p.plot_object(
@@ -62,7 +62,7 @@ p.plot_object(
         },
     )
 )
-p.export("starchart-coma.png")
+p.export("02_star_chart_extra.png")
 
 ```
 
@@ -76,7 +76,7 @@ The following code will create a simple map plot that shows the area around the
 ```python
 import starplot as sp
 
-style = sp.styles.MAP_BLUE.extend(
+style = sp.styles.MAP_BLUE_LIGHT.extend(
     {
         "bayer_labels": {
             "font_name": "GFS Didot",  # use a better font for Greek letters
@@ -120,10 +120,10 @@ p.plot_object(
         },
     )
 )
-p.export("orion.svg", format="svg")
+p.export("03_map_orion.svg", format="svg", padding=0.5)
 
 
 ```
 The result should look something like this:
 
-![map-orion](images/mercator-orion.png)
+![map-orion](images/03_map_orion.svg)