jupyter ipywidgets
date: 2023-04-15 excerpt: jupyter ipywidgetsの使い方
jupyter ipywidgetsの使い方
概要
- jupyterでGUI機能を追加するもの
- 最終的な提供物に対してipywidgetsを設定してわかりやすく提供することができる
- ウィジェットのインスタンスを初期化する以外にも関数デコレータを使う方法がある
@ipywidgets.interactを関数の前につけるとウィジェットになる
- 複数のwidgetを同時に制御する場合には、関数デコレータを使用して関数内関数を用いる
インストール
$ python3 -m pip install ipywidgets
各ウィジェットの例
スライダー
import ipywidgets as widgets
from IPython.display import display
slider = widgets.FloatSlider(
value=0.5,
min=0,
max=1,
step=0.01,
description='パラメータ:',
readout_format='.2f',
)
display(slider)
print(slider.value)
ドロップダウン
dropdown = widgets.Dropdown(
options=['オプション1', 'オプション2', 'オプション3'],
value='オプション1',
description='選択:',
)
display(dropdown)
チェックボックス
checkbox = widgets.Checkbox(
value=False,
description='チェックボックス',
)
display(checkbox)
レンジスライダー
range_slider = widgets.FloatRangeSlider(
value=[0, 1],
min=0,
max=1,
step=0.01,
description='範囲:',
readout_format='.2f',
)
display(range_slider)
複数行のテキストボックス(TextArea)
textarea = widgets.Textarea(
value='',
placeholder='Type something',
description='String:',
disabled=False
)
ウィジェットに関数を紐付ける
ボタンを描画して押されたら関数を実行する
button = widgets.Button(
description='送信',
disabled=False,
button_style='',
tooltip='Click me',
icon='check'
)
output = widgets.Output()
output.clear_output(wait=True)
def on_button_clicked(b):
with output:
print("Button clicked.")
button.on_click(on_button_clicked)
display(button, output)
二つの変数を操作してすぐ結果を得る
def multiply(x, y):
return x * y
widgets.interact(
multiply,
x=widgets.FloatSlider(min=-10, max=10, step=0.1, value=0, description="x"),
y=widgets.FloatSlider(min=-10, max=10, step=0.1, value=0, description="y")
);
描画の単位
- VBox
- ウィジェットを引数にまとめることができる
- AppLayout
- VBoxやコントロール要素を引数に左右に分割して描画する単位
- Tab
- 複数のAppLayoutやVBoxやウィジェットをタブで切り替えできる
stdoutをキャプチャして表示する
out = widgets.Output(layout={'border': '1px solid black'})
with out:
for i in range(10):
print(i, 'Hello world!')
display(out) # 1pxの黒い枠に囲まれたテキストが表示される
複数のウィジェットを入力に応じて制御する
@ipywidgets.interact
def select_date(date=ipywidgets.DatePicker(description='Pick a Date', value=datetime.datetime.now(), disabled=False)):
@ipywidgets.interact
def select_category(category=["cat_a", "cat_b", "cat_c"]):
@ipywidgets.interact
def select_number(number=ipywidgets.BoundedIntText(value=0, min=0, max=10)):
display(f"{date}, {category}, {number}")
# 2023-09-06 06:18:25.026029, cat_a, 0