matplotlib.patheffects#

パス エフェクトのクラスを定義します。パス エフェクトは、Text、 Line2DおよびでサポートされてPatchいます。

こちらもご覧ください

パス エフェクト ガイド

クラス matplotlib.patheffects. AbstractPathEffect (オフセット= (0.0, 0.0) ) [ソース] #

拠点:object

パス エフェクトの基本クラス。

サブクラスはメソッドをオーバーライドしdraw_pathて、エフェクト機能を追加する必要があります。

パラメータ:
オフセット(float、float)、デフォルト: (0, 0)

ポイント単位で測定された、パスに適用する (x, y) オフセット。

draw_path ( renderer , gc , tpath , affine , rgbFace = None ) [source] #

Derived はこのメソッドをオーバーライドする必要があります。matplotlib.backend_bases.RendererBase.draw_path() 引数は、最初の引数がレンダラーであることを除いて、 と同じです。

クラス matplotlib.patheffects. 通常(オフセット= (0.0, 0.0) ) [ソース] #

拠点:AbstractPathEffect

「アイデンティティ」PathEffect。

通常の PathEffect の唯一の目的は、特別なパス効果なしで元のアーティストを描画することです。

パラメータ:
オフセット(float、float)、デフォルト: (0, 0)

ポイント単位で測定された、パスに適用する (x, y) オフセット。

クラス matplotlib.patheffects. PathEffectRenderer ( path_effects , renderer ) [ソース] #

拠点:RendererBase

別のレンダラーを含む Renderer を実装します。

次に、このプロキシは描画呼び出しをインターセプトし、適切な AbstractPathEffect描画メソッドを呼び出します。

ノート

この RendererBase サブクラスですべてのメソッドがオーバーライドされているわけではありません。PathEffects 機能をさらに拡張するには、さらにメソッドを追加する必要がある場合があります。

パラメータ:
path_effects反復可能AbstractPathEffect

このレンダラーが表すパス効果。

レンダラーmatplotlib.backend_bases.RendererBaseサブクラス
copy_with_path_effect ( path_effects ) [ソース] #
draw_markers ( gc , marker_path , marker_trans , path , * args , ** kwargs ) [source] #

pathの各頂点 (制御点を除く)にマーカーを描画します。

基本 (フォールバック) 実装は、 を複数回呼び出しますdraw_path。バックエンドは、マーカーを一度だけ描画して複数回再利用するために、このメソッドをオーバーライドしたい場合があります。

パラメータ:
GCGraphicsContextBase

グラフィックス コンテキスト。

マーカートランスmatplotlib.transforms.Transform

マーカーに適用されるアフィン変換。

トランスmatplotlib.transforms.Transform

パスに適用されるアフィン変換。

draw_path ( gc , tpath ,アフィン, rgbFace = None ) [source] #

Path指定されたアフィン変換を使用してインスタンスを描画します。

draw_path_collection ( gc , master_transform , paths , * args , ** kwargs ) [source] #

パスのコレクションを描画します。

各パスはまずall_transforms ((3, 3) 行列のリスト) の対応するエントリによって変換され、次に master_transformによって変換されます。次に、 offset_transによって最初に変換された、offsetsの対応するエントリによって変換されます。

facecolors、edgecolors、linewidths、linestyles 、および antialiasedは、対応するプロパティを設定するリストです。

offset_positionは現在使用されていませんが、後方互換性のために引数が保持されています。

基本 (フォールバック) 実装は、 を複数回呼び出しますdraw_path。バックエンドは、パス データの各セットを 1 回だけレンダリングし、そのパスをさまざまなオフセット、色、スタイルなどで複数回参照するために、これをオーバーライドすることができます。ジェネレーター メソッド _iter_collection_raw_pathsと_iter_collectionは、実装を支援 (および標準化) するために提供されています。バックエンド全体。draw_path_collectionの動作をグローバルに変更できるように、これらのジェネレータを使用することを強くお勧めします。

クラス matplotlib.patheffects. PathPatchEffect (オフセット= (0, 0) , ** kwargs ) [ソース] #

拠点:AbstractPathEffect

PathPatch元の PathEffect アーティストに由来する Path を持つインスタンスを描画します。

パラメータ:
オフセット(float、float)、デフォルト: (0, 0)

パスに適用する (x, y) オフセット (ポイント単位)。

**kwargs

PathPatchすべてのキーワード引数はコンストラクターに渡さ れます。オーバーライドできないプロパティは、"path"、"clip_box"、"transform"、"clip_path" です。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

Derived はこのメソッドをオーバーライドする必要があります。matplotlib.backend_bases.RendererBase.draw_path() 引数は、最初の引数がレンダラーであることを除いて、 と同じです。

クラス matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs ) [source] #

拠点:AbstractPathEffect

線による単純な影。

パラメータ:
オフセット(float、float)、デフォルト: (2, -2)

パスに適用する (x, y) オフセット (ポイント単位)。

shadow_color色、デフォルト: '黒'

影の色。の値Noneは、元のアーティストの色を縮尺係数rhoで取得します。

アルファフロート、デフォルト: 0.3

作成されたシャドウ パッチのアルファ透明度。

ローフロート、デフォルト: 0.3

shadow_color がの場合に rgbFace カラーに適用する倍率None。

**kwargs

追加のキーワードが保存され、 に渡され AbstractPathEffect._update_gc()ます。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

標準の draw_path をオーバーライドして、影のオフセットと必要な色の変更を追加します。

クラス matplotlib.patheffects. SimplePatchShadow (オフセット= (2, -2) , shadow_rgbFace =なし,アルファ=なし,ロー= 0.3 , ** kwargs ) [ソース] #

拠点:AbstractPathEffect

塗りつぶされたパッチによる単純な影。

パラメータ:
オフセット(float、float)、デフォルト: (2, -2)

ポイント単位の影の (x, y) オフセット。

shadow_rgbフェイスカラー

影の色。

アルファフロート、デフォルト: 0.3

作成されたシャドウ パッチのアルファ透明度。

ローフロート、デフォルト: 0.3

shadow_rgbFaceが指定されていない場合に、rgbFace カラーに適用する倍率 。

**kwargs

追加のキーワードが保存され、 に渡され AbstractPathEffect._update_gc()ます。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

標準の draw_path をオーバーライドして、影のオフセットと必要な色の変更を追加します。

クラス matplotlib.patheffects. ストローク(オフセット= (0, 0) , ** kwargs ) [ソース] #

拠点:AbstractPathEffect

ストロークを再描画する線ベースの PathEffect。

パスは、与えられたキーワード引数で更新された gc でストロークされます。つまり、キーワード引数は有効な gc パラメータ値でなければなりません。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

更新された gc でパスを描画します。

クラス matplotlib.patheffects. TickedStroke (オフセット= (0, 0)、間隔= 10.0、角度= 45.0、長さ= 1.4142135623730951、 ** kwargs ) [ソース] #

拠点:AbstractPathEffect

チェックされたスタイルでパスを描画する線ベースの PathEffect。

この線のスタイルは、最適化における制約を表すためによく使用されます。ティックは、ラインの片側が無効であることを示したり、ドメインの閉じた境界 (つまり、壁やパイプの端) を表すために使用できます。

目盛りの間隔、長さ、および角度を制御できます。

この線のスタイルは、斜線と呼ばれることもあります。

輪郭デモの例も参照してください。

最適化の例 の輪郭も参照してください。

パラメータ:
オフセット(float、float)、デフォルト: (0, 0)

パスに適用する (x, y) オフセット (ポイント単位)。

間隔フロート、デフォルト: 10.0

ポイント単位の目盛り間の間隔。

角度フロート、デフォルト: 45.0

パスとティックの間の角度 (度単位)。角度は、曲線に沿って歩くアリのように測定されます。0 度は真正面、90 度は左、90 度は右、180 度は後ろを指します。

長さ浮動小数点数、デフォルト: 1.414

間隔に対する目盛りの長さ。angle=45 の場合、推奨される長さ = 1.414 (sqrt(2))、angle=90 の場合、length=1.0、angle=60 の場合、length=2.0 です。

**kwargs

追加のキーワードが保存され、 に渡され AbstractPathEffect._update_gc()ます。

例

TickedStroke パス効果を参照してください。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

更新された gc でパスを描画します。

クラス matplotlib.patheffects. withSimplePatchShadow (オフセット= (2, -2) , shadow_rgbFace =なし,アルファ=なし,ロー= 0.3 , ** kwargs ) [ソース] #

拠点:SimplePatchShadow

元のアーティストを適用して描画するためのショートカット PathEffect SimplePatchShadow。

このクラスでは、使用できます

artist.set_path_effects([path_effects.withSimplePatchShadow()])

のショートカットとして

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])
パラメータ:
オフセット(float、float)、デフォルト: (2, -2)

ポイント単位の影の (x, y) オフセット。

shadow_rgbフェイスカラー

影の色。

アルファフロート、デフォルト: 0.3

作成されたシャドウ パッチのアルファ透明度。

ローフロート、デフォルト: 0.3

shadow_rgbFaceが指定されていない場合に、rgbFace カラーに適用する倍率 。

**kwargs

追加のキーワードが保存され、 に渡され AbstractPathEffect._update_gc()ます。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

標準の draw_path をオーバーライドして、影のオフセットと必要な色の変更を追加します。

クラス matplotlib.patheffects. withStroke (オフセット= (0, 0) , ** kwargs ) [ソース] #

拠点:Stroke

元のアーティストを適用して描画するためのショートカット PathEffect Stroke。

このクラスでは、使用できます

artist.set_path_effects([path_effects.withStroke()])

のショートカットとして

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

パスは、与えられたキーワード引数で更新された gc でストロークされます。つまり、キーワード引数は有効な gc パラメータ値でなければなりません。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

更新された gc でパスを描画します。

クラス matplotlib.patheffects. withTickedStroke (オフセット= (0, 0)、間隔= 10.0、角度= 45.0、長さ= 1.4142135623730951、 ** kwargs ) [ソース] #

拠点:TickedStroke

元のアーティストを適用して描画するためのショートカット PathEffect TickedStroke。

このクラスでは、使用できます

artist.set_path_effects([path_effects.withTickedStroke()])

のショートカットとして

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])
パラメータ:
オフセット(float、float)、デフォルト: (0, 0)

パスに適用する (x, y) オフセット (ポイント単位)。

間隔フロート、デフォルト: 10.0

ポイント単位の目盛り間の間隔。

角度フロート、デフォルト: 45.0

パスとティックの間の角度 (度単位)。角度は、曲線に沿って歩くアリのように測定されます。0 度は真正面、90 度は左、90 度は右、180 度は後ろを指します。

長さ浮動小数点数、デフォルト: 1.414

間隔に対する目盛りの長さ。angle=45 の場合、推奨される長さ = 1.414 (sqrt(2))、angle=90 の場合、length=1.0、angle=60 の場合、length=2.0 です。

**kwargs

追加のキーワードが保存され、 に渡され AbstractPathEffect._update_gc()ます。

例

TickedStroke パス効果を参照してください。

draw_path ( renderer , gc , tpath , affine , rgbFace ) [source] #

更新された gc でパスを描画します。