メインコンテンツまでスキップ

カスタムチャート

カスタムチャートを使用して、現在のデフォルトのUIでは作成できないチャートを作成します。任意のデータ表をログし、正確にどのように表示したいかを制御できます。Vegaの力で、フォント、色、ツールチップの詳細を制御します。

vega.github.io/vegaからのサポートされるチャート

使い方​

  1. データを記録：スクリプトから、configやサマリーデータなどをW&Bと一緒に実行するときと同様に記録します。特定の時間に記録された複数の値のリストを視覚化するには、カスタム wandb.Tableを使用します。
  2. チャートをカスタマイズ：GraphQL クエリを使用して、この記録されたデータの任意の部分を取り込みます。クエリの結果を、強力な視覚化文法であるVegaを使って可視化します。
  3. チャートを記録： wandb.plot_table()を使って、スクリプトから自分のプリセットを呼び出します。

スクリプトからチャートを記録する​

ビルトインプリセット​

これらのプリセットには、ビルトインの wandb.plot メソッドがあり、スクリプトから直接チャートを記録し、UIで探している正確な視覚化をすばやく表示できます。

wandb.plot.line()

カスタム折れ線グラフをログに記録します。接続された順序付きの点（x、y）を任意の軸xとyにプロットします。

data = [[x, y] for (x, y) in zip(x_values, y_values)]
table = wandb.Table(data=data, columns = ["x", "y"])
wandb.log({"my_custom_plot_id" : wandb.plot.line(table, "x", "y", title="Custom Y vs X Line Plot")})

任意の2次元で曲線をログに記録することができます。2つの値のリストを互いにプロットする場合、リストの値の数が完全に一致している必要があります（つまり、各点はxとyを持っている必要があります）。

アプリで見る →

コードを実行する →

カスタムプリセット​

ビルトインプリセットを調整するか、新しいプリセットを作成してから、チャートを保存します。チャートIDを使用して、スクリプトからデータをそのカスタムプリセットに直接ログすることができます。

# プロットするための列を持つテーブルを作成
table = wandb.Table(data=data, columns=["step", "height"])

# テーブルの列からチャートのフィールドにマップする
fields = {"x": "step",
          "value": "height"}

# テーブルを使って新しいカスタムチャートプリセットにデータを入力
# 自分で保存したチャートプリセットを使用するには、vega_spec_nameを変更
my_custom_chart = wandb.plot_table(vega_spec_name="carey/new_chart",
              data_table=table,
              fields=fields,
              )

コードを実行 →

データのログ取り​

以下は、スクリプトからログを取得し、カスタムチャートで使用できるデータタイプです。

  • Config: 実験の初期設定（独立変数）。これには、トレーニングの開始時にwandb.configのキーとしてログに記録した名前付きフィールドが含まれます（例：wandb.config.learning_rate = 0.0001)）。
  • Summary: トレーニング中に記録された単一の値（結果や従属変数）。例：wandb.log({"val_acc" : 0.8})。トレーニング中にwandb.log()でこのキーに複数回書き込むと、サマリーはそのキーの最終値に設定されます。
  • History: ログされたスカラーの完全な時系列データは、historyフィールド経由でクエリに利用可能です。
  • summaryTable: 複数の値のリストをログに記録する必要がある場合は、wandb.Table()を使ってデータを保存し、カスタムパネルでそのデータをクエリします。
  • historyTable: 履歴データを表示する必要がある場合は、カスタムチャートパネルでhistoryTableをクエリしてください。wandb.Table()を呼び出したり、カスタムチャートをログに記録するたびに、そのステップの履歴の新しいテーブルが作成されます。

カスタムテーブルの記録方法​

wandb.Table()を使用して、データを2次元配列としてログに記録します。通常、このテーブルの各行は1つのデータポイントを表し、各列はプロットするための各データポイントの関連フィールド/次元を示します。カスタムパネルを設定すると、wandb.log()に渡された名前付きキー("custom_data_table"以下)でテーブル全体がアクセス可能になり、個々のフィールドが列名("x"、"y"、"z")でアクセス可能になります。実験の途中で複数のタイムステップでテーブルを記録できます。各テーブルの最大サイズは10,000行です。

Google Colabで試してみる →

# Logging a custom table of data
my_custom_data = [[x1, y1, z1], [x2, y2, z2]]
wandb.log({"custom_data_table": wandb.Table(data=my_custom_data,
                                columns = ["x", "y", "z"])})

チャートをカスタマイズする​

新しいカスタムチャートを追加して始め、クエリを編集して可視化されたランからデータを選択します。クエリはGraphQLを使用して、実行中のconfig、summary、historyフィールドからデータを取得します。

新しいカスタムチャートを追加し、クエリを編集する

カスタムビジュアライゼーション​

右上のChartを選択してデフォルトのプリセットから始めます。次に、Chart fieldsを選択して、クエリから取得したデータをチャートの対応するフィールドにマッピングします。以下は、クエリから取得するメトリックを選択し、それを下のバーチャートフィールドにマッピングする例です。

プロジェクトの実行間での精度を示すカスタムバーチャートを作成する

Vegaの編集方法​

パネルの上部にあるEditをクリックして、Vega編集モードに移ります。ここでは、UIでインタラクティブなチャートを作成するVega specificationを定義できます。チャートの視覚スタイル（例えば、タイトルの変更、異なるカラースキームの選択、曲線を接続された線の代わりに一連の点として表示）からデータ自体（Vega変換を使用して、値の配列をヒストグラムにビン分けするなど）まで、チャートのあらゆる側面を変更できます。パネルプレビューはインタラクティブに更新されるため、Vega仕様やクエリを編集すると、変更の効果がわかりやすくなります。Vegaのドキュメントとチュートリアルは、インスピレーションのすばらしいソースです。

フィールド参照 W&Bからチャートにデータを取り込むには、Vega spec内の任意の場所に "${field:<field-name>}" という形式のテンプレート文字列を追加してください。これにより、右側のChart Fieldsエリアにドロップダウンが作成され、ユーザーはそのドロップダウンを使用して、Vegaにマッピングするクエリ結果列を選択できます。

フィールドのデフォルト値を設定するには、次の構文を使用してください："${field:<field-name>:<placeholder text>}"

チャート設定の保存​

変更を特定のビジュアライゼーションパネルに適用するには、モーダルの下部にあるボタンを使用してください。あるいは、Vega specをプロジェクト内の他の箇所で使用するために保存することもできます。再利用可能なチャート定義を保存するには、Vegaエディタの上部にあるSave asをクリックし、プリセットに名前を付けてください。

記事とガイド​

  1. W&B機械学習ビジュアライゼーションIDE
  2. NLPアテンションベースモデルの可視化
  3. アテンション効果の勾配フローを可視化する方法
  4. 任意の曲線のログ記録

よくある質問​

近日中に追加予定​

  • ポーリング：チャート内のデータの自動更新
  • サンプリング：パネルに読み込まれるポイントの総数を動的に調整して効率を向上させる

ゴッチャ​

  • チャートの編集中に、想定しているデータがクエリに表示されない理由は、選択しているrunに探している列が記録されていないためかもしれません。チャートを保存して、runテーブルに戻り、eyeアイコンを使用して表示したいrunを選択してください。

カスタムチャートで「ステップスライダー」を表示するには？​

これは、カスタムチャートエディタの「その他の設定」ページで有効にできます。クエリをsummaryTableからhistoryTableに変更すると、カスタムチャートエディタで「ステップセレクタを表示」するオプションが得られます。これにより、ステップを選択できるスライダーが提供されます。

カスタムチャートプリセットを削除する方法は？​

これは、カスタムチャートエディタに行くことでできます。次に、現在選択されているチャートタイプをクリックし、プリセットがすべて表示されるメニューを開きます。削除したいプリセットの上にマウスを置き、ゴミ箱アイコンをクリックします。

一般的なユースケース​

  • エラーバー付きの棒グラフをカスタマイズする

  • カスタムx-y座標が必要なモデル検証メトリクスを表示する（PR曲線のような）

  • 二つの異なるモデル/実験からのデータ分布をヒストグラムで重ねて表示する

  • トレーニング中に複数のポイントでのメトリックの変化をスナップショットで表示する

  • W&Bではまだ利用できない独自の可視化を作成し（そしてできれば世界と共有する）

On this page
Was this page helpful?👍👎