> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> View and traverse artifact lineage graphs to track the inputs and outputs of W&B runs as a directed acyclic graph.

# Explore artifact lineage graphs

W\&B は、\_リネージグラフ\_と呼ばれる有向非巡回グラフ (DAG) を使って run の入力と出力を追跡します。リネージグラフは、機械学習の実験におけるアーティファクトと run の関係を視覚的に表したものです。データとモデルが、
生データの取り込みからモデルのトレーニングや評価まで、機械学習のライフサイクルの各段階をどのように流れるかを示します。

アーティファクトのリネージを追跡することには、次のような主な利点があります。

* **再現性**: チームがデバッグ、実験、検証のために実験、モデル、結果を再現できるようにします。
* **バージョン管理**: アーティファクトの変更を時系列で追跡し、必要に応じて以前のデータやモデルのバージョンに戻せるようにします。
* **監査**: アーティファクトと変換の詳細な記録を保持し、コンプライアンスとガバナンスを支援します。
* **共同作業**: 実験履歴を透明化し、作業の重複を減らし、開発を加速することで、チームワークの向上に役立ちます。

<h2 id="view-an-artifacts-lineage-graph">
  アーティファクトのリネージグラフを表示する
</h2>

アーティファクトのリネージグラフを表示するには、次の手順に従います。

1. W\&B アプリで、対象のプロジェクトのワークスペースにアクセスします。
2. プロジェクトのサイドバーで **Artifacts** タブをクリックします。
3. アーティファクトを選択し、**Lineage** タブをクリックします。

<h2 id="navigate-lineage-graphs">
  リネージグラフを操作する
</h2>

リネージグラフは、ML実験におけるアーティファクトとrunの関係を視覚的に表現したものです。W\&B アプリ UIまたはPython SDKを使用して、アーティファクトのリネージグラフを探索し、たどることができます。

<Tabs>
  <Tab title="W&B App UI">
    緑色のアイコンを持つノードはrunを表します。青色のアイコンを持つノードはアーティファクトを表します。ノード間の矢印は、runまたはアーティファクトの入力と出力を示します。

    アーティファクトノードには、アーティファクトの名前とバージョンの形式 `<artifact_name>:<version>` で表示されます。アーティファクトのタイプは、アーティファクト名の上に表示されます。

    <Note>
      アーティファクトのタイプと名前は、左サイドバーとリネージグラフノードの両方で確認できます。
    </Note>

    Runノードにはrunの名前が表示されます。

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage2.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=a2fd27e45b1a080e02a194af597debaf" alt="Run and artifact nodes" width="4608" height="1754" data-path="products/wandb/_media/lineage2.png" />
    </Frame>

    個別のrunをクリックすると、そのrunの開始時間、所要時間、作成者、ジョブタイプなどの詳細情報を確認できます。個別のアーティファクトをクリックすると、アーティファクトのエイリアス、作成時間、タイプ、バージョン、説明、アーティファクトをログしたrun、ファイルサイズなどの詳細情報を確認できます。

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage3a.gif?s=312d9c111d2e9b16cb04de31f06c5865" alt="Previewing a run" width="4754" height="1930" data-path="products/wandb/_media/lineage3a.gif" />
    </Frame>

    同じアーティファクトの複数のバージョンを生成したrunは、クラスターにグループ化されます。クラスター内にリストされている特定のバージョンをクリックすると、そのアーティファクトバージョンの詳細情報を確認できます。

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage_multiple_artifact_versions.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=0ec0d2f4d521f0a27be77dfaa156d212" alt="Cluster of artifact versions in a lineage graph" width="4594" height="1866" data-path="products/wandb/_media/lineage_multiple_artifact_versions.png" />
    </Frame>

    ノードをクリックしてドラッグすると、グラフのレイアウトをカスタマイズして再配置できます。ノードとその関係をよりよく確認するために、グラフをズームインおよびズームアウトすることもできます。

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage_rearrange_nodes.gif?s=81b87ad3898858fd9cc38b7f732237d3" alt="Rearranging nodes in a lineage graph" width="4754" height="2466" data-path="products/wandb/_media/lineage_rearrange_nodes.gif" />
    </Frame>

    ノードにマウスをホバーし、目のアイコンをクリックすると、グラフ内のノードを非表示または表示できます。これは、特定のノードとその関係に焦点を当てるためにグラフを整理するのに便利です。
  </Tab>

  <Tab title="W&B Python SDK">
    W\&B Python SDKを使用して、プログラムでグラフを操作します。アーティファクトオブジェクトの
    [`logged_by()`](/ja/products/wandb/ref/python/experiments/artifact#method-artifact-logged-by) および [`used_by()`](/ja/products/wandb/ref/python/experiments/artifact#method-artifact-used-by) メソッドを使用して、グラフを移動します:

    ```python theme={"system"}
    with wandb.init() as run:
        artifact = run.use_artifact("artifact_name:latest")

        # Walk up and down the graph from an artifact:
        producer_run = artifact.logged_by()
        consumer_runs = artifact.used_by()
    ```
  </Tab>
</Tabs>

<h2 id="enable-lineage-graph-tracking">
  リネージグラフのトラッキングを有効にする
</h2>

リネージグラフのトラッキングを有効にするには、W\&B Python SDK を使用して、アーティファクトを run の[入力](/ja/products/wandb/artifacts/explore-and-traverse-an-artifact-graph)または
[出力](/ja/products/wandb/artifacts/explore-and-traverse-an-artifact-graph#track-the-output-of-a-run)として指定する必要があります。

<h3 id="track-the-input-of-a-run">
  run の入力をトラッキングする
</h3>

アーティファクトを run の入力 (または依存関係) として [`wandb.Run.use_artifact()`](/ja/products/wandb/ref/python/experiments/run#method-runuse_artifact)
メソッドでマークします。アーティファクトの名と、オプションのエイリアスを指定して、そのアーティファクトの特定のバージョンを参照します。アーティファクトの
名は `<artifact_name>:<version>` または `<artifact_name>:<alias>` の形式です。

山括弧 (`< >`) で囲まれた値をあなたの値に置き換えてください：

```python theme={"system"}
import wandb

# run を初期化します
with wandb.init(entity="<entity>", project="<project>") as run:
  # アーティファクトを取得し、依存関係としてマークします
  artifact = run.use_artifact(artifact_or_name="<name>", aliases="<alias>")
```

<h3 id="track-the-output-of-a-run">
  run の出力をトラッキングする
</h3>

[`wandb.Run.log_artifact()`](/ja/products/wandb/ref/python/experiments/run#log_artifact) を使用して、アーティファクトを run の出力として宣言します。まず、[`wandb.Artifact()`](/ja/products/wandb/ref/python/experiments/artifact#wandb.Artifact) コンストラクターでアーティファクトを作成します。次に、`wandb.Run.log_artifact()` を使用して、アーティファクトを run の出力としてログします。

山括弧 (`< >`) で囲まれた値をあなたの値に置き換えてください：

```python theme={"system"}
import wandb

# run を初期化します
with wandb.init(entity="<entity>", project="<project>") as run:
  
  # アーティファクトを作成します
  artifact = wandb.Artifact(name = "<artifact_name>", type = "<artifact_type>")
  artifact.add_file(local_path = "<local_filepath>", name="<optional-name>")

  # run の出力としてアーティファクトをログします
  run.log_artifact(artifact_or_path = artifact)
```

<h2 id="artifact-clusters">
  アーティファクト クラスター
</h2>

グラフのレベルに 5 つ以上の run または アーティファクト がある場合、クラスターが作成されます。クラスターには、run または アーティファクト の特定のバージョンを検索する検索バーがあり、クラスター内のノードのリネージを調査し続けるために、クラスターから個別のノードをプルします。

ノードをクリックすると、そのノードの概要を含むプレビューが開きます。矢印をクリックすると、個別の run または アーティファクト が抽出され、抽出されたノードのリネージを調べることができます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/lineage3b.gif?s=b0e02791559ddc14bb345c930cc11e73" alt="run クラスターの検索" width="3016" height="1600" data-path="products/wandb/_media/lineage3b.gif" />
</Frame>