Probe is a visual performance monitor for TouchDesigner processes, measuring CPU times (circles), and GPU times (diamonds), plus, via the selector on the left, CPU memory, GPU memory and the number of children in a component.
There are forum posts at https://www.derivative.ca/Forum/viewtopic.php?p=30059
See also the non-graphical monitor: Performance Monitor
How to Use probe
probe component from the Palette anywhere in your TouchDesigner process, preferably in
Pressing Ctrl-p (it may be Cmd-p on macOS) will display and un-display the probe panel: You will be able to see the probe when you are in Designer Mode as a floating window, or in Perform Mode. In Perform Mode it is a panel embedded in your main UI (to minumize effect of having 2 windows open).
The probe panel looks a bit like your network. For CPU Times, each stack of circles represents the recent time-history of a node. There is one stack for every node in your current network. The color and size of the circles gives the cook time... use the color legend at the bottom left, expressed in milliseconds.
Each stack is 10 circles, the top being the most recent Time Slice that cooked, the bottom being the tenth most-recent Time Slice. However if a node hasn't cooked in the last 10 time slices, the bottom circle represents the most recent time it actually cooked.
Navigate the networks by left-clicking on a node's box, if it is a component. Click on the background to go up the network hierarchy.
Middle click on the node to bring up its parameter dialog. Right-click on a node to bring up another window containing the network editor for that node.
The stacks that look like donuts or Tootsie Roll (USA) that have a circle within a circle are components. The inner circle represents the children cooking inside the component, the outer circle representing the sum of the node's cook time and its children's cook time.
The large colored box around all the nodes represents, through its color, the cook time of all the nodes in the network, including all children.
Rolling over a node or stack will show the numeric value of the metric, and in the spectrum graphic on the left (the white line shows the value of the current node's metric, otherwise the parent's value).
The network has a colored bounding box around the nodes. The color of the bounding box represents the total cook time or memory of the component that you are in. Again, refer to the color legend on the left to translate the color into the metric's value.
When you are displaying probe, the buttons at the top right (1) Par+ opens the parameters of probe, where you can, for example, adjust its position in your Perform window, and (2) Help gets this wiki page.
Like in the standard Performance monitor, the OP cooking you see with "CPU TIme" selected is for the CPU times. TOPs and panels are the only OP families that uses GPU, and the cook time you see for them is only the CPU set-up time. (same is true for the Dialogs -> Performance Monitor)
Click on "GPU Time" to get GPU times, etc. Memory is expressed in Megabytes.
This component consumes its own minimal cook time, sometimes up to a few milliseconds, so it will slow your process down a bit when it is being displayed. Undilplaying it (Ctrl-P) stops all cooking of Probe.
Parameters - Probe Page
Datatype - ⊞ -
- CPU Time
- GPU Time
- CPU Memory
- GPU Memory
Open/Close with Ctrl-p
Embedded in Perform
Position in Perform
Performpos - ⊞ -
- Position in Perform
- Position in Perform
Scale in Perform
Opacity in Perform
Renderres - ⊞ -
- Render Resolution
- Render Resolution
|• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •|
The Graphics Processing Unit. This is the high-speed, many-core processor of the graphics card/chip that takes geometry, images and data from the CPU and creates images and processed data.
Mode where the network editing window is not open, your performance interface window(s) is open and you are running your application as fast as possible. See Designer Mode.
A Time Slice is the time from the last cook frame to the current cook frame. In CHOPs it is the set of short channels that only contain the CHOP channels' samples between the last and the current cook frame.
The tool built-in to TouchDesigner that analyzes and displays what TouchDesigner is doing as it generates an image.
A built-in panel in TouchDesigner that contains a library of components and media that can be dragged-dropped into a TouchDesigner network.