Skip to content

docs: add shape and label styling tutorial - #16

Merged
timtreis merged 5 commits into
mainfrom
feat/styling-tutorial
Aug 27, 2026
Merged

docs: add shape and label styling tutorial#16
timtreis merged 5 commits into
mainfrom
feat/styling-tutorial

Conversation

@timtreis

Copy link
Copy Markdown
Member

Summary

Adds tutorials/styling_shapes_and_labels.ipynb — the styling counterpart to the colour tutorial. Where color_and_palette covers what colour an element gets, this covers how it is drawn.

Covers the fill/outline surface of render_shapes and render_labels on the blobs dataset:

  • fill_alpha — fill opacity, for both shapes and labels
  • the outline bool toggle (restored for shapes and labels in #750) with outline_width / outline_color / outline_alpha
  • hollow shapes (transparent fill + outline)
  • scale — resizing shape geometries about their centroids
  • segmentation boundaries on labels via outline + contour_px, and the translucent-fill-plus-outline overlay over an image

Executed against spatialdata-plot v0.4.1, committed with outputs. Adds the gallery card + toctree entry and a 552×496 thumbnail.

Scope: deliberately leaves color=/palette/groups to the colour tutorial and points styling to the as_points tutorial (#15), to avoid overlap.

Part of the 0.4.1 feature-tutorial series (after multi-panel colour #14 and normalization #9).

New tutorials/styling_shapes_and_labels.ipynb covering the fill/outline
styling surface of render_shapes and render_labels on the blobs dataset:

- fill_alpha for both shapes and labels
- the outline bool toggle (restored for shapes and labels in #750) with
  outline_width / outline_color / outline_alpha
- hollow shapes (transparent fill + outline)
- scale for resizing shape geometries about their centroids
- segmentation boundaries on labels via outline + contour_px, and the
  translucent-fill-plus-outline overlay over an image

Executed against spatialdata-plot v0.4.1; committed with outputs. Adds the
gallery card + toctree entry and a thumbnail. Deliberately leaves color=/
palette/groups to the colour tutorial and points styling to as_points.
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown

📖 Docs preview: https://scverse.org/spatialdata-plot-tutorials/pr-16/gallery.html

Built from 240c2dd; redeployed on every push.

github-actions Bot pushed a commit that referenced this pull request Aug 18, 2026
…erlay demo go below default, drop internal jargon
github-actions Bot pushed a commit that referenced this pull request Aug 19, 2026
Add a 'Two outlines — outer and inner' section demonstrating the
(outer, inner) two-tuple form of outline_width/color/alpha, which the
tutorial previously never showed. Note column-based outline colouring
in the summary (points to the Colouring tutorial; needs a table-annotated
element, so no blobs demo). Renumber sections and refresh objectives.

Claude-Session: https://claude.ai/code/session_01U9J5GSXR4XGjPMaQQR5iSj
github-actions Bot pushed a commit that referenced this pull request Aug 27, 2026
Replace the dark single-facet label overlay with one coherent scene:
crimson/gold double-outlined translucent polygons (fill opacity + the
new double outline) over white segmentation contours on the blobs image
— shapes styling and label boundaries in one frame.

Claude-Session: https://claude.ai/code/session_01U9J5GSXR4XGjPMaQQR5iSj
github-actions Bot pushed a commit that referenced this pull request Aug 27, 2026
@timtreis
timtreis merged commit ec06a00 into main Aug 27, 2026
4 checks passed
@timtreis
timtreis deleted the feat/styling-tutorial branch August 27, 2026 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant