> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-dbrian-docs-serverless-training-quickstart.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# メディアパネル
> 画像、動画、オーディオ、3D オブジェクト、ポイントクラウド向けのメディアパネルを W&B Workspace に追加して設定します。
メディアパネルでは、3D オブジェクト、オーディオ、画像、動画、ポイントクラウドなど、[メディアオブジェクトとしてログされたキー](/ja/models/track/log/media/)を可視化できます。このページでは、Workspace でメディアパネルを追加して管理する方法を説明します。
## メディアパネルを追加する
Quick Add を使用してメディアパネルを追加することもできます (この場合、デフォルトの設定が適用されます)。また、作成時に設定できるように手動で追加することもできます。いずれの場合も、パネルは Workspace 全体に追加することも、特定のセクションに追加することもできます。
デフォルトの設定でログ済みのキーに対するメディアパネルを追加するには、Quick Add を使用します。
1. **Global**: パネル検索フィールドの近くにあるコントロールバーで **Add panels** をクリックします。
2. **Section**: セクションの **action ()** メニューをクリックし、**Add panels** をクリックします。
3. 利用可能なパネルの一覧で対象のパネルのキーを探し、**Add** をクリックします。追加する各メディアパネルについてこの step を繰り返し、最後に右上の **X** をクリックして **Quick Add** リストを閉じます。
4. 必要に応じて、[メディアパネルを設定](#configure-a-media-panel)します。
作成時に設定できるようにメディアパネルを手動で追加するには:
1. **Global**: パネル検索フィールドの近くにあるコントロールバーで **Add panels** をクリックします。
2. **Section**: セクションの **action ()** メニューをクリックし、**Add panels** をクリックします。
3. **Media** セクションをクリックして展開します。
4. パネルで可視化するメディアのタイプ (3D オブジェクト、images、video、またはオーディオ) を選択します。パネルの設定画面が表示されます。パネルを設定して **Apply** をクリックします。詳細は [メディアパネルを設定する](#configure-a-media-panel)を参照してください。
## メディアパネルを設定する
すべてのメディアタイプのパネルで、同じオプションを使用できます。そのため、以下の手順は、どのメディアタイプを扱っている場合にも適用されます。
メディアパネルを手動で追加すると、メディアのタイプを選択した後に設定ページが開きます。既存のパネルの設定を更新するには、パネルにカーソルを合わせ、右上に表示される歯車アイコンをクリックします。以下のセクションでは、各タブで利用可能な設定について説明します。
### オーバーレイ
このタブは、セグメンテーションマスクまたはバウンディングボックスとともにログした画像やポイントクラウドに対して表示されます。これを使用して次の操作を行います。
* オーバーレイを名で検索・フィルターします。
* オーバーレイの色をカスタマイズします。
### Sync
このタブは、Workspace とセクション設定に表示され、以下の設定項目があります。
* **Sync slider by key**: セクション内の動画の step スライダーを同期して動かすかどうかを設定します。
* **動画の自動再生**: ページの読み込み時に動画の再生を開始するかどうかを設定します。
* **Loop videos**: セクション内の動画を自動的に最初から再生し、停止するまで連続再生するかどうかを設定します。セクションレベルではカスタマイズできません。Workspace に動画メディアパネルがある場合にのみ表示されます。
### Display
パネル全体の外観と動作をカスタマイズします:
* パネルのタイトルを設定します。
* 表示するメディアキーを選択します。
* パネルのスライダーや再生時の動作をカスタマイズします。
* スライダーキーを設定します。デフォルトは **Step** です。
* **Stride length** を、スライダーをクリックするたびに進める step 数に設定します。
* **Snap to existing step** をオンまたはオフにします。オンの場合、ステッパーは **Stride length** 分進んだ後、次の既存の step に移動します。オフの場合は、既存の step と一致しなくても **Stride length** 分だけ進みます。
* **Images**: スムージングをオンまたはオフにします。
* **Videos**: 左右の矢印キーを使用したときに、前後へどれだけスキップするかを制御する video seek step interval を設定します。
* **3D オブジェクト**: 背景色とポイントの色を設定します。
### Layout
パネル内の各項目の表示をカスタマイズします:
* 必要に応じて、パネルに含める **Max runs to include** の数を制限します。
* 必要に応じて、run ごとに含めるメディア項目数を制限する **Media display limit** を指定します。
* **Panel mode** を設定します:
* **Gallery** (デフォルト) : 列数と、グリッドに run ごとに 1 つの項目 (デフォルト) 、step ごと、またはインデックスごとの項目を表示するかどうかを指定します。
* **Grid**: 列数、x 軸 (デフォルトは **Log Step**) 、y 軸 (デフォルトは **Run**) を指定します。
* **Compare**: 最大 4 つのメディア項目を横に並べて比較し、必要に応じて step またはインデックスごとに展開できます。詳細は [Compare mode](#compare-mode) を参照してください。
* **Use original size**: オフ (デフォルト) の場合、W\&B はパネル内の画像と動画を同じサイズで表示されるように拡大・縮小します。**Compare** モードでは効果はありません。
* メディアのフィットとスケーリングの動作を設定します:
* **Images**: **Original image**、**Original size**、**Fit to available space** のいずれかを選択します。最後のオプションを選択すると、W\&B はパネル内の画像を可能な限り大きく表示されるように拡大・縮小します。**Gallery** モードでは、各画像はパネルの幅いっぱいに表示されます。**Grid** モードでは、各画像はグリッドの幅いっぱいに表示されます。**Compare** モードでは効果はありません。
* **Videos**: **Use original size** を切り替えて、メディアを同じサイズで表示されるように拡大・縮小するかどうかを制御します。オフ (デフォルト) の場合、W\&B はパネル内の動画を可能な限り大きく表示されるように拡大・縮小します。**Gallery** モードでは、各動画はパネルの幅いっぱいに表示されます。**Grid** モードでは、各動画はグリッドの幅いっぱいに表示されます。**Compare** モードでは効果はありません。
* **Right-handed system**: オンの場合、ポイントクラウドはデフォルトの左手系ではなく、右手系で点をプロットします。
### セクション内のすべてのメディアパネル
セクション内のすべてのメディアパネルで同じ設定を共有し、Workspace レベルのデフォルトを上書きしたい場合は、セクション レベルのデフォルトを設定します。
セクション内のすべてのメディアパネルのデフォルト設定をカスタマイズして、メディアパネルの Workspace 設定を上書きするには、次のようにします。
1. セクションの歯車アイコンをクリックして設定を開きます。
2. **Media settings** をクリックします。
3. 表示されたドロワーで、**Display**、**Layout**、または **Sync** タブをクリックし、セクションのデフォルトのメディア設定を行います。画像、動画、オーディオ、3D オブジェクトの設定を行えます。表示される設定項目は、セクション内の現在のメディアパネルによって異なります。
**Display** または **Layout** のメディア設定にある各設定項目の詳細については、[メディアパネルを設定する](#configure-a-media-panel) を参照してください。**Sync** タブは、個々のメディアパネルではなく、セクションまたは Workspace レベルでのみ使用できます。
**Step slider syncing** をオンにすると、同じ step スライダーを持つセクション内のメディアパネルが同期された状態に保たれます。step スライダーの同期をオンにするには、次のようにします。
1. **Sync** タブをクリックします。
2. **Sync slider by key (Step)** をオンにします。
### Workspace 内のすべてのメディアパネル
Workspace 内のすべてのセクションにわたってメディアパネルの一貫したベースラインを設定したい場合は、Workspace レベルのデフォルトを構成します。
Workspace 内のすべてのメディアパネルのデフォルト設定をカスタマイズするには、次の手順に従います。
1. **Settings** と表示された歯車アイコンの Workspace 設定をクリックします。
2. **Media settings** をクリックします。
3. 表示されるドロワー内で **Display** または **Layout** タブをクリックし、Workspace のデフォルトのメディア設定を構成します。画像、動画、オーディオ、3D オブジェクトの設定を構成できます。表示される設定は、Workspace の現在のメディアパネルによって異なります。
**Sync** タブを除く各設定の詳細については、[メディアパネルを設定する](#configure-a-media-panel) を参照してください。**Sync** タブは、個々のメディアパネルではなく、セクションまたは Workspace レベルでのみ使用できます。
**Step slider syncing** をオンにすると、同じ step スライダー を持つセクション内のメディアパネルは同期された状態に保たれます。step スライダー syncing をオンにするには、次の手順に従います。
1. **Sync** タブをクリックします。
2. **Sync slider by key (Step)** をオンにします。
各設定の詳細については、[メディアパネルを設定する](#configure-a-media-panel) を参照してください。
## Compare mode
Compare mode を使用すると、runs、steps、または indices を任意に組み合わせて、2～4 個の画像または動画を選択し、1 つのグリッドに表示できます。1 つ以上のファイルをダウンロードしたりタブを切り替えたりすることなく、メディアを比較できます。
Compare mode の主な用途:
* 新しい checkpoint や run が、ベースラインや以前の checkpoint よりも良い出力を生成していることを確認する。
* 同じ step または index で現在の run を既知の良好な checkpoint と比較し、リグレッションを検出する。
* reference メディアと生成されたメディアを並べて表示し、モデルの出力を ground truth と照らし合わせて検証する。
* トレーニング step 間、または異なる checkpoints や runs 間で、生成された画像や動画がどのように変化するかを確認する。
Compare mode は、diffusion や generative models などの画像・動画生成 workflow、マルチモーダル評価、vision experiments、そのほかメディアをログし、runs、steps、または indices をまたいで比較する必要がある workflow で役立ちます。
Compare mode を使用するには:
1. Workspace でメディアパネルを開きます (画像または動画) 。
2. **Panel mode** を **Compare** に設定します。
3. 列数と fan-out mode を指定して、グリッドのサイズと密度を設定します。最適なグリッド構成は、runs がどのようにメディアをログするかによって異なります。
* **Number of columns**: 1 行あたりに表示する項目数です。`1` から `4` まで指定できます。
* **Fan out**: グリッドの各行に表示するメディアの粒度を制御します。最適な設定は、各 run の各 step でログするメディア項目数や、手早くスポットチェックしたいのか、詳細に分析したいのかによって異なります。
* **None** (デフォルト): fan-out なし。グリッドの各列は run を表し、各行はログされた画像または動画を表します。
* **Step**: step 軸に沿って fan out します。グリッドの各列は run を表し、各行には run:step の組み合わせで最初にログされた画像または動画が表示されます。
* **Index**: index 軸に沿って fan out します。step ごとに複数の項目をログする場合に便利です (たとえば、`run.log({"images": [img0, img1, img2, img3]})`) 。各行のセルには、特定の run:step:index の組み合わせでログされた画像または動画が表示されます。
4. 各変数が単一のタイル (**Individual**) に影響するか、すべてのタイル (**Linked**) に影響するかを設定します。
* **Media key**: デフォルトは **Linked** です。
* **Run**: デフォルトは **Individual** です。
* **Step**: デフォルトは **Linked** です。
* **Index**: デフォルトは **Linked** です。
W\&B は選択内容を保存するため、後から同じ比較に戻る際にパネルを再設定する必要はありません。
## メディアパネルを操作する
メディアパネルを追加して設定した後は、以下の操作を使用して、ログされたメディアを順に確認したり、比較したり、詳しく調べたりできます。
* メディアパネルを設定するには、パネルにカーソルを合わせて、上部の歯車アイコンをクリックします。
* メディアパネルのstep スライダーを移動するには、**Cmd + 左矢印キーまたは右矢印キー** (macOS) または **Ctrl + 左矢印キーまたは右矢印キー** (Windows または Linux) を使用します。セクションまたはWorkspaceで **Sync slider by key** がオンになっている場合、1 つのメディアパネルでstep スライダーを動かすと、同じstep スライダーキーを持つ他のメディアパネルのstep スライダーも連動して動きます。
* メディアパネル上部のステッパーを使用して、メディアrunを順に切り替えます。step スライダーを移動するには、UIコントロールを使用します。
* メディアパネルをクリックすると、全画面モードで表示できます。全画面モードを終了するには、パネル上部の矢印ボタンをクリックします。
* 全画面モードを終了せずにセクション内のパネルを切り替えるには、パネル下部の **Previous** ボタンと **Next** ボタン、または左右の矢印キーを使用します。
* 画像を全画面モードで表示しているときは、右上のズームコントロールをクリックして拡大または縮小できます。デフォルトでは、画像は表示領域に収まるように拡大縮小されます。拡大した画像は、クリックしてドラッグすると移動できます。キーボードショートカットを使用して、拡大、縮小、ズームを 100% にリセット、または全体が収まるようにズームすることもできます。詳しくは [Keyboard shortcuts](/ja/models/app/keyboard-shortcuts#media-panels) を参照してください。
* セグメンテーションマスクとともにログされた画像では、表示をカスタマイズしたり、各マスクの表示をオンまたはオフにしたりできます。パネルにカーソルを合わせてから、下部の歯車アイコンをクリックします。
* バウンディングボックスとともにログされた画像またはポイントクラウドでは、表示をカスタマイズしたり、各ボックスの表示をオンまたはオフにしたりできます。パネルにカーソルを合わせてから、下部の歯車アイコンをクリックします。
* メディアコントロールを使用して、動画の再生、一時停止、停止を行います。左右の矢印キーを使用すると、設定された **video seek step** 単位で早送りまたは巻き戻しできます。**Sync video playback** がオンになっている場合、セクション内のすべての動画が同期して再生されます。**Loop videos** がオンになっている場合、セクション内の動画は自動的に最初から再生され、停止するまで連続して再生されます。