Get network performance
get_td_performanceRead-only
Measure cook times in a TouchDesigner network, flag nodes exceeding the target frame budget, and return performance metrics including slowest nodes and total cook time.
Instructions
Read-only: report cook times under a network (recursively by default, slowest node first) and warn about nodes that exceed the frame budget. Returns {targetFps, frameBudgetMs, totalCookMs, nodes[], warnings[]} and changes nothing. Use this to just measure; use optimize_performance when you want suggestions and the option to auto-shrink the slow TOPs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root_path | No | Network root to measure cook times under. | /project1 |
| target_fps | No | Frame-rate target used to flag slow nodes. | |
| recursive | No | Measure every descendant (true, default) so cook time inside generated containers is counted, not just the root's direct children. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The network root that was measured, echoing the request. | |
| targetFps | Yes | The frame-rate target used to derive the per-frame budget. | |
| frameBudgetMs | Yes | Milliseconds available per frame at the target FPS (1000 / targetFps). | |
| totalCookMs | Yes | Sum of the measured nodes' last cook times, in milliseconds. | |
| nodes | Yes | Per-node cook times, slowest first. | |
| warnings | Yes | Budget warnings: one line per node whose cook time exceeds the frame budget, plus a final aggregate line when the summed total cook time exceeds the budget. Empty when everything is within budget. |