Get the current colorable artist.

Specifically, returns the current ScalarMappable instance (Image created by imshow or figimage, Collection created by pcolor or scatter, etc.), or None if no such instance has been defined.

The current image is an attribute of the current axes, or the nearest earlier axes in the current figure that contains an image.


Historically, the only colorable artists were images; hence the name gci (get current image).

Examples using matplotlib.pyplot.gci