Skip to content

Clarify colormap_name requirements and usage - #25

Open
emmanuelmathot wants to merge 3 commits into
mainfrom
fix/issue-14-colormap-interop
Open

emmanuelmathot wants to merge 3 commits into
mainfrom
fix/issue-14-colormap-interop

Conversation

@emmanuelmathot

@emmanuelmathot emmanuelmathot commented Sep 21, 2026 •

Copy link
Copy Markdown
Member

Update the CHANGELOG and README to specify that colormap_name must be a standard matplotlib colormap name, ensuring a consistent naming convention for raster bands. Include additional details on how to use colormaps with titiler.

fixes #14

This is a breaking change and will require a version bump

Comment thread README.md Outdated
@vincentsarago

Copy link
Copy Markdown
Collaborator

must be a standard matplotlib colormap name,

We also have custom colormap names in titiler

I'm starting to feel that it will be difficult to generalize renders for many backends/clients 🤷

@m-mohr

m-mohr commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

Such an extension will be a compromise if we don't want this to be the "titiler" extension (which should then be the name), and never be supporting everything that a specific implementation might support. User could use colormap instead of pre-defined names for those additional cases. Coming up with a more interoperable compromise render extension is generally a good way forward IMHO. That could make it work for the "80%" of the cases for everyone instead of 100% only for titiler.

Co-authored-by: Matthias Mohr <m.mohr@moregeo.it>
Comment thread README.md
| colormap | object | [Color map JSON definition](https://developmentseed.org/titiler/user_guide/rendering/#custom-colormaps) that must be applied for a raster band |
| color_formula | string | [Color formula](https://developmentseed.org/titiler/user_guide/rendering/#color-formula) that must be applied for a raster band |
| rescale | \[float] | 2 dimensions array of delimited Min,Max range per band. If not provided, the data will not be rescaled. | |
| colormap_name | string | Name of a standard [matplotlib colormap](https://matplotlib.org/stable/users/explain/colors/colormaps.html) (e.g. `viridis`, `YlGn`) to apply to a raster band. Third party colormaps are not supported, use `colormap` instead. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| colormap_name | string | Name of a standard [matplotlib colormap](https://matplotlib.org/stable/users/explain/colors/colormaps.html) (e.g. `viridis`, `YlGn`) to apply to a raster band. Third party colormaps are not supported, use `colormap` instead. |
| colormap_name | string | Name of a standard [matplotlib colormap](https://matplotlib.org/3.11.2/users/explain/colors/colormaps.html) (e.g. `viridis`, `YlGn`) to apply to a raster band. Third party colormaps are not supported, use `colormap` instead. |

Not 100% sure, but should this link to a specific version to ensure we are not implementing against a moving target?

This branch has not been deployed

No deployments
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.

colormap_name is an interoperability issue

3 participants