生成 AI アプリケーションを構築するための W&B のツール群、W&B Weave をお探しですか?Weave ドキュメントをご覧ください。

クエリパネルを作成する
クエリパネルを追加すると、式を記述して結果を視覚化するためのエリアが用意されます。プロジェクトの Workspace または report 内に追加できます。- プロジェクトの Workspace
- W&B Report
- プロジェクトの Workspace にアクセスします。
- 右上の隅で、Add panel をクリックします。
- ドロップダウンメニューから Query panel を選択します。
クエリコンポーネント
以下のセクションでは、クエリパネルを構成する3つの要素について説明します。データを選択する式、パネルの動作を制御する設定、および出力をレンダリングする結果パネルです。式
クエリ式を使用して、W&B に保存されている run、アーティファクト、モデル、表などのデータをクエリします。Example: 表をクエリする
W&B Table をクエリしたいとします。トレーニングコード内で、"cifar10_sample_table" という名前の表をログします:

runsは、クエリパネルが Workspace にある場合にクエリパネル式に自動的に注入される変数です。その値は、その Workspace で表示される run のリストです。run 内で利用可能なさまざまな属性の詳細については、さまざまな属性の理解 を参照してください。summaryは、run の Summary オブジェクトを返す Op です。Op は マッピング され、この Op がリスト内の各 run に適用され、Summary オブジェクトのリストが生成されます。["cifar10_sample_table"]は、キーcifar10_sample_tableを持つ Pick op (括弧で示される) です。Summary オブジェクトは辞書やマップのように動作するため、この操作は各 Summary オブジェクトからそのフィールドを選択します。
設定
パネルの左上隅にある歯車アイコンをクリックしてクエリ設定を展開します。設定では、パネルのタイプと結果パネルのパラメーターを設定できます。
パネルのオプション
設定メニューには、パネルが表形式の結果を結合または読み込む方法を変更するオプションが含まれる場合があります。実際のラベルや利用できるオプションは、式とパネルのタイプによって異なります。具体的な設定例については、Query panel examples report を参照してください。 Concat 互換性のある表形式の結果をパネルで結合し、表示や後続の操作で単一の表として扱う場合は、設定で Concat を使用します。式レベルでの行の結合 (たとえば、クエリ内のconcat や join) は、この設定とは別のものです。詳細については、式で表を結合するを参照してください。
Paginate
表の結果が大きく、一度にレンダリングできない可能性がある場合は、Paginate を使用します。ページネーションでは行をチャンク単位で読み込むため、パネルの応答性が保たれます。このオプションは、大量の行を返す式と組み合わせて使用してください。ページネーションに適したパターンについては、Query panel examples report を参照してください。
結果パネル
クエリの結果パネルは、選択したクエリパネルを使用してクエリ式の結果をレンダリングします。クエリパネルは、データをインタラクティブな形式で表示するように設定されています。次の画像は、同じデータを Table と Plot で表示した例です。

run の履歴をステップごとに進める
runs または runs.history から構築された表やプロットでは、アプリは ステップ コントロール (例: スライダー) を表示して、ログされたステップを移動し、run の過程でメトリクス、テキスト、またはメディアを検査できます。式を変更した後、クエリパネルの設定を編集し、Render As を Stepper に変更します。コントロールは、データのログ方法に合わせて _step 以外のメトリクスに従うことができます。サンプルの式については、Query panel examples report を参照してください。
基本的な操作
クエリパネルが結果をレンダリングした後、並べ替え、フィルター、マッピング、または行のグループ化によって表示内容を絞り込むことができます。以下は、クエリパネル内で実行できる一般的な操作です。並べ替え
列のオプションから並べ替えを行います。
フィルター
クエリ内で直接フィルターするか、パネルの左上隅にあるフィルターボタンを使用できます。

Map
Map 操作はリストを反復処理し、データ内の各要素に関数を適用します。パネルクエリで直接実行するか、列オプションから新しい列を挿入して実行できます。

グループ化
クエリを使用するか、列のオプションからグループ化できます。

式で表を結合する
表の行リストを縦に連結したりマージしたりするには、式でconcat、join、およびその関連 Op を使用します。完全な例については、Join を参照してください。なお、パネルのオプション にある Concat と Paginate の項目は、UI で表の結果をマージしたり読み込んだりする方法を制御するもので、これらとは別のコントロールです。
Join
クエリ内で表を直接結合することもできます。次のクエリ式を例に説明します。
(row) => row["Label"]は各表のセレクターで、結合に使用する列を決定します。"Table1"と"Table2"は、結合時に使用される各表名です。trueとfalseは、左側および右側それぞれの内部結合/外部結合の設定です。
run オブジェクト
クエリパネルを使用してruns オブジェクトにアクセスします。Run オブジェクトは実験の記録を保存します。詳細については、Accessing runs object を参照してください。クイック概要として、runs オブジェクトには以下が利用可能です。
summary: run の結果を要約する情報の辞書。summary には、精度や損失などのスカラー値、または大規模なファイルを含めることができます。デフォルトでは、wandb.Run.log()は summary をログされた時系列の最終値に設定します。summary の内容を直接設定できます。summary を run の出力と考えることができます。history: モデルがトレーニング中に変化する値 (損失など) を保存するための辞書のリスト。コマンドwandb.Run.log()はこのオブジェクトに追加します。config: トレーニング run のハイパーパラメーターや、データセット アーティファクトを作成する run の前処理方法など、run の設定情報の辞書。これらを run の入力と考えることができます。

アーティファクトへのアクセス
アーティファクトは W&B のコアコンセプトです。バージョン管理された、名前付きのファイルとディレクトリのコレクションです。アーティファクトを使用して、モデルの重み、データセット、その他のファイルやディレクトリをトラッキングします。W&B はアーティファクトを保存し、ダウンロードしたり他の run で使用したりできます。詳細と例については、アーティファクトへのアクセス を参照してください。通常はproject オブジェクトからアーティファクトにアクセスします:
project.artifactVersion(): project 内の指定された名前とバージョンの特定のアーティファクトのバージョンを返します。project.artifact(""): project 内の指定された名前のアーティファクトを返します。その後、.versionsを使用してこのアーティファクトのすべてのバージョンのリストを取得できます。project.artifactType(): project 内の指定された名前のartifactTypeを返します。その後、.artifactsを使用してこのタイプのすべてのアーティファクトのリストを取得できます。project.artifactTypes: project 下のすべてのアーティファクト タイプのリストを返します。

