You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 3.0.0rc1.post350+gf1a4d9821
matplotlib
Fork me on GitHub

The top level matplotlib module

matplotlib.use(arg, warn=True, force=False)[source]

Set the matplotlib backend to one of the known backends.

To find out which backend is currently set, see matplotlib.get_backend().

Parameters:
arg : str

The backend to switch to. This can either be one of the 'standard' backend names or a string of the form module://my.module.name. This value is case-insensitive.

warn : bool, optional

If True, warn if this is called after pyplot has been imported and a backend is set up.

defaults to True

force : bool, optional

If True, attempt to switch the backend. This defaults to False.

matplotlib.get_backend()[source]

Return the name of the current backend.

matplotlib.rcParams

An instance of RcParams for handling default matplotlib values.

matplotlib.rc_context(rc=None, fname=None)[source]

Return a context manager for managing rc settings.

This allows one to do:

with mpl.rc_context(fname='screen.rc'):
    plt.plot(x, a)
    with mpl.rc_context(fname='print.rc'):
        plt.plot(x, b)
    plt.plot(x, c)

The 'a' vs 'x' and 'c' vs 'x' plots would have settings from 'screen.rc', while the 'b' vs 'x' plot would have settings from 'print.rc'.

A dictionary can also be passed to the context manager:

with mpl.rc_context(rc={'text.usetex': True}, fname='screen.rc'):
    plt.plot(x, a)

The 'rc' dictionary takes precedence over the settings loaded from 'fname'. Passing a dictionary only is also valid. For example a common usage is:

with mpl.rc_context(rc={'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('A.png', format='png')
    plt.close(fig)
matplotlib.rc(group, **kwargs)[source]

Set the current rc params. group is the grouping for the rc, e.g., for lines.linewidth the group is lines, for axes.facecolor, the group is axes, and so on. Group may also be a list or tuple of group names, e.g., (xtick, ytick). kwargs is a dictionary attribute name/value pairs, e.g.,:

rc('lines', linewidth=2, color='r')

sets the current rc params and is equivalent to:

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

The following aliases are available to save typing for interactive users:

Alias Property
'lw' 'linewidth'
'ls' 'linestyle'
'c' 'color'
'fc' 'facecolor'
'ec' 'edgecolor'
'mew' 'markeredgewidth'
'aa' 'antialiased'

Thus you could abbreviate the above rc command as:

rc('lines', lw=2, c='r')

Note you can use python's kwargs dictionary facility to store dictionaries of default parameters. e.g., you can customize the font rc as follows:

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}

rc('font', **font)  # pass in the font dict as kwargs

This enables you to easily switch between several configurations. Use matplotlib.style.use('default') or rcdefaults() to restore the default rc params after changes.

matplotlib.rc_file(fname)[source]

Update rc params from file.

Style-blacklisted rc params (defined in matplotlib.style.core.STYLE_BLACKLIST) are not updated.

matplotlib.rcdefaults()[source]

Restore the rc params from Matplotlib's internal default style.

Style-blacklisted rc params (defined in matplotlib.style.core.STYLE_BLACKLIST) are not updated.

See also

rc_file_defaults
Restore the rc params from the rc file originally loaded by Matplotlib.
matplotlib.style.use
Use a specific style file. Call style.use('default') to restore the default style.
matplotlib.rc_file_defaults()[source]

Restore the rc params from the original rc file loaded by Matplotlib.

Style-blacklisted rc params (defined in matplotlib.style.core.STYLE_BLACKLIST) are not updated.

class matplotlib.RcParams(*args, **kwargs)[source]

A dictionary object including validation

validating functions are defined and associated with rc parameters in matplotlib.rcsetup

find_all(pattern)[source]

Return the subset of this RcParams dictionary whose keys match, using re.search(), the given pattern.

Note

Changes to the returned dictionary are not propagated to the parent RcParams dictionary.

msg_backend_obsolete

Deprecated since version 3.0: The msg_backend_obsolete function was deprecated in Matplotlib 3.0 and will be removed in 3.2.

msg_depr

Deprecated since version 3.0: The msg_depr function was deprecated in Matplotlib 3.0 and will be removed in 3.2.

msg_depr_ignore

Deprecated since version 3.0: The msg_depr_ignore function was deprecated in Matplotlib 3.0 and will be removed in 3.2.

msg_depr_set

Deprecated since version 3.0: The msg_depr_set function was deprecated in Matplotlib 3.0 and will be removed in 3.2.

msg_obsolete

Deprecated since version 3.0: The msg_obsolete function was deprecated in Matplotlib 3.0 and will be removed in 3.2.

validate = {'_internal.classic_mode': <function validate_bool at 0x7f74d086e6a8>, 'agg.path.chunksize': <function validate_int at 0x7f74d086eae8>, 'animation.avconv_args': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'animation.avconv_path': <function validate_animation_writer_path at 0x7f74d0870378>, 'animation.bitrate': <function validate_int at 0x7f74d086eae8>, 'animation.codec': <function validate_string at 0x7f74d086f400>, 'animation.convert_args': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'animation.convert_path': <function validate_animation_writer_path at 0x7f74d0870378>, 'animation.embed_limit': <function validate_float at 0x7f74d086e7b8>, 'animation.ffmpeg_args': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'animation.ffmpeg_path': <function validate_animation_writer_path at 0x7f74d0870378>, 'animation.frame_format': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0865be0>, 'animation.html': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0866278>, 'animation.html_args': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'animation.writer': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0865c50>, 'axes.autolimit_mode': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0866e48>, 'axes.axisbelow': <function validate_axisbelow at 0x7f74d086e9d8>, 'axes.edgecolor': <function validate_color at 0x7f74d086f2f0>, 'axes.facecolor': <function validate_color at 0x7f74d086f2f0>, 'axes.formatter.limits': <matplotlib.rcsetup.validate_nseq_int object at 0x7f74d0866ac8>, 'axes.formatter.min_exponent': <function validate_int at 0x7f74d086eae8>, 'axes.formatter.offset_threshold': <function validate_int at 0x7f74d086eae8>, 'axes.formatter.use_locale': <function validate_bool at 0x7f74d086e6a8>, 'axes.formatter.use_mathtext': <function validate_bool at 0x7f74d086e6a8>, 'axes.formatter.useoffset': <function validate_bool at 0x7f74d086e6a8>, 'axes.grid': <function validate_bool at 0x7f74d086e6a8>, 'axes.grid.axis': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0866ba8>, 'axes.grid.which': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0865eb8>, 'axes.labelcolor': <function validate_color at 0x7f74d086f2f0>, 'axes.labelpad': <function validate_float at 0x7f74d086e7b8>, 'axes.labelsize': <function validate_fontsize at 0x7f74d086f620>, 'axes.labelweight': <function validate_string at 0x7f74d086f400>, 'axes.linewidth': <function validate_float at 0x7f74d086e7b8>, 'axes.prop_cycle': <function validate_cycler at 0x7f74d0870268>, 'axes.spines.bottom': <function validate_bool at 0x7f74d086e6a8>, 'axes.spines.left': <function validate_bool at 0x7f74d086e6a8>, 'axes.spines.right': <function validate_bool at 0x7f74d086e6a8>, 'axes.spines.top': <function validate_bool at 0x7f74d086e6a8>, 'axes.titlepad': <function validate_float at 0x7f74d086e7b8>, 'axes.titlesize': <function validate_fontsize at 0x7f74d086f620>, 'axes.titleweight': <function validate_string at 0x7f74d086f400>, 'axes.unicode_minus': <function validate_bool at 0x7f74d086e6a8>, 'axes.xmargin': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0866e80>, 'axes.ymargin': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0866ef0>, 'axes3d.grid': <function validate_bool at 0x7f74d086e6a8>, 'backend': <function validate_backend at 0x7f74d086ec80>, 'backend.qt4': <function validate_qt4 at 0x7f74d086ed08>, 'backend.qt5': <function validate_qt5 at 0x7f74d086ed90>, 'backend_fallback': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.bootstrap': <function validate_int_or_None at 0x7f74d086eb70>, 'boxplot.boxprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.boxprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.boxprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.capprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.capprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.capprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.flierprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.flierprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.flierprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.flierprops.marker': <function validate_string at 0x7f74d086f400>, 'boxplot.flierprops.markeredgecolor': <function validate_color at 0x7f74d086f2f0>, 'boxplot.flierprops.markerfacecolor': <function validate_color_or_auto at 0x7f74d086f1e0>, 'boxplot.flierprops.markersize': <function validate_float at 0x7f74d086e7b8>, 'boxplot.meanline': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.meanprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.meanprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.meanprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.meanprops.marker': <function validate_string at 0x7f74d086f400>, 'boxplot.meanprops.markeredgecolor': <function validate_color at 0x7f74d086f2f0>, 'boxplot.meanprops.markerfacecolor': <function validate_color at 0x7f74d086f2f0>, 'boxplot.meanprops.markersize': <function validate_float at 0x7f74d086e7b8>, 'boxplot.medianprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.medianprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.medianprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.notch': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.patchartist': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.showbox': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.showcaps': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.showfliers': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.showmeans': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.vertical': <function validate_bool at 0x7f74d086e6a8>, 'boxplot.whiskerprops.color': <function validate_color at 0x7f74d086f2f0>, 'boxplot.whiskerprops.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'boxplot.whiskerprops.linewidth': <function validate_float at 0x7f74d086e7b8>, 'boxplot.whiskers': <function validate_whiskers at 0x7f74d086f7b8>, 'contour.corner_mask': <function validate_bool at 0x7f74d086e6a8>, 'contour.negative_linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'datapath': <function validate_path_exists at 0x7f74d086e620>, 'date.autoformatter.day': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.hour': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.microsecond': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.minute': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.month': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.second': <function validate_string at 0x7f74d086f400>, 'date.autoformatter.year': <function validate_string at 0x7f74d086f400>, 'docstring.hardcopy': <function validate_bool at 0x7f74d086e6a8>, 'errorbar.capsize': <function validate_float at 0x7f74d086e7b8>, 'examples.directory': <function validate_string at 0x7f74d086f400>, 'figure.autolayout': <function validate_bool at 0x7f74d086e6a8>, 'figure.constrained_layout.h_pad': <function validate_float at 0x7f74d086e7b8>, 'figure.constrained_layout.hspace': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868978>, 'figure.constrained_layout.use': <function validate_bool at 0x7f74d086e6a8>, 'figure.constrained_layout.w_pad': <function validate_float at 0x7f74d086e7b8>, 'figure.constrained_layout.wspace': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868b00>, 'figure.dpi': <function validate_float at 0x7f74d086e7b8>, 'figure.edgecolor': <function validate_color at 0x7f74d086f2f0>, 'figure.facecolor': <function validate_color at 0x7f74d086f2f0>, 'figure.figsize': <matplotlib.rcsetup.validate_nseq_float object at 0x7f74d0866f98>, 'figure.frameon': <function validate_bool at 0x7f74d086e6a8>, 'figure.max_open_warning': <function validate_int at 0x7f74d086eae8>, 'figure.subplot.bottom': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868400>, 'figure.subplot.hspace': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868860>, 'figure.subplot.left': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868278>, 'figure.subplot.right': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d08682b0>, 'figure.subplot.top': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868550>, 'figure.subplot.wspace': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d08686a0>, 'figure.titlesize': <function validate_fontsize at 0x7f74d086f620>, 'figure.titleweight': <function validate_string at 0x7f74d086f400>, 'font.cursive': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.family': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.fantasy': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.monospace': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.sans-serif': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.serif': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'font.size': <function validate_float at 0x7f74d086e7b8>, 'font.stretch': <function validate_string at 0x7f74d086f400>, 'font.style': <function validate_string at 0x7f74d086f400>, 'font.variant': <function validate_string at 0x7f74d086f400>, 'font.weight': <function validate_string at 0x7f74d086f400>, 'grid.alpha': <function validate_float at 0x7f74d086e7b8>, 'grid.color': <function validate_color at 0x7f74d086f2f0>, 'grid.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'grid.linewidth': <function validate_float at 0x7f74d086e7b8>, 'hatch.color': <function validate_color at 0x7f74d086f2f0>, 'hatch.linewidth': <function validate_float at 0x7f74d086e7b8>, 'hist.bins': <function validate_hist_bins at 0x7f74d08702f0>, 'image.aspect': <function validate_aspect at 0x7f74d086f510>, 'image.cmap': <function validate_string at 0x7f74d086f400>, 'image.composite_image': <function validate_bool at 0x7f74d086e6a8>, 'image.interpolation': <function validate_string at 0x7f74d086f400>, 'image.lut': <function validate_int at 0x7f74d086eae8>, 'image.origin': <function validate_string at 0x7f74d086f400>, 'image.resample': <function validate_bool at 0x7f74d086e6a8>, 'interactive': <function validate_bool at 0x7f74d086e6a8>, 'keymap.all_axes': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.back': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.copy': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.forward': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.fullscreen': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.grid': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.grid_minor': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.help': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.home': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.pan': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.quit': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.quit_all': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.save': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.xscale': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.yscale': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'keymap.zoom': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'legend.borderaxespad': <function validate_float at 0x7f74d086e7b8>, 'legend.borderpad': <function validate_float at 0x7f74d086e7b8>, 'legend.columnspacing': <function validate_float at 0x7f74d086e7b8>, 'legend.edgecolor': <function validate_color_or_inherit at 0x7f74d086eea0>, 'legend.facecolor': <function validate_color_or_inherit at 0x7f74d086eea0>, 'legend.fancybox': <function validate_bool at 0x7f74d086e6a8>, 'legend.fontsize': <function validate_fontsize at 0x7f74d086f620>, 'legend.framealpha': <function validate_float_or_None at 0x7f74d086e8c8>, 'legend.frameon': <function validate_bool at 0x7f74d086e6a8>, 'legend.handleheight': <function validate_float at 0x7f74d086e7b8>, 'legend.handlelength': <function validate_float at 0x7f74d086e7b8>, 'legend.handletextpad': <function validate_float at 0x7f74d086e7b8>, 'legend.labelspacing': <function validate_float at 0x7f74d086e7b8>, 'legend.loc': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0865b70>, 'legend.markerscale': <function validate_float at 0x7f74d086e7b8>, 'legend.numpoints': <function validate_int at 0x7f74d086eae8>, 'legend.scatterpoints': <function validate_int at 0x7f74d086eae8>, 'legend.shadow': <function validate_bool at 0x7f74d086e6a8>, 'legend.title_fontsize': <function validate_fontsize_None at 0x7f74d086f598>, 'lines.antialiased': <function validate_bool at 0x7f74d086e6a8>, 'lines.color': <function validate_color at 0x7f74d086f2f0>, 'lines.dash_capstyle': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0863c18>, 'lines.dash_joinstyle': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085f320>, 'lines.dashdot_pattern': <matplotlib.rcsetup.validate_nseq_float object at 0x7f74d0866978>, 'lines.dashed_pattern': <matplotlib.rcsetup.validate_nseq_float object at 0x7f74d0866198>, 'lines.dotted_pattern': <matplotlib.rcsetup.validate_nseq_float object at 0x7f74d08669e8>, 'lines.linestyle': <function _validate_linestyle at 0x7f74d0870488>, 'lines.linewidth': <function validate_float at 0x7f74d086e7b8>, 'lines.marker': <function validate_string at 0x7f74d086f400>, 'lines.markeredgecolor': <function validate_color_or_auto at 0x7f74d086f1e0>, 'lines.markeredgewidth': <function validate_float at 0x7f74d086e7b8>, 'lines.markerfacecolor': <function validate_color_or_auto at 0x7f74d086f1e0>, 'lines.markersize': <function validate_float at 0x7f74d086e7b8>, 'lines.scale_dashes': <function validate_bool at 0x7f74d086e6a8>, 'lines.solid_capstyle': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0863c18>, 'lines.solid_joinstyle': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085f320>, 'markers.fillstyle': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d0865208>, 'mathtext.bf': <function validate_font_properties at 0x7f74d086f730>, 'mathtext.cal': <function validate_font_properties at 0x7f74d086f730>, 'mathtext.default': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085ccc0>, 'mathtext.fallback_to_cm': <function validate_bool at 0x7f74d086e6a8>, 'mathtext.fontset': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085ae48>, 'mathtext.it': <function validate_font_properties at 0x7f74d086f730>, 'mathtext.rm': <function validate_font_properties at 0x7f74d086f730>, 'mathtext.sf': <function validate_font_properties at 0x7f74d086f730>, 'mathtext.tt': <function validate_font_properties at 0x7f74d086f730>, 'patch.antialiased': <function validate_bool at 0x7f74d086e6a8>, 'patch.edgecolor': <function validate_color at 0x7f74d086f2f0>, 'patch.facecolor': <function validate_color at 0x7f74d086f2f0>, 'patch.force_edgecolor': <function validate_bool at 0x7f74d086e6a8>, 'patch.linewidth': <function validate_float at 0x7f74d086e7b8>, 'path.effects': <function validate_any at 0x7f74d086e510>, 'path.simplify': <function validate_bool at 0x7f74d086e6a8>, 'path.simplify_threshold': <matplotlib.rcsetup.ValidateInterval object at 0x7f74d0868b70>, 'path.sketch': <function validate_sketch at 0x7f74d086fd90>, 'path.snap': <function validate_bool at 0x7f74d086e6a8>, 'pdf.compression': <function validate_int at 0x7f74d086eae8>, 'pdf.fonttype': <function validate_fonttype at 0x7f74d086ebf8>, 'pdf.inheritcolor': <function validate_bool at 0x7f74d086e6a8>, 'pdf.use14corefonts': <function validate_bool at 0x7f74d086e6a8>, 'pgf.preamble': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'pgf.rcfonts': <function validate_bool at 0x7f74d086e6a8>, 'pgf.texsystem': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d08655c0>, 'polaraxes.grid': <function validate_bool at 0x7f74d086e6a8>, 'ps.distiller.res': <function validate_int at 0x7f74d086eae8>, 'ps.fonttype': <function validate_fonttype at 0x7f74d086ebf8>, 'ps.papersize': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085f208>, 'ps.useafm': <function validate_bool at 0x7f74d086e6a8>, 'ps.usedistiller': <function validate_ps_distiller at 0x7f74d086f8c8>, 'savefig.bbox': <function validate_bbox at 0x7f74d086fd08>, 'savefig.directory': <function validate_string at 0x7f74d086f400>, 'savefig.dpi': <function validate_dpi at 0x7f74d086ea60>, 'savefig.edgecolor': <function validate_color at 0x7f74d086f2f0>, 'savefig.facecolor': <function validate_color at 0x7f74d086f2f0>, 'savefig.format': <function update_savefig_format at 0x7f74d086f840>, 'savefig.frameon': <function validate_bool at 0x7f74d086e6a8>, 'savefig.jpeg_quality': <function validate_int at 0x7f74d086eae8>, 'savefig.orientation': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085a898>, 'savefig.pad_inches': <function validate_float at 0x7f74d086e7b8>, 'savefig.transparent': <function validate_bool at 0x7f74d086e6a8>, 'scatter.marker': <function validate_string at 0x7f74d086f400>, 'svg.fonttype': <function validate_svg_fonttype at 0x7f74d086fbf8>, 'svg.hashsalt': <function validate_string_or_None at 0x7f74d086e950>, 'svg.image_inline': <function validate_bool at 0x7f74d086e6a8>, 'text.antialiased': <function validate_bool at 0x7f74d086e6a8>, 'text.color': <function validate_color at 0x7f74d086f2f0>, 'text.hinting': <function validate_hinting at 0x7f74d086fc80>, 'text.hinting_factor': <function validate_int at 0x7f74d086eae8>, 'text.latex.preamble': <function _listify_validator.<locals>.f at 0x7f74d086f488>, 'text.latex.preview': <function validate_bool at 0x7f74d086e6a8>, 'text.latex.unicode': <function validate_bool at 0x7f74d086e6a8>, 'text.usetex': <function validate_bool at 0x7f74d086e6a8>, 'timezone': <function validate_string at 0x7f74d086f400>, 'tk.window_focus': <function validate_bool at 0x7f74d086e6a8>, 'toolbar': <function validate_toolbar at 0x7f74d086ee18>, 'verbose.fileo': <function validate_string at 0x7f74d086f400>, 'verbose.level': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085c240>, 'webagg.address': <function validate_webagg_address at 0x7f74d0870400>, 'webagg.open_in_browser': <function validate_bool at 0x7f74d086e6a8>, 'webagg.port': <function validate_int at 0x7f74d086eae8>, 'webagg.port_retries': <function validate_int at 0x7f74d086eae8>, 'xtick.alignment': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085f198>, 'xtick.bottom': <function validate_bool at 0x7f74d086e6a8>, 'xtick.color': <function validate_color at 0x7f74d086f2f0>, 'xtick.direction': <function validate_string at 0x7f74d086f400>, 'xtick.labelbottom': <function validate_bool at 0x7f74d086e6a8>, 'xtick.labelsize': <function validate_fontsize at 0x7f74d086f620>, 'xtick.labeltop': <function validate_bool at 0x7f74d086e6a8>, 'xtick.major.bottom': <function validate_bool at 0x7f74d086e6a8>, 'xtick.major.pad': <function validate_float at 0x7f74d086e7b8>, 'xtick.major.size': <function validate_float at 0x7f74d086e7b8>, 'xtick.major.top': <function validate_bool at 0x7f74d086e6a8>, 'xtick.major.width': <function validate_float at 0x7f74d086e7b8>, 'xtick.minor.bottom': <function validate_bool at 0x7f74d086e6a8>, 'xtick.minor.pad': <function validate_float at 0x7f74d086e7b8>, 'xtick.minor.size': <function validate_float at 0x7f74d086e7b8>, 'xtick.minor.top': <function validate_bool at 0x7f74d086e6a8>, 'xtick.minor.visible': <function validate_bool at 0x7f74d086e6a8>, 'xtick.minor.width': <function validate_float at 0x7f74d086e7b8>, 'xtick.top': <function validate_bool at 0x7f74d086e6a8>, 'ytick.alignment': <matplotlib.rcsetup.ValidateInStrings object at 0x7f74d085f198>, 'ytick.color': <function validate_color at 0x7f74d086f2f0>, 'ytick.direction': <function validate_string at 0x7f74d086f400>, 'ytick.labelleft': <function validate_bool at 0x7f74d086e6a8>, 'ytick.labelright': <function validate_bool at 0x7f74d086e6a8>, 'ytick.labelsize': <function validate_fontsize at 0x7f74d086f620>, 'ytick.left': <function validate_bool at 0x7f74d086e6a8>, 'ytick.major.left': <function validate_bool at 0x7f74d086e6a8>, 'ytick.major.pad': <function validate_float at 0x7f74d086e7b8>, 'ytick.major.right': <function validate_bool at 0x7f74d086e6a8>, 'ytick.major.size': <function validate_float at 0x7f74d086e7b8>, 'ytick.major.width': <function validate_float at 0x7f74d086e7b8>, 'ytick.minor.left': <function validate_bool at 0x7f74d086e6a8>, 'ytick.minor.pad': <function validate_float at 0x7f74d086e7b8>, 'ytick.minor.right': <function validate_bool at 0x7f74d086e6a8>, 'ytick.minor.size': <function validate_float at 0x7f74d086e7b8>, 'ytick.minor.visible': <function validate_bool at 0x7f74d086e6a8>, 'ytick.minor.width': <function validate_float at 0x7f74d086e7b8>, 'ytick.right': <function validate_bool at 0x7f74d086e6a8>}
matplotlib.rc_params(fail_on_error=False)[source]

Return a matplotlib.RcParams instance from the default matplotlib rc file.

matplotlib.rc_params_from_file(fname, fail_on_error=False, use_default_template=True)[source]

Return matplotlib.RcParams from the contents of the given file.

Parameters:
fname : str

Name of file parsed for matplotlib settings.

fail_on_error : bool

If True, raise an error when the parser fails to convert a parameter.

use_default_template : bool

If True, initialize with default parameters before updating with those in the given file. If False, the configuration class only contains the parameters specified in the file. (Useful for updating dicts.)

matplotlib.matplotlib_fname()[source]

Get the location of the config file.

The file location is determined in the following order

  • $PWD/matplotlibrc

  • $MATPLOTLIBRC if it is not a directory

  • $MATPLOTLIBRC/matplotlibrc

  • $MPLCONFIGDIR/matplotlibrc

  • On Linux,

    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc (if $XDG_CONFIG_HOME is defined)
    • or $HOME/.config/matplotlib/matplotlibrc (if $XDG_CONFIG_HOME is not defined)
  • On other platforms,

    • $HOME/.matplotlib/matplotlibrc if $HOME is defined.
  • Lastly, it looks in $MATPLOTLIBDATA/matplotlibrc for a system-defined copy.

matplotlib.interactive(b)[source]

Set interactive mode to boolean b.

If b is True, then draw after every plotting command, e.g., after xlabel

matplotlib.is_interactive()[source]

Return true if plot mode is interactive