Houdini 18.0 ノード TOPノード

HQueue Scheduler TOP node

HQueueを使用してワークアイテムのスケジュールを組みます。

On this page

このノードは、リモートマシン上でワークアイテムを実行できるようにHQueueを使ってそれらのワークアイテムのスケジュールを組みます。

Cook Modes

This scheduler can operate in two different cook modes:

  • The normal cook mode connects to your HQueue scheduler and creates jobs for work items as they become ready to execute, and the jobs then communicate back to the submitting machine with status changes. This means that the submitting Houdini session must remain open for the duration of the cook.

    This mode is used whenever you select Cook from any of the menus or buttons in the TOP UI.

  • The standalone job mode cooks the entire TOP network as a standalone job. In this mode, the submitting Houdini session is detached from the cooking of the TOP network, the .hip file is copied if necessary, and a Hython process executes the TOP network using the default scheduler for that topnet. You will also not see any updates to your current Houdini session. To check the progress of your job when using this mode, you will need to use the HQueue web portal.

    This mode is used whenever you click the Submit Graph As Job > Submit button in the HQueue Scheduler’s parameters.

ネットワーク要件

クックの一部として、メッセージキュー(MQ)ジョブが投入されます。 このジョブは、実行中のジョブから投入マシンに情報を返すために使用されます。 このため、ファームマシンは、他のファームマシンのホスト名を解決できる必要があります。

Tip

これは、/etc/hosts(Linux / MacOS)またはC:\Windows\System32\Drivers\etc\hosts(Windows)を編集することと同じくらい簡単です。

さらに、ファームマシン間にファイアーウォールを設定しないようにするか、または、 Task Callback Port を使って、使用する開放ポートを指定する必要があります。

クックが開始されると、ジョブ投入マシンは、MQジョブを実行しているファームマシンに接続するので、そのジョブ投入マシンとファームマシン間にファイアーウォールを設定しないようにするか、または、 Relay Port を使って開放ポートを指定する必要があります。

Warning

Windows Services cannot use mapped drives. Since HQueue jobs on Windows are executed by a Windows Service, you should only use UNC paths. For example, use //myserver/hq/project/myhip.hip instead of H:/project/myhip.hip. Also be careful with backslashes in paths, as they are interpreted as escape sequences when evaluated by Houdini or the command shell.

TOP Attributes

hqueue_jobid

integer

HQueue SchedulerがワークアイテムをHQueueに投入した時、HQueueジョブIDを追跡できるように、このアトリビュートがそのワークアイテムに追加されます。

パラメータ

Scheduler

以下のパラメータは、このスケジューラを使ったすべてのワークアイテムのグローバルパラメータです。

Submit Graph As Job

Submit

このスケジューラがTOPネットワーク全体をスタンドアローンのジョブとしてクックします。 投入されたジョブには、ステータスURIを表示します。 The submitting Houdini session is detached from the cooking of the TOP network. The .hip file is copied if necessary and a Hython process executes the TOP network normally using the default scheduler for that topnet.

Tip

You can restart a finished standalone jobs using the HQueue Web UI. However, you should restart the child job named TOP Cook instead of the parent job.

Job Name

投入されたクックのトップレベルのHQueue Jobの名前。

Data Layer Server

Enable Server

When on, turns on the data layer server for the TOP job that cooks on the farm. This allows PilotPDG or other WebSocket clients to connect to the cooking job remotely to view the state of PDG.

Server Port

This parameter is only available when Enable Server is on.

Determines which server port to use for the data layer server.

Automatic

A free TCP port selected by the node.

Custom

A custom TCP port specified by the user.

This is useful when there is a firewall between the farm machine and the monitoring machine.

Auto Connect

This parameter is only available when Enable Server is on.

When on, the node will try to send a command to create a remote visualizer when the job starts.

If successful, a remote graph is created and it automatically connects to the server executing the job. The client submitting the job must be visible to the server running the job or the connection will fail.

Working Directory

Specifies the directory where the cook generates intermediate files and output. The intermediate files are placed in a subdirectory named pdgtemp.

If you are opening your .hip file in Houdini from the shared network path (for example, from H:/myproj/myhip.hip), you can use $HIP here (the default). However, if you are opening your .hip file from a local directory (for example, from C:/temp/myhip.hip), you have to copy it to a shared network before it can be accessed by farm machines. In this case, the Working Directory should be an absolute or relative path to that shared network location (for example, //MYPC/Shared/myproj).

Job Name

TOPネットワークをクックするジョブの名前。

Job Description

トップレベルのHQueue Jobの説明。 これは、そのジョブのJob Propertiesに表示することができます。

Override Local Shared Root

有効にすると、ローカル共有ルートディレクトリの位置が Local Shared Root Paths パラメータで上書きされます。

Local Shared Root Paths

These parameters are only available when Override Local Shared Root is on.

The HQueue farm should be configured with a shared network filesystem and the mount point of this shared file system is specified for each platform.

Load from HQueue

HQueueサーバーを照会して、プラットフォーム別にローカル共有ルートパスを取得し、以下のパラメータを埋めます。

Windows

Windowsマシン上のローカル共有ルートパス。例えば、I:/

macOS

MacOSマシン上のローカル共有ルートパス。例えば、/Volumes/hq

Linux

Linuxマシン上のローカル共有ルートパス。例えば、/mnt/hq

HQueue Server

HQueueサーバーのURL。例えば、http://localhost:5000

Executable Paths

Universal HFS

When on, a single path to the $HFS directory (the Houdini install directory) is used by all platforms. You can use $HQROOT and $HQCLIENTARCH to help specify the directory path.

Linux HFS Path

このパラメータは、 Universal HFS が無効な時にのみ利用可能です。

Linux用$HFSパス。

macOS HFS Path

このパラメータは、 Universal HFS が無効な時にのみ利用可能です。

MacOS用$HFSパス。

Windows HFS Path

このパラメータは、 Universal HFS が無効な時にのみ利用可能です。

Windows用$HFSパス。

Python

Select which python interpreter should be used for python jobs. This python can be specified in a command using the PDG_PYTHON token.

From HFS: Use the python interpreter that is installed with Houdini.

From HQClient: Use the same python interpreter that HQClient is using on the farm machine.

Custom: Use the executable path specified by Python Executable

Python Executable

The full path to the python executable to use for python jobs.

Message Queue

Create Queue

Determines whether or not Message Queue jobs are created for interactive cooks.

The Message Queue is useful when the submitting Houdini session is not reachable by farm machines due to networking restrictions or firewalls.

Automatically

The Message Queue is created for interactive cooks.

Jobs on the farm communicate their status changes to the Message Queue, which in turn is connected to the submitting Houdini session.

Never

The Message Queue is not created for interactive cooks.

Jobs on the farm communicate their status changes directly back to the submitting Houdini session.

Task Callback Port

Message Queue ServerのXMLRPCコールバックAPIで使用するTCP Portを設定します。このポートはファームクライアント間でアクセスできなければなりません。

Relay Port

PDGとMessage Queue Commandを実行しているクライアントとの間のMessage Queue Server接続で使用するTCP Portを設定します。 このポートは、PDG/ユーザマシンからファームクライアントに到達できなければなりません。

Submission Timing

Tick Period

onTickコールバックをコールする間隔の最小時間(秒)。

Max Items Per Tick

Tick間でonScheduleコールバックが準備するワークアイテムの最大数。

Job Parms

以下のジョブ特有のパラメータは、投入されたすべてのジョブに影響を与えますが、各ノードによって上書きすることができます。 Scheduler Job Parms / Propertiesを参照してください。

Note

これらのパラメータのほとんどがHQueue Job Propertiesと等価です。

Scheduling

Job Priority

ジョブのHQueue優先度。

優先度の高いジョブほど優先度の低いジョブよりも先にスケジュールが組まれて処理されます。 0が一番低い優先度です。

Assign To

優先度の割り当て先となるクライアント。

Any Client

任意のクライアントに割り当てます。

Listed Clients

指定したクライアントに割り当てます。

Clients from Listed Groups

指定したクライアントグループに割り当てます。

Clients

This parameter is only available when Assign To is set to Listed Clients.

ジョブを割り当てるクライアントの名前をスペースで区切ります。

Select Clients

This parameter is only available when Assign To is set to Listed Clients.

HQueueからクライアントを選択して、 Clients リストを集計します。

Client Groups

This parameter is only available when Assign To is set to Clients from Listed Groups.

ジョブを割り当てるクライアントグループの名前をスペースで区切ります。

Select Groups

This parameter is only available when Assign To is set to Clients from Listed Groups.

HQueueからクライアントグループを選択して、 Client Groups リストを集計します。

CPUs per Job

ジョブが消費するCPUsの最大数。 この数がクライアントマシンの空きCPU数を超えている場合、そのクライアントマシンにはジョブが 割り当てられなくなります

Note

いくつかのジョブのマルチスレッド化はHoudini Max Threadsで制御することができます。 このパラメータを設定 しなかった 場合、且つ、 Houdini Max Threads も設定 しなかった 場合、そのジョブに’single'タグが適用されて、指定したクライアントでのみそのジョブが実行されるようになります。

Job Description

ジョブのDescriptionプロパティ。

Tags

スペース区切りのジョブタグ。

Allowed Host

ジョブを実行させるマシンのホスト名。

Resources

A space-separated list of HQueue Resources that the job consumes. For example, sidefx.license.render sidefx.license.engine.

Non-Zero Exit Code Handling

Handle By

What to do when the command fails.

Reporting Error

The work item fails.

Reporting Warning

The work item succeeds and a warning is added to the node.

Retrying Task

The work item is retried by HQueue for the number of Retries remaining.

Ignoring Exit Code

The work item succeeds.

Handle All Non Zero

When off, you can specify a particular exit code.

Exit Code

This parameter is only available when Handle All Non Zero is off.

Specifies the exit code that you want to handle using Handle By. All other non-zero exit codes will be treated as a failure as normal.

Retries

This parameter is only available when Handle By is set to Retrying Task.

コマンドが失敗した時にそのジョブを再試行する回数。

Task Environment

Houdini Max Threads

HOUDINI_MAXTHREADS環境変数に値を設定します。

CPUs per Job が有効の場合、 Houdini Max Threads に値が設定されます。 CPUs per Job が無効の場合、 Houdini Max Threads にデフォルトで0が設定されます。つまり、ジョブは利用可能なプロセッサすべてを使用することを意味します。

プラスの値は、利用可能なスレッド数を制限します。 例えば、1の値は、ジョブを1スレッドに制限することで完全にマルチスレッド処理を無効にします。 プラスの値は、利用可能なCPUコア数で制限されます。

マイナスの値を指定すると、最大プロセッサ数からその値が引かれて、スレッド数が決定されます。 例えば、-1の値は全CPUコア数から1を引いたCPUコア数が使用されます。

リソースの使用量を制限する方法を参照してください。

Inherit Local Environment

When on, the environment variables in the current Houdini session are copied into the job’s environment.

Environment Variables

Adds custom key-value environment variables to each task.

See also

TOPノード

  • Attribute Copy

    あるブランチのワークアイテムのアトリビュートを他のブランチのワークアイテムにコピーします。

  • Attribute Create

    入力のワークアイテムすべてに対してアトリビュートを作成または設定します。

  • Attribute Delete

    ワークアイテムからアトリビュートを削除します。

  • Attribute from String

    ファイル名などの文字列からアトリビュート値を解析します。

  • Block Begin Feedback

    For-Loop with Feedbackブロックを開始します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • Block End Feedback

    For-Loop with Feedbackブロックを終了します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • CSV Input

    CSVファイルのデータをワークアイテムのアトリビュートにコピーします。

  • CSV Output

    ワークアイテムのアトリビュートをCSVファイルに書き出します。

  • Command Send

    実行させたいコードを共有サーバーに送信します。

  • Command Server End

    サーバーブロックを終了します。

  • Deadline Scheduler

    Thinkbox社のDeadlineソフトウェア用PDGスケジューラ。

  • Download File

    1つ以上のURLの内容をファイルにダウンロードします。

  • Environment Edit

    ワークアイテムのコマンドラインが実行する環境下で設定する変数を編集します。

  • Error

    条件を満たした時に警告またはエラーを生成します。

  • Error Handler

    失敗したワークアイテムのエラーハンドル。

  • FFmpeg Encode Video

    静止画像シーケンスを動画に変換します。

  • FFmpeg Extract Images

    動画ファイルから静止画像シーケンスを抽出します。

  • File Compress

    ファイルをアーカイブに圧縮します。

  • File Copy

    実行時またはノードがファイルを生成した時に、ファイルをある場所から別の場所にコピーします。

  • File Decompress

    入力のワークアイテムで指定されたアーカイブファイルを個々のファイルに解凍します。

  • File Pattern

    特定のパターンに合致したファイルに基づいてワークアイテムを生成します。

  • File Range

    特定のファイルパターンに基づいたフレーム範囲からワークアイテムを生成します。

  • File Remove

    指定したパスのファイルを削除します。

  • File Rename

    ファイルを名前変更または移動させます。

  • Filter by Expression

    上流のワークアイテムを条件付きでフィルタリングします。

  • Filter by Range

    指定したフレーム内またはアトリビュート範囲内にある上流のワークアイテムを絞り込みます。

  • Generic Generator

    アトリビュートなしでコマンドラインを実行するワークアイテムを生成します。

  • Geometry Import

    SOPまたはファイルジオメトリのポイントまたはプリミティブをワークアイテムアトリビュートまたは一時ファイルに読み込みます。

  • HDA Processor

    デジタルアセットをクックするワークアイテムを生成します。

  • HQueue Scheduler

    HQueueを使用してワークアイテムのスケジュールを組みます。

  • Houdini Server Begin

    持続型Houdiniコマンドサーバーを起動します。

  • ImageMagick

    一括で画像変換、サイズ変更、画像モザイクなどのImageMagickの機能に簡単にアクセスすることができます。

  • In Process Scheduler

    In-Processワークアイテムのスケジューリングを制御します。

  • Invoke

    入力ジオメトリに対してコンパイルブロックを呼び出します。

  • Json Input

    JSONファイルからデータを抽出してアトリビュートを作成します。

  • Json Output

    JSON出力を生成する色々なオペレーションを実行します。

  • Local Scheduler

    ローカルマシン上でワークアイテムのスケジュールを組みます。

  • Make Directory

    ディレクトリを作成します。

  • Map All

    上流のすべてのワークアイテムを下流のワークアイテムにマップします。

  • Map by Expression

    エクスプレッションを使って、上流のワークアイテムを下流のワークアイテムにマップします。

  • Map by Index

    上流のワークアイテムをインデックスに基づいて下流のワークアイテムにマップします。

  • Map by Range

    範囲を使って上流のワークアイテムを下流のワークアイテムにマップします。

  • Maya Server Begin

    持続型Mayaコマンドサーバーを起動します。

  • Merge

    上流のすべてのワークアイテムを結合します。

  • Nuke Server Begin

    持続型Nukeコマンドサーバーを開始します。

  • Null

    何もしません。

  • OP Notify

    何かしらのTOPワークが完了したことを通知します。

  • Output

    サブネット出力。

  • Partition by Attribute

    アトリビュートに基づいてワークアイテムを区分けします。

  • Partition by Bounds

    境界アイテムを使って、ソースアイテムを空間的に区分けします。

  • Partition by Combination

    ワークアイテムを2個毎、3個毎などに区分けします。

  • Partition by Comparison

    既存の比較を使ってワークアイテムを区分けします。

  • Partition by Expression

    エクスプレッションに基づいてワークアイテムを区分けします。

  • Partition by Frame

    フレームに基づいてワークアイテムを区分けします。

  • Partition by Index

    インデックスに基づいてワークアイテムを区分けします。

  • Partition by Node

    ノードに基づいてワークアイテムを区分けします。

  • Partition by Range

    範囲に基づいてワークアイテムを区分けします。

  • Partition by Tile

    軸に平行な境界ボックスを使ってワークアイテムを空間的に区分けします。

  • Perforce

    PDG経由でPerforceコマンドを実行します。

  • Python Mapper

    Pythonスクリプトを使ってワークアイテムをマップします。

  • Python Partitioner

    Pythonスクリプトを使ってワークアイテムを区分けします。

  • Python Processor

    Pythonスクリプトを使ってワークアイテムを生成します。

  • Python Scheduler

    Pythonベースでプログラミング可能なPDG用スケジューラ。

  • Python Script

    スクリプトを実行するワークアイテムを生成します。

  • Python Server Begin

    Pythonコマンドサーバーを起動します。

  • ROP Alembic Output

    埋め込まれたROP Alembic ROPノードをクックするワークアイテムを生成します。

  • ROP Composite Output

    埋め込まれたComposite ROPノードをクックするワークアイテムを生成します。

  • ROP Fetch

    ROPノードまたはROPネットワークをクックするワークアイテムを生成します。

  • ROP Geometry Output

    埋め込まれたGeometry ROPノードをクックするワークアイテムを生成します。

  • ROP Mantra Render

    埋め込まれたMantra ROPノードをクックするワークアイテムを生成します。

  • ROP USD Output

    組み込まれたUSD ROPノードをクックするワークアイテムを作成します。

  • Range Generate

    指定した範囲のワークアイテムを生成します。

  • Render IFD

    Mantraを使ってIFDファイルをレンダリングするワークアイテムを生成します。

  • SQL Input

    SQLクエリの作成と行毎にワークアイテムを生成する入力ノードです。

  • SQL Output

    SQL INSERTクエリを生成する出力ノードです。

  • Send Email

    電子メールを送信します。

  • Shotgun Create

    Shotgunエンティティを作成します。

  • Shotgun Delete

    Shotgunからエンティティを削除します。

  • Shotgun Download

    ShotgunからAttachmentをダウンロードします。

  • Shotgun Find

    Shotgunエンティティを検索します。

  • Shotgun Server Begin

    持続型Shotgunコマンドサーバーを起動します。

  • Shotgun Update

    Shotgunエンティティを更新します。

  • Shotgun Upload

    Shotgunにファイルをアップロードします。

  • Sort

    アトリビュートのリストからワークアイテムを並べ替えます。

  • Split

    上流のワークアイテムを2つのグループに分けます。

  • Subnetwork

    TOPノード用コンテナ。

  • Switch

    ネットワーク分岐を切り替えます。

  • TOP Fetch

    他のTOPネットワークをクックします。

  • TOP Fetch Input

    TOP Fetchで取得したネットワークの入力。

  • Text Output

    テキストを新しいファイルに書き出したり、既存ファイルに追加します。

  • Tractor Scheduler

    PixarのTractorを使ってワークアイテムのスケジュールを組みます。

  • USD Import

    USDステージで見つかったPrimsからワークアイテムを生成します。

  • USD Import Files

    USDステージで見つかったファイル参照からワークアイテムを作成します。

  • USD Render

    USDファイルを書き出すワークアイテムを作成します。

  • Wait for All

    上流のワークアイテムすべてが完了するのを待ちます。

  • Wedge

    アトリビュート値を色々と変えながらワークアイテムを生成します。

  • Work Item Expand

    ファイルリストまたはパーティションを複数のワークアイテムに展開します。

  • Xml Input

    XMLファイルからデータをワークアイテムアトリビュートに抽出します。