標準のPythonシェル内でhouモジュールをインポートすることで、HoudiniをPythonスクリプトに統合することができます。 初回でhouをインポートすると、PythonはHoudiniのライブラリすべてをロードし、空っぽのHoudiniセッションを初期化します。 houモジュールは実質的にHoudiniセッションを保存していて、hipファイルをそのセッションにロードし、スクリプトからそのファイルを評価し、 そのセッション内で情報とノードを入出力させることができます。

houモジュールをインポートできるようにするには、まず最初に$HFS/houdini/pythonX.Ylibs内のPythonモジュールを検索するようにPythonに指示する必要があります。 これは、Pythonを起動する前にPYTHONPATH環境変数にそのパスを追加するか、または、Python内でsys.pathにそのパスを追加することで行なうことができます。

以下のPythonスニペットは、標準のPythonシェルにhouモジュールをインポートします。 このスニペットは、事前にsourceコマンドによるhoudini_setupスクリプトの実行が済んでいることを前提にしています。

def enableHouModule():
    '''"import hou"が動作するように、環境をセットアップします。'''
    import sys, os

    # houをインポートすることで、Houdiniのライブラリが読み込まれ、Houdiniが初期化されます。
    # これによって、HoudiniはC++で記述されたHDK拡張を読み込みます。
    # それらの拡張は、Houdiniのライブラリに対してリンクさせる必要があるので、Houdiniのライブラリのシンボルが、
    # Houdiniが読み込む他のライブラリから見えている必要があります。
    # シンボルが見える状態にするために、RTLD_GLOBAL dlopenフラグを追加します。
    if hasattr(sys, "setdlopenflags"):
        old_dlopen_flags = sys.getdlopenflags()
        sys.setdlopenflags(old_dlopen_flags | os.RTLD_GLOBAL)

    # Windowsのみ。
    # PythonがhouモジュールのHoudiniライブラリ依存ファイルを認識できるように、DLL検索パスに%HFS%/binを追加します。
    # os.add_dll_directory()は古いバージョンのPythonには存在しないことに注意してください。
    # 代わりに、Python3.7ユーザは、Pythonを起動する前に、PATH環境変数に%HFS%/binを追加する必要があります。
    if sys.platform == "win32" and hasattr(os, "add_dll_directory"):
        os.add_dll_directory("{}/bin".format(os.environ["HFS"]))

    try:
        import hou
    except ImportError:
        # houモジュールをインポートできなかった場合に
        # Pythonがhouモジュールを検索できるようにするために
        # sys.pathに`$HFS/houdini/pythonX.Ylibs`を追加します。
        sys.path.append(os.environ['HHP'])
        import hou
    finally:
        # dlopenフラグを元の値に戻ります。
        if hasattr(sys, "setdlopenflags"):
            sys.setdlopenflags(old_dlopen_flags)

enableHouModule()
import hou

LD_PRELOAD="$HFS/dsolib/libjemalloc.so" python

houモジュールをインポートする時は、Pythonはライセンスをチェックします。 デフォルトでは、PythonはHoudini Batchライセンスを使用し、BatchライセンスがなければHoudini FXライセンスを使用します。Pythonが使用するHoudiniライセンスを指定したい場合は、houモジュールをインポートする前にHOUDINI_SCRIPT_LICENSE変数をhescapeに設定します。Pythonスクリプトから、この変数を設定するには、os.environ['HOUDINI_SCRIPT_LICENSE'] = 'hescape'を記述します。

デフォルトでは、houモジュールはPythonインタプリタが終了するまでHoudiniのライセンスを返しません。しかし、Pythonスクリプトを長時間実行して、すぐにライセンスを取得して解放したい場合は、houモジュールを使い終わった時にhou.releaseLicense()をコールすることができます。houモジュールはコールされた時点でライセンスを取得します。HoudiniのセッションデータとライブラリはPythonが終了するまでメモリからアンロードされないことに注意してください。

houモジュールは、PythonやHoudiniでインポートされると、$HOUDINI_PATH内のディレクトリをループします。そして、見つかったディレクトリ名に“/python2.7libs”を足してsys.pathに追加します。さらに上位互換用に$HOUDINI_PATHはディレクトリ名に“/scripts/python”を足して検索されます。例えば、$HOME/houdiniX.Y/python2.7libsにPythonモジュールを配置すれば、houをインポートした後にPython検索パスにそのパスが追加されます。