Palette:probe

From Derivative
Jump to: navigation, search

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[edit]

Drag-drop the probe component from the Palette anywhere in your TouchDesigner process, preferably in /.

Pressing Ctrl-p 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.

probe CPU performance monitor

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.

a component

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).

Note[edit]

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.

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 .

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.