【Plotly&ボタン】updatemenusのargs2で2回目のボタン押下機能を追加

2023年1月4日 2023年5月21日

今回はPlotlyのボタン機能に2回目のボタン押下の処理を追加する方法を解説する。この機能を使うことで、1つのボタンに2種類の機能を付与してボタンの数を減らすことができるだろう。

また、オン・オフの切り替えを1つのボタンで担うことができるので、機能面でもわかりやすくなるだろう。

本記事の内容は以下のupdatemenusでボタンを追加する方法の応用版だ。まだ読んでいない人はまずは基礎固めから始めてほしい。

: 【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

Plotlyはプロットしたデータを動かすことができるのが大き ...

続きを見る

Python環境は以下。

Python 3.10.8
numpy 1.24.0
plotly 5.11.0
plotly-orca 3.4.2

参考になるサイト

Plotly公式

StackOverflow

How to set the values of args and args2 in Plotly's buttons in updatemenus?

本記事のコード全文

+ クリックでオープン

import plotly.graph_objects as go
import plotly.io as pio

print('------------------------------------------------------------')
# （復習）2つのグラフを切り替えられるボタンを作成

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# 2プロット表示用のボタン作成
button_all = dict(
    label='all',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[True, True]),  # y1, y2の両方を表示
        dict(title='all plots'),  # グラフタイトル
    ]
)
# y1表示用のボタン作成
button1 = dict(
    label='y1',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[True, False]),  # y1のみ表示
        dict(title='y1 plot'),  # グラフタイトル
    ]
)
# y2表示用のボタン作成
button2 = dict(
    label='y2',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[False, True]),  # y2のみ表示
        dict(title='y2 plot'),  # グラフタイトル
    ]
)

# ボタンをひとまとめにする
buttons = [button_all, button1, button2]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        active=0,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttuns-args2'
save_name = f"{prefix}_simple_buttons"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

print('------------------------------------------------------------')
# 2つのプロットを2種類の機能を持つボタンで切り替える

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# args2を適用し全プロット表示と全プロット非表示のボタンを追加
button_all = dict(
    label='all or nothing',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        dict(visible=[False, False]),  # y1, y2の両方を表示
        dict(title='No plots'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        dict(visible=[True, True]),  # y1, y2の両方を表示
        dict(title='all plots'),  # グラフタイトル
    ]
)

# ボタンをlistにまとめる
buttons = [button_all]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        # active=0にしていると、args2のボタンがすでに一度押された扱いになる
        active=-1,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttuns-args2'
save_name = f"{prefix}_second_buttons"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

print(' - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -')
# args3はない

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# args3はない
button_all = dict(
    label='all or nothing',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        dict(visible=[True, True]),  # y1, y2の両方を表示
        dict(title='all plots'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        dict(visible=[False, False]),  # y1, y2の両方を表示
        dict(title='No plots'),  # グラフタイトル
    ],
    # aegs3はない
    args3=[
        dict(visible=[True, False]),  # y1, y2の両方を表示
        dict(title='1 plots'),  # グラフタイトル
    ]
)

# ボタンをlistにまとめる
buttons = [button_all]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        # active=0にしていると、args2のボタンがすでに一度押された扱いになる
        active=-1,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# # レイアウトの作成
# layout = go.Layout(
#     font_size=20,  # グラフ全体のフォントサイズ
#     hoverlabel_font_size=20,  # ホバーのフォントサイズ
#     updatemenus=updatemenus,  # ボタンを設置
# )
# # ValueError: Invalid property specified for object of type plotly.graph_objs.layout.updatemenu.Button: 'args3'

# # Did you mean "args"?

# #     Valid properties:
# #         args
# #             Sets the arguments values to be passed to the Plotly
# #             method set in `method` on click.
# #         args2
# #             Sets a 2nd set of `args`, these arguments values are
# #             passed to the Plotly method set in `method` when
# #             clicking this button while in the active state. Use
# #             this to create toggle buttons.
# #         execute
# #             When true, the API method is executed. When false, all
# #             other behaviors are the same and command execution is
# #             skipped. This may be useful when hooking into, for
# #             example, the `plotly_buttonclicked` method and
# #             executing the API command manually without losing the
# #             benefit of the updatemenu automatically binding to the
# #             state of the plot through the specification of `method`
# #             and `args`.
# #         label
# #             Sets the text label to appear on the button.
# #         method
# #             Sets the Plotly method to be called on click. If the
# #             `skip` method is used, the API updatemenu will function
# #             as normal but will perform no API calls and will not
# #             bind automatically to state updates. This may be used
# #             to create a component interface and attach to
# #             updatemenu events manually via JavaScript.
# #         name
# #             When used in a template, named items are created in the
# #             output figure in addition to any items the figure
# #             already has in this array. You can modify these items
# #             in the output figure by making your own item with
# #             `templateitemname` matching this `name` alongside your
# #             modifications (including `visible: false` or `enabled:
# #             false` to hide it). Has no effect outside of a
# #             template.
# #         templateitemname
# #             Used to refer to a named item in this array in the
# #             template. Named items from the template will be created
# #             even without a matching item in the input figure, but
# #             you can modify one by making an item with
# #             `templateitemname` matching its `name`, alongside your
# #             modifications (including `visible: false` or `enabled:
# #             false` to hide it). If there is no template or no
# #             matching item, this item will be hidden unless you
# #             explicitly show it with `visible: true`.
# #         visible
# #             Determines whether or not this button is visible.

# # Did you mean "args"?

# # Bad property path:
# # args3
# # ^^^^^

print('------------------------------------------------------------')
# シンボルサイズや線の種類・大きさを変更したボタンを作成

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# args2を適用しマーカーのシンボルのサイズを変更するボタンを作成
button_size = dict(
    label='symbol size',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'marker.size': 30},  # プロットのマーカーのサイズを変更
        dict(title='symbol size: 30'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'marker.size': 6},  # プロットのマーカーのサイズをデフォルトに
        dict(title='symbol size: 6'),  # グラフタイトル
    ]
)

# args2を適用し線の種類を変更するボタンを作成
button_dash = dict(
    label='line dash',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'line.dash': 'dash'},  # プロット線の種類を破線に
        dict(title='line dash: dash'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'line.dash': 'solid'},  # プロット線の種類を実線に
        dict(title='line dash: solid'),  # グラフタイトル
    ]
)

# args2を適用し線の太さ・マーカーの種類とサイズを変更するボタンを作成
button_width_symbol = dict(
    label='line width & symbol',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {
            'line.width': 0.5,  # 線の太さ
            'marker.symbol': 'star',  # マーカーの種類
            'marker.size': 15  # マーカーのサイズ
        },
        # グラフタイトルと横軸ラベル
        dict(title='line width: 0.5', xaxis=dict(title='X (1st button)')),
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {
            'line.width': 2,  # 線の太さ
            'marker.symbol': 'square',  # マーカーの種類
            'marker.size': 10  # マーカーのサイズ
        },
        # グラフタイトルと縦軸ラベル
        dict(title='line width: 2', yaxis=dict(title='Y (2nd button)')),
    ]
)

# ボタンをlistにまとめる
buttons = [button_size, button_dash, button_width_symbol]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        # active=0にしていると、args2のボタンが1回目の処理扱いになる
        active=-1,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttuns-args2'
save_name = f"{prefix}_second_buttons_ex"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

下準備の`import`

import plotly.graph_objects as go
import plotly.io as pio

まずは下準備としてのimport関連。今回は基本goを使用する。pioはplotlyでのグラフ保存用のライブラリ。保存の仕方は色々あるがpioはその1つだ。

（復習）グラフにボタンを追加する

まずはupdatemenusでボタンを追加する記事で解説・作成したボタン機能付きのグラフを作成。ボタンは合計3種類で以下の機能がある。

all: y1, y2を表示
y1: y1だけ表示、y2は非表示
y1: y2だけ表示、y1は非表示

詳しくは以下の記事を参照いただきたいが、グラフにボタンを追加するざっくりとした手順は以下。

ボタン処理（button_all, button1, button2）を作成
作成したボタン処理を配列に入れる（buttons）
ボタン自体の設定（updatemenus）
updatemenusをレイアウトに入れる

ここで作成したボタンは一度押せば他のボタンを押さない限り再度機能することはない。しかし、以降で解説するargs2を使用することでもう一度押した時の処理を追加できる。

import plotly.graph_objects as go
import plotly.io as pio

# （復習）2つのグラフを切り替えられるボタンを作成

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# 2プロット表示用のボタン作成
button_all = dict(
    label='all',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[True, True]),  # y1, y2の両方を表示
        dict(title='all plots'),  # グラフタイトル
    ]
)
# y1表示用のボタン作成
button1 = dict(
    label='y1',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[True, False]),  # y1のみ表示
        dict(title='y1 plot'),  # グラフタイトル
    ]
)
# y2表示用のボタン作成
button2 = dict(
    label='y2',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    args=[
        dict(visible=[False, True]),  # y2のみ表示
        dict(title='y2 plot'),  # グラフタイトル
    ]
)

# ボタンをひとまとめにする
buttons = [button_all, button1, button2]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        active=0,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttons-args2'
save_name = f"{prefix}_simple_buttons"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

`args2`で2回目のボタン押下を有効に

同じボタン2回押して際に別の処理をつけるにはボタン処理（buttons_allなど）に引数args2を使えば良い。使い方はargsと同じで、単に処理が走るタイミングが異なるだけ。

ここでは以下の状態になるようにグラフを作成した。

args（1回目のボタン押下）：y1, y2非表示
args2（2回目のボタン押下）：y1, y2表示

表示・非表示はargsの1つ目のdict内でvisibleを使って指定すれば良い。y1, y2の順番でプロットしているので、visibleの1つ目の要素をFalseにするとy1が非表示になる。一方でTrueにすると表示される。

argsは最初にボタンを押した時の挙動なので、ここでは最初にy1, y2を表示していることを踏まえvisible=[False, False]にして非表示にした。

dict(visible=[False, False]),

ただし、argsでプロットを非表示にしている場合はupdatemenusの引数acriveを-1にする必要がある。active=0にするとすでにargsのボタンが押された状態になるからだ。

逆にargsでプロットを表示（visible=[True, True]）にしたなら、初期状態ですでに1回目のボタンを押していることと同義なのでactive=0にする必要がある。

少しややこしいが以下のイメージだ。

active=-1
- ボタンは押されていない状態
- 最初に押した時にvisible=Falseに
active=0
- ボタンは1回押されている状態
- 最初に押した時にvisible=Trueに

よくわからなかった場合はvisibleとactiveの値を変えて色々とチャレンジしてほしい。実際に手を動かすのが一番の近道だ。

import plotly.graph_objects as go
import plotly.io as pio

# 2つのプロットを2種類の機能を持つボタンで切り替える

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# args2を適用し全プロット表示と全プロット非表示のボタンを追加
button_all = dict(
    label='all or nothing',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        dict(visible=[False, False]),  # y1, y2の両方を表示
        dict(title='No plots'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        dict(visible=[True, True]),  # y1, y2の両方を表示
        dict(title='all plots'),  # グラフタイトル
    ]
)

# ボタンをlistにまとめる
buttons = [button_all]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        # active=0にしていると、args2のボタンがすでに一度押された扱いになる
        active=-1,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttons-args2'
save_name = f"{prefix}_second_buttons"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

`args3`はなくてエラーになる

ValueError: Invalid property specified for object of type plotly.graph_objs.layout.updatemenu.Button: 'args3'

Did you mean "args"?

    Valid properties:
        args
            Sets the arguments values to be passed to the Plotly
            method set in `method` on click.
        args2
            Sets a 2nd set of `args`, these arguments values are
            passed to the Plotly method set in `method` when
            clicking this button while in the active state. Use
            this to create toggle buttons.
        execute
            When true, the API method is executed. When false, all
            other behaviors are the same and command execution is
            skipped. This may be useful when hooking into, for
            example, the `plotly_buttonclicked` method and
            executing the API command manually without losing the
            benefit of the updatemenu automatically binding to the
            state of the plot through the specification of `method`
            and `args`.
        label
            Sets the text label to appear on the button.
        method
            Sets the Plotly method to be called on click. If the
            `skip` method is used, the API updatemenu will function
            as normal but will perform no API calls and will not
            bind automatically to state updates. This may be used
            to create a component interface and attach to
            updatemenu events manually via JavaScript.
        name
            When used in a template, named items are created in the
            output figure in addition to any items the figure
            already has in this array. You can modify these items
            in the output figure by making your own item with
            `templateitemname` matching this `name` alongside your
            modifications (including `visible: false` or `enabled:
            false` to hide it). Has no effect outside of a
            template.
        templateitemname
            Used to refer to a named item in this array in the
            template. Named items from the template will be created
            even without a matching item in the input figure, but
            you can modify one by making an item with
            `templateitemname` matching its `name`, alongside your
            modifications (including `visible: false` or `enabled:
            false` to hide it). If there is no template or no
            matching item, this item will be hidden unless you
            explicitly show it with `visible: true`.
        visible
            Determines whether or not this button is visible.

Did you mean "args"?

Bad property path:
args3
^^^^^

argsで1回目のボタン操作、args2で2回目のボタン操作ができるが、args3は存在せずエラーになる。

なので、3回目のボタン押下を実現することは基本的にはできないと考えるのが良いだろう（条件分岐で無理やりやることはできるかもしれない）。

その他の引数については公式ドキュメント参照。

マーカーと線をボタンで切り替え

ということで最後にボタン機能を応用してマーカーと線を変更する処理を作成した。このグラフのボタンでは以下の機能がある。

symbol size
- 1回目：マーカーサイズが30に
- 2回目：マーカーサイズが6に
line dash
- 1回目：線が破線に
- 2回目：線が実線に
line width & symbol
- 1回目：線の太さが0.5、マーカーが大きさ15のstarに
- 2回目：線の太さが2、マーカーが大きさ10のsquareに

このグラフを作成するためのコード全文はこの章の最後に記載するとして、以下で各ボタンの解説をする。

symbol sizeボタン

マーカーのサイズはmarker=dict(size=30)の形式で記述できる。ただし、Plotlyでは.を使って途中のdictを省略することが可能。ここではmarker.sizeでマーカーのサイズを変更している。

デフォルトのマーカーサイズは6なので、updatemenusのactive=-1に設定する場合はargsに変更後の処理を記述する必要がある。もちろんactive=0ならargs2に変更後の処理を記述する。

なお、ボタンのmethod=’update’だとプロットとレイアウトの両方を変更できるので、ここではグラフタイトルにそれぞれのマーカーサイズを表示するようにした。

# args2を適用しマーカーのシンボルのサイズを変更するボタンを作成
button_size = dict(
    label='symbol size',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'marker.size': 30},  # プロットのマーカーのサイズを変更
        dict(title='symbol size: 30'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'marker.size': 6},  # プロットのマーカーのサイズをデフォルトに
        dict(title='symbol size: 6'),  # グラフタイトル
    ]
)

line dashボタン

線の種類を変更するためのボタンも同じように作成できる。線の種類（dash）はline.dashで変更可能、変更できる線の種類は以下の6種類。

'solid': 実線
'dot': 点線
'dash': 破線
'longdash': 長い破線
'dashdot': 一点鎖線
'longdashdot': 長い破線の一点鎖線
'5px,10px,2px,2px': 5, 10, 2, 2 pixごとの破線

詳しくは公式ドキュメント参照。

# args2を適用し線の種類を変更するボタンを作成
button_dash = dict(
    label='line dash',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'line.dash': 'dash'},  # プロット線の種類を破線に
        dict(title='line dash: dash'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'line.dash': 'solid'},  # プロット線の種類を実線に
        dict(title='line dash: solid'),  # グラフタイトル
    ]
)

line width & symbolボタン

最後に線の太さとマーカーの種類とサイズを変更するボタンを作成。設定内容は以下。

1回目
- 線の太さline.width=0.5
- マーカーの種類marker.symbol=’star’
- マーカーの大きさ'marker.size'=15
2回目
- 線の太さline.width=2
- マーカーの種類marker.symbol=’square’
- マーカーの大きさ'marker.size'=10

それぞれの処理はargs, args2に辞書形式で並べて記述すればいい。

# args2を適用し線の太さ・マーカーの種類とサイズを変更するボタンを作成
button_width_symbol = dict(
    label='line width & symbol',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {
            'line.width': 0.5,  # 線の太さ
            'marker.symbol': 'star',  # マーカーの種類
            'marker.size': 15  # マーカーのサイズ
        },
        # グラフタイトルと横軸ラベル
        dict(title='line width: 0.5', xaxis=dict(title='X (1st button)')),
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {
            'line.width': 2,  # 線の太さ
            'marker.symbol': 'square',  # マーカーの種類
            'marker.size': 10  # マーカーのサイズ
        },
        # グラフタイトルと縦軸ラベル
        dict(title='line width: 2', yaxis=dict(title='Y (2nd button)')),
    ]
)

あとはそれぞれのボタンをまとめて変数buttonsに配列として格納してupdatemenusで参照してグラフを作成すればいいだけ。

import plotly.graph_objects as go
import plotly.io as pio

# シンボルサイズや線の種類・大きさを変更したボタンを作成

x = (0, 1, 2, 3, 4)
y1 = (0, 1, 4, 3, 2)
y2 = (1, 3, 2, 4, 0)

# 配列の要素にプロット内容を格納
plot = [
    go.Scatter(x=x, y=y1, name='y1'),
    go.Scatter(x=x, y=y2, name='y2'),
]

# args2を適用しマーカーのシンボルのサイズを変更するボタンを作成
button_size = dict(
    label='symbol size',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'marker.size': 30},  # プロットのマーカーのサイズを変更
        dict(title='symbol size: 30'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'marker.size': 6},  # プロットのマーカーのサイズをデフォルトに
        dict(title='symbol size: 6'),  # グラフタイトル
    ]
)

# args2を適用し線の種類を変更するボタンを作成
button_dash = dict(
    label='line dash',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {'line.dash': 'dash'},  # プロット線の種類を破線に
        dict(title='line dash: dash'),  # グラフタイトル
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {'line.dash': 'solid'},  # プロット線の種類を実線に
        dict(title='line dash: solid'),  # グラフタイトル
    ]
)

# args2を適用し線の太さ・マーカーの種類とサイズを変更するボタンを作成
button_width_symbol = dict(
    label='line width & symbol',  # ボタンのラベル
    method='update',  # ボタンの適用範囲はデータプロットとレイアウト
    # aegsを1回押した時のボタンの挙動
    args=[
        {
            'line.width': 0.5,  # 線の太さ
            'marker.symbol': 'star',  # マーカーの種類
            'marker.size': 15  # マーカーのサイズ
        },
        # グラフタイトルと横軸ラベル
        dict(title='line width: 0.5', xaxis=dict(title='X (1st button)')),
    ],
    # aegs2がもう一回押した時のボタンの挙動
    args2=[
        {
            'line.width': 2,  # 線の太さ
            'marker.symbol': 'square',  # マーカーの種類
            'marker.size': 10  # マーカーのサイズ
        },
        # グラフタイトルと縦軸ラベル
        dict(title='line width: 2', yaxis=dict(title='Y (2nd button)')),
    ]
)

# ボタンをlistにまとめる
buttons = [button_size, button_dash, button_width_symbol]

# レイアウトに設置するためのupdatemenus作成
updatemenus = [
    dict(
        # active=0にしていると、args2のボタンが1回目の処理扱いになる
        active=-1,  # 初期グラフで見た目上、押されるボタン
        type='buttons',  # ボタンのタイプはボタンに
        direction='right',  # ボタンは右向きに配置
        x=0.5, y=1.01,  # ボタンの位置
        xanchor='center', yanchor='bottom',  # ボタンの位置の基準
        buttons=buttons,  # ここに設定したボタン情報を入れる
    )
]

# レイアウトの作成
layout = go.Layout(
    font_size=20,  # グラフ全体のフォントサイズ
    hoverlabel_font_size=20,  # ホバーのフォントサイズ
    updatemenus=updatemenus,  # ボタンを設置
)

# グラフの表示
fig = go.Figure(data=plot, layout=layout)
fig.show()

# グラフの保存
prefix = 'plotly-buttons-args2'
save_name = f"{prefix}_second_buttons_ex"
pio.orca.config.executable = '/Applications/orca.app/Contents/MacOS/orca'
pio.write_html(fig, f"{save_name}.html")
pio.write_image(fig, f"{save_name}.png")

ボタンで設定した内容だけ処理される

グラフを作成して最初にsymbol sizeボタンを押す。そうするとargsの「マーカーサイズを30にする」の処理でマーカーサイズが30になる。この状態が上のグラフ。

続いてline dashを押すと線の種類が初期状態の実線からline dashのargsに従ってdash：破線に変わる。これが下のグラフの状態。

この時、マーカーサイズはsymbol sizeで変更した30のサイズのまま。そりゃline dashで変更したのは線の種類だけだから当たり前だが、案外落とし穴になるので注意。

さらに、この状態でline width & symbolボタンを押すと線の太さとマーカーの種類・サイズは変更されるが線の種類はdashのまま。これが下のグラフの状態。

args, args2で指定した処理だけが実行され、指定していない部分については何も変更がないことに注意。

また、line width & symbolボタンではグラフの横軸と縦軸にタイトル（軸ラベル）をつけるように設定しているが、symbol size・line dashのどちらのボタンにも軸ラベルを変更する処理がない。

すなわち一度line width & symbolボタンを押して軸ラベルを追加してしまうとこのグラフを再度作成もしくはリロードしない限り軸ラベルが消えることはない。

いまいち要領が掴めていない人は色々とボタンを押して試してほしい。傾向が掴めるはず。

2回目のボタンでさらに自由度が増す

ということで今回はPlotlyのupdatemenusのボタンに2回目のボタン押下機能を追加する方法を解説した。方法はシンプルにargs2を設定するだけなので簡単だっただろう。

今回の内容は以下のPlotlyでボタンを追加する方法の派生系なので、まだ読んでいない人は併せて読んでいただくことをおすすめする。

: 【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

Plotlyはプロットしたデータを動かすことができるのが大き ...

続きを見る

ただでさえ自由度の高いPlotlyにボタン押下の機能を追加することでさらに使い勝手が良いグラフを作成することができるだろう。

今回の記事を参考により高度なグラフを作成いただきたい。

: 【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

Plotlyはプロットしたデータを動かすことができるのが大き ...

続きを見る

: 【Plotlyで散布図】go.Scatterのグラフの描き方まとめ

これからPloltyで動くグラフを作りたい、もっとグラフをキ ...

続きを見る

: 【Plotly&sliders】スライダーを追加しデータを切り変える

本記事ではPlotlyでデータの流れを簡単に理解できる機能の ...

続きを見る

: 【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

今回は社会人がプログラミング言語「Python」を独学で学習 ...

続きを見る

Pythonを効率的に学びたいなら

本記事を読んでもっとPythonを学びたいと思った人もいるだろう。ただ、どうせ学ぶなら効率的に学びたい。

就職するにも転職するにも教養として身に付けたいにしろ、遠回りして学習するのはもったいない。

独学でもなんとかなるが

正直、Pythonの学習は独学でもある程度なんとかなると思う。というより他の言語も独学でなんとかなるのが現実。ただ、なんとかなるとしても以下の問題は見逃せない。

プログラミングをやらなくても正直問題ない
何をしたらいいのかわからない
どう学習したらいいのかわからない
これで合っているのかわからない
時間が足りない

私は大学・大学院の研究でPythonを使用、この時に教えてくれる人がいなかったので独学でPythonを学んで大学院の修士論文が通った。

ただ、あくまでもそれは、

大学の研究の過程で必要
何をしないといけないか明白
大学の研究室が超ホワイト
大学生だから時間があった

という「学生」という身分だから独学で学べただけ。すでに社会人の人は時間がないからかなりキツい。

さらに現在大学生の人も大学の授業や研究室が忙くてなかなか独学が難しいという人もいる。

副業で稼ぐならFreeks

特に社会人は難しい

以下の記事でも解説したが、特に社会人は日々の仕事に追われプライベートが疎かになりがちだ。そこでさらにプログラミングを学ぼうとするとかなりハードルが高い。

今の生活を振り返って自力で独学で学ぶ覚悟と根気と時間があるか確認してほしい。

: 【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

今回は社会人がプログラミング言語「Python」を独学で学習 ...

続きを見る

スクールだと目的と目標がはっきりする

また、プログラミングを学習したいけど何をしたらいいのかわからない、どうしたらいいのかわからないという漠然とした不安がある人も多いだろう。

そんな人はプログラミングスクールに通うことをおすすめする。スクールだと、

何をすればいいのかわかる
したいことがなくてもアドバイスをもらえる
学習方法を教えてもらえる

といったメリットがある。何をするかが分かれば最初の一歩は踏み出しやすい。最初が踏み出せないから今立ち止まっているのだから。

さらに独学とは違いそれなりに費用がかかるので、サボるとかなりもったいない。

王道中の王道 TechAcademy

スクールで客観的視点を持つ

また、現役でエンジニアとして働く私からいうと、独学で学んだコードは我流で実務では使いづらいことも多い。

このサイトで紹介するコードはあくまでも最初の学習をメインとしているから簡素にしているが、実務ではしっかりと汎用性や保守性を担保しないといけない。

そんな中で独学で突っ走ると転職するにも就職するにもその後がかなりしんどい。

プログラミング学習のショートカットはスクール

結論、独学でPythonを学ぶことは可能。しかし効率的かつ汎用的なスキルを身に付けたいならスクールに通うのが1番だ。特に未経験者はなおさら。

私はプログラミング経験があることで転職で若手なのに年収が数十万円も増えたしプログラミングの知識があることで周りから一目置かれることも。

Pythonに限らずだがプログラミングに興味があれば是非ともトライしていただきたい。

自分のペースで進めるSAMURAI TERAKOYA

メガネ

ベンチャー企業のWebエンジニア駆け出し。独学のPythonで天文学系の大学院を修了→転職→今に至る。最近は主にPHPを触ってます。メインのブログは「M天パ」https://megatenpa.com/です。

2023/04/23

【Plotlyでヒートマップ】go.Heatmapで動かせるヒートマップを作成する

2023/04/09

【astropy.units】Pythonで単位付きの数値を計算・単位換算

2023/03/25

【Plotlyでsubplot】goとmake_subplotsでサブプロットを作成する

comment コメントをキャンセル

Plotly全般の知識

2023/2/4

【Plotly&sliders】スライダーを追加しデータを切り変える

本記事ではPlotlyでデータの流れを簡単に理解できる機能のスライダーにつ& ...

Plotly全般の知識

2023/5/21

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

Plotlyはプロットしたデータを動かすことができるのが大きな魅力の1つだが ...

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

【Plotly&sliders】スライダーを追加しデータを切り変える

【Plotly&ボタン】updatemenusのargs2で2回目のボタン押下機能を追加

【PythonでChatGPT】話題のAI（人工知能）を簡単に試す（Google Colaboratoryもあり）

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

参考になるサイト

本記事のコード全文

下準備の`import`

（復習）グラフにボタンを追加する

`args2`で2回目のボタン押下を有効に

`args3`はなくてエラーになる

マーカーと線をボタンで切り替え

ボタンで設定した内容だけ処理される

2回目のボタンでさらに自由度が増す

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

関連記事

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

【Plotlyで散布図】go.Scatterのグラフの描き方まとめ

【Plotly&sliders】スライダーを追加しデータを切り変える

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

Pythonを効率的に学びたいなら

独学でもなんとかなるが

特に社会人は難しい

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

スクールだと目的と目標がはっきりする

スクールで客観的視点を持つ

プログラミング学習のショートカットはスクール

【Plotly&ボタン】updatemenusのargs2で2回目のボタン押下機能を追加

【PythonでChatGPT】話題のAI（人工知能）を簡単に試す（Google Colaboratoryもあり）

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

参考になるサイト

本記事のコード全文

下準備のimport

（復習）グラフにボタンを追加する

args2で2回目のボタン押下を有効に

args3はなくてエラーになる

マーカーと線をボタンで切り替え

ボタンで設定した内容だけ処理される

2回目のボタンでさらに自由度が増す

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

関連記事

【Plotly&ボタン】updatemenusとbuttonsでボタン機能を追加

【Plotlyで散布図】go.Scatterのグラフの描き方まとめ

【Plotly&sliders】スライダーを追加しデータを切り変える

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

Pythonを効率的に学びたいなら

独学でもなんとかなるが

特に社会人は難しい

【Pythonを独学】社会人が1人で学習できるのか。結論、学べるが...

スクールだと目的と目標がはっきりする

スクールで客観的視点を持つ

プログラミング学習のショートカットはスクール

下準備の`import`

`args2`で2回目のボタン押下を有効に

`args3`はなくてエラーになる