matplotlib#

オブジェクト指向のプロット ライブラリ。

手続き型インターフェースは、直接インポートできるコンパニオン pyplot モジュールによって提供されます。

import matplotlib.pyplot as plt

または ipython を使用:

ipython

端末で、その後に次のように入力します。

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt

ipython シェル プロンプトで。

ほとんどの場合、プログラミング時には、明示的なオブジェクト指向ライブラリを直接使用することをお勧めします。暗黙的な pyplot インターフェイスは、主にインタラクティブに作業するためのものです。この提案の例外は pyplot 関数pyplot.figure、pyplot.subplot、pyplot.subplots、および pyplot.savefigで、スクリプト作成を大幅に簡素化できます。暗黙的インターフェイスと明示的インターフェイスの間のトレードオフの説明については、Matplotlib アプリケーション インターフェイス (API)を参照してください 。

モジュールには以下が含まれます。

matplotlib.axes

Axesクラス。ほとんどの pyplot 関数は Axesメソッドのラッパーです。軸モジュールは、ライブラリへのオブジェクト指向アクセスの最高レベルです。

matplotlib.figure

Figureクラス。

matplotlib.artist

Artistものを描画するすべてのクラスの基本クラス。

matplotlib.lines

Line2D線とマーカーを描画するためのクラス。

matplotlib.patches

ポリゴンを描画するためのクラス。

matplotlib.text

およびTextクラスAnnotation。

matplotlib.image

およびAxesImageクラスFigureImage。

matplotlib.collections

ラインまたはポリゴンのグループを効率的に描画するためのクラス。

matplotlib.colors

色の指定とカラーマップの作成。

matplotlib.cm

カラーマップ、およびScalarMappableカラー マッピング機能を他のクラスに提供する mixin クラス。

matplotlib.ticker

目盛り位置の計算と目盛りラベルの書式設定。

matplotlib.backends

さまざまな GUI ライブラリと出力形式のモジュールを含むサブパッケージ。

ベースの matplotlib 名前空間には以下が含まれます。

rcParams

デフォルトの構成設定。これらのデフォルトは、ファイルを使用してオーバーライドmatplotlibrcできます。

use

Matplotlib バックエンドの設定。これは、Figure が作成される前に呼び出す必要があります。これは、後で異なる GUI バックエンドを切り替えることができないためです。

Matplotlib は、John D. Hunter (1968-2012) によって最初に作成され、現在は他の多くの人によって開発および保守されています。

内部ドキュメント (python docstrings) では、The MathWorks, Inc. の登録商標である MATLAB® を参照している場合があります。

バックエンド管理#

matplotlib. use ( backend , * , force = True ) [source] #

レンダリングと GUI 統合に使用するバックエンドを選択します。

パラメータ:
バックエンド文字列

切り替えるバックエンド。これは、大文字と小文字を区別しない標準のバックエンド名のいずれかです。

  • インタラクティブなバックエンド: GTK3Agg、GTK3Cairo、GTK4Agg、GTK4Cairo、MacOSX、nbAgg、QtAgg、QtCairo、TkAgg、TkCairo、WebAgg、WX、WXAgg、WXCairo、Qt5Agg、Qt5Cairo

  • 非インタラクティブなバックエンド: agg、cairo、pdf、pgf、ps、svg、template

または次の形式の文字列: module://my.module.name.

無関係なイベント ループが既に開始されている場合、対話型バックエンドに切り替えることはできません (たとえば、TkAgg ウィンドウが既に開いている場合に GTK3Agg に切り替えるなど)。非インタラクティブなバックエンドへの切り替えはいつでも可能です。

強制ブール、デフォルト: True

True (デフォルト) のImportError場合、バックエンドをセットアップできない場合 (インポートに失敗したか、互換性のない GUI 対話型フレームワークが既に実行されているため) を発生させます。False の場合、失敗を黙って無視します。

こちらもご覧ください

バックエンド
matplotlib.get_backend
matplotlib. get_backend ( ) [ソース] #

現在のバックエンドの名前を返します。

こちらもご覧ください

matplotlib.use
matplotlib. インタラクティブ( b ) [ソース] #

プロット コマンドごとに再描画するかどうかを設定します (例: pyplot.xlabel)。

matplotlib. is_interactive ( ) [ソース] #

各プロット コマンドの後に再描画するかどうかを返します。

ノート

この関数は、バックエンドでの使用のみを目的としています。エンド ユーザーはpyplot.isinteractive代わりに使用する必要があります。

デフォルト値とスタイリング#

matplotlib. rcParams [ソース] #

RcParamsデフォルトの Matplotlib 値を処理するための のインスタンス。

クラス matplotlib。RcParams ( * args , ** kwargs ) [ソース] #

検証を含む辞書オブジェクト。

検証関数が定義され、 で rc パラメータに関連付けられています matplotlib.rcsetup。

rcParams のリストは次のとおりです。

  • _internal.classic_mode

  • agg.path.chunksize

  • アニメーション.ビットレート

  • animation.codec

  • animation.convert_args

  • animation.convert_path

  • animation.embed_limit

  • animation.ffmpeg_args

  • animation.ffmpeg_path

  • animation.frame_format

  • animation.html

  • アニメーションライター

  • 軸.autolimit_mode

  • 軸.軸下

  • 軸.edgecolor

  • 軸.facecolor

  • 軸.フォーマッター.制限

  • axis.formatter.min_exponent

  • axes.formatter.offset_threshold

  • axis.formatter.use_locale

  • axis.formatter.use_mathtext

  • axis.formatter.useoffset

  • 軸.グリッド

  • 軸.グリッド.軸

  • Axes.grid.which

  • 軸.ラベルカラー

  • 軸.ラベルパッド

  • 軸.ラベルサイズ

  • 軸.ラベルの重み

  • 軸.線幅

  • 軸.prop_cycle

  • 軸.スパイン.底

  • 軸.棘.左

  • 軸.棘.右

  • 軸.スパイン.トップ

  • 軸.タイトルカラー

  • 軸.タイトルの場所

  • 軸.タイトルパッド

  • 軸.タイトルサイズ

  • 軸.タイトルの重み

  • 軸.タイトル

  • 軸.unicode_minus

  • 軸.xmargin

  • 軸.yマージン

  • 軸.zmargin

  • 軸3d.グリッド

  • バックエンド

  • backend_fallback

  • boxplot.bootstrap

  • boxplot.boxprops.color

  • boxplot.boxprops.linestyle

  • boxplot.boxprops.linewidth

  • boxplot.capprops.color

  • boxplot.capprops.linestyle

  • boxplot.capprops.linewidth

  • boxplot.flierprops.color

  • boxplot.flierprops.linestyle

  • boxplot.flierprops.linewidth

  • boxplot.flierprops.marker

  • boxplot.flierprops.markeredgecolor

  • boxplot.flierprops.markeredgewidth

  • boxplot.flierprops.markerfacecolor

  • boxplot.flierprops.markersize

  • boxplot.meanline

  • boxplot.meanprops.color

  • boxplot.meanprops.linestyle

  • boxplot.meanprops.linewidth

  • boxplot.meanprops.marker

  • boxplot.meanprops.markeredgecolor

  • boxplot.meanprops.markerfacecolor

  • boxplot.meanprops.markersize

  • boxplot.medianprops.color

  • boxplot.medianprops.linestyle

  • boxplot.medianprops.linewidth

  • boxplot.notch

  • boxplot.patchアーティスト

  • boxplot.showbox

  • boxplot.showcaps

  • boxplot.showfliers

  • boxplot.showmeans

  • boxplot.vertical

  • boxplot.whiskerprops.color

  • boxplot.whiskerprops.linestyle

  • boxplot.whiskerprops.linewidth

  • boxplot.whiskers

  • 輪郭.アルゴリズム

  • 輪郭.コーナーマスク

  • 輪郭.線幅

  • Contour.negative_linestyle

  • date.autoformatter.day

  • date.autoformatter.hour

  • date.autoformatter.microsecond

  • date.autoformatter.minute

  • date.autoformatter.month

  • date.autoformatter.second

  • date.autoformatter.year

  • date.converter

  • 日付.エポック

  • date.interval_multiples

  • docstring.ハードコピー

  • errorbar.capsize

  • figure.autolayout

  • figure.constrained_layout.h_pad

  • figure.constrained_layout.hspace

  • figure.constrained_layout.use

  • figure.constrained_layout.w_pad

  • figure.constrained_layout.wspace

  • フィギュア.dpi

  • figure.edgecolor

  • フィギュア.フェイスカラー

  • figure.figsize

  • figure.frameon

  • figure.labelsize

  • figure.labelweight

  • figure.max_open_warning

  • figure.raise_window

  • figure.subplot.bottom

  • figure.subplot.hspace

  • figure.subplot.left

  • figure.subplot.right

  • figure.subplot.top

  • figure.subplot.wspace

  • figure.titlesize

  • figure.titleweight

  • フォント.筆記体

  • フォントファミリー

  • フォント.ファンタジー

  • font.monospace

  • フォント.サンセリフ

  • フォント.セリフ

  • フォントサイズ

  • font.stretch

  • font.style

  • font.variant

  • font.weight

  • grid.alpha

  • グリッドの色

  • grid.linestyle

  • グリッド.線幅

  • ハッチングの色

  • ハッチングの線幅

  • hist.bins

  • 画像.アスペクト

  • image.cmap

  • image.composite_image

  • 画像補間

  • image.lut

  • image.origin

  • image.resample

  • 相互の作用

  • keymap.back

  • keymap.copy

  • keymap.forward

  • キーマップ.フルスクリーン

  • キーマップ.グリッド

  • keymap.grid_minor

  • keymap.help

  • キーマップ.ホーム

  • キーマップ.パン

  • keymap.quit

  • keymap.quit_all

  • keymap.save

  • keymap.xscale

  • keymap.yscale

  • キーマップ.ズーム

  • legend.borderaxespad

  • 凡例.borderpad

  • 凡例.列間隔

  • 凡例.エッジカラー

  • 凡例.facecolor

  • 凡例.ファンシーボックス

  • 凡例.フォントサイズ

  • 凡例.framealpha

  • 凡例.frameon

  • 凡例.ハンドルの高さ

  • 凡例.ハンドル長

  • 凡例.ハンドルテキストパッド

  • 凡例.ラベルカラー

  • legend.labelspacing

  • 凡例.loc

  • 凡例.マーカースケール

  • 凡例.数値

  • 凡例.散布点

  • 凡例.影

  • legend.title_fontsize

  • lines.antialiased

  • 線.色

  • lines.dash_capstyle

  • lines.dash_joinstyle

  • lines.dashdot_pattern

  • lines.dashed_pa​​ttern

  • lines.dotted_pa​​ttern

  • lines.linestyle

  • lines.linewidth

  • lines.marker

  • lines.markeredgecolor

  • lines.markeredgewidth

  • lines.markerfacecolor

  • lines.markersize

  • lines.scale_dashes

  • lines.solid_capstyle

  • lines.solid_joinstyle

  • マーカー.フィルスタイル

  • mathtext.bf

  • mathtext.cal

  • mathtext.default

  • mathtext.フォールバック

  • mathtext.fontset

  • mathtext.it

  • mathtext.rm

  • mathtext.sf

  • mathtext.tt

  • patch.antialiased

  • patch.edgecolor

  • patch.facecolor

  • patch.force_edgecolor

  • パッチ.線幅

  • パス.効果

  • path.simplify

  • path.simplify_threshold

  • パス.スケッチ

  • パス.スナップ

  • pcolor.shading

  • pcolormesh.snap

  • pdf.圧縮

  • pdf.fonttype

  • pdf.inheritcolor

  • pdf.use14corefonts

  • pgf.プリアンブル

  • pgf.rcfonts

  • pgf.texsystem

  • polaraxes.grid

  • ps.distiller.res

  • ps.fonttype

  • ps.papersize

  • ps.useafm

  • ps.使用蒸留器

  • savefig.bbox

  • savefig.directory

  • savefig.dpi

  • savefig.edgecolor

  • savefig.facecolor

  • savefig.format

  • savefig.orientation

  • savefig.pad_inches

  • savefig.transparent

  • scatter.edgecolors

  • scatter.marker

  • svg.fonttype

  • svg.ハッシュソルト

  • svg.image_inline

  • text.antialiased

  • テキストの色

  • テキスト.ヒンティング

  • text.hinting_factor

  • text.kerning_factor

  • text.latex.プリアンブル

  • text.parse_math

  • text.usetex

  • タイムゾーン

  • tk.window_focus

  • ツールバー

  • webagg.address

  • webagg.open_in_browser

  • webagg.port

  • webagg.port_retries

  • xaxis.labellocation

  • xtick.alignment

  • xtick.bottom

  • xtick.color

  • xtick.direction

  • xtick.labelbottom

  • xtick.labelcolor

  • xtick.labelsize

  • xtick.labeltop

  • xtick.major.bottom

  • xtick.major.pad

  • xtick.major.size

  • xtick.major.top

  • xtick.major.width

  • xtick.minor.bottom

  • xtick.minor.pad

  • xtick.minor.size

  • xtick.minor.top

  • xtick.minor.visible

  • xtick.minor.width

  • xtick.top

  • yaxis.labellocation

  • ytick.alignment

  • ytick.color

  • ytick.direction

  • ytick.labelcolor

  • ytick.labelleft

  • ytick.labelright

  • ytick.labelsize

  • ytick.left

  • ytick.major.left

  • ytick.major.pad

  • ytick.major.right

  • ytick.major.size

  • ytick.major.width

  • ytick.minor.left

  • ytick.minor.pad

  • ytick.minor.right

  • ytick.minor.size

  • ytick.minor.visible

  • ytick.minor.width

  • ytick.right

こちらもご覧ください

matplotlibrc ファイル
find_all (パターン) [ソース] #

re.search()指定された を使用して、キーが一致するこの RcParams 辞書のサブセットを返しますpattern。

ノート

返されたディクショナリへの変更は、親の RcParams ディクショナリには反映されません。

コピー( ) [ソース] #

この RcParams インスタンスをコピーします。

matplotlib. rc_context ( rc =なし, fname =なし) [ソース] #

rcParams を一時的に変更するためのコンテキスト マネージャーを返します。

はrcParams["backend"]、コンテキスト マネージャーによってリセットされません。

パラメータ:
rc辞書

一時的に設定する rcParams。

fname str またはパスのようなもの

Matplotlib rc 設定を含むファイル。fnameとrcの両方が指定された場合、 rcからの設定が優先されます。

こちらもご覧ください

matplotlibrc ファイル

例

dict を介して明示的な値を渡す:

with mpl.rc_context({'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('example.png')
    plt.close(fig)

ファイルから設定を読み込む:

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'
matplotlib. rc (グループ, ** kwargs ) [ソース] #

現在の を設定しrcParamsます。groupは rc のグループ化です。たとえば、lines.linewidthgroup is lines、 for axes.facecolor、 group isaxesなどです。Group は、グループ名のリストまたはタプル ( xtick、ytick ) の場合もあります。 kwargsは、ディクショナリ属性の名前と値のペアです。たとえば、次のとおりです。

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

電流rcParamsを設定し、次と同等です:

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

対話型ユーザーの入力を節約するために、次のエイリアスを使用できます。

エイリアス

財産

'lw'

'線幅'

'ls'

「ラインスタイル」

'c'

'色'

'fc'

「フェイスカラー」

'ec'

'エッジカラー'

「ニャー」

'markeredgewidth'

「ああ」

「アンチエイリアス」

したがって、上記の呼び出しを次のように省略できます。

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

Python の kwargs ディクショナリ機能を使用して、デフォルト パラメータのディクショナリを保存できることに注意してください。たとえば、次のようにフォント rc をカスタマイズできます。

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

これにより、複数の構成を簡単に切り替えることができます。matplotlib.style.use('default')またはを使用 して、変更後rcdefaults()にデフォルトに戻しますrcParams。

ノート

同様の機能は、通常の dict インターフェイスを使用して利用できます (ただし、 省略形やグループ化はサポートされていません)。rcParams.update({"lines.linewidth": 2, ...})rcParams.update

matplotlib. rcdefaults ( ) [ソース] #

rcParamsMatplotlib の内部デフォルト スタイルから を復元します。

スタイル ブラックリストrcParams( で定義 matplotlib.style.core.STYLE_BLACKLIST) は更新されません。

こちらもご覧ください

matplotlib.rc_file_defaults

rcParamsMatplotlib によって最初に読み込まれた rc ファイルから復元します。

matplotlib.style.use

特定のスタイル ファイルを使用します。style.use('default')デフォルトのスタイルを復元するために呼び出します。

matplotlib. rc_file_defaults ( ) [ソース] #

rcParamsMatplotlib によってロードされた元の rc ファイルから復元します。

スタイル ブラックリストrcParams( で定義 matplotlib.style.core.STYLE_BLACKLIST) は更新されません。

matplotlib. rc_file ( fname , * , use_default_template = True ) [ソース] #

ファイルから更新rcParamsします。

スタイル ブラックリストrcParams( で定義 matplotlib.style.core.STYLE_BLACKLIST) は更新されません。

パラメータ:
fname str またはパスのようなもの

Matplotlib rc 設定を含むファイル。

use_default_templateブール値

True の場合、指定されたファイル内のパラメーターで更新する前に、既定のパラメーターで初期化します。False の場合、現在の構成が保持され、ファイルで指定されたパラメーターのみが更新されます。

matplotlib. rc_params ( fail_on_error = False ) [ソース] #

RcParamsデフォルトの Matplotlib rc ファイルからインスタンスを構築します。

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

RcParamsファイルfnameから を構築します。

パラメータ:
fname str またはパスのようなもの

Matplotlib rc 設定を含むファイル。

fail_on_errorブール値

True の場合、パーサーがパラメーターの変換に失敗したときにエラーを発生させます。

use_default_templateブール値

True の場合、指定されたファイル内のパラメーターで更新する前に、既定のパラメーターで初期化します。False の場合、構成クラスには、ファイルで指定されたパラメーターのみが含まれます。(辞書の更新に便利です。)

matplotlib. get_configdir ( ) [ソース] #

構成ディレクトリの文字列パスを返します。

ディレクトリは次のように選択されます。

  1. MPLCONFIGDIR 環境変数が指定されている場合は、それを選択します。

  2. Linux では、XDG 仕様に従い、 $XDG_CONFIG_HOME定義されている場合は 、またはを最初に調べます$HOME/.config。他のプラットフォームでは、 を選択します$HOME/.matplotlib。

  3. 選択したディレクトリが存在し、書き込み可能な場合は、それを構成ディレクトリとして使用します。

  4. それ以外の場合は、一時ディレクトリを作成し、構成ディレクトリとして使用します。

matplotlib. matplotlib_fname ( ) [ソース] #

設定ファイルの場所を取得します。

ファイルの場所は次の順序で決定されます

  • $PWD/matplotlibrc

  • $MATPLOTLIBRCディレクトリでない場合

  • $MATPLOTLIBRC/matplotlibrc

  • $MPLCONFIGDIR/matplotlibrc

  • Linux では、

    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc($XDG_CONFIG_HOME 定義されている場合)

    • または$HOME/.config/matplotlib/matplotlibrc($XDG_CONFIG_HOME 定義されていない場合)

  • 他のプラットフォームでは、 -が定義されている$HOME/.matplotlib/matplotlibrc場合$HOME

  • 最後に、$MATPLOTLIBDATA/matplotlibrc常に存在するはずの を検索します。

matplotlib. get_data_path ( ) [ソース] #

Matplotlib データへのパスを返します。

ロギング#

matplotlib. set_loglevel (レベル) [ソース] #

Matplotlib のルート ロガーとルート ロガー ハンドラー レベルを設定し、まだ存在しない場合はハンドラーを作成します。

通常、set_loglevel("info")または set_loglevel("debug")を呼び出して、追加のデバッグ情報を取得する必要があります。

パラメータ:
レベル{"notset", "debug", "info", "warning", "error", "critical"}

ハンドラのログ レベル。

ノート

この関数が初めて呼び出されると、追加のハンドラーが Matplotlib のルート ハンドラーにアタッチされます。このハンドラーは毎回再利用され、この関数は単にロガーとハンドラーのレベルを操作します。

カラーマップとカラーシーケンス#

matplotlib. カラーマップ[ソース] #

名前で Matplotlib に知られているカラーマップのコンテナー。

実験的

API が最終版になることを期待していますが、必要に応じて API を 3.6 に適応させるオプションを残しておきたいため、正式に 3.5 の実験的なものとしてマークします。

ユニバーサル レジストリのインスタンスはmatplotlib.colormapsです。ユーザーが自分自身をインスタンス化する必要はありませんColormapRegistry。

読み取りアクセスは、名前をColormapsにマッピングする dict のようなインターフェースを使用します。

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

返さColormapれる はコピーであるため、変更によってカラーマップのグローバル定義が変更されることはありません。

次の方法で追加のカラーマップを追加できますColormapRegistry.register。

mpl.colormaps.register(my_colormap)
matplotlib. color_sequences [ソース] #

Matplotlib が名前で認識している一連の色のコンテナー。

ユニバーサル レジストリのインスタンスはmatplotlib.color_sequencesです。ユーザーが自分自身をインスタンス化する必要はありませんColorSequenceRegistry 。

読み取りアクセスは、名前を色のリストにマッピングする dict のようなインターフェイスを使用します。

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

返されるリストはコピーであるため、変更によってカラー シーケンスのグローバルな定義が変更されることはありません。

追加のカラー シーケンスは、次の方法で追加できます ColorSequenceRegistry.register。

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])

その他#

クラス matplotlib。MatplotlibDeprecationWarning [ソース] #

Matplotlib ユーザーに非推奨の警告を発行するためのクラス。

matplotlib. get_cachedir ( ) [ソース] #

キャッシュ ディレクトリの文字列パスを返します。

ディレクトリを見つけるために使用される手順は、代わりに$XDG_CACHE_HOME/を使用することを除いて、_get_config_dir の場合と同じです。$HOME/.cache