カスタムスケジューラノードを作成すれば、ビルトインのスケジューラノードで対応していないスケジューラソフトウェアにワークを送信することができます。 カスタムノードであれば、独自にワークのスケジュールを組んだり(例えば、独自のスケジューリングアルゴリズムを使用したい)、サードパーティ製または内製のスケジューラのAPIにアクセスすることができます。

カスタムスケジューラを実装するには、以下の手順を踏みます:

1. TOPネットワーク内にPython Schedulerノードを作成します。

   このノードには、スケジューラの挙動を定義するコールバック関数用のフィールドが備わっています。 このノードは、他のスケジューラと同様に動作し、コールバック関数フィールドに入力されたPythonコードを評価して実行します。 これは、作業ネットワーク内でスケジューラコードを試行することができて非常に便利です。

2. このノードのタブで色々なPythonスニペットを記入する方法に関しては、以下のコールバックの実装方法を参照してください。

3. ユーザ側でノードの挙動を制御できるようにするためにSpareパラメータを追加します。

   このようにした方が、Pythonコード内で値をハードコーディングするよりも非常に柔軟性があり便利です。 コードを記述しつつインターフェースを改良し、コードが記述し終わったらパラメータを追加/削除することができます。

   以下のカスタムスケジューラにパラメータインターフェースを追加する方法を参照してください。

4. スケジューラが正しく動作すれば、他のユーザや他のネットワークで使用できるように、そのスケジューラをデジタルアセットに変換することができます。また、これによって個々のTOPノードがスケジューラのパラメータをオーバーライドすることができます(Python Schedulerインスタンスをオーバーライドすることはできません)。

オーバーライドできるコールバックに関しては、スケジューラノードのコールバックを参照してください。

hou.hipFile.load(graph_file)
network = hou.node(node_path)
to_cook = network.displayNode()
if not disp_node:
    to_cook = network

# ネットワークを初期化します。
to_cook.executeGraph(True, True, False, True)
# PDGグラフのクックをブロックします
to_cook.executeGraph(True, True, False, False)

Spareパラメータ とは、既存ノードのパラメータインターフェースに追加する"ユーザ"パラメータのことです。 このパラメータを追加することで、スケジューラにユーザ側で設定可能なオプションを追加することができます。 このノードを後でアセットに変換すれば、それらのSpareパラメータがアセットのインターフェースの一部として自動的に使用できるようになります。

• Spareパラメータを追加する方法に関しては、Spareパラメータを参照してください。

• このノードのPythonコードスニペットの中にselfを使用すれば、このスケジューラを表現したpdg.Schedulerインスタンス(これは、Houdiniネットワークノードオブジェクト ではありません )を参照することができます。

  Python Processorノード/アセット上のすべてのSpareパラメータは、このオブジェクト内にpdg.Portオブジェクトとしてコピーされます。 self["parm_name"]を使用することで、それらのパラメータにアクセスすることができ、Port.evaluateFloat(), Port.evaluateInt()などを使用することで、それらの値を読み込むことができます。

  # このノードの"url"パラメータからコピーされた値を取得します。
  url = self["url"].evaluateString()
  

• スクリプトからそれらのパラメータを簡単に参照できるようにするために、それらのパラメータ名を短く、且つ、意味のわかる内部名を付けるように心がけてください。

• 個々のノードがパラメータをオーバーライドできるようにするには: Spareパラメータ編集インターフェース内で、そのパラメータにpdg::schedulerタグを付けます。 このタグは、パラメータがスケジューラジョブパラメータであり、個々のノードでオーバーライドできる事をPDGに示します。 これらのパラメータは、 Node Properties メニューにも追加されているはずなので、ユーザーは簡単にどのパラメータがオーバーライド可能なのか知ることができ、それらの値をオーバーライドすることができます。 詳細は、Schedulers Propertiesフォルダの追加セクションを参照してください。

  • スケジューラのオーバーライドの使い方の詳細は、スケジューラのオーバーライドを参照してください。

  • 現在のところ、このタグの値は使用しません。システムは、pdg::schedulerという名前のタグが存在するかどうかのみをチェックします。

  • これは、ノードをアセットに変換した場合にのみ動作することに注意してください。Python Schedulerインスタンスのパラメータをオーバーライドすることはできません。

    Note

    個々のノードでオーバーライド可能なパラメータを評価する時、必ず以下のメソッドを使用してください:

    • evaluateFloatOverride(node, prefix, parm, work_item, default_value)

    • evaluateIntOverride(node, prefix, parm, work_item, default_value)

    • evaluateStringOverride(node, prefix, parm, work_item, default_value)

    

すべてのビルトインスケジューラでオーバーライド可能なスケジューラプロパティはScheduler Propertiesフォルダに入っています。 スケジューラプロパティの使い方に関する詳細は、スケジューラオーバーライドドキュメントを参照してください。

ユーザーがカスタムスケジューラのスケジューラパラメータをもっと簡単にオーバーライドできるようにしたいのであれば、 オーバーライド可能なスケジューラプロパティをScheduler Propertiesフォルダ構造に追加してください。 これをするには、それらのスケジューラプロパティをtopscheduler.user.dsという名前のファイルに追加してください。 このtopscheduler.user.dsファイルは、ユーザーのHOUDINI_PATHのどこにでも配置することができます。

topscheduler.user.dsファイルは、スケジューラのオーバーライド可能なプロパティの定義を含んだダイアログスクリプトファイルです。

Python Schedulerインスタンスまたはカスタムスケジューラアセットを、TOPグラフ全体(つまり、すべてのワークアイテム)または特定のノードから生成されたワークアイテムのみに対して、デフォルトのTOPスケジューラとして設定することができます。

• デフォルトのTOPスケジューラとして設定するには、TOP Networkノードを選択して、 Default TOP Scheduler をカスタムスケジューラノードに変更します。

  

• 特定のTOPノードに対して設定するには、そのTOPノードを選択して、 Override TOP Scheduler をカスタムスケジューラノードに設定します。

  

これによって、TOP NetworkノードまたはTOPノードをクックすると、カスタムスケジューラを使ってワークアイテムが処理されるようになります。