matplotlib.pyplot.gci

matplotlib.pyplot.gci() [source]

Get the current colorable artist. Specifically, returns the current ScalarMappable instance (image or patch collection), or None if no images or patch collections have been defined. The commands imshow() and figimage() create Image instances, and the commands pcolor() and scatter() create Collection instances. The current image is an attribute of the current axes, or the nearest earlier axes in the current figure that contains an image.

Notes

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