Overview

Edit Similar lets you view and modify knob values across every node of the same class in a single spreadsheet. Select a Blur, launch Edit Similar, and instantly see every Blur in your script with its key knobs laid out as columns. Change values in bulk, compare settings at a glance, and keep your node graph consistent.

📷Edit Similar overview — spreadsheet with multiple Blur nodesimg/edit-similar/es-overview.png
The Edit Similar spreadsheet showing all Blur nodes in the script with their key knobs as columns.

How to Access

There are two entry points depending on whether you want to edit all matching nodes or only your current selection:

Edit Similar (all matching nodes)

Opens a spreadsheet containing every node of the same class in the current script. Select any node and run:

# From the Script Editor
import node_graph_tools.tools.edit_similar as es
es.run()

Edit Selection (selected nodes only)

Opens a spreadsheet containing only the currently selected nodes. Useful when you want to compare or batch-edit a specific subset.

# Edit only the selected nodes
import node_graph_tools.tools.edit_similar as es
es.run(selection_only=True)

Spreadsheet View

Each row represents a node, each column a knob. The widget used for editing depends on the knob type:

Knob TypeWidgetExample Knobs
BooleanCheckboxdisable, postage_stamp
EnumDropdownchannels, operation
FormatDropdownformat
IntegerSpinBoxsamples, first_frame
FloatDoubleSpinBoxsize, mix, opacity
StringLineEditlabel, name, file

Batch Edit Panel

The batch edit panel sits at the top of the spreadsheet and lets you apply a single value to all selected rows at once:

  1. Select the target knob from the dropdown.
  2. Enter the desired value in the text field (supports the multi-dimensional syntax described below).
  3. Click Apply to Selected to push the value to every selected node.
🎬Batch edit — applying a value to multiple selected nodesimg/edit-similar/es-batch-edit.gif
Using the batch edit panel to set the size knob on all selected Blur nodes simultaneously.

Live Selection Sync

The spreadsheet selection and the DAG selection stay in sync in both directions:

This makes it easy to locate specific nodes and understand your script layout while editing values.

🎬Selection sync — bidirectional sync between spreadsheet and DAGimg/edit-similar/es-selection-sync.gif
Clicking rows in the spreadsheet highlights and zooms to the corresponding node in the DAG, and vice versa.

Table Interaction

ActionBehaviour
Single click on rowSelect node, zoom to it in DAG
Shift + clickExtend selection (range)
Ctrl + clickToggle individual row in selection
Double-click cellEnter inline edit mode for that knob value
Edit widgetValue is applied immediately on change (live editing)
Click column headerSort table by that knob's values

Value Syntax for Multi-Dimensional Knobs

Knobs like translate, scale, or color have multiple components. The batch edit field supports a flexible syntax to target individual dimensions or apply relative operations:

Syntax Table

InputMeaningExample
50Set all components to 50translate → (50, 50)
50/100Set component 1 to 50, component 2 to 100translate → (50, 100)
x/50Keep X unchanged, set Y to 50translate → (current, 50)
x+10Add 10 to X (relative)translate.x → current + 10
y-5Subtract 5 from Ytranslate.y → current − 5
w*2Multiply W by 2size.w → current × 2
h/3Divide H by 3size.h → current ÷ 3
r=0.5Set R component to 0.5color.r → 0.5
+50Add 50 to all componentstranslate → (x+50, y+50)
-10Subtract 10 from alltranslate → (x−10, y−10)
*2Multiply all components by 2scale → (sx*2, sy*2)

Variable Sets

The variable names available depend on the knob's dimensionality:

Variable SetComponentsUsed For
x y z3D coordinatestranslate, rotate, scale
r g b aColor channelscolor, white, black, multiply
w hWidth, Heightsize, crop
u vUV coordinatesUV knobs
📷Multi-dimensional value syntax applied to translate knobsimg/edit-similar/es-multi-dim.png
Using relative syntax to offset the translate knob across multiple Transform nodes.

Knob Filter

When dealing with nodes that expose many knobs, use the knob filter to narrow down the visible columns. Type part of a knob name into the filter field and the spreadsheet updates instantly, showing only matching columns.

📷Knob filter narrowing columns to matching knobsimg/edit-similar/es-knob-filter.png
The knob filter field lets you quickly find specific knobs in complex node classes.

Preferred Knobs

When the spreadsheet opens, it shows a sensible default knob as the first visible column based on the node class. These preferred knobs make the most common editing task immediate:

Node ClassDefault Knob
Blursize
Defocusdefocus
Transformtranslate
Gradewhite
ColorCorrectsaturation
Merge / Merge2mix
Dissolvewhich
Shuffle / Shuffle2in
Trackertranslate
Roto / RotoPaintopacity
StickyNotelabel
OtherFirst user knob or name

Context Menu

Right-click any row to access the context menu. The primary action is:

Troubleshooting

ProblemSolution
Spreadsheet opens emptyMake sure at least one node is selected before launching. If using Edit Similar (not Edit Selection), ensure there are other nodes of the same class in the script.
Knob column shows "N/A"The knob exists on most nodes of this class but not on this particular instance (e.g., a custom gizmo variant). The cell is read-only in this case.
Value does not updateThe knob may be driven by an expression or linked. Check the node properties for expression links.
Multi-dimensional syntax not workingEnsure the knob is actually multi-dimensional. Single-value knobs like mix only accept plain numbers.
Panel does not appearCheck the Script Editor for error messages. Ensure node_graph_tools is correctly installed and loaded.

Compatibility

RequirementSupported Versions
Nuke11.0v4, 12.x, 13.x, 14.x, 15.x, 16.x
Qt BindingPySide (Nuke 11), PySide2 (Nuke 12+)
Python2.7 (Nuke 11–12), 3.7+ (Nuke 13+)
OSWindows, macOS, Linux