mpl_toolkits.mplot3d.axes3d.Axes3D #

クラス mpl_toolkits.mplot3d.axes3d. Axes3D ( fig、 rect =なし、 * args、 elev = 30、 azim = -60、 roll = 0、 sharez =なし、 proj_type = 'persp'、 box_aspect =なし、 computed_zorder = True、 focus_length =なし、 ** kwargs ) [ソース] #

拠点:Axes

3D 軸オブジェクト。

パラメータ:

図図

親フィギュア。

rectタプル (左、下、幅、高さ)、デフォルト: なし。

軸の位置。(left, bottom, width, height)

高さフロート、デフォルト: 30

度単位の仰角は、カメラを xy 平面の上下に回転させます。正の角度は、平面の上の位置に対応します。

アジムフロート、デフォルト: -60

度単位の方位角は、z 軸を中心にカメラを回転させます。正の角度は右手の回転に対応します。つまり、正の方位角は、原点を中心に +x 軸に沿った位置から +y 軸に向かってカメラを回転させます。

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

ロール角度 (度単位) は、ビュー軸を中心にカメラを回転させます。正の角度はカメラを時計回りに回転させ、シーンを反時計回りに回転させます。

sharez Axes3D、オプション

Z 制限を共有する他の軸。

proj_type {'persp', 'ortho'}

投影タイプ、デフォルトは 'persp' です。

box_aspect floatの 3 タプル、デフォルト: なし

表示単位での軸の長さの比率が x:y:z になるように、Axes3D の物理的な寸法を変更します。なしの場合、デフォルトは 4:4:3 です

計算された_zorder bool、デフォルト: True

ArtistTrue の場合、ビュー方向に沿ったの平均位置に基づいて描画順序が計算されます。zorder 属性を使用して、アーティストが互いの上に描画される順序を手動で制御する場合は、False に設定します。これは、自動順序付けで目的の結果が得られない場合の微調整に使用できます。ただし、手動の zorder は限られた視野角に対してのみ正しいことに注意してください。ユーザーが Figure を回転させると、特定の角度からは正しく見えなくなります。

auto_add_to_figure bool、デフォルト: False

Matplotlib 3.4 より前は、Axes3D は init でホスト Figure に自分自身を追加していました。他の Axes クラスはこれを行いません。

この動作は 3.4 で非推奨になり、デフォルトは 3.6 で False に変更されました。キーワードは文書化されず、False 以外の値は 3.7 でエラーになります。

focus_length float、デフォルト: なし

'persp' の投影タイプの場合、仮想カメラの焦点距離。> 0 である必要があります。None の場合、デフォルトは 1 です。投影タイプが「ortho」の場合は、None または無限大 (numpy.inf) に設定する必要があります。None の場合、デフォルトは無限大です。焦点距離は、次の式を使用して、目的の視野から計算できます。focal_length = 1/tan(FOV/2)

**kwargs

その他のオプションのキーワード引数:

財産	説明
`adjustable`	{'ボックス', 'データリム'}
`agg_filter`	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
`alpha`	スカラーまたはなし
`anchor`	(float, float) または {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	ブール
`aspect`	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
`autoscale_on`	ブール
`autoscalex_on`	わからない
`autoscaley_on`	わからない
`autoscalez_on`	わからない
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	ブールまたは「行」
`box_aspect`	float の 3 タプルまたはなし
`clip_box`	`Bbox`
`clip_on`	ブール
`clip_path`	パッチまたは (パス、変換) またはなし
`facecolor`またはfc	色
`figure`	`Figure`
`frame_on`	ブール
`gid`	力
`in_layout`	ブール
`label`	物体
`mouseover`	ブール
`navigate`	ブール
`navigate_mode`	わからない
`path_effects`	`AbstractPathEffect`
`picker`	None または bool または float または callable
`position`	[左、下、幅、高さ] または`Bbox`
`proj_type`	{'パース', 'オルソ'}
`prop_cycle`	わからない
`rasterization_zorder`	float または None
`rasterized`	ブール
`sketch_params`	(位取り: float、長さ: float、乱数: float)
`snap`	ブールまたはなし
`title`	わからない
`transform`	`Transform`
`url`	力
`visible`	ブール
`xbound`	わからない
`xlabel`	力
`xlim`またはxlim3d	（下：浮き、上：浮き）
`xlim3d`	（下：浮き、上：浮き）
`xmargin`	-0.5 より大きい float
`xscale`	わからない
`xticklabels`	わからない
`xticks`	わからない
`ybound`	わからない
`ylabel`	力
`ylim`またはylim3d	（下：浮き、上：浮き）
`ylim3d`	（下：浮き、上：浮き）
`ymargin`	-0.5 より大きい float
`yscale`	わからない
`yticklabels`	わからない
`yticks`	わからない
`zbound`	わからない
`zlabel`	わからない
`zlim`またはzlim3d	わからない
`zmargin`	-0.5 より大きい float
`zorder`	浮く
`zscale`	わからない
`zticklabels`	わからない
`zticks`	わからない

add_collection3d ( col , zs = 0 , zdir = 'z' ) [ソース] #

3D コレクションオブジェクトをプロットに追加します。

2D コレクションタイプは、オブジェクトを変更して z 座標情報を追加することにより、3D バージョンに変換されます。

サポートされているのは次のとおりです。

ポリコレクション
ラインコレクション
パッチコレクション

add_contour_set ( cset、 extend3d = False、 stride = 5、 zdir = 'z'、 offset = None ) [source] #

add_contourf_set ( cset , zdir = 'z' ,オフセット=なし) [ソース] #

apply_aspect ( position = None ) [source] #

指定されたデータの縦横比の軸を調整します。

これに応じてget_adjustable、軸ボックス (位置) またはビュー制限が変更されます。前者の場合、 get_anchor位置に影響します。

パラメータ:

位置None または .Bbox: そうでない場合None、これは Figure 内の Axes の位置を Bbox として定義します。詳細については、を参照get_position してください。

こちらもご覧ください

matplotlib.axes.Axes.set_aspect: 縦横比の扱いについて説明します。
matplotlib.axes.Axes.set_adjustable: 必要な縦横比を実現するために軸を調整する方法を設定します。
matplotlib.axes.Axes.set_anchor: 余分なスペースがある場合は位置を設定します。

ノート

これは、各軸が描画されるときに自動的に呼び出されます。Figure を描画する前に Axes の位置やビューの制限を更新する必要がある場合は、自分で呼び出す必要がある場合があります。

auto_scale_xyz ( X , Y , Z =なし, had_data =なし) [source] #

autoscale ( enable = True , axis = 'both' , tight = None ) [source] #

単純な軸ビューの自動スケーリングの便利な方法。

Axes.autoscale完全なドキュメントについては、を参照してください。この関数は 3D 軸に適用されるため、軸を「z」に設定することもできます。軸を「両方」に設定すると、3 つの軸すべてが自動スケーリングされます。

autoscale_view ( tight =なし, scalex = True , scaley = True , scalez = True ) [source] #

データ制限を使用してビュー制限を自動スケーリングします。

Axes.autoscale_view完全なドキュメントについては、を参照してください。この関数は 3D Axes に適用されるため、scalez引数もとります。

bar ( left , height , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs ) [source] #

2D バーを追加します。

パラメータ:

左1D 配列のような: バーの左側の x 座標。
高さ1D 配列のようなもの: バーの高さ。
zs float または 1D 配列のようなもの: バーの Z 座標。単一の値が指定されている場合は、すべてのバーに使用されます。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 2D データをプロットするとき、z として使用する方向 ('x'、'y' または 'z')。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.barます。

戻り値:

mpl_toolkits.mplot3d.art3d.Patch3DCollection

bar3d ( x , y , z , dx , dy , dz , color = None , zsort = 'average' , shade = True , lightsource = None , * args , data = None , ** kwargs ) [source] #

3D バープロットを生成します。

このメソッドは、棒の幅、深さ、高さ、および色をすべて一意に設定できる 3 次元の棒グラフを作成します。

パラメータ:

x、y、z配列のようなもの

バーのアンカーポイントの座標。

dx、dy、dz float または配列のようなもの

それぞれバーの幅、深さ、高さ。

色の色シーケンス、オプション

バーの色は、全体または個別に指定できます。このパラメーターは次のいずれかです。

単一の色。すべてのバーを同じ色にします。
長さ N バーの色の配列で、各バーを個別に色付けします。
長さ 6 の色の配列で、バーの面を同様に色付けします。
各面を個別に色付けするための長さ 6 * N バーの色の配列。

ボックスの面を具体的に色付けする場合、これは色付けの順序です。

-Z (箱の底)
+Z (ボックスの上部)
-Y
+Y
-バツ
+X

zsort文字列、オプション

渡された z 軸の並べ替えスキームPoly3DCollection

シェードブール、デフォルト: True

true の場合、これはバーの暗い側を (プロットの光源に対して) シェーディングします。

光源LightSource

shadeが Trueの場合に使用する光源。

データのインデックス可能なオブジェクト、オプション

指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]

**kwargs

追加のキーワード引数はに渡され Poly3DCollectionます。

戻り値:

コレクションPoly3DCollection: バーを表す 3 次元ポリゴンのコレクション。

can_pan ( ) [ソース] #

この Axes がパン/ズームボタンの機能をサポートするかどうかを返します。

Axes3d オブジェクトは、パン/ズームボタンを使用しません。

can_zoom ( ) [ソース] #

この Axes がズームボックスボタンの機能をサポートするかどうかを返します。

Axes3D オブジェクトは、ズームボックスボタンを使用しません。

clabel ( *引数, ** kwargs ) [ソース] #: 現在、3D 軸には実装されておらず、Noneを返します。

クリア( ) [ソース] #: 軸をクリアします。

輪郭( X、 Y、 Z、 * args、 extend3d = False、ストライド= 5、 zdir = 'z'、オフセット=なし、データ=なし、 ** kwargs ) [ソース] #

3D 等高線図を作成します。

パラメータ:

X、Y、Z配列のような、: 入力データ。Axes.contourサポートされているデータ形状については、を参照してください。
extend3d bool、デフォルト: False: 3D で輪郭を延長するかどうか。
ストライド整数: 輪郭を拡張するためのステップサイズ。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.contourます。

戻り値:

matplotlib.contour.QuadContourSet

contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #

3D 等高線図を作成します。

パラメータ:

X、Y、Z配列のような、: 入力データ。Axes.contourサポートされているデータ形状については、を参照してください。
extend3d bool、デフォルト: False: 3D で輪郭を延長するかどうか。
ストライド整数: 輪郭を拡張するためのステップサイズ。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.contourます。

戻り値:

matplotlib.contour.QuadContourSet

contourf ( X , Y , Z , * args , zdir = 'z' ,オフセット=なし,データ=なし, ** kwargs ) [source] #

3D 塗りつぶし等高線図を作成します。

パラメータ:

X、Y、Z配列のような: 入力データ。Axes.contourfサポートされているデータ形状については、を参照してください。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.contourfます。

戻り値:

matplotlib.contour.QuadContourSet

contourf3D ( X , Y , Z , * args , zdir = 'z' ,オフセット=なし,データ=なし, ** kwargs ) [source] #

3D 塗りつぶし等高線図を作成します。

パラメータ:

X、Y、Z配列のような: 入力データ。Axes.contourfサポートされているデータ形状については、を参照してください。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.contourfます。

戻り値:

matplotlib.contour.QuadContourSet

convert_zunits ( z ) [ソース] #: Axes 内のアーティストの場合、z 軸に単位がサポートされている場合は、 z 軸の単位タイプを使用してzを変換します

disable_mouse_rotation ( ) [ソース] #: 3D 回転とズームのマウスボタンを無効にします。

プロパティ dist [ソース] #

draw (レンダラー) [ソース] #

指定されたレンダラーを使用してアーティスト (およびその子) を描画します。

アーティストが表示されていない場合、これは効果がありません ( Artist.get_visible False を返します)。

パラメータ:

レンダラーRendererBaseのサブクラス。

ノート

このメソッドは Artist サブクラスでオーバーライドされます。

errorbar ( x , y , z , zerr =なし, yerr =なし, xerr =なし, fmt = '' , barsabove = False , errorevery = 1 , ecolor =なし, elinewidth =なし, capsize =なし, capthick =なし, xlolims = False , xuplims= False , ylolims = False , yuplims = False , zlolims = False , zuplims = False , * , data = None , ** kwargs ) [source] #

線やマーカーをエラーバーでプロットします。

x / y / zはデータの位置を定義し、xerr / yerr / zerrはエラーバーのサイズを定義します。デフォルトでは、データマーカー/ラインとエラーバーが描画されます。エラーバーのみを描画するには、fmt='none' を使用します。

パラメータ:

x、y、z float または配列のようなもの

データの位置。

xerr、yerr、zerr float または配列のような形状、形状 (N,) または (2, N)、オプション

エラーバーのサイズ:

スカラー: すべてのデータポイントの対称 +/- 値。
shape(N,): 各データポイントの対称 +/- 値。
shape(2, N): 各バーの - と + の値を分離します。最初の行には下位のエラーが含まれ、2 番目の行には上位のエラーが含まれます。
None : エラーバーはありません。

すべてのエラー配列は正の値を持つ必要があることに注意してください。

fmt str、デフォルト: ''

データポイント/データ行の形式。詳細plotについては、を参照してください。

データマーカーなしでエラーバーをプロットするには、'none' (大文字と小文字を区別しない) を使用します。

ecolorカラー、デフォルト: なし

エラーバーの線の色。なしの場合は、マーカーを結ぶ線の色を使用します。

elinewidth float、デフォルト: なし

エラーバーラインの線幅。None の場合、現在のスタイルの線幅が使用されます。

capsize float、デフォルト: rcParams["errorbar.capsize"](デフォルト: 0.0)

エラーバーの長さはポイント単位でキャップされます。

capthick float、デフォルト: なし

キーワード引数markeredgewidth (別名mew ) のエイリアス。この設定は、エラーバーキャップの太さをポイント単位で制御するプロパティのより適切な名前です。下位互換性のために、mewまたはmarkeredgewidthが指定されている場合、それらはcapthickをオーバーライドします。これは、将来のリリースで変更される可能性があります。

barsabove bool、デフォルト: False

True の場合、プロットシンボルの上にエラーバーをプロットします。デフォルトは以下。

xlolims、ylolims、zlolims bool、デフォルト: False

これらの引数は、値が下限のみを示すことを示すために使用できます。その場合、これを示すためにキャレット記号が使用されます。lims -arguments は、スカラー、またはエラーと同じ長さの配列のようなものです。反転した軸で制限を使用するには、 set_xlimまたはのset_ylim前に呼び出す必要があります errorbar。トリッキーなパラメーター名に注意してください。たとえば、 ylolimsを True に設定すると、y 値がTrue 値の下限になるため、上向きの矢印のみが描画されます。

xuplims、yuplims、zuplims bool、デフォルト: False

上記と同じですが、上限を制御するためのものです。

errorevery int または (int, int)、デフォルト: 1

データのサブセットにエラーバーを描画します。errorevery =N は、点 (x[::N]、y[::N]、z[::N]) にエラーバーを描画します。 errorevery =(start, N) は点 (x[start::N]、y[start::N]、z[start::N]) にエラーバーを描画します。たとえば、errorevery=(6, 3) は、(x[6]、x[9]、x[12]、x[15]、...) のデータにエラーバーを追加します。2 つの系列が x 軸の値を共有する場合に、誤差範囲が重ならないようにするために使用されます。

戻り値:

エラー行リスト: Line3DCollectionそれぞれエラーバー行を含むインスタンスのリスト。
キャプラインリスト: Line3Dcapline オブジェクトを含むインスタンスのリスト。
リムマークリスト: Line3D上限または下限のあるマーカーを含むインスタンスのリスト。

その他のパラメータ:

データのインデックス可能なオブジェクト、オプション

指定された場合、次のパラメーターは string も受け入れますs。これは、次のように解釈されますdata[s](例外が発生しない限り)。

x、y、z、xerr、yerr、zerr

**kwargs

エラーバーの行をスタイリングするための他のすべてのキーワード引数が渡され Line3DCollectionます。

例

(ソースコード、png )

format_coord ( xd , yd ) [ソース] #: 2D ビュー座標を指定して、3D 座標を推測しようとします。ポイントに最も近いエッジを探し、そのポイントがエッジ上の最も近いポイントと同じ z 位置にあると想定します。

format_zdata ( z ) [ソース] #: フォーマットされたz文字列を返します。この関数は、 fmt_zdata呼び出し可能な場合は属性を使用し、それ以外の場合は zaxis メジャーフォーマッタにフォールバックします。

get_autoscalez_on ( ) [ソース] #: zaxis が自動スケーリングされているかどうかを返します。

get_axis_position ( ) [ソース] #

get_frame_on ( ) [ソース] #: 3D 軸パネルが描画されているかどうかを取得します。

get_proj ( ) [ソース] #: 現在の表示位置から射影行列を作成します。

get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False ) [source] #

軸とそのデコレータ (xlabel、タイトルなど) を含む、Axes のタイトなバウンディングボックスを返します。

持っているアーティストartist.set_in_layout(False)は bbox に含まれていません。

パラメータ:

レンダラーRendererBaseサブクラス: 図形の描画に使用されるレンダラー (つまり fig.canvas.get_renderer())
またはのbbox_extra_artistsリストArtistNone: タイトなバウンディングボックスに含めるアーティストのリスト。(デフォルト) の場合 None、Axes のすべてのアーティストの子がタイトなバウンディングボックスに含まれます。
call_axes_locator bool、デフォルト: True: call_axes_locatorがの場合、正しいバウンディングボックスを取得するために必要な属性をFalse呼び出しません。呼び出し元が Axes bbox と比較した tightbbox の相対的なサイズのみに関心がある場合に使用できます。_axes_locatorcall_axes_locator=False
for_layout_onlyデフォルト: False: 境界ボックスには、タイトルと xlabel の x 範囲、または ylabel の y 範囲は含まれません。

戻り値:

BboxBase: Figure のピクセル座標の境界ボックス。

こちらもご覧ください

matplotlib.axes.Axes.get_window_extent
matplotlib.axis.Axis.get_tightbbox
matplotlib.spines.Spine.get_window_extent

get_w_lims ( ) [ソース] #: 3D ワールドの制限を取得します。

get_xlim ( ) [ソース] #

x 軸のビュー範囲を返します。

戻り値:

左、右(フロート、フロート): データ座標における現在の x 軸の範囲。

こちらもご覧ください

Axes.set_xlim
set_xbound、get_xbound
invert_xaxis、xaxis_inverted

ノート

X 軸は反転する場合があり、その場合、左の値が右の値よりも大きくなります。

get_xlim3d ( ) [ソース] #: のエイリアスget_xlim。

get_ylim ( ) [ソース] #

y 軸のビュー範囲を返します。

戻り値:

ボトム、トップ(フロート、フロート): データ座標における現在の y 軸の範囲。

こちらもご覧ください

Axes.set_ylim
set_ybound、get_ybound
invert_yaxis、yaxis_inverted

ノート

y 軸は反転する場合があり、その場合、下の値が上の値よりも大きくなります。

get_ylim3d ( ) [ソース] #: のエイリアスget_ylim。

get_zaxis ( ) [ソース] #: ZAxis( Axis) インスタンスを返します。

get_zbound ( ) [ソース] #: z 軸の下限と上限を昇順で返します。

get_zgridlines ( ) [ソース] #: zaxis のグリッド線をのリストとして返しLine2Dます。

get_zlabel ( ) [ソース] #: z ラベルのテキスト文字列を取得します。

get_zlim ( ) [ソース] #: 3D z 制限を取得します。

get_zlim3d ( ) [ソース] #: のエイリアスget_zlim。

get_zmajorticklabels ( ) [ソース] #: zaxis の主目盛ラベルをのリストとして返しTextます。

get_zminorticklabels ( ) [ソース] #: zaxis の小目盛ラベルをのリストとして返しTextます。

get_zscale ( ) [ソース] #: zaxis のスケールを (str として) 返します。

get_zticklabels (マイナー= False , which = None ) [source] #

zaxis の目盛りラベルを取得します。

パラメータ:

マイナーブール

小目盛りラベルまたは大目盛りラベルを返すかどうか。

なし、(「マイナー」、「メジャー」、「両方」)

マイナーをオーバーライドします。

返す目盛ラベルを選択します

戻り値:

のリストText

get_zticklines (マイナー= False ) [ソース] #: zaxis の目盛り線をのリストとして返しLine2Dます。

get_zticks ( * ,マイナー= False ) [ソース] #

データ座標で zaxis の目盛りの位置を返します。

位置は現在の軸の制限にクリップされないため、出力に表示されない位置が含まれる場合があります。

パラメータ:

マイナーブール値、デフォルト: False: マイナーティックの方向を返す場合は True、メジャーティックの方向を返す場合は False。

戻り値:

目盛り位置のnumpy配列

grid ( visible = True , ** kwargs ) [source] #: 3D グリッドを設定/設定解除します。

ノート

現在、この関数はと同じようには動作しませんが、 axes.Axes.grid最終的にはその動作をサポートする予定です。

invert_zaxis ( ) [ソース] #: z 軸を反転します。

margins ( * margins , x = None , y = None , z = None , Tight = True ) [source] #

自動スケーリングのマージンを設定または取得します。

Axes.margins完全なドキュメントについては、を参照してください。この関数は 3D 軸に適用されるため、z引数も取り、を返します。(xmargin, ymargin, zmargin)

mouse_init ( rotate_btn = 1 , zoom_btn = 3 ) [ソース] #

3D 回転とズームのマウスボタンを設定します。

パラメータ:

rotate_btn int または int のリスト、デフォルト: 1: 軸の 3D 回転に使用するマウスボタン。
zoom_btn int または int のリスト、デフォルト: 3: 3D 軸のズームに使用するマウスボタン。

名前= '3d' #

plot ( xs , ys , * args , zdir = 'z' , ** kwargs ) [source] #

2D または 3D データをプロットします。

パラメータ:

xs 1D 配列のようなもの: 頂点の x 座標。
ys 1D 配列のような: 頂点の y 座標。
zs float または 1D 配列のようなもの: 頂点の z 座標。すべてのポイントに 1 つ、または各ポイントに 1 つ。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 2D データをプロットするとき、z として使用する方向 ('x'、'y' または 'z')。
**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.plotます。

plot3D ( xs , ys , * args , zdir = 'z' , ** kwargs ) [source] #

2D または 3D データをプロットします。

パラメータ:

xs 1D 配列のようなもの: 頂点の x 座標。
ys 1D 配列のような: 頂点の y 座標。
zs float または 1D 配列のようなもの: 頂点の z 座標。すべてのポイントに 1 つ、または各ポイントに 1 つ。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 2D データをプロットするとき、z として使用する方向 ('x'、'y' または 'z')。
**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.plotます。

plot_surface ( X , Y , Z , * , norm =なし, vmin =なし, vmax =なし, lightsource =なし, ** kwargs ) [source] #

表面プロットを作成します。

デフォルトでは単色の色合いで色付けされますが、cmap引数を指定することでカラーマッピングもサポートします。

ノート

rcountおよびccount kwargsは、どちらもデフォルトで 50 に設定されており、各方向で使用されるサンプルの最大数を決定します。入力データがこれよりも大きい場合は、(スライスによって) これらのポイント数にダウンサンプリングされます。

ノート

レンダリング速度を最大化するには、 rstrideとcstride をそれぞれ行数から 1 を引いた数と列数から 1 を引いた数の約数に設定することを検討してください。たとえば、51 行が与えられた場合、rstride は 50 の任意の約数になります。

同様に、rstrideとcstrideを 1 (または rcountとccountを行と列の数に等しい) に設定すると、最適化されたパスを使用できます。

パラメータ:

X、Y、Z 2D 配列

データ値。

rcount、アカウントint

各方向で使用されるサンプルの最大数。入力データがこれよりも大きい場合は、(スライスによって) これらのポイント数にダウンサンプリングされます。デフォルトは 50 です。

rstride、cstride int

各方向のダウンサンプリングストライド。これらの引数は、rcountおよびccountと相互に排他的です。rstrideまたはcstrideの一方のみが設定されている場合、もう一方はデフォルトで 10 に設定されます。

「クラシック」モードでは、新しいデフォルトのの代わりにデフォルトのが使用されます。rstride = cstride = 10rcount = ccount = 50

色っぽい_

表面パッチの色。

cmapカラーマップ

表面パッチのカラーマップ。

facecolors配列のような色。

個々のパッチの色。

ノーマライズ_

カラーマップの正規化。

vmin、vmaxフロート

正規化の境界。

シェードブール、デフォルト: True

面の色をシェーディングするかどうか。cmapが指定されている場合、シェーディングは常に無効になります。

光源LightSource

shadeが Trueの場合に使用する光源。

**kwargs

他の引数はに転送されPoly3DCollectionます。

plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs ) [source] #

三角形化された表面をプロットします。

(オプションの) 三角形分割は、2 つの方法のいずれかで指定できます。また：

plot_trisurf(triangulation, ...)

ここで、三角形分割はTriangulationオブジェクトです。または:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

この場合、Triangulation オブジェクトが作成されます。Triangulationこれらの可能性の説明については、を参照してください。

残りの引数は次のとおりです。

plot_trisurf(..., Z)

ここで、Zは輪郭を描く値の配列で、三角形分割のポイントごとに 1 つです。

パラメータ:

X、Y、Z配列のような: 1D 配列としてのデータ値。
色: 表面パッチの色。
cmap: 表面パッチのカラーマップ。
ノーマライズ_: 値を色にマップする Normalize のインスタンス。
vmin、vmax float、デフォルト: なし: マップする最小値と最大値。
シェードブール、デフォルト: True: 面の色をシェーディングするかどうか。cmapが指定されている場合、シェーディングは常に無効になります。
光源LightSource: shadeが Trueの場合に使用する光源。
**kwargs: 他のすべての引数はに渡されます Poly3DCollection

例

(ソースコード、png )

(ソースコード、png )

plot_wireframe ( X , Y , Z , ** kwargs ) [ソース] #

3D ワイヤーフレームをプロットします。

ノート

パラメータ:

X、Y、Z 2D 配列

データ値。

rcount、アカウントint

各方向で使用されるサンプルの最大数。入力データがこれよりも大きい場合は、(スライスによって) これらのポイント数にダウンサンプリングされます。カウントをゼロに設定すると、対応する方向でデータがサンプリングされず、ワイヤフレームプロットではなく 3D ラインプロットが生成されます。デフォルトは 50 です。

rstride、cstride int

各方向のダウンサンプリングストライド。これらの引数は、rcountおよびccountと相互に排他的です。rstrideまたはcstrideの一方のみが設定されている場合、もう一方のデフォルトは 1 です。ストライドを 0 に設定すると、対応する方向でデータがサンプリングされず、ワイヤフレームプロットではなく 3D ラインプロットが生成されます。

「クラシック」モードでは、新しいデフォルトのの代わりにデフォルトのが使用されます。rstride = cstride = 1rcount = ccount = 50

**kwargs

他の引数はに転送されLine3DCollectionます。

quiver ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [source] #

矢印の 3D フィールドをプロットします。

引数は、一緒にブロードキャストできる限り、配列のようなものでもスカラーでもかまいません。引数は、マスクされた配列にすることもできます。いずれかの引数の要素がマスクされている場合、対応する矢筒要素はプロットされません。

パラメータ:

X、Y、Z配列のような: 矢印の位置の x、y、z 座標 (デフォルトは矢印の尾部です。ピボットkwarg を参照してください)。
U、V、W配列のような: 矢印ベクトルの x、y、および z コンポーネント。
長さ浮動小数点数、デフォルト: 1: 各矢筒の長さ。
arrow_length_ratio float、デフォルト: 0.3: 矢筒に対する矢じりの比率。
ピボット{'尾', '中', '先端'}, デフォルト: '尾': グリッドポイントにある矢印の部分。矢印はこの点を中心に回転するため、名前はpivotです。
正規化ブール値、デフォルト: False: すべての矢印が同じ長さになるように正規化されるか、u、v、およびwで定義された長さを維持するか。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
**kwargs: 追加のキーワード引数はすべてに委任されます LineCollection

quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [source] #

矢印の 3D フィールドをプロットします。

パラメータ:

X、Y、Z配列のような: 矢印の位置の x、y、z 座標 (デフォルトは矢印の尾部です。ピボットkwarg を参照してください)。
U、V、W配列のような: 矢印ベクトルの x、y、および z コンポーネント。
長さ浮動小数点数、デフォルト: 1: 各矢筒の長さ。
arrow_length_ratio float、デフォルト: 0.3: 矢筒に対する矢じりの比率。
ピボット{'尾', '中', '先端'}, デフォルト: '尾': グリッドポイントにある矢印の部分。矢印はこの点を中心に回転するため、名前はpivotです。
正規化ブール値、デフォルト: False: すべての矢印が同じ長さになるように正規化されるか、u、v、およびwで定義された長さを維持するか。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
**kwargs: 追加のキーワード引数はすべてに委任されます LineCollection

scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [source] #

散布図を作成します。

パラメータ:

xs、ys配列のようなもの

データの位置。

zs float または array-like、デフォルト: 0

Z 位置。xsおよび ysと同じ長さの配列、またはすべての点を同じ平面に配置する単一の値。

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, デフォルト: 'z'

zsの軸方向。これは、2D データを 3D Axes にプロットする場合に便利です。データはxs、ysとして渡す必要があります。zdirを 'y' に設定すると、データが xz 平面にプロットされます。

2D データを 3D プロットにプロットするも参照してください。

s float または array-like、デフォルト: 20

ポイント単位のマーカーサイズ**2。xsおよびysと同じ長さの配列、またはすべてのマーカーを同じサイズにする単一の値。

c色、シーケンス、または色のシーケンス、オプション

マーカーの色。可能な値:

単一の色の書式文字列。
長さ n の色のシーケンス。
cmapと normを使用して色にマッピングされる n 個の数値のシーケンス。
行が RGB または RGBA である 2D 配列。

詳細については、のc引数を参照してくださいscatter。

depthshade bool、デフォルト: True

散布マーカーを陰影付けして深さを表現するかどうか。への各呼び出しscatter()は、その深度シェーディングを個別に実行します。

データのインデックス可能なオブジェクト、オプション

指定された場合、次のパラメーターは string も受け入れますs。これは、次のように解釈されますdata[s](例外が発生しない限り)。

xs、ys、zs、s、edgecolors、c、facecolor、facecolors、color

**kwargs

他のすべての引数はに渡されscatterます。

戻り値:

パスPathCollection

scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [source] #

散布図を作成します。

パラメータ:

xs、ys配列のようなもの

データの位置。

zs float または array-like、デフォルト: 0

Z 位置。xsおよび ysと同じ長さの配列、またはすべての点を同じ平面に配置する単一の値。

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, デフォルト: 'z'

2D データを 3D プロットにプロットするも参照してください。

s float または array-like、デフォルト: 20

ポイント単位のマーカーサイズ**2。xsおよびysと同じ長さの配列、またはすべてのマーカーを同じサイズにする単一の値。

c色、シーケンス、または色のシーケンス、オプション

マーカーの色。可能な値:

単一の色の書式文字列。
長さ n の色のシーケンス。
cmapと normを使用して色にマッピングされる n 個の数値のシーケンス。
行が RGB または RGBA である 2D 配列。

詳細については、のc引数を参照してくださいscatter。

depthshade bool、デフォルト: True

散布マーカーを陰影付けして深さを表現するかどうか。への各呼び出しscatter()は、その深度シェーディングを個別に実行します。

データのインデックス可能なオブジェクト、オプション

指定された場合、次のパラメーターは string も受け入れますs。これは、次のように解釈されますdata[s](例外が発生しない限り)。

xs、ys、zs、s、edgecolors、c、facecolor、facecolors、color

**kwargs

他のすべての引数はに渡されscatterます。

戻り値:

パスPathCollection

set ( *、 adjustable=<UNSET>、 agg_filter=<UNSET>、 alpha=<UNSET>、 anchor=< UNSET> 、 animate=<UNSET >、 aspect=<UNSET>、 autoscale_on=<UNSET>、 autoscalex_on=<UNSET >、 autoscaley_on=<UNSET>、 autoscalez_on=<UNSET>、 axes_locator=<UNSET>、 axisbelow=<UNSET>、 box_aspect=<UNSET>、 clip_box=<UNSET>、 clip_on=<UNSET>、 clip_path=<UNSET>、フェイスカラー=<UNSET> 、 frame_on=<UNSET>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , navigate=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , position=<UNSET> , proj_type =<UNSET> , prop_cycle=<UNSET > , rasterization_zorder=< UNSET > , rasterized=< UNSET> , sketch_params=<UNSET> , snap=<UNSET> , title=<UNSET> , transform=<UNSET> , url=< UNSET>、visible=<UNSET>, xbound=<UNSET> ,xlabel=<UNSET> , xlim=<UNSET> , xlim3d=<UNSET> , xmargin=<UNSET> , xscale=<UNSET> , xticklabels=<UNSET> , xticks=<UNSET> , ybound=<UNSET> , ylabel= <UNSET> , ylim=<UNSET> , ylim3d=<UNSET> , ymargin=<UNSET> , yscale=<UNSET> , yticklabels=<UNSET> , yticks=<UNSET> , zbound=<UNSET> , zlabel=<UNSET > , zlim=<UNSET> , zlim3d=<UNSET>, zmargin=<UNSET> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> ) [ソース] #

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産

説明

adjustable

{'ボックス', 'データリム'}

agg_filter

(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数

alpha

スカラーまたはなし

anchor

(float, float) または {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

ブール

aspect

{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

autoscale_on

ブール

autoscalex_on

わからない

autoscaley_on

わからない

autoscalez_on

わからない

axes_locator

Callable[[Axes, Renderer], Bbox]

axisbelow

ブールまたは「行」

box_aspect

float の 3 タプルまたはなし

clip_box

Bbox

clip_on

ブール

clip_path

パッチまたは (パス、変換) またはなし

facecolorまたはfc

色

figure

Figure

frame_on

ブール

gid

力

in_layout

ブール

label

物体

mouseover

ブール

navigate

ブール

navigate_mode

わからない

path_effects

AbstractPathEffect

picker

None または bool または float または callable

position

[左、下、幅、高さ] またはBbox

proj_type

{'パース', 'オルソ'}

prop_cycle

わからない

rasterization_zorder

float または None

rasterized

ブール

sketch_params

(位取り: float、長さ: float、乱数: float)

snap

ブールまたはなし

title

わからない

transform

Transform

url

力

visible

ブール

xbound

わからない

xlabel

力

xlim

（下：浮き、上：浮き）

xlim3d

（下：浮き、上：浮き）

xmargin

-0.5 より大きい float

xscale

わからない

xticklabels

わからない

xticks

わからない

ybound

わからない

ylabel

力

ylim

（下：浮き、上：浮き）

ylim3d

（下：浮き、上：浮き）

ymargin

-0.5 より大きい float

yscale

わからない

yticklabels

わからない

yticks

わからない

zbound

わからない

zlabel

わからない

zlim

わからない

zlim3d

わからない

zmargin

-0.5 より大きい float

zorder

浮く

zscale

わからない

zticklabels

わからない

zticks

わからない

set_aspect (アスペクト、調整可能=なし、アンカー=なし、共有= False ) [ソース] #

アスペクト比を設定します。

パラメータ:

アスペクト{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

可能な値:

価値	説明
「オート」	自動; 位置の四角形をデータで埋めます。
'同等'	すべての軸が同じ縦横比になるように調整します。
「等しい」	x 軸と y 軸の縦横比が等しくなるように調整します。
'equalxz'	x 軸と z 軸の縦横比が等しくなるように調整します。
'equalyz'	縦横比が等しくなるように y 軸と z 軸を調整します。

調整可能なし

現在、Axes3D では無視されています

Noneでない場合、これは、必要な側面を満たすために調整されるパラメーターを定義します。詳細については、を参照set_adjustableしてください。

anchor None または str または float の 2 タプル、オプション

Noneでない場合、縦横の制約により余分なスペースがある場合に Axes が描画される場所を定義します。アンカーを指定する最も一般的な方法は、基本方向の省略形です。

価値	説明
'C'	中央揃え
「SW」	左下隅
'S'	下端の真ん中
「SE」	右下隅
等

詳細については、を参照set_anchorしてください。

共有ブール値、デフォルト: False

の場合True、すべての共有軸に設定を適用します。

こちらもご覧ください

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscalez_on ( b ) [ソース] #

描画時またはによって z 軸を自動スケーリングするかどうかを設定し Axes.autoscale_viewます。

パラメータ:

ブール値

set_axis_off ( ) [ソース] #

x 軸と y 軸をオフにします。

これは、軸線、目盛り、目盛りラベル、グリッド、および軸ラベルに影響します。

set_axis_on ( ) [ソース] #

X 軸と Y 軸をオンにします。

これは、軸線、目盛り、目盛りラベル、グリッド、および軸ラベルに影響します。

set_box_aspect (アスペクト, * , zoom = 1 ) [source] #

軸ボックスのアスペクトを設定します。

ボックスの縦横比は、ボックスの各面に対して垂直に見たときの表示単位での高さと幅の比率です。これをデータアスペクト (Axes3D では常に「自動」) と混同しないでください。デフォルトの比率は 4:4:3 (x:y:z) です。

データ空間でアスペクトが等しいことをシミュレートするには、ボックスのアスペクトを各次元のデータ範囲と一致するように設定します。

zoomは、Figure 内の Axes3D の全体的なサイズを制御します。

パラメータ:

float のアスペクト3 タプルまたは None: 表示単位での軸の長さの比率が x:y:z になるように、Axes3D の物理的な寸法を変更します。None の場合、デフォルトは (4,4,3) です。
ズームフロート、デフォルト: 1: Figure 内の Axes3D の全体的なサイズを制御します。> 0 でなければなりません。

set_frame_on ( b ) [ソース] #

3D 軸パネルを描画するかどうかを設定します。

パラメータ:

ブール値

set_proj_type ( proj_type , focus_length = None ) [ソース] #

投影タイプを設定します。

パラメータ:

proj_type {'persp', 'ortho'}: 投影タイプ。
focus_length float、デフォルト: なし: 'persp' の投影タイプの場合、仮想カメラの焦点距離。> 0 でなければなりません。None の場合、デフォルトは 1 です。焦点距離は、次の式を使用して目的の視野から計算できます。focal_length = 1/tan(FOV/2)

set_title ( label , fontdict = None , loc = 'center' , ** kwargs ) [source] #

軸のタイトルを設定します。

利用可能な 3 つの Axes タイトルのいずれかを設定します。使用可能なタイトルは、中央の Axes の上、左端と同じ高さ、および右端と同じ高さで配置されます。

パラメータ:

ラベル文字列

タイトルに使用するテキスト

fontdict辞書

タイトルテキストの外観を制御する辞書。デフォルトのfontdictは次のとおりです。

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc {'center', 'left', 'right'}, デフォルト: rcParams["axes.titlelocation"](デフォルト: 'center')

どのタイトルを設定するか。

y float、デフォルト: rcParams["axes.titley"](デフォルト: None)

タイトルの垂直軸の位置 (1.0 が上)。None (デフォルト) でrcParams["axes.titley"](デフォルト: None) も None の場合、y は Axes のデコレーターを避けるために自動的に決定されます。

パッドフロート、デフォルト: rcParams["axes.titlepad"](デフォルト: 6.0)

Axes の上部からのタイトルのオフセット (ポイント単位)。

戻り値:

Text: タイトルを表す matplotlib テキストインスタンス

その他のパラメータ:

**kwargsTextプロパティ: その他のキーワード引数はテキストプロパティTextです。有効なテキストプロパティのリストについては、を参照してください。

set_top_view ( ) [ソース] #

set_xlim3d (左=なし,右=なし, * ,放出=真,自動=偽, xmin =なし, xmax =なし) [ソース] #

X 軸の表示範囲を設定します。

パラメータ:

左フロート、オプション

データ座標の左 xlim。Noneを渡すと、制限は変更されません。

左と右の xlim は、タプル ( left、right ) として最初の位置引数 (またはleftキーワード引数)として渡すこともできます。

右フロート、オプション

データ座標の右の xlim。Noneを渡すと、制限は変更されません。

ブール値を発行、デフォルト: True

制限の変更をオブザーバーに通知するかどうか。

auto bool または None、デフォルト: False

x 軸の自動スケーリングをオンにするかどうか。True はオン、False はオフ、None は変更されません。

xmin、xmax float、オプション

これらはそれぞれ left と right に相当し、xminとleftまたはxmaxとrightの両方を渡すとエラーになります。

戻り値:

左、右(フロート、フロート): データ座標の新しい x 軸の範囲。

こちらもご覧ください

get_xlim
set_xbound、get_xbound
invert_xaxis、xaxis_inverted

ノート

左の値が右の値より大きい場合、x 軸の値は左から右に減少します。

例

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

1 つの制限は変更しないでおくことができます。

>>> set_xlim(right=right_lim)

x 軸の方向を反転するために、制限を逆の順序で渡すことができます。たとえば、xが現在までの年数を表しているとします。x 軸の範囲は次のように設定される可能性があるため、5000 年前はプロットの左側にあり、現在は右側にあります。

>>> set_xlim(5000, 0)

set_xscale (値, ** kwargs ) [ソース] #

X 軸のスケールを設定します。

パラメータ:

値{"線形"}: 適用する軸スケールタイプ。3D 軸は現在、線形スケールのみをサポートしています。他の尺度では無意味な結果が得られます。
**kwargs: キーワード引数は名目上スケールクラスに転送されますが、線形スケールには適用できません。

set_ylim3d (下=なし、上=なし、 *、出力=真、自動=偽、 ymin =なし、 ymax =なし) [source] #

Y 軸の表示範囲を設定します。

パラメータ:

ボトムフロート、オプション

データ座標の下の ylim。Noneを渡すと、制限は変更されません。

ボトムとトップの ylim は、タプル ( bottom、top ) として最初の位置引数 (またはbottomキーワード引数)として渡すこともできます。

トップフロート、オプション

データ座標の一番上の ylim。Noneを渡すと、制限は変更されません。

ブール値を発行、デフォルト: True

制限の変更をオブザーバーに通知するかどうか。

auto bool または None、デフォルト: False

y 軸の自動スケーリングをオンにするかどうか。Trueはオン、 Falseはオフ、Noneは変更されません。

ymin、ymax float、オプション

これらはそれぞれ bottom と top に相当し、yminとbottomまたはymaxとtopの両方を渡すとエラーになります。

戻り値:

ボトム、トップ(フロート、フロート): データ座標の新しい y 軸の範囲。

こちらもご覧ください

get_ylim
set_ybound、get_ybound
invert_yaxis、yaxis_inverted

ノート

下部の値が上部の値よりも大きい場合があります。その場合、y 軸の値は下部から上部に向かって減少します。

例

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

1 つの制限は変更しないでおくことができます。

>>> set_ylim(top=top_lim)

y 軸の方向を反転するために、制限を逆の順序で渡すことができます。たとえばy、海の深さを m で表しているとします。y 軸の範囲は次のように設定されるため、深さ 5000 m がプロットの下部にあり、表面 0 m が上部になります。

>>> set_ylim(5000, 0)

set_yscale (値, ** kwargs ) [ソース] #

y 軸のスケールを設定します。

パラメータ:

値{"線形"}: 適用する軸スケールタイプ。3D 軸は現在、線形スケールのみをサポートしています。他の尺度では無意味な結果が得られます。
**kwargs: キーワード引数は名目上スケールクラスに転送されますが、線形スケールには適用できません。

set_zbound (下=なし、上=なし) [ソース] #

z 軸の数値の下限と上限を設定します。

このメソッドは、パラメーターの順序に関係なく、軸の反転を受け入れます。自動スケーリングの設定は変更されません ( get_autoscalez_on())。

set_zlabel ( zlabel , fontdict =なし, labelpad =なし, ** kwargs ) [source] #: zlabel を設定します。説明については、ドキュメントを参照しset_ylabelてください。

set_zlim (下=なし、上=なし、 *、出力=真、自動=偽、 zmin =なし、 zmax =なし) [source] #

3D z 制限を設定します。

Axes.set_ylim完全なドキュメントについては、を参照してください

set_zlim3d (下=なし、上=なし、 *、出力=真、自動=偽、 zmin =なし、 zmax =なし) [ソース] #: のエイリアスset_zlim。

set_zmargin ( m ) [ソース] #

自動スケーリングの前に Z データ制限のパディングを設定します。

m回のデータ間隔が、自動スケーリングで使用される前に、その間隔の両端に追加されます。mが負の場合、これはデータ範囲を拡張する代わりにクリップします。

たとえば、データが [0, 2] の範囲にある場合、0.1 のマージンは [-0.2, 2.2] の範囲になります。-0.1 のマージンは [0.2, 1.8] の範囲になります。

パラメータ:

m float が -0.5 より大きい

set_zscale (値, ** kwargs ) [ソース] #

z 軸スケールを設定します。

パラメータ:

値{"線形"}: 適用する軸スケールタイプ。3D 軸は現在、線形スケールのみをサポートしています。他の尺度では無意味な結果が得られます。
**kwargs: キーワード引数は名目上スケールクラスに転送されますが、線形スケールには適用できません。

set_zticklabels ( labels , * , fontdict = None , minor = False , ** kwargs ) [source] #

文字列ラベルのリストで zaxis のラベルを設定します。

警告

このメソッドは、を使用して目盛りの位置を固定した後にのみ使用する必要がありますAxes3D.set_zticks。そうしないと、ラベルが予期しない位置に配置される可能性があります。

パラメータ:

str のラベルリスト

ラベルのテキスト。

fontdict dict、オプション

ticklabels の外観を制御するディクショナリ。デフォルトのfontdictは次のとおりです。

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

マイナーブール値、デフォルト: False

大目盛りではなく小目盛りを設定するかどうか。

戻り値:

のリストText: ラベル。

その他のパラメータ:

**kwargsTextプロパティ。

set_zticks ( ticks , labels = None , * , minor = False , ** kwargs ) [source] #

zaxis の目盛りの位置とオプションでラベルを設定します。

必要に応じて、指定されたすべての目盛りが表示されるように、軸のビュー制限が拡張されます。

パラメータ:

フロートのリスト

ティック位置のリスト。軸Locatorはに置き換えられ FixedLocatorます。

一部の目盛りフォーマッタは、任意の目盛り位置にラベルを付けません。たとえば、ログフォーマッタはデフォルトで 10 年の目盛りのみにラベルを付けます。このような場合、フォーマットされたラベルAxis.set_major_formatterを自分で使用するか、軸にフォーマッタを明示的に設定できます。

ラベルstr のリスト、オプション

目盛りラベルのリスト。設定されていない場合、ラベルは軸 tick で生成されFormatterます。

マイナーブール値、デフォルト: False

の場合False、主目盛りを設定します。の場合True、マイナーティック。

**kwargs

Textラベルのプロパティ。これらは、 labelsを渡した場合にのみ有効になります。それ以外の場合はをご利用くださいtick_params。

ノート

ビュー制限の必須の拡張は、目に見えない目盛りの驚きを防ぐための意図的な設計上の選択です。他の制限が必要な場合は、ティックを設定した後に制限を明示的に設定する必要があります。

sharez (その他) [source] #

z 軸を他のと共有します。

これは、Axes を構築するときに渡すことと同等sharex=otherであり、z 軸が既に別の Axes と共有されている場合は使用できません。

ステム( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , orientation = 'z' , data = None ) [ソース] #

3D ステムプロットを作成します。

ステムプロットは、ベースラインに垂直な線を描画し、マーカーを頭に配置します。デフォルトでは、ベースラインはxとyによって定義され、ステムは下からzまで垂直に描画されます。

パラメータ:

x、y、z配列のようなもの

茎の頭の位置。ステムは、( orientation -座標の)下部のベースラインから head まで、orientation -方向に沿って描画されます。デフォルトでは、xとyの位置がベースラインに使用され、zが頭の位置に使用されますが、これはorientationによって変更できます。

linefmt文字列、デフォルト: 'C0-'

垂直線のプロパティを定義する文字列。通常、これは色または色と線種になります。

キャラクター	線種
`'-'`	実線
`'--'`	破線
`'-.'`	一点鎖線
`':'`	点線

注: 色または色と線種 (たとえば、'rx' または '-.') 以外の有効な形式を指定することは技術的に可能ですが、これはメソッドの意図を超えており、妥当なプロットが得られない可能性が高くなります。

markerfmt文字列、デフォルト: 'C0o'

ステムヘッドのマーカーのプロパティを定義する文字列。

basefmt文字列、デフォルト: 'C3-'

ベースラインのプロパティを定義する書式文字列。

ボトムフロート、デフォルト: 0

方向座標でのベースラインの位置。

ラベル文字列、デフォルト: なし

凡例のステムに使用するラベル。

向き{'x', 'y', 'z'}, デフォルト: 'z'

ステムが描かれる方向。

データのインデックス可能なオブジェクト、オプション

指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]

戻り値:

StemContainer: コンテナはタプルのように扱うことができます ( markerline、stemlines、baseline )

例

(ソースコード、png )

( png )

( png )

stem3D ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' ,ボトム= 0 ,ラベル=なし,方向= 'z' ,データ=なし) [ソース] #

3D ステムプロットを作成します。

パラメータ:

x、y、z配列のようなもの

linefmt文字列、デフォルト: 'C0-'

垂直線のプロパティを定義する文字列。通常、これは色または色と線種になります。

キャラクター	線種
`'-'`	実線
`'--'`	破線
`'-.'`	一点鎖線
`':'`	点線

markerfmt文字列、デフォルト: 'C0o'

ステムヘッドのマーカーのプロパティを定義する文字列。

basefmt文字列、デフォルト: 'C3-'

ベースラインのプロパティを定義する書式文字列。

ボトムフロート、デフォルト: 0

方向座標でのベースラインの位置。

ラベル文字列、デフォルト: なし

凡例のステムに使用するラベル。

向き{'x', 'y', 'z'}, デフォルト: 'z'

ステムが描かれる方向。

データのインデックス可能なオブジェクト、オプション

指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]

戻り値:

StemContainer: コンテナはタプルのように扱うことができます ( markerline、stemlines、baseline )

例

(ソースコード、png )

( png )

text ( x , y , z , s , zdir = None , ** kwargs ) [source] #: プロットにテキストを追加します。kwargs は、z 方向として使用される方向を設定するzdirキーワードを除いて、Axes.text に渡されます。

text2D ( x , y , s , fontdict = None , ** kwargs ) [source] #

Axes にテキストを追加します。

データ座標の位置x、yでテキストsを Axes に追加します。

パラメータ:

x、yフロート: テキストを配置する位置。デフォルトでは、これはデータ座標です。座標系は、 transformパラメータを使用して変更できます。
s str: テキスト。
fontdict dict、デフォルト: なし: デフォルトのテキストプロパティをオーバーライドする辞書。fontdict が None の場合、デフォルトはによって決定されrcParamsます。

戻り値:

Text: 作成されたTextインスタンス。

その他のパラメータ:

**kwargsTextプロパティ。

その他のその他のテキストパラメータ。

財産	説明
`agg_filter`	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
`alpha`	スカラーまたはなし
`animated`	ブール
`backgroundcolor`	色
`bbox`	プロパティを持つdict`patches.FancyBboxPatch`
`clip_box`	わからない
`clip_on`	わからない
`clip_path`	わからない
`color`またはc	色
`figure`	`Figure`
`fontfamily`または家族	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
`fontproperties`または font または font_properties	`font_manager.FontProperties`または`str`または`pathlib.Path`
`fontsize`またはサイズ	float または {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
`fontstretch`またはストレッチ	{範囲 0 ～ 1000 の数値、「超凝縮」、「超凝縮」、「凝縮」、「半圧縮」、「通常」、「半拡張」、「拡張」、「超拡張」 ', '超拡張'}
`fontstyle`またはスタイル	{'normal', 'italic', 'oblique'}
`fontvariant`またはバリアント	{'normal', 'small-caps'}
`fontweight`または重量	{0 ～ 1000 の範囲の数値、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demibold'、'demi'、 'bold', 'heavy', 'extra bold', 'black'}
`gid`	力
`horizontalalignment`またはは	{'左', '中央', '右'}
`in_layout`	ブール
`label`	物体
`linespacing`	float (フォントサイズの倍数)
`math_fontfamily`	力
`mouseover`	ブール
`multialignment`またはま	{'左', '右', '中央'}
`parse_math`	ブール
`path_effects`	`AbstractPathEffect`
`picker`	None または bool または float または callable
`position`	(浮く、浮く)
`rasterized`	ブール
`rotation`	float または {'vertical', 'horizontal'}
`rotation_mode`	{なし、「デフォルト」、「アンカー」}
`sketch_params`	(位取り: float、長さ: float、乱数: float)
`snap`	ブールまたはなし
`text`	物体
`transform`	`Transform`
`transform_rotates_text`	ブール
`url`	力
`usetex`	ブールまたはなし
`verticalalignment`またはva	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
`visible`	ブール
`wrap`	ブール
`x`	浮く
`y`	浮く
`zorder`	浮く

例

個々のキーワード引数を使用して、特定のパラメーターをオーバーライドできます。

>>> text(x, y, s, fontsize=12)

デフォルトの変換では、テキストがデータ座標にあることを指定しますが、代わりに、テキストを軸座標に指定することもできます ((0, 0) は左下、(1, 1) は右上)。以下の例では、軸の中央にテキストを配置します。

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

キーワードbboxを使用すると、テキストインスタンスの周りに長方形のボックスを配置できます (たとえば、背景色を設定するため) 。bboxはRectangle プロパティの辞書です。例えば：

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

text3D ( x , y , z , s , zdir =なし, ** kwargs ) [ソース] #: プロットにテキストを追加します。kwargs は、z 方向として使用される方向を設定するzdirキーワードを除いて、Axes.text に渡されます。

tick_params ( axis = 'both' , ** kwargs ) [source] #

目盛りと目盛りラベルの外観を変更する便利なメソッド。

Axes.tick_params完全なドキュメントについては、を参照してください。この関数は 3D 軸に適用されるため、軸を「z」に設定することもできます。軸を「両方」に設定すると、3 つの軸すべてが自動スケーリングされます。

また、Axes3D オブジェクトは通常の 2D 軸とは大きく異なる方法で描画されるため、これらの設定の一部にはあいまいな意味がある場合があります。簡単にするために、「z」軸は「y」軸と同じように設定を受け入れます。

ノート

Axes3D は現在、これらの設定の一部を無視します。

tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #

3D 等高線図を作成します。

ノート

このメソッドは現在、3D PolyCollection レンダリングの長年のバグにより、正しくない出力を生成します。

パラメータ:

X、Y、Z配列のような: 入力データ。Axes.tricontourサポートされているデータ形状については、を参照してください。
extend3d bool、デフォルト: False: 3D で輪郭を延長するかどうか。
ストライド整数: 輪郭を拡張するためのステップサイズ。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送されmatplotlib.axes.Axes.tricontourます。

戻り値:

matplotlib.tri.tricontour.TriContourSet

tricontourf ( *引数, zdir = 'z' ,オフセット=なし,データ=なし, ** kwargs ) [ソース] #

3D 塗りつぶし等高線図を作成します。

ノート

このメソッドは現在、3D PolyCollection レンダリングの長年のバグにより、正しくない出力を生成します。

パラメータ:

X、Y、Z配列のような: 入力データ。Axes.tricontourfサポートされているデータ形状については、を参照してください。
zdir {'x', 'y', 'z'}、デフォルト: 'z': 使用する方向。
オフセットフロート、オプション: 指定されている場合、zdir に垂直な平面のこの位置に等高線の投影をプロットします。
データのインデックス可能なオブジェクト、オプション: 指定された場合、すべてのパラメーターは string も受け入れます。これは(例外が発生しない限り)sと解釈されます。data[s]
*引数、**kwargs: 他の引数はに転送され matplotlib.axes.Axes.tricontourfます。

戻り値:

matplotlib.tri.tricontour.TriContourSet

tunit_cube ( vals =なし, M =なし) [ソース] #

tunit_edges ( vals =なし, M =なし) [ソース] #

unit_cube ( vals =なし) [ソース] #

update_datalim ( xys , ** kwargs ) [ソース] #

dataLimBbox を拡張して、指定された点を含めます。

現在データが設定されていない場合、Bbox はその制限を無視し、境界を xydata ( xys ) の境界に設定します。それ以外の場合は、現在のデータと xysのデータの和集合の境界を計算します。

パラメータ:

xys 2D 配列のようなもの: データ制限 Bbox に含めるポイント。これは、(x, y) タプルのリストまたは Nx2 配列のいずれかです。
updatex、updatey bool、デフォルト: True: x/y 制限を更新するかどうか。

view_init ( elev =なし, azim =なし, roll =なし, vertical_axis = 'z' ) [source] #

軸の仰角と方位角を度数 (ラジアンではなく) で設定します。

これを使用して、軸をプログラムで回転させることができます。

主平面に垂直に見えるようにするには、次の仰角と方位角を使用できます。0、90、180、または 270 度のロール角度は、軸を直角に保ちながらこれらのビューを回転させます。

ビュープレーン	高さ	アジム
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

パラメータ:

elevフロート、デフォルト: なし: 度単位の仰角は、垂直軸が貫通する平面の上でカメラを回転させます。正の角度は、その平面の上の位置に対応します。たとえば、デフォルトの垂直軸が「z」の場合、仰角は xy 平面上のカメラ位置の角度を定義します。Axes3D None の場合、コンストラクタで指定された初期値が使用されます。
azim float、デフォルト: なし: 度単位の方位角は、垂直軸を中心にカメラを回転させます。正の角度は右手の回転に対応します。たとえば、デフォルトの垂直軸が 'z' の場合、正の方位角は、+x 軸に沿った位置から +y 軸に向かって原点を中心にカメラを回転させます。Axes3D None の場合、コンストラクタで指定された初期値が使用されます。
ロールフロート、デフォルト: なし: ロール角度 (度単位) は、ビュー軸を中心にカメラを回転させます。正の角度はカメラを時計回りに回転させ、シーンを反時計回りに回転させます。Axes3D None の場合、コンストラクタで指定された初期値が使用されます。
vertical_axis {"z", "x", "y"}、デフォルト: "z": 垂直方向に整列する軸。azimはこの軸を中心に回転します。

ボクセル( [ x , y , z , ] / ,塗りつぶし, facecolors=None , edgecolors=None , **kwargs ) [source] #

塗りつぶされたボクセルのセットをプロットする

すべてのボクセルは、軸上に 1x1x1 の立方体としてプロットされ、下隅が原点に配置されます。遮られた面はプロットされません。filled[0, 0, 0]

パラメータ:

bool の塗りつぶされた3D np.array

どのボクセルを埋めるかを示す真の値を持つ、値の 3D 配列

x、y、z 3D np.array、オプション

ボクセルの角の座標。これは、 filledの形状よりもすべての次元で 1 大きい形状にブロードキャストする必要があります。これらは非立方体ボクセルのプロットに使用できます。

指定されていない場合は、デフォルトで、によって返されるように、各軸に沿って増加する整数になりますindices()。関数シグネチャので示されているよう/に、これらの引数は位置的にのみ渡すことができます。

facecolors、edgecolors配列のようなもの、オプション

ボクセルの面とエッジを描画する色。キーワード引数としてのみ渡すことができます。これらのパラメータは次のとおりです。

すべてのボクセルを同じ色にする単一の色値。これは、文字列または 1D rgb/rgba 配列のいずれかです。
None、デフォルトで、面に単一の色を使用し、スタイルのデフォルトをエッジに使用します。
色名の 3D ndarray で、各項目は対応するボクセルの色です。サイズはボクセルと一致する必要があります。
rgb/rgba データの 4D ndarray で、コンポーネントが最後の軸に沿っています。

シェードブール、デフォルト: True

面の色をシェーディングするかどうか。cmapが指定されている場合、シェーディングは常に無効になります。

光源LightSource

shadeが Trueの場合に使用する光源。

**kwargs

に渡す追加のキーワード引数 Poly3DCollection。

戻り値:

顔の口述: 座標によってインデックス付けされたディクショナリ。はボクセル用に描画された面のです。描画が要求されていないか、完全に遮られているために、特定のボクセルに対して面が描画されなかった場合、.faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

例

(ソースコード、png )

(ソースコード、png )

(ソースコード、png )

(ソースコード、png )

プロパティ w_xaxis [ソース] #

プロパティ w_yaxis [ソース] #

プロパティ w_zaxis [ソース] #

zaxis_date ( tz =なし) [ソース] #

軸の目盛りとラベルを設定して、z 軸に沿ったデータを日付として扱います。

パラメータ:

tz str またはdatetime.tzinfo、デフォルト: rcParams["timezone"](デフォルト: 'UTC'): 日付ラベルの作成に使用されるタイムゾーン。

ノート

この関数は完全を期すために提供されているにすぎませんが、3D 軸はティックの日付をサポートしていないため、期待どおりに機能しない可能性があります。

zaxis_inverted ( ) [ソース] #: z 軸が反転している場合は True を返します。