You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 2.0.0b1.post7580.dev0+ge487118
matplotlib
Fork me on GitHub

Table Of Contents

This Page

matplotlib.pyplot.gca

matplotlib.pyplot.gca(**kwargs)

Get the current Axes instance on the current figure matching the given keyword args, or create one.

See also

matplotlib.figure.Figure.gca
The figure’s gca method.

Examples

To get the current polar axes on the current figure:

plt.gca(projection='polar')

If the current axes doesn’t exist, or isn’t a polar one, the appropriate axes will be created and then returned.