stairs【折れ線グラフ (段階的定数)】3.4
メモ
基本
〔 例 〕- 段階的な定数 (values (ステップの高さ)とedges (ステップの端の位置)指定)
- ステップ方向:orientation (ステップ方向)
- 塗りつぶし (詳細は、線・塗りつぶしの指定方法): fill (塗りつぶしの有無)・hatch (塗りつぶしパターン)
データの指定方法
〔 例 〕- データ引数 (values (ステップの高さ)・edges (ステップの端の位置)) に データ指定
- データ引数にラベル名を指定、data (ラベル名指定データ)にラベル名とデータを指定
線・塗りつぶしの指定方法
〔 例 〕- 線
alpha【アルファ値】 (塗りつぶしでも使用)
color【各種色 (一括指定)】 (塗りつぶしでも使用)
edgecolor・ec【外枠・塗りつぶしパターンの色】 (塗りつぶしでも使用)
linestyle・ls【線種】
linewidth・lw【線の幅】
joinstyle【結合スタイル】
capstyle【線端スタイル】 - 塗りつぶし
fill (塗りつぶしの有無)
hatch (塗りつぶしパターン)
alpha【アルファ値】 (線でも使用)
color【各種色 (一括指定)】 (線でも使用)
edgecolor・ec【外枠・塗りつぶしパターンの色】 (線でも使用)
facecolor・fc【塗りつぶし色】
積み上げ
〔 例 〕- baseline (下端の位置)を指定
- values (ステップの高さ)は上端を指定 (baseline (下端の位置)とは無関係なのでデータを加算)
関連設定
〔 例 〕- タイトル・凡例・目盛り等:設定・グラフパーツ 参照
関連
- plot【折れ線グラフ】
- step【折れ線グラフ (ステップ)】
- plot_date【折れ線グラフ (時系列)】
- stackplot【折れ線グラフ (積み上げ)】
外部リンク
構文
pyplot.stairs(
values (配列形式:ステップの高さ)※data,
edges (配列形式:ステップの端の位置)※data =None,
*,
orientation (str:ステップ方向)='vertical',
baseline (下端の位置)=0,
fill (bool:塗りつぶしの有無)=False,
data (ラベル名指定データ)=None,
**kwargs (その他プロパティ)) 3.4
axes.Axes.stairs(同上) 3.4
戻り値patches.StepPatch【ステップ区画】
values (配列形式)※dataステップの高さ (baseline (下端の位置)とは無関係)
edges (配列形式)※dataステップの端の位置 (values (ステップの高さ)より1つ多い個数)
省略:[0, 1, 2, ...]
orientation (str) キーワード引数ステップ方向 ('vertical':垂直方向 | 'horizontal':水平方向)
baseline (float | 配列形式 | None) キーワード引数下端の位置
fill (bool) キーワード引数塗りつぶしの有無
data (キーワード引数)ラベル名指定データ
(※data:ラベル名指定可・詳細は、データの指定方法 参照・下記が対象)
・values (ステップの高さ)
・edges (ステップの端の位置)
kwargs (可変長キーワード引数)StepPatch【ステップ区画】のプロパティ
StepPatch【ステップ区画】のプロパティ
プロパティ | 型 | デフォルト | 取得 | 設定 | 備考 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
agg_filter | callable | ○ | ○ | agg フィルター | |||||||||||||||||||||||
alpha | スカラー None | ○ | ○ | アルファ値 (0:透明 ~ 1:不透明) (線とマーカー共有) | |||||||||||||||||||||||
animated | bool | ○ | ○ | アニメーション使用の有無 | |||||||||||||||||||||||
antialiased aa | bool | ○ | ○ | アンチエイリアス処理の有無 | |||||||||||||||||||||||
baseline | float 配列形式 None | 0 | ○ | ○ | 下端の位置 | ||||||||||||||||||||||
capstyle | CapStyle str | ○ | ○ | 線端スタイル
| |||||||||||||||||||||||
clip_box | Bbox | ○ | ○ | ||||||||||||||||||||||||
clip_on | bool | ○ | ○ | クリッピングの有無 (True:範囲内のみ描画 / False:範囲外にも描画可) | |||||||||||||||||||||||
clip_path | Patch (Path, Transform) None | ○ | ○ | ||||||||||||||||||||||||
color | color【色定義】 | ○ | ○ | 各種色 (一括指定) 参照:edgecolor (ec)【外枠・塗りつぶしパターンの色】・facecolor (fc)【塗りつぶし色】 | |||||||||||||||||||||||
contains 3.3 | callable | ○ | ○ | ピッカーイベント (参照:picker【ピッカーイベント】) | |||||||||||||||||||||||
edgecolor ec | color【色定義】 list( color【色定義】) 'face':塗りつぶし色 | rcParams["patch.edgecolor"]:'black' | ○ | ○ | 外枠・塗りつぶしパターンの色 | ||||||||||||||||||||||
edges | 配列形式 | ○ | ○ | ステップの端の位置 | |||||||||||||||||||||||
facecolor fc | color【色定義】 list( color【色定義】) 'none' | rcParams["patch.facecolor"]:'C0' | ○ | ○ | 塗りつぶし色 | ||||||||||||||||||||||
figure | Figure | ○ | ○ | 所属フィギュア | |||||||||||||||||||||||
fill | bool | ○ | ○ | 塗りつぶしの有無 | |||||||||||||||||||||||
gid | str | ○ | ○ | グループId (識別子として利用可) | |||||||||||||||||||||||
hatch | str | ○ | ○ | 塗りつぶしパターン (繰り返しで高密度 / 組合せ可)
| |||||||||||||||||||||||
in_layout | bool | ○ | ○ | レイアウト計算に含めるか否か | |||||||||||||||||||||||
joinstyle | JoinStyle str | rcParams["patch.joinstyle"] | ○ | ○ | 結合スタイル
| ||||||||||||||||||||||
label | object | ○ | ○ | 凡例ラベル (アンダースコアで始まるラベルは対象外) | |||||||||||||||||||||||
linestyle ls | str (offset, on-off-seq) | ○ | ○ | 線種
| |||||||||||||||||||||||
linewidth lw | float None | ○ | ○ | 線の幅 | |||||||||||||||||||||||
orientation | str | 'vertical' | ○ | ○ | ステップ方向
| ||||||||||||||||||||||
path_effects | AbstractPathEffect | ○ | ○ | ||||||||||||||||||||||||
picker | None bool float callable | None | ○ | ○ | None:ピッカーイベントなし bool:ピッカーイベント有無 float:ピッカー有効半径 callable:ピッカーイベント hit(bool), props(dict) = picker(artist, mouseevent) | ||||||||||||||||||||||
rasterized | bool | ○ | ○ | ラスタライズ(ビットマップ) 描画の強制有無 | |||||||||||||||||||||||
sketch_params | ○ | ○ | |||||||||||||||||||||||||
snap | bool None | ○ | ○ | スナップ (ピクセル位置補正) の有無 (Agg・MacOSX バックエンドのみサポート) | |||||||||||||||||||||||
transform | Transform | ○ | ○ | ||||||||||||||||||||||||
url | list( str ) | None | ○ | ○ | ハイパーリンクURL (SVG のみ対応) | ||||||||||||||||||||||
values | 配列形式 | ○ | ○ | ステップの高さ | |||||||||||||||||||||||
visible | bool | ○ | ○ | 表示有無 | |||||||||||||||||||||||
zorder | float | ○ | ○ | Zオーダー (大きい方が手前) |
設定・グラフパーツ
pyplot. | axes.Axes. | その他 | |
---|---|---|---|
タイトル | suptitle【タイトル設定 (全体)】 title【タイトル設定】 | set_title【タイトル設定】 get_title【タイトル取得】 Axes3D.set_title【タイトル設定】 | figure.Figure.suptitle【タイトル設定 (全体)】 figure.SubFigure.suptitle |
凡例 | legend【凡例 設定】3.5 / 3.7 / 3.8 quiverkey【ベクトルの凡例 追加】 | figure.Figure.legend【凡例 設定 (全体)】3.7 / 3.8 PathCollection.legend_elements【凡例項目作成】 | |
get_legend【凡例 取得】 get_legend_handles_labels【凡例 取得 (ハンドル・ラベル)】 | |||
軸ラベル | xlabel【x軸ラベル 設定】3.3 ylabel【y軸ラベル 設定】3.3 | set_xlabel【x軸ラベル 設定】3.3 set_ylabel【y軸ラベル 設定】3.3 Axes3D.set_zlabel【z軸ラベル 設定】 get_xlabel【x軸ラベル 取得】 get_ylabel【y軸ラベル 取得】 Axes3D.get_zlabel【z軸ラベル 取得】 | figure.Figure.supxlabel【x軸ラベル(全体) 設定】3.43.6 figure.Figure.supylabel【y軸ラベル(全体) 設定】3.43.6 figure.SubFigure.supxlabel figure.SubFigure.supylabel projections.polar.PolarAxes.set_rlabel_position【半径ラベルのシータ位置設定】 |
clabel【等高線ラベル 設定】 | |||
グリッド線 | grid【グリッド線 設定】3.5 | grid【グリッド線 設定】3.5 get_xgridlines【x軸グリッド線 取得】 get_ygridlines【y軸グリッド線 取得】 (Axes3D.grid【3Dグリッド線 取得・設定】) Axes3D.get_zgridlines【z軸グリッド線 取得】 | axis.Axis.grid【軸グリッド線 設定】3.5 axis.Axis.get_gridlines【軸グリッド線 取得】 |
triplot【三角形分割】 | |||
rgrids【放射状グリッド線 取得・設定】 thetagrid【放射状シータグリッド線 取得・設定】 | projections.polar.PolarAxes.set_rgrids【放射状グリッド線 設定】 projections.polar.PolarAxes.set_thetagrid【放射状シータグリッド線 設定】 | ||
表示範囲 | xlim【x軸表示範囲 取得・設定】 ylim【y軸表示範囲 取得・設定】 axis【表示範囲等 取得・設定】3.1~3.4 / 3.7 | set_xlim【x軸表示範囲 設定】3.1 / 3.6 set_ylim【y軸表示範囲 設定】3.1 / 3.6 get_xlim【x軸表示範囲 取得】 get_ylim【y軸表示範囲 取得】 axis【表示範囲等 取得・設定】3.1~3.4 / 3.7 | projections.polar.PolarAxes.set_rlim【極座標範囲 設定】 |
Axes3D.set_xlim【3D x軸表示範囲 設定】 Axes3D.set_xlim3d【3D x軸表示範囲 設定】 Axes3D.set_ylim【3D y軸表示範囲 設定】 Axes3D.set_ylim3d【3D y軸表示範囲 設定】 Axes3D.set_zlim【3D z軸表示範囲 設定】 Axes3D.set_zlim3d【3D z軸表示範囲 設定】 Axes3D.get_xlim3d【3D x軸表示範囲 取得】 Axes3D.get_ylim3d【3D y軸表示範囲 取得】 Axes3D.get_zlim3d【3D z軸表示範囲 取得】 | |||
データ上限・下限 | set_xbound【x軸データ上限・下限 設定】 set_ybound【y軸データ上限・下限 設定】 get_xbound【x軸データ上限・下限 取得】 get_ybound【y軸データ上限・下限 取得】 | projections.polar.PolarAxes.set_rmax【極座標上限 設定】 projections.polar.PolarAxes.set_rmin【極座標下限 設定】 | |
目盛り | xticks【x軸目盛り (ラベル) 取得・設定】3.6 yticks【y軸目盛り (ラベル) 取得・設定】3.6 locator_params【目盛り制御】 minorticks_on minorticks_off ticklabel_format【目盛りフォーマット設定 (指数形式)】 tick_params【目盛り・グリッド線 外観変更】 | set_xticks【x軸目盛り 設定】3.2 / 3.5 set_yticks【y軸目盛り 設定】3.2 / 3.5 Axes3D.set_zticks【z軸目盛り 設定】 set_xticklabels【x軸目盛りラベル 設定】3.3 / 3.5 set_yticklabels【y軸目盛りラベル 設定】3.3 / 3.5 Axes3D.set_zticklabels【z軸目盛りラベル 設定】 get_xticks【x軸目盛り 取得】3.2 get_yticks【y軸目盛り 取得】3.2 Axes3D.get_zticks【z軸目盛り 取得】 get_xticklabels【x軸目盛りラベル 取得】3.3 / 3.6 get_yticklabels【y軸目盛りラベル 取得】3.3 / 3.6 Axes3D.get_zticklabels【z軸目盛りラベル 取得】 get_xmajorticklabels【x軸目盛りラベル 取得 (主)】3.3 / 3.6 get_ymajorticklabels【y軸目盛りラベル 取得 (主)】3.3 / 3.6 get_xminorticklabels【x軸目盛りラベル 取得 (補助)】3.3 / 3.6 get_yminorticklabels【y軸目盛りラベル 取得 (補助)】3.3 / 3.6 get_xticklines get_yticklines xaxis_date yaxis_date minorticks_on minorticks_off ticklabel_format【目盛りフォーマット設定 (指数形式)】 tick_params【目盛り・グリッド線 外観変更】 locator_params【目盛り制御】 fmt_xdata fmt_ydata | ticker【目盛りモジュール】 axis.Axis.set_ticks【目盛り 設定】 axis.Axis.set_ticklabels【目盛りラベル 設定】 axis.Axis.set_tick_params【目盛り・グリッド線 外観変更】 axis.XAxis.set_ticks_position【x軸目盛り位置 設定】 axis.YAxis.set_ticks_position【y軸目盛り位置 設定】 Axes3D.locator_params【目盛り制御】 axis.Axis.set_major_formatter【フォーマッタ設定 (主)】 axis.Axis.set_minor_formatter【フォーマッタ設定 (補助)】 axis.Axis.set_major_locator【ロケータ設定 (主)】 axis.Axis.set_minor_locator【ロケータ設定 (補助)】 axis.Axis.get_ticklabels【目盛りラベル取得】 axis.Axis.get_majorticklabels【目盛りラベル取得 (主)】 axis.Axis.get_minorticklabels【目盛りラベル取得 (補助)】 axis.Axis.get_major_formatter【フォーマッタ取得 (主)】 axis.Axis.get_minor_formatter【フォーマッタ取得 (補助)】 axis.Axis.get_ticklocs axis.Axis.get_major_locator【ロケータ取得 (主)】 axis.Axis.get_minor_locator【ロケータ取得 (補助)】 figure.Figure.autofmt_xdate【x軸日付目盛りラベル回転】 axis.Axis.get_tick_params【目盛り・グリッド線 外観取得】3.7 |
直線 範囲 | axhline【水平線 (単一)】3.9 axvline【垂直線 (単一)】 hlines【水平線 (複数)】3.3 vlines【垂直線 (複数)】3.3 axhspan【水平範囲】3.9 axvspan【垂直範囲】3.9 axline【直線】3.3 |