tkplot_pyplot プログラム仕様

matplotlib.pyplot を tkinter 環境で使用するためのユーティリティクラスと関数を提供します。

このモジュールは、matplotlib.pyplot の機能を拡張し、tkinter との統合を容易にするためのラッパーを提供します。 特に、インタラクティブなプロットを tkinter ウィンドウに組み込む際などに有用です。

tkplot_pyplot.py 技術ドキュメント

tklib.tkgraphic.tkplot_pyplot.select_plt(plt=None, use_tkinter=False, parent=None, title='tkPlot_tkinter')

matplotlib.pyplot オブジェクトまたは tkPlot_tkinter オブジェクトを選択して返します。

use_tkinter フラグに基づいて、通常の matplotlib.pyplot オブジェクトまたは tkinter と統合された tkPlot_tkinter オブジェクトを初期化し、関連するオブジェクトとともに返します。

パラメータ:

• plt -- matplotlib.pyplot のインスタンス。デフォルトは None で、その場合グローバルな pyplot が使用されます。

• use_tkinter -- True の場合、tkPlot_tkinter オブジェクトを返します。False の場合、標準の pyplot オブジェクトを返します。

• parent -- tkPlot_tkinter を使用する場合の親 tkinter ウィジェット。None の場合、新しい tk.Tk() が作成されます。

• title -- tkPlot_tkinter ウィンドウのタイトル。

戻り値:

タプル (tkplt, root, tkpyplot)。 tkplt: use_tkinter が True の場合は tkPlot_tkinter オブジェクト、False の場合は matplotlib.pyplot オブジェクト。 root: use_tkinter が True の場合は tkinter のルートウィンドウ、False の場合は None。 tkpyplot: tkPlot_pyplot オブジェクト。

class tklib.tkgraphic.tkplot_pyplot.tkPlot_pyplot(plt=None, **kwargs)

ベースクラス: tkObject

matplotlib.pyplot を拡張し、tkinter との連携を強化するクラスです。

matplotlib.pyplot のラッパーとして機能し、tkinter 環境でのプロット操作や 追加のUI要素（スライダーなど）の統合を容易にします。tkObject を継承しています。

add_slider(box, axcolor='lightgoldenrodyellow', label='A', min=0.1, max=10.0, init=1.0, cmd=None)

matplotlib のプロットにスライダーを追加します。

指定された位置にスライダーウィジェットを作成し、その値を変更したときに実行されるコマンドを設定します。 作成されたスライダーは内部リストに保持されます。

パラメータ:

• box -- list [left, bottom, width, height] の形式でスライダーの軸の位置を指定するリスト。単位は図の幅と高さに対する相対的な座標です。

• axcolor -- str スライダーの軸の背景色。

• label -- str スライダーのラベル。

• min -- float スライダーの最小値。

• max -- float スライダーの最大値。

• init -- float スライダーの初期値。

• cmd -- function スライダーの値が変更されたときに呼び出されるコールバック関数。デフォルトは値をプリントする関数です。

戻り値:

matplotlib.widgets.Slider 作成されたスライダーオブジェクト。

create_window(fig)

新しいウィンドウを作成します。

現在は実装されておらず、何もしません。

パラメータ:

fig -- matplotlib の Figure オブジェクト。

get_window_from_plt()

現在の matplotlib の図マネージャーからウィンドウオブジェクトを取得します。

matplotlib が管理する現在の図のウィンドウオブジェクト（通常は tkinter の Toplevel または Tk ウィンドウ）を返します。

戻り値:

object matplotlib ウィンドウオブジェクト。

legend(ax, h_list, l_list=None, is_draggable=True, **kwargs)

プロットに凡例を追加します（重複定義）。

h_list と l_list を使用して凡例を作成し、ドラッグ可能に設定します。 このメソッドは、同じ名前の1つ目のメソッドと重複しています。

パラメータ:

• ax -- matplotlib.axes.Axes 凡例を追加する軸オブジェクト。

• h_list -- list 凡例に追加するハンドル（線オブジェクトなど）のリスト。各要素はイテラブルであると想定されます。

• l_list -- list 凡例に追加するラベルのリスト。各要素はイテラブルであると想定されます。None の場合、h_list からラベルを抽出します。

• is_draggable -- bool 凡例をドラッグ可能にするかどうか。デフォルトは True です。

• kwargs -- ax.legend に渡される追加のキーワード引数。

pause(duration=0.001, **kwargs)

matplotlib の描画を一時停止し、イベントを処理します。

親クラス tkObject の pause メソッドを呼び出して、指定された期間だけ matplotlib のイベントループを一時停止し、UIイベントを処理します。

パラメータ:

• duration -- float 一時停止する期間（秒）。デフォルトは 0.001 秒です。

• kwargs -- tkObject.pause に渡される追加のキーワード引数。

show(**kwargs)

matplotlib のプロットウィンドウを表示します。

親クラス tkObject の show メソッドを呼び出して、matplotlib のプロットウィンドウを表示し、イベントループを開始します。

パラメータ:

kwargs -- tkObject.show に渡される追加のキーワード引数。

sleep(duration)

指定された期間、プログラムの実行を停止します。

time.sleep() を使用して、プログラムの実行を指定された秒数だけ一時停止させます。

パラメータ:

duration -- float 停止する期間（秒）。

subplots(ny, nx, figsize=None, dpi=100, tight_layout=True, **kwargs)

複数のサブプロットを持つ図を作成します。

matplotlib.pyplot.subplots() のラッパーで、指定された行数と列数で サブプロットのグリッドを作成し、図と軸オブジェクトを返します。 タイトなレイアウトがデフォルトで有効になっています。

パラメータ:

• ny -- int 行数。

• nx -- int 列数。

• figsize -- tuple 図のサイズ (幅, 高さ) をインチで指定します。

• dpi -- int 図の解像度（ドット/インチ）。

• tight_layout -- bool constrained_layout を使用して、サブプロットとパディングを自動的に調整するかどうか。

• kwargs -- matplotlib.pyplot.subplots に渡される追加のキーワード引数。

update()

プロットを更新します。

現在は実装されておらず、何もしません。