diff --git a/docs/_static/gallery/color_and_palette.png b/docs/_static/gallery/color_and_palette.png deleted file mode 100644 index 67f7af67..00000000 Binary files a/docs/_static/gallery/color_and_palette.png and /dev/null differ diff --git a/docs/_static/gallery/getting_started.png b/docs/_static/gallery/getting_started.png deleted file mode 100644 index 68600f15..00000000 Binary files a/docs/_static/gallery/getting_started.png and /dev/null differ diff --git a/docs/_static/gallery/interactive_annotate.png b/docs/_static/gallery/interactive_annotate.png deleted file mode 100644 index 405252f8..00000000 Binary files a/docs/_static/gallery/interactive_annotate.png and /dev/null differ diff --git a/docs/_static/gallery/performance.png b/docs/_static/gallery/performance.png deleted file mode 100644 index db2a4c3d..00000000 Binary files a/docs/_static/gallery/performance.png and /dev/null differ diff --git a/docs/_static/gallery/visium_mouse_brain.png b/docs/_static/gallery/visium_mouse_brain.png deleted file mode 100644 index 6e9b9820..00000000 Binary files a/docs/_static/gallery/visium_mouse_brain.png and /dev/null differ diff --git a/docs/gallery.md b/docs/gallery.md index 16d41d2b..b8ff5248 100644 --- a/docs/gallery.md +++ b/docs/gallery.md @@ -10,69 +10,22 @@ against the latest `spatialdata-plot` release. ## Tutorials -Entry-point material for learning the API on synthetic data. +Learn the API on synthetic data. Start with *Getting started*. -::::{grid} 1 2 2 2 -:gutter: 3 - -:::{grid-item-card} Getting started -:link: notebooks/tutorials/getting_started -:link-type: doc -:img-top: _static/gallery/getting_started.png - -The fluent `.pl` API, layering, and styling on the in-memory `blobs` -dataset. Ideal first read. -::: - -:::{grid-item-card} Colour and palettes -:link: notebooks/tutorials/color_and_palette -:link-type: doc -:img-top: _static/gallery/color_and_palette.png - -How `color=` resolves, the v0.3.0 `groups` behaviour, and building -perceptually well-spaced or colourblind-safe palettes with -`make_palette` and `make_palette_from_data`. -::: - -:::{grid-item-card} Speeding up rendering -:link: notebooks/tutorials/performance -:link-type: doc -:img-top: _static/gallery/performance.png - -Keep rendering fast on large data: automatic rasterization and scale -selection for images, and the `datashader` backend for large collections -of shapes and points. +:::{include} notebooks/tutorials/index.md +:start-after: +:end-before: ::: -:::: - ## Examples -Worked examples on real datasets you'd actually analyse. - -::::{grid} 1 2 2 2 -:gutter: 3 +Apply the API to real datasets you'd actually analyse. -:::{grid-item-card} Visium mouse brain -:link: notebooks/examples/visium_mouse_brain -:link-type: doc -:img-top: _static/gallery/visium_mouse_brain.png - -Render H&E tissue, overlay spots, color by gene expression and by cluster, -and finish with a publication-style figure. +:::{include} notebooks/examples/index.md +:start-after: +:end-before: ::: -:::{grid-item-card} Interactive region annotation -:link: notebooks/examples/interactive_annotate -:link-type: doc -:img-top: _static/gallery/interactive_annotate.png - -Draw regions of interest directly on a `spatialdata-plot` canvas with -`sdata.pl.annotate(...)` and persist them as a `ShapesModel` element. -::: - -:::: - ```{toctree} :hidden: :maxdepth: 2 diff --git a/docs/notebooks b/docs/notebooks index 05b0f515..8d786cf9 160000 --- a/docs/notebooks +++ b/docs/notebooks @@ -1 +1 @@ -Subproject commit 05b0f515192f21c0eb4b00304b7d342035ea9200 +Subproject commit 8d786cf96d1507a29ec34175bf0361efe5e8d8ee