# manx151089/ligament-houdini-pipeline architecture

> Architecture diagram of the GitHub repository manx151089/ligament-houdini-pipeline, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manx151089/ligament-houdini-pipeline
- Repository: https://github.com/manx151089/ligament-houdini-pipeline

## Overview

This tree is a Houdini-oriented Python tools repository alongside a large vendored Python ecosystem. The visible custom tools cover environment setup, crowd and animation workflows, motion/vision, USD construction, and packed deformation. The README excerpt supplies only a documentation pointer, and several custom modules were not sampled; their internal call graph and the documented end-to-end workflow therefore cannot be confirmed. Dashed links indicate likely user entry points, not verified calls.

Main entry points: [`python/numpy/lib/function_base.py`](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/lib/function_base.py) (Array functions), [`python/crowdCoreLGM/crowdCore.py`](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/crowdCoreLGM/crowdCore.py) (Crowd core), [`python/fontTools/feaLib/parser.py`](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/fontTools/feaLib/parser.py) (Feature parser), [`python3.11libs/pythonrc.py`](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python3.11libs/pythonrc.py) (Python startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_houdini["Houdini Tools"]
  node_startup["Python startup<br/>[pythonrc.py]"]
  node_environment["Environment setup"]
  node_relocator["Agent relocator"]
  node_automagic["AutoMagic agent<br/>[agent.py]"]
  node_crowd["Crowd core<br/>[crowdCore.py]"]
  node_animation["Animation browser"]
  node_shotapi["Shot API<br/>[lsa.py]"]
end

subgraph group_vision["Motion Vision"]
  node_visiongod["Vision workflow<br/>[visionGod.py]"]
  node_computevision["Vision compute<br/>[computeVison.py]"]
  node_depth["Depth wrappers<br/>[midasWrap.py]"]
  node_depthv2["Depth wrapper v2<br/>[midasWrapV2.py]"]
  node_video["Video frames<br/>[videoToImg.py]"]
  node_handtracking["Hand tracking"]
  node_facemesh["Face mesh<br/>[FaceMeshModule.py]"]
end

subgraph group_geometry["Scene Geometry"]
  node_usd["USD builder<br/>[usdBuilder.py]"]
  node_deformer["Packed deformer<br/>[packed_deformer.py]"]
end

subgraph group_libraries["Vendored Libraries"]
  node_numpy["Numerical arrays<br/>[numeric.py]"]
  node_numpyfunctions["Array functions<br/>[function_base.py]"]
  node_masked["Masked arrays<br/>[core.py]"]
  node_fontparser["Feature parser<br/>[parser.py]"]
  node_fontast["Feature AST<br/>[ast.py]"]
  node_flags["Flag definitions<br/>[_defines.py]"]
  node_flagvalues["Flag values<br/>[_flagvalues.py]"]
  node_flaghelpers["Flag helpers<br/>[_helpers.py]"]
  node_dateparser["Date parser<br/>[_parser.py]"]
  node_tz["Time zones<br/>[tz.py]"]
  node_six["Compatibility<br/>[six.py]"]
end

node_artist(("Houdini user"))

node_artist -.->|"starts session"| node_startup
node_artist -.->|"uses crowd tools"| node_crowd
node_artist -.->|"uses vision tools"| node_visiongod
node_artist -.->|"builds scenes"| node_usd
node_artist -.->|"uses deformer"| node_deformer
node_fontparser -->|"builds AST"| node_fontast
node_numpyfunctions -->|"imports"| node_numpy
node_numpyfunctions -->|"imports"| node_masked
node_crowd -.->|"possible companion"| node_animation

click node_startup "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python3.11libs/pythonrc.py"
click node_environment "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/setShowBasedEnv/setHscriptEnvirons.py"
click node_relocator "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/agentPointRelocator.py"
click node_automagic "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/autoMagic/agent.py"
click node_crowd "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/crowdCoreLGM/crowdCore.py"
click node_animation "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/crowdCoreLGM/animationBrowser.py"
click node_visiongod "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/visionGod.py"
click node_computevision "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/computeVison.py"
click node_depth "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/midasWrap.py"
click node_depthv2 "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/midasWrapV2.py"
click node_video "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/videoToImg.py"
click node_handtracking "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/cvzone2/HandTrackingModule.py"
click node_facemesh "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/cvzone2/FaceMeshModule.py"
click node_shotapi "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/lgmfxShotApi/lsa.py"
click node_usd "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/usdCoreLGM/usdBuilderLGM/usdBuilder.py"
click node_deformer "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/node_snippets/packed_deformer.py"
click node_numpy "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/core/numeric.py"
click node_numpyfunctions "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/lib/function_base.py"
click node_masked "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/ma/core.py"
click node_fontparser "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/fontTools/feaLib/parser.py"
click node_fontast "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/fontTools/feaLib/ast.py"
click node_flags "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_defines.py"
click node_flagvalues "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_flagvalues.py"
click node_flaghelpers "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_helpers.py"
click node_dateparser "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/dateutil/parser/_parser.py"
click node_tz "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/dateutil/tz/tz.py"
click node_six "https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/six.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_startup,node_environment,node_relocator,node_automagic,node_crowd,node_animation,node_shotapi,node_artist toneBlue
class node_visiongod,node_computevision,node_depth,node_depthv2,node_video,node_handtracking,node_facemesh toneAmber
class node_usd,node_deformer toneMint
class node_numpy,node_numpyfunctions,node_masked,node_fontparser,node_fontast,node_flags,node_flagvalues,node_flaghelpers,node_dateparser,node_tz,node_six toneRose
```

## Components

### Houdini Tools

- [Python startup](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python3.11libs/pythonrc.py): `python3.11libs/pythonrc.py`
- [Environment setup](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/setShowBasedEnv/setHscriptEnvirons.py): `python/setShowBasedEnv/setHscriptEnvirons.py`
- [Agent relocator](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/agentPointRelocator.py): `python/agentPointRelocator.py`
- [AutoMagic agent](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/autoMagic/agent.py): `python/autoMagic/agent.py`
- [Crowd core](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/crowdCoreLGM/crowdCore.py): `python/crowdCoreLGM/crowdCore.py`
- [Animation browser](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/crowdCoreLGM/animationBrowser.py): `python/crowdCoreLGM/animationBrowser.py`
- [Shot API](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/lgmfxShotApi/lsa.py): `python/lgmfxShotApi/lsa.py`

### Motion Vision

- [Vision workflow](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/visionGod.py): `python/motionCore/visionGod.py`
- [Vision compute](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/computeVison.py): `python/motionCore/computeVison.py`
- [Depth wrappers](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/midasWrap.py): `python/motionCore/midasWrap.py`
- [Depth wrapper v2](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/midasWrapV2.py): `python/motionCore/midasWrapV2.py`
- [Video frames](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/motionCore/videoToImg.py): `python/motionCore/videoToImg.py`
- [Hand tracking](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/cvzone2/HandTrackingModule.py): `python/cvzone2/HandTrackingModule.py`
- [Face mesh](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/cvzone2/FaceMeshModule.py): `python/cvzone2/FaceMeshModule.py`

### Scene Geometry

- [USD builder](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/usdCoreLGM/usdBuilderLGM/usdBuilder.py): `python/usdCoreLGM/usdBuilderLGM/usdBuilder.py`
- [Packed deformer](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/node_snippets/packed_deformer.py): `python/node_snippets/packed_deformer.py`

### Vendored Libraries

- [Numerical arrays](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/core/numeric.py): `python/numpy/core/numeric.py`
- [Array functions](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/lib/function_base.py): `python/numpy/lib/function_base.py`
- [Masked arrays](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/numpy/ma/core.py): `python/numpy/ma/core.py`
- [Feature parser](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/fontTools/feaLib/parser.py): `python/fontTools/feaLib/parser.py`
- [Feature AST](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/fontTools/feaLib/ast.py): `python/fontTools/feaLib/ast.py`
- [Flag definitions](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_defines.py): `python/absl/flags/_defines.py`
- [Flag values](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_flagvalues.py): `python/absl/flags/_flagvalues.py`
- [Flag helpers](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/absl/flags/_helpers.py): `python/absl/flags/_helpers.py`
- [Date parser](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/dateutil/parser/_parser.py): `python/dateutil/parser/_parser.py`
- [Time zones](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/dateutil/tz/tz.py): `python/dateutil/tz/tz.py`
- [Compatibility](https://github.com/manx151089/ligament-houdini-pipeline/blob/master/python/six.py): `python/six.py`

### Other components

- **Houdini user**

## Connections

- Houdini user → Python startup: starts session
- Houdini user → Crowd core: uses crowd tools
- Houdini user → Vision workflow: uses vision tools
- Houdini user → USD builder: builds scenes
- Houdini user → Packed deformer: uses deformer
- Feature parser → Feature AST: builds AST (evidence: `python/fontTools/feaLib/parser.py`)
- Array functions → Numerical arrays: imports (evidence: `python/numpy/lib/function_base.py`)
- Array functions → Masked arrays: imports (evidence: `python/numpy/ma/core.py`)
- Crowd core → Animation browser: possible companion
