Support divergent color ramps #912

nakul-py · 2025-08-29T14:37:31Z

Description

Addresses #881

Currently, Color Ramp Type only supports Divergent colors such as balance, delta , curl, diff and tarn so other colormaps are still show type unknown. Enable users to set a min and max value and also get self-populated min max values for the colormap.
Also updates Color Ramp when user setted to reverse.

Bug Fix - This pr also fixes the selection of bands on SingleBand Pseudocolor

Closes Singleband pseudocolor band selector doesn't respect user selection #958

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

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

github-actions · 2025-08-29T14:37:40Z

👈 Launch a Binder on branch nakul-py/jupytergis/divergent

github-actions · 2025-08-29T14:49:11Z

Integration tests report: appsharing.space

nakul-py

cmocean's "balance" is cool :)

packages/base/src/dialogs/symbology/colorRampUtils.ts

mfisher87

Hey Nakul! This looks really good so far! I have some thoughts on the implementation details, most importantly around saving the min & max into the project file as symbologyState.min, symbologyState.max and updating singleband pseudocolor (for raster data) to share the same behavior. We can definitely share a common component!

packages/base/src/dialogs/symbology/colorRampUtils.ts

packages/base/src/dialogs/symbology/components/color_ramp/ColorRamp.tsx

packages/base/src/dialogs/symbology/vector_layer/types/Categorized.tsx

packages/base/src/dialogs/symbology/symbologyUtils.ts

packages/base/src/dialogs/symbology/components/color_ramp/ColorRamp.tsx

packages/base/src/panelview/components/legendItem.tsx

mfisher87 · 2025-09-10T16:43:47Z

Hey @nakul-py I'm a bit overwhelmed with interviewing folks for an internship program. I may be a bit delayed!

Co-authored-by: Nakul Verma <[email protected]>

mfisher87

Nakul and I worked on this together for a little bit today. Just leaving some thoughts we talked about -- I'll get to a more comprehensive review on Monday!

packages/base/src/dialogs/symbology/colorRampUtils.ts

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampControls.tsx

mfisher87 · 2025-10-03T19:22:56Z

cf7fe08 removes the min/max source input fields. But now the rendering is non-deterministic. Try clicking classify, then OK, then re-open symbology, re-classify, and click OK. The rendered data can look different each time.

This data should come from symbology choices.

mfisher87 · 2025-10-03T23:41:39Z

443d195 resolves the initialization of the OpenLayers Source object's min/max values from the symbology info. This is follow-on work resolving problems introduced in cf7fe08. We still need to initialize the symbology info from the file at initialization time (here, if symbologyState isn't defined, look at the data to find the min and max and save it into symbology state: https://github.com/nakul-py/jupytergis/blob/443d19524930b610859583a03f6d3f2f93d5b68a/packages/base/src/mainview/mainView.tsx#L798-L799)

nakul-py · 2025-10-04T05:57:25Z

4755f5e this commit fixes that we always get 0/100 fallback values as min/max. Now we got min/max from actual data.

nakul-py · 2025-10-07T08:06:43Z

Hey @mfisher87

9b55f00 (#912) This commit implement calculation logic for actual min/max values from maps raster data because some maps are very big So i have added some fallbacks so we can now get min/max values loaded in symbology in 5-25 seconds maximum instead of 3-4 minutes. I think now this can be the easiest and fastest way to calculate symbology.

packages/base/src/dialogs/symbology/hooks/useGetBandInfo.ts

mfisher87 · 2025-10-15T14:07:39Z

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampControls.tsx

  ) => void;
  showModeRow: boolean;
  showRampSelector: boolean;
+  renderType:
+    | 'Graduated'


Suggested change

| 'Graduated'

'Graduated'

Leading | doesn't do anything and can be omitted to avoid confusion

I remove this but it regenerates while formatting unless it give lint error.

packages/base/src/dialogs/symbology/components/color_ramp/ColorRamp.tsx

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampValueControls.tsx

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

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampValueControls.tsx

packages/base/src/dialogs/symbology/tiff_layer/components/BandRow.tsx

…g as expected dataMin and dataMax should be attributes of the `source`, not the layer/symbology. This only impacts performance, so let's punt it for later.

These are different things! The data minimum and maximum are attributes of the data, and symbology min/max are user preference.

mfisher87 · 2025-10-15T16:15:04Z

packages/base/src/dialogs/symbology/hooks/useGetSingleBandInfo.ts

+        let dataMax = image.fileDirectory.STATISTICS_MAXIMUM;
+
+        if (dataMin === undefined || dataMax === undefined) {
+          // 2. Try smallest overview if available


Suggested change

// 2. Try smallest overview if available

// 2. Try smallest overview if available

// A consequence of this method is that we will almost never find the **true** minimum and maximum for the whole raster, as overviews are aggregate data, averaging groups of grid cells to calculate lower-resolution grid cells. However, calculating the minimum and maximum from the entire dataset may be prohibitively expensive on CPU and memory!

There's probably a better way to do this, but we don't need to solve that now. We just need to document the tradeoff we're making :)

Supporting divergent colomaps

78e9966

nakul-py added 2 commits August 29, 2025 20:48

critical value only for divergent

63bcb15

Divergent with min-max

e9ecb40

nakul-py changed the title ~~Wip: Supporting divergent colomaps with critical value~~ Supporting divergent colomaps with critical value Sep 2, 2025

nakul-py marked this pull request as ready for review September 2, 2025 12:16

nakul-py commented Sep 2, 2025

View reviewed changes

packages/base/src/dialogs/symbology/colorRampUtils.ts Outdated Show resolved Hide resolved

mfisher87 added the enhancement New feature or request label Sep 3, 2025

mfisher87 requested changes Sep 3, 2025

View reviewed changes

mfisher87 changed the title ~~Supporting divergent colomaps with critical value~~ Support divergent color ramps Sep 3, 2025

mfisher87 reviewed Sep 3, 2025

View reviewed changes

packages/base/src/panelview/components/legendItem.tsx Outdated Show resolved Hide resolved

mfisher87 requested a review from arjxn-py September 3, 2025 16:13

nakul-py marked this pull request as draft September 5, 2025 08:53

nakul-py added 5 commits September 5, 2025 14:31

changes

2e2f37b

lint fix

67faef4

support singleband psuedocolor

1af0c01

pre-populating values

19ed962

making radius work wit min and max

dbeb780

nakul-py marked this pull request as ready for review September 9, 2025 11:02

nakul-py requested a review from mfisher87 September 9, 2025 11:02

gives colors a sequance

c1fbede

Simplify call to useColorMapList effect

b478a85

Co-authored-by: Nakul Verma <[email protected]>

mfisher87 force-pushed the divergent branch from 3a488a0 to b478a85 Compare September 12, 2025 15:32

Remove type assertion

df7df8f

Co-authored-by: Nakul Verma <[email protected]>

mfisher87 reviewed Sep 12, 2025

View reviewed changes

packages/base/src/dialogs/symbology/colorRampUtils.ts Outdated Show resolved Hide resolved

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampControls.tsx Show resolved Hide resolved

geojupyter-pr-triage bot added this to JupyterGIS PR triage Sep 12, 2025

nakul-py force-pushed the divergent branch from 835794a to c067f57 Compare September 14, 2025 08:37

Update selectedRamp state initialization

4c86aaf

mfisher87 added 3 commits October 3, 2025 14:01

Don't initialize min/max from user input when adding layer

3033b51

This data should come from symbology choices.

Remove console.logs

d1c7ce9

Set the OpenLayers Source object with min/max from symbology info

443d195

fix min/max values fallback

4755f5e

Adding min/max caliculation when loading symbology.

9b55f00

nakul-py requested a review from mfisher87 October 7, 2025 10:28

mfisher87 reviewed Oct 10, 2025

View reviewed changes

Adding seperate hook files for Singleband and Multiband Colors.

2e0209e

nakul-py requested a review from mfisher87 October 13, 2025 08:45

nakul-py commented Oct 13, 2025

View reviewed changes

packages/base/src/dialogs/symbology/hooks/useGetBandInfo.ts Show resolved Hide resolved

refactor

372b9c5

mfisher87 reviewed Oct 15, 2025

View reviewed changes

packages/base/src/dialogs/symbology/tiff_layer/types/SingleBandPseudoColor.tsx Show resolved Hide resolved

mfisher87 reviewed Oct 15, 2025

View reviewed changes

packages/base/src/dialogs/symbology/components/color_ramp/ColorRampValueControls.tsx Show resolved Hide resolved

Restore empty tag for easier diff reading

3d07f7b

mfisher87 reviewed Oct 15, 2025

View reviewed changes

packages/base/src/dialogs/symbology/tiff_layer/components/BandRow.tsx Show resolved Hide resolved

mfisher87 added 2 commits October 15, 2025 09:21

Remove dataMin/Max from symbologyState and note that it's not updatin…

5370f3e

…g as expected dataMin and dataMax should be attributes of the `source`, not the layer/symbology. This only impacts performance, so let's punt it for later.

Avoid loading the dataMin/Max from symbology min/max

1cb0b92

These are different things! The data minimum and maximum are attributes of the data, and symbology min/max are user preference.

mfisher87 reviewed Oct 15, 2025

View reviewed changes

nakul-py added 2 commits October 16, 2025 18:48

Refactoring...

cf5fd26

Selectedband selection fix

1747e6e

nakul-py mentioned this pull request Oct 17, 2025

Singleband pseudocolor band selector doesn't respect user selection #958

Open

nakul-py requested a review from mfisher87 October 17, 2025 06:12

mfisher87 mentioned this pull request Oct 17, 2025

Add support for saving color stops in symbologyState #949

Open

4 tasks

nakul-py added 2 commits November 7, 2025 19:14

Resolving Conflicts

657aba6

Merge branch 'main' into divergent

612d0fa

	// 2. Try smallest overview if available
	// 2. Try smallest overview if available
	// A consequence of this method is that we will almost never find the true minimum and maximum for the whole raster, as overviews are aggregate data, averaging groups of grid cells to calculate lower-resolution grid cells. However, calculating the minimum and maximum from the entire dataset may be prohibitively expensive on CPU and memory!

Support divergent color ramps #912

Are you sure you want to change the base?

Support divergent color ramps #912

Conversation

nakul-py commented Aug 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Bug Fix - This pr also fixes the selection of bands on SingleBand Pseudocolor

Checklist

Uh oh!

github-actions bot commented Aug 29, 2025

Uh oh!

github-actions bot commented Aug 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nakul-py left a comment • 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!

Uh oh!

mfisher87 left a comment • 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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mfisher87 commented Sep 10, 2025

Uh oh!

mfisher87 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

mfisher87 commented Oct 3, 2025

Uh oh!

mfisher87 commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nakul-py commented Oct 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nakul-py commented Oct 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mfisher87 Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

nakul-py Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mfisher87 Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

nakul-py commented Aug 29, 2025 •

edited

Loading

github-actions bot commented Aug 29, 2025 •

edited

Loading

nakul-py left a comment •

edited

Loading

mfisher87 left a comment •

edited

Loading

mfisher87 commented Oct 3, 2025 •

edited

Loading

nakul-py commented Oct 4, 2025 •

edited

Loading

nakul-py commented Oct 7, 2025 •

edited

Loading