API reference¶
Top-level functions¶
Primary functions used to interactively work with figures. Modeled after the
pyplot
versions.
|
Pass the input arguments to |
|
Call |
|
Create a figure with a single subplot or arbitrary grids of subplots, analogous to |
Figure classes¶
The figure class and a couple related classes.
|
List subclass and pseudo-2d array that is used as a container for the list of axes returned by |
|
|
|
Matplotlib |
|
Matplotlib |
Axes classes¶
The axes classes used for all ProPlot figures.
|
Lowest-level axes subclass. |
|
Axes subclass for plotting |
|
Axes subclass for plotting cartopy projections. |
|
|
|
Intermediate class, shared by |
|
Axes subclass for ordinary 2D cartesian coordinates. |
Plotting wrappers¶
Wrapper functions applied to various Axes
plotting methods.
In a future version these features will be documented on the individual
plotting methods, but for now they are documented separately.
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps methods that take a |
|
Wraps methods that use the property cycler ( |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
|
Wraps |
Projection tools¶
New cartopy projection classes and a projection constructor function
for generating Basemap
and cartopy
Projection
classes.
Variables
Default keyword args for |
|
Mapping of “projection names” to cartopy |
Functions
|
Returns a |
Classes
|
The Aitoff projection. |
|
The Hammer projection. |
|
The Kavrayskiy VII projection. |
Analogous to |
|
|
Analogous to |
Analogous to |
|
Analogous to |
|
|
Analogous to |
Analogous to |
|
|
The Winkel tripel (Winkel III) projection. |
Axis tools¶
Various axis Formatter
and ScaleBase
classes. Includes constructor functions so that these classes can be selected
with a shorthand syntax.
Variables
Mapping of strings to |
|
Mapping of strings to |
|
The registered scale names and their associated |
Functions
|
Return a |
|
Return a |
|
Return a |
|
Return a |
|
Return a |
Classes
|
The new default formatter, a simple wrapper around |
|
Axis scale composed of arbitrary piecewise linear transformations. |
|
“Exponential scale” that performs either of two transformations. |
|
An axis scale comprised of arbitrary forward and inverse transformations. |
Axis scale that is linear in the inverse of x. |
|
|
As with |
|
As with |
|
As with |
|
Axis scale that transforms coordinates as with latitude in the Mercator projection. |
|
“Power scale” that performs the transformation |
Axis scale that is linear in the sine of x. |
|
|
As with |
Color and font tools¶
Tools for registering and visualizing colormaps, color cycles, color string names, and fonts. New colormap classes, new colormap normalizer classes, and new constructor functions for generating instances of these classes. Related utilities for manipulating colors. See Colormaps, Color cycles, and Colors and fonts for details.
Variables
List of registered colormap names. |
|
Lists of registered color names by category. |
|
List of registered color cycle names. |
|
Registered font names. |
Functions
|
Similar to |
Register colormaps packaged with ProPlot or saved to the |
|
|
Add color names packaged with ProPlot or saved to the |
Register color cycles packaged with ProPlot or saved to the |
|
Add fonts packaged with ProPlot or saved to the |
|
|
Scale the saturation channel of the input color. |
|
Scale the luminance channel of the input color. |
|
Generate a table of the registered colormaps or the input colormaps categorized by source. |
|
Show how arbitrary colormap(s) vary with respect to the hue, chroma, luminance, HSL saturation, and HPL saturation channels, and optionally the red, blue and green channels. |
|
Generate tables of the registered color names. |
|
Generate hue-saturation, hue-luminance, and luminance-saturation cross-sections for the HCL, HSL, and HPL colorspaces. |
|
Generate a table of registered color cycles or the input color cycles categorized by source. |
|
Generate a table of fonts. |
|
Translate the color in any format and from any colorspace to an RGB tuple. |
|
Translate color in any format to a tuple of channel values in any colorspace. |
|
Generate or retrieve colormaps and optionally merge and manipulate them in a variety of ways. |
|
Pass all arguments to |
|
Generate and merge |
|
Return an arbitrary |
Classes
|
This normalizer is used for all colormap plots. |
|
Dictionary subclass used to replace the |
This class overrides the builtin matplotlib color cache, allowing users to draw colors from named colormaps and color cycles for any plotting command that accepts a |
|
|
This is the default normalizer paired with |
|
New base class for all |
|
New base class for all |
|
Ensures a “midpoint” always lies at the central colormap color. |
|
Similar to |
Rc configuration tools¶
Utilities for configuring matplotlib and ProPlot global settings. See Configuring proplot for details.
Instance of |
|
|
Magical abstract class for managing matplotlib rcParams and additional ProPlot rcParamsLong and rcParamsShort settings. |
|
Set up the ipython inline backend format and ensure that inline figures always look the same as saved figures. |
Miscellaneous tools¶
Simple tools used in various places across this package.
|
Identical to |
|
Calculate the approximate “edge” values along an arbitrary axis, given “center” values. |
|
Like |
|
Convert values and lists of values between arbitrary physical units. |