# Usage overview¶

ProPlot is an object-oriented matplotlib wrapper, which means most of its features derive from subclasses of the Figure and Axes classes. If you tend to use the pyplot API and are not familiar with figure and axes “objects”, you should first take a look at this page. Using the objects directly tends to be more clear and concise than pyplot API, and makes life easier when working with multiple figures or axes.

## Importing proplot¶

We recommend importing ProPlot with

import proplot as plot


This differentiates ProPlot from the usual plt abbreviation used for the pyplot module. Importing proplot immediately adds a bunch of new colormaps, property cyclers, color names, and fonts to matplotlib. See Colormaps, Color cycles, and Colors and fonts for details.

## Figure and axes classes¶

ProPlot’s features derive from subplots, modeled after the native matplotlib.pyplot.subplots command. subplots creates a Figure subclass populated with special Axes subclasses. See Creating figures and Figure tight layout for details.

Each Axes class also belongs to one of the XYAxes, PolarAxes, or ProjAxes parent classes, depending on the projection used. See Geographic and polar plots for details.

The Figure and Axes subclasses include useful new methods and override several existing methods:

## Integration with other packages¶

ProPlot includes integration with xarray, pandas, cartopy, and basemap:

## Other functions and classes¶

ProPlot includes a bunch of useful tools outside of the Figure and Axes subclasses: