You are reading an old version of the documentation (v2.1.2). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.gca.html
Version 2.1.2
matplotlib
Fork me on GitHub


Travis-CI:

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.