メインコンテンツへスキップ
W&B で可視化およびクエリするデータをログするには、wandb.Table を使用します。このガイドでは、次の方法を学びます。
  1. Tables を作成する
  2. データを追加する
  3. データを取得する
  4. Tables を保存する

表を作成する

Table を定義するには、データの各行に対して表示したい列を指定します。各行は、トレーニング用データセット内の 1 つの項目、トレーニング中の特定の step やエポック、テスト項目に対してモデルが行った予測、モデルによって生成されたオブジェクトなどを表します。各列には、数値、テキスト、ブール値、画像、動画、オーディオなどの固定のタイプがあります。タイプを事前に指定する必要はありません。各列に名を付け、その列インデックスにはそのタイプのデータだけを渡すようにしてください。より詳しい例については、W&B Tables ガイドを参照してください。 wandb.Table コンストラクタは、次の 2 つの方法のいずれかで使用します。
  1. 行のリスト: 名前付きの列とデータ行をログします。たとえば、次のコード スニペットは 2 行 3 列の表を生成します。
  2. Pandas DataFrame: wandb.Table(dataframe=my_df) を使用して DataFrame をログします。列名は DataFrame から抽出されます。

既存の配列またはデータフレームから

データを追加する

表は変更可能です。スクリプトの実行中に、表へ最大 200,000 行までデータを追加できます。表にデータを追加する方法は 2 つあります。
  1. 行を追加する: table.add_data("3a", "3b", "3c")。新しい行はリストとして表現されない点に注意してください。行がリスト形式の場合は、スター記法 * を使用してリストを位置引数に展開します: table.add_data(*my_row_list)。行には、表の列数と同じ数のエントリが含まれている必要があります。
  2. 列を追加する: table.add_column(name="col_name", data=col_data)col_data の長さは、表の現在の行数と同じである必要があります。ここで、col_data にはリストまたは NumPy の NDArray を使用できます。

データを段階的に追加する

このコードサンプルでは、W&B の表を段階的に作成し、データを追加していく方法を示します。表は、考えられるすべてのラベルの信頼度スコアを含む事前定義済みの列で定義し、推論中にデータを1行ずつ追加します。また、run の再開時に表へデータを段階的に追加することもできます。

再開したrunにデータを追加する

artifactから既存の表を読み込み、データの最終行を取得して更新後のメトリクスを追加することで、再開したrunのW&Bの表を段階的に更新できます。次に、互換性を保つために表を再初期化し、更新したバージョンをW&Bにログします。

データを取得する

データが Table に入ったら、列単位または行単位でアクセスできます。
  1. 行イテレータ: for ndx, row in table.iterrows(): ... のように Table の行イテレータを使用して、データの各行を効率的に反復処理できます。
  2. 列を取得する: table.get_column("col_name") を使用してデータの列を取得します。必要に応じて、convert_to="numpy" を渡すと、その列をプリミティブ型の NumPy NDArray に変換できます。これは、列に wandb.Image のようなメディアタイプが含まれている場合に、元のデータへ直接アクセスするのに便利です。

テーブルを保存する

スクリプトでデータの表 (たとえばモデルの予測をまとめた表) を生成したら、結果をリアルタイムで可視化できるよう、W&B に保存します。

表を run にログする

wandb.Run.log() を使用して、次のように表を run に保存します。
表が同じキーにログされるたびに、新しいバージョンの表が作成され、バックエンドに保存されます。つまり、同じ表を複数のトレーニングstepにわたってログすれば、時間の経過とともにモデルの予測がどのように改善していくかを確認できます。また、同じキーにログされていれば、異なるrun間で表を比較することもできます。ログできるのは最大 200,000 行です。
200,000 行を超えてログするには、次のように制限を上書きできます。wandb.Table.MAX_ARTIFACT_ROWS = Xただし、これにより、UI でのクエリが遅くなるなどのパフォーマンス上の問題が発生する可能性があります。

プログラムから Tables にアクセスする

バックエンドでは、Tables は Artifacts として永続化されます。特定のバージョンにアクセスする場合は、artifact API を使用できます。
Artifacts の詳細については、Developer Guide のArtifacts 章を参照してください。

表を可視化する

この方法でログした表は、Workspace の Run Page と Project Page の両方に表示されます。詳細は、表の可視化と分析を参照してください。

Artifact テーブル

Workspace ではなく、run の Artifacts セクションに表をログするには、artifact.add() を使用します。これは、一度だけログし、その後の run から参照したいデータセットがある場合に便利です。
画像データを使った artifact.add() の詳細な例 についてはこの Colab を、Artifacts と Tables を使って表形式データのバージョン管理と重複排除を行う方法の例についてはこの Report を参照してください。

Artifact テーブルを結合する

ローカルで作成したテーブルや、他の artifact から取得したテーブルは、wandb.JoinedTable(table_1, table_2, join_key) を使って結合できます。 artifact コンテキストで以前にログした 2 つの Table を結合するには、それらを artifact から取得し、その結果を新しい Table にまとめます。 たとえば、次のコード例は、'original_songs' という名前の元の楽曲の Table と、同じ楽曲の合成版を含む 'synth_songs' という名前の別の Table を読み取る方法を示しています。このコードは 2 つのテーブルを "song_id" で結合し、結果のテーブルを新しい W&B Table としてアップロードします。
このチュートリアルを参照して、異なるArtifactオブジェクトに保存されている2つの既存の表を結合する方法の例を確認してください。