ハイパーパラメーターコントローラーは、デフォルトでは W&B のクラウドサービスとしてホストされています。W&B エージェントはコントローラーと通信し、トレーニングに使用する次のパラメーターセットを決定します。コントローラーはまた、どの run を停止できるかを判断するために、早期停止アルゴリズムを実行する役割も担います。
ローカルコントローラー機能を使用すると、探索アルゴリズムと停止アルゴリズムをローカルで実行できます。ローカルコントローラーを使うことで、問題のデバッグや、クラウドサービスに組み込める新機能の開発に向けて、コードを調査・計測できます。
この機能は、Sweeps 向けの新しいアルゴリズムをより迅速に開発およびデバッグできるようにするためのサポートとして提供されています。実運用のハイパーパラメーター最適化ワークロードを想定したものではありません。
開始する前に、W&B SDK(wandb) をインストールする必要があります。次のコードスニペットをコマンドラインに入力してください。
以下の例では、PythonスクリプトまたはJupyter Notebook内で、設定ファイルとトレーニングループがすでに定義されていることを前提としています。設定ファイルの定義方法について詳しくは、sweepの設定を定義するを参照してください。
コマンドラインからローカルコントローラーを実行する
通常どおり、W&B のクラウドサービスで提供されるハイパーパラメーターコントローラーを使用する場合と同様に、sweep を初期化します。W&B sweep ジョブでローカルコントローラーを使用することを示すには、controller フラグ (controller) を指定します:
あるいは、sweep の初期化とローカルコントローラーを使用する指定を、2 つの step に分けることもできます。
step を分けるには、まず sweep の YAML 設定ファイルに次のキーと値のペアを追加します。
次に、sweepを初期化します。
wandb sweep は sweep ID を生成します。sweep を初期化したら、wandb controller でコントローラーを起動します。
ローカルコントローラーを使用するように指定したら、sweep を実行するために 1 つ以上の Sweep エージェントを起動します。通常どおり W&B Sweep を開始してください。詳細については、Start sweep agents を参照してください。
W&B Python SDK でローカルコントローラーを実行する
以下のコードスニペットでは、W&B Python SDK でローカルコントローラーを指定して使用する方法を示します。
Python SDK でコントローラーを使用する最も簡単な方法は、wandb.controller() method に sweep ID を渡すことです。次に、返されたオブジェクトの run method を使用して sweep ジョブを開始します。
コントローラーループをより細かく制御したい場合:
あるいは、提供するパラメーターをさらに細かく制御することもできます。
sweep を完全にコードだけで指定したい場合は、次のようにできます。