Skip to content

[Bug]: pcolormesh passes alpha value down to colormap instead of alpha blending #29761

Open

Description

@aw32

Bug summary

Using a combination of the following:

  • pcolormesh with a set alpha parameter
  • a colormap that uses the alpha channel for color mapping
    results in the colormap using the alpha parameter from pcolormesh as a constant.

Expected result would be that all resulting values from the colormapping are additionally blended with the alpha parameter from pcolormesh.

Code for reproduction

import matplotlib.pyplot as plt
import matplotlib.colors

cdict ={'red':[(0.0, None, 1.0),
               (1.0, 1.0,  None)],
     'green': [(0.0, None, 0.0),
               (1.0, 0.0,  None)],
     'blue':  [(0.0, None, 0.0),
               (1.0, 0.0,  None)],
     'alpha': [(0.0, None, 0.0),
               (1.0,  1.0, None)]}
cmap = matplotlib.colors.LinearSegmentedColormap('custom',cdict,256)

H = [[1,2,3]]
yedges = [0,1]
xedges = [0,1,2,3]

f, (ax1, ax2) = plt.subplots(2, 1)

# case 1: no alpha, colormap defines alpha of values
ax1.pcolormesh(xedges, yedges, H, cmap=cmap)
ax1.set_title("pcolormesh without alpha parameter")

# case 2: with alpha, alpha is passed to colormap and every value has the same alpha
ax2.pcolormesh(xedges, yedges, H, cmap=cmap, alpha=0.5)
ax2.set_title("pcolormesh with alpha parameter 0.5")

plt.show()

Actual outcome

Image

Expected outcome

Image

The expected outcome is, that the "normal" output of pcolormesh is additionally alpha blended.

Additional information

This happens when an alpha parameter is passed to pcolormesh.
I suspect that the alpha parameter is passed to the colormap call, which effectively sets the colormap result alpha value to a constant.

Operating system

MacOS

Matplotlib Version

3.10.1

Matplotlib Backend

macosx

Python version

Python 3.13.1

Jupyter version

No response

Installation

pip

Activity

  1. greglucas commented on Mar 16, 2025

    @greglucas
    Contributor

    There was some recent discussion in #28437 about how the various alphas should interact. I think different people have different expectations for whether one should take precedence, whether we should blend, a combination of some sort. It would be good to handle this consistently throughout the library.

    I do find it a bit odd that we have a colormap with alpha, but then if blend we actually get different alphas rendered. I'm thinking about the case where we add a colorbar to this only red linear alpha ramp. If we blend, the image values would not map to the colorbar values anymore because that blending stage happens later.

  2. jklymak commented on Mar 16, 2025

    @jklymak
    Member

    As a workaround, you can convert your data to rgba (data->norm->colormap) apply your alpha mask to the alpha channel, and pass to pcolormesh as rgba.

  3. timhoffm commented on Mar 16, 2025

    @timhoffm
    Member

    Indeed, colormapping with alpha is problematic. In particular with the white-to-read colormap, adding alpha makes the values more whitish, which gives the impression of a value shift.

  4. aw32 commented on Mar 18, 2025

    @aw32
    Author

    My use case was to create multiple 2d histograms that are rendered on top of each other.
    Therefore, I was confused about the resulting blended image.
    After figuring out the behavior, I solved it by adjusting the maximum alpha value in the colormap instead of using the alpha parameter of pcolormesh.

  5. dikshajangra12918-oss commented on Apr 19, 2026

    @dikshajangra12918-oss
    Contributor

    @timhoffm
    Is there a clear direction for fixing this? I'd like to work on it for GSoC.

  6. timhoffm commented on Apr 19, 2026

    @timhoffm
    Member

    @dikshajangra12918-oss no there isn’t.

    Also note that the GSoC application deadline was March 31.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions