タグを使って run にラベルを付ける

Python SDK、Public API、または W&B App UI を使用して、W&B run のタグを追加、更新、削除し、整理できます。

ログされたメトリクスや artifact データだけでは分かりにくい特定の特徴を示すために、タグを追加して run にラベルを付けます。

たとえば、run のモデルが in_production であること、その run が preemptible であること、その run が baseline を表していることなどを示すタグを run に追加できます。

​

1 つ以上の run にタグを追加する

プログラムから、またはインタラクティブに run にタグを追加できます。

ユースケースに応じて、ニーズに最も適した以下のタブを選択してください。

W&B Python SDK

run の初期化時にタグを追加するには、wandb.init() を使用します。run にタグを追加するには、wandb.init() の tags パラメーターに文字列のリストを渡します。例:

import wandb

with wandb.init(
  entity="<entity>",
  project="<project>",
  tags=["<tag1>", "<tag2>"]
) as run:
    # ここにトレーニングコード

アクティブな run の実行中に、run オブジェクトの tags 属性 (wandb.Run.tags) を更新して、既存のタグを追加または更新することもできます。tags 属性は文字列のタプルを受け取ります。run の初期化後に新しいタグを追加するには、既存の run のタグ プロパティに 1 つ以上のタグを連結します。

import wandb

with wandb.init(entity="<entity>", project="<project>", tags=["<tag1>"]) as run:
  # ここにトレーニングループのロジック

  # run オブジェクトに新しいタグを追加
  run.tags += ("<new_tag>",)

Public API

以前に保存した run にタグを追加または更新するには、W&B Public API を使用します。

既存の run のタグを更新するには、wandb.Run.tags プロパティにアクセスします。wandb.Run.tags プロパティは文字列のリストで構成されています。新しいタグを既存のタグに追加し、その後 wandb.Run.update() を呼び出して、新しいタグで run を更新します。例:

with wandb.Api().run("{entity}/{project}/{run-id}") as run:
  run.tags.append("<tag1>")
  run.update()

プロジェクトページ

この方法は、同じタグを多数の run に付ける場合に最適です。

1. プロジェクトのワークスペースにアクセスします。
2. プロジェクトのサイドバーから Runs を選択します。
3. 表から 1 つ以上の run を選択します。
4. 1 つ以上の run を選択したら、表の上にある Tag ボタンを選択します。
5. 追加するタグを入力し、Create new tag チェックボックスを選択してタグを追加します。

Run page

この方法は、単一の run に手動でタグを付ける場合に最適です。

1. プロジェクトのワークスペースにアクセスします。
2. run をクリックして開きます。run ページが開き、デフォルトで Overview タブが表示されます。
3. Tags の横にある灰色のプラス アイコン (+) ボタンを選択します。
4. 追加するタグを入力し、テキストボックスの下にある Add を選択して新しいタグを追加します。

​

1 つ以上の run からタグを削除する

W&B App で run からタグを削除するには、次の step に従う。

プロジェクトページ

この method は、多数の run からタグを削除する場合に最適です。

1. プロジェクトの Run サイドバーで、右上の表アイコンを選択します。これにより、サイドバーが Runs 表全体に展開されます。
2. 表内の run にカーソルを合わせると、左側にチェックボックスが表示されます。すべての Runs を選択する場合は、ヘッダー行のチェックボックスを使用します。
3. チェックボックスを選択して、一括 action を有効にします。
4. タグを削除する runs を選択します。
5. run の行の上にある Tag ボタンを選択します。
6. タグの横にあるチェックボックスを選択して、run からそのタグを削除します。

Run page

1. Run page の左サイドバーで、最上部の Overview タブを選択します。run のタグはここに表示されます。
2. タグにカーソルを合わせて “x” を選択し、run から削除します。