> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-update-reference-docs-40.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 元のデータを失うことなく、run の履歴を修正または変更するために run を巻き戻します。
# run を巻き戻す
run の履歴を変更するには、run を巻き戻します。run を巻き戻すと、W\&B は同じ run ID を維持したまま、run の状態を指定した step にリセットします。
run を巻き戻すオプションは現在プライベートプレビュー段階にあり、活発に開発が進められています。Rewind には既知のパフォーマンス上の制約があるため、W\&B は通常、代替手段として [Forking](./forking) を推奨しています。
現在、W\&B は以下をサポートしていません。
* **ログの巻き戻し**: 新しい run セグメントではログがリセットされます。
* **システムメトリクスの巻き戻し**: W\&B は巻き戻しポイント以降の新しいシステムメトリクスのみをログします。
* **artifact の関連付け**: W\&B は artifact を、それを生成したソース run に関連付けます。
この機能へのアクセスをリクエストするには、[support@wandb.com](mailto:support@wandb.com) の W\&B Support までお問い合わせください。
W\&B は、巻き戻した run の summary メトリクスを、新たにログされた履歴に基づいて再計算します。これは、次のような動作を意味します。
* **履歴の切り詰め**: W\&B は履歴を巻き戻しポイントで切り詰め、新しいデータをログできるようにします。
* **summary メトリクス**: 新たにログされた履歴に基づいて再計算されます。
* **設定の保持**: W\&B は元の設定を保持し、新しい設定をマージできます。
**巻き戻しとフォークの互換性**
フォークは巻き戻しを補完する機能です。
run からフォークすると、W\&B は特定の時点の run から新しいブランチを作成し、異なるパラメーターやモデルを試せるようにします。
run を巻き戻すと、W\&B は run の履歴そのものを修正・変更できるようにします。
## 前提条件
run を巻き戻す前に、以下の前提条件を満たしていることを確認してください。
* run を巻き戻すには、[W\&B Python SDK](https://pypi.org/project/wandb/) のバージョン `0.17.1` 以降が必要です。
* 単調増加する step を使用する必要があります。[`define_metric()`](/ja/models/ref/python/experiments/run#define_metric) で定義した非単調な step は、run の履歴とシステムメトリクスに必要な時系列順を乱すため、使用できません。
## run を巻き戻す
特定の step から run を巻き戻し、その時点から新しいデータをログします。[`wandb.init()`](/ja/models/ref/python/functions/init) の `resume_from` パラメーターには、巻き戻したい run の run ID と step の両方を引数として渡します。`resume_from` パラメーターは、`?_step=` 形式の文字列を受け取ります。ここで、`` は巻き戻したい run の run ID、`` は巻き戻しを開始する step です。
300 step にわたって直線をログするとします:
```python theme={null}
import wandb
# 最初のrunを初期化し、いくつかのメトリクスをログする
with wandb.init(project="", entity="wandb") as run:
for i in range(300):
# 直線をプロットする
run.log({"metric": i, "step": i})
```
プロジェクトのWorkspaceには、step 0 から step 300 までの折れ線グラフが表示されています。
後で、step 200 から run を巻き戻し、`additional_metric` という新しいメトリクスに step 200 から step 300 まで `i*1.1` をログしたいとします。さらに、step 250 以降は直線ではなく、緩やかに波打つ新しいパターン (`i**2 + 2*sin(i/3)`) をログしたいとします。
```python theme={null}
import math
run_ID = "" # 巻き戻したいrunのrun IDに置き換えてください
# 特定のstepから最初のrunを巻き戻し、step 200からメトリクスをログする
with wandb.init(project="", entity="wandb", resume_from=f"{run_ID}?_step=200") as run:
# 最初の数stepはrunのメトリクスをそのままログする
# step 250以降は波形パターンのログを開始する
for i in range(200, 300):
if i < 250:
run.log({"metric": i, "step": i}) # 波形なしでrunのログを継続する
else:
# step 250から波形パターンを導入する
subtle_wave = i + (2 * math.sin(i / 3.0)) # 微細な波形パターンを適用する
run.log({"metric": subtle_wave, "step": i})
# すべてのstepで新しいメトリクスも追加でログする
run.log({"additional_metric": i * 1.1, "step": i})
```
次の画像は、更新後のプロジェクトのWorkspaceを示しています。巻き戻し後のプロットでは、次のような変更が見られます。
* 折れ線グラフでは、step 0 から step 200 まで元の直線的な線が表示され、step 250 から新しいわずかに波打つパターンが始まっています (左の画像) 。
* W\&B は、step 200 から始まる `additional_metric` というラベルの新しいプロット (右のプロット) を作成しました。
## アーカイブされた run を表示する
run を巻き戻した後、W\&B App で元のアーカイブ済みの run を確認できます。アーカイブされた run を表示するには、次の step に従ってください。
1. **Overview タブにアクセスする:** run のページの [**Overview** タブ](./#overview-tab) にアクセスします。このタブでは、run の詳細と履歴をまとめて確認できます。
2. **Forked From フィールドを見つける:** **Overview** タブ内で、`Forked From` フィールドを見つけます。このフィールドには、再開の履歴が記録されています。**Forked From** フィールドにはソース run へのリンクが含まれているため、元の run までたどって巻き戻し履歴全体を把握できます。
`Forked From` フィールドを使うと、アーカイブされた再開のツリー内を簡単にたどり、各巻き戻しの順序と起点を確認できます。
## 巻き戻した run からフォークする
巻き戻した run からフォークするには、`wandb.init()` で [`fork_from`](/ja/models/runs/forking/) 引数を使用し、フォーク元とするソース run ID と、そのソース run の step を指定します。
```python theme={null}
import wandb
# 特定のstepからrunをフォークする
forked_run = wandb.init(
project="",
entity="",
fork_from=f"{rewind_run.id}?_step=500",
)
# 新しいrunでログを続ける
for i in range(500, 1000):
forked_run.log({"metric": i*3})
forked_run.finish()
```