Add story segment symbology overrides by gjmooney · Pull Request #1102 · geojupyter/jupytergis

gjmooney · 2026-02-04T16:19:26Z

Description

This lets a story map segment temporarily change how other layers look (visibility, opacity, color, render type, etc.) while that segment is active. Each segment has a list of overrides keyed by target layer; when you move to that segment, those overrides are applied. When you change segment or leave the story, the previous state of the layers is restored.

Editing symbology in the segment panel:

segment-edit.mp4

Symbology updating during story:

do-story.mp4

Checklist

PR has a descriptive title and content.
PR description contains references to any issues the PR resolves, e.g. Resolves #XXX.
PR has one of the labels: documentation, bug, enhancement, feature, maintenance
Checks are passing.
Failing lint checks can be resolved with:
- pre-commit run --all-files
- jlpm run lint
If you wish to be cited for your contribution, CITATION.cff contains an author entry for yourself

📚 Documentation preview: https://jupytergis--1102.org.readthedocs.build/en/1102/
💡 JupyterLite preview: https://jupytergis--1102.org.readthedocs.build/en/1102/lite

github-actions · 2026-02-04T16:19:36Z

👈 Launch a Binder on branch gjmooney/jupytergis/segment-absolute-control

github-actions · 2026-02-05T12:17:13Z

Integration tests report: appsharing.space

martinRenou · 2026-02-05T12:57:24Z

That is quite amazing

martinRenou

haven't tried yet, but it looks great

docs/user_guide/how-tos/story-maps.md

martinRenou · 2026-02-05T13:49:56Z

docs/user_guide/how-tos/story-maps.md

+- **Preview Mode off** (default): The panel shows the **Story Editor** (story-level form and **Add Story Segment**). Use this to create and edit the story and segment properties.
+- **Preview Mode on**: The panel shows the **Story Map** viewer: the same step-through experience as in full presentation mode (previous/next, segment content, map updates), but still inside the main JupyterGIS window.
+
+Use Preview Mode to check how the story will look and behave without entering full-screen presentation. The switch is hidden when you are already in presentation mode.


We could add a section about sharing the story map made easier with specta and JupyterLite. For that we'd need a minimal setup, maybe in a separate repo, of specta + jupyterlite + jupytergis. I can help with that if you need.

Let's also leave that for futur us and not block this PR with this

martinRenou · 2026-02-05T13:56:38Z

packages/base/src/dialogs/symbology/tiff_layer/types/SingleBandPseudoColor.tsx

          const obj: IStopRow = {
-            stop: scaleValue(color[i], isQuantile),
-            output: color[i + 1],
+            stop: scaleValue(Number(color[i]), isQuantile),


This makes me think, it seems the color stops do not support other types than numbers. Although you may want to define color stops with data other than numbers e.g. with categorized symbology.

That's not an issue that this PR introduced, it's already on main. But the Number(...) makes me wonder if that's related?

Yea the typing was subpar 🤣 The interpolate case only supports numbers, so that's for Graduated vector symbology and the linear option in SingleBand symbology. The case case (Categorized, Discrete, and Exact) should work with strings as well, but it doesn't populate the stop rows. Right now the color attribute in the vector schema isn't typed at all (it is for the WebGLLayer schema). So yea we should fix that 🙃

Let's not hold this PR longer than needed. If I understand correctly, things are not getting worse with this PR anyway?

I feel like it's an issue we should look into sooner than later though. Maybe as a follow up if you feel like looking into it?

things are not getting worse with this PR anyway?

Right.

I feel like it's an issue we should look into sooner than later though. Maybe as a follow up if you feel like looking into it?

Yea that seems like a good idea.

packages/base/src/formbuilder/objectform/components/OpacitySlider.tsx

packages/base/src/mainview/mainView.tsx

python/jupytergis_lab/style/base.css

martinRenou · 2026-02-06T08:18:58Z

packages/base/src/types.ts

+export const SYMBOLOGY_VALID_LAYER_TYPES = [
+  'VectorLayer',
+  'VectorTileLayer',
+  'WebGlLayer',
+  'HeatmapLayer',
+];


Do we really need this? I feel like we could take a step further, and allow editing any parameter of the layer AND the source, not just symbologyState/visible/opacity.

But before we generalize, I think a valid use case if to show/hide any layer type in the story segment. I was trying to make a story based of raster tile layers only and got surprised I could not select a layer to hide/show it.

Maybe for the current state of the PR, we can allow any type of layer here, of course grey out the symbology button for those that do not support the symbology panel (we have a condition somewhere in the open symbology command that does just that), we can generalize to any layer parameter in a follow up PR.

Then we should probably name it "Layer parameters override" instead of "Symbology override".

Let's track the idea of layer/source override in an issue

martinRenou

That's amazing!! I'll release that in 0.13.0! 🚀 Thanks!

* Squashed * Fix rebase * Lint * Remove unused props * Remove example * Add story maps doc * Add Short Screencast * Remove unused css * Allow selecting all layers * Rename symbologyOverride -> layerOverride * Use const in command

geojupyter-pr-triage bot added this to JupyterGIS PR triage Feb 4, 2026

gjmooney added 4 commits February 5, 2026 12:04

Squashed

34c0d58

Fix rebase

1fe654f

Lint

1a2e437

Remove unused props

7d07e3e

gjmooney force-pushed the segment-absolute-control branch from 35f8cdf to 7d07e3e Compare February 5, 2026 12:04

Remove example

3f21adf

gjmooney added the enhancement New feature or request label Feb 5, 2026

gjmooney requested a review from martinRenou February 5, 2026 12:26

gjmooney force-pushed the segment-absolute-control branch from 0049236 to a2ba73d Compare February 5, 2026 12:51

gjmooney force-pushed the segment-absolute-control branch from a2ba73d to 53e1878 Compare February 5, 2026 13:08

Add story maps doc

72bf681

gjmooney force-pushed the segment-absolute-control branch from 53e1878 to 72bf681 Compare February 5, 2026 13:16

martinRenou requested changes Feb 5, 2026

View reviewed changes

gjmooney added 2 commits February 5, 2026 17:18

Add Short Screencast

83d7955

Remove unused css

e4c98bd

martinRenou reviewed Feb 6, 2026

View reviewed changes

Allow selecting all layers

f31425f

martinRenou approved these changes Feb 6, 2026

View reviewed changes

gjmooney added 2 commits February 6, 2026 10:56

Rename symbologyOverride -> layerOverride

b148190

Use const in command

f363b7c

martinRenou merged commit e1850c1 into geojupyter:main Feb 6, 2026
15 checks passed

github-project-automation bot moved this to Done in JupyterGIS PR triage Feb 6, 2026

geojupyter-pr-triage bot removed this from JupyterGIS PR triage Feb 6, 2026

Conversation

gjmooney commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Uh oh!

github-actions bot commented Feb 4, 2026

Uh oh!

github-actions bot commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

martinRenou commented Feb 5, 2026

Uh oh!

martinRenou left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

martinRenou Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

martinRenou Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

martinRenou Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

gjmooney Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

martinRenou Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

gjmooney Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

martinRenou Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

martinRenou Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

martinRenou left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gjmooney commented Feb 4, 2026 •

edited

Loading

github-actions bot commented Feb 5, 2026 •

edited

Loading

martinRenou Feb 6, 2026 •

edited

Loading