VARIANT LAB
Render many versions of one comp from a simple table. Exposure brackets, two-way grids, split images, compare sheets and a client review page you can email.
One comp. Every option.
Your client says "can we see it a bit warmer, and a stop brighter, and one more darker?" Instead of changing, rendering and renaming by hand, you fill in a table. Variant Lab changes the settings, renders every version, labels each picture and builds the review for you.
Any setting is a control
Pick any knob in your script: a number, a colour, even text. Each one becomes a column in the table.
Three ways to make versions
Type your own rows, make exposure brackets in one line, or cross two settings in a grid.
Auto-fill
Fill a column with a range, random values, a list or steps with an ease curve.
Labelled and checked
Burn the changed values on each picture. Flags clipped highlights and crushed blacks.
Compare and split
One sheet of everything, or strips and quarters from different versions in a single picture.
Client package
A web page and a zip. Your client stars the ones they like and writes comments. No account, no software.
Five tabs. One idea each.
Open it from Nodes > Variant Lab or from a pane. Work left to right through the tabs.
What changes
Pick every setting you want to change between versions. Each one becomes a column in the table.
| Option | What it does and an example |
|---|---|
| Add control | Opens a list of every node in your script. Pick a node, then a knob. Example: Grade1 > multiply for exposure. |
| Pick by node | Search the node list. Example: type "grade" to see only Grade nodes. |
| Remove control | Takes a column out of the table. Example: remove Blur1.size if you no longer need it. |
Versions
The table of versions. Three sets: My versions, Exposure brackets and a 2-way grid.
| Option | What it does and an example |
|---|---|
| My versions | One row = one version. Type a name and a value for each control. Example: row "warm" with Grade1.white 1.12, 1.0, 0.86. |
| Auto-fill column | Fills a whole column for you: Range, Random, List or Steps, with an ease curve. Example: Range from 0.7 to 1.3 with 5 values. |
| Exposure brackets | Stops in a row. Example: -2, -1, 0, 1, 2 makes five exposure versions. |
| 2-way grid | Two settings crossed. Example: exposure down (0, 1) and gamma across (0.8, 1, 1.2) gives six versions. |
| Preview row | Shows one row in your Viewer without rendering. Example: select "warm" and press Preview row. |
| Undo preview | Puts every setting back as it was before you previewed. |
| Use this row | Keeps that row's values in your script. Example: the client chose "warm", press Use this row. |
| CSV | Export the table to a spreadsheet, or import one. Example: edit 40 rows in Excel and import them. |

Add control

Auto-fill

2-way grid
Output and checks
Where and how the pictures are written, and what is added on top.
| Option | What it does and an example |
|---|---|
| Write node | Which Write node renders. Example: Write_out. |
| Output folder | Empty means a folder called variantlab_out next to your script. Example: type a path to send it elsewhere. |
| Frames | Current frame, a Range, or the whole script. Example: Range 1 to 48 makes movies. |
| File name | Pattern with {name}. Example: cafe_{name}. |
| Format | Keep your Write settings, Review, PNG 16, JPG, EXR 16 or EXR 32. Example: JPG for emails, EXR 16 to keep highlights. |
| Colourspace | Colourspace of the written files. Example: sRGB for JPG. |
| Thumbnails | Small pictures for the gallery and client page. |
| Burn-in | Prints the version label on the picture. Example: bottom left, size 28. |
| Corner / Size | Where and how big the burn-in text is. |
| Changed values | Prints what changed. Example: "Grade1.multiply 1.4". |
| Also burn in | Frame number, colourspace, date, notes. |
| Note | A comment for one version. Example: "too hot in the sky". |
| Checks | Flags clipped highlights (CLIP) and crushed blacks. |
| Measure area | Measures the average colour in a region. Example: use the Viewer region over a face. |
Share
Turn the finished pictures into something you can show.
| Option | What it does and an example |
|---|---|
| Make compare sheet | Every finished version in one labelled picture. Example: pin it to a review email. |
| Zoom to | Compare only part of the picture. Example: type 1000, 500, 1600, 850 (left, bottom, right, top in pixels) to compare one eye or a logo. |
| Use viewer region | Takes the Region of Interest from your Viewer instead of typing numbers. |
| Split image: Layout | 3 strips (-1 EV | normal | +1 EV side by side), 4 quarters (2 x 2) or Stacked (one above the other). |
| Use versions from | Exposure brackets or My versions. Example: choose Exposure brackets after you made brackets in tab 2. |
| Or pick by name | Choose the versions and their order. Example: dark, normal, bright. |
| Frame | For a movie, which frame to show. Example: 1050. First frame uses the start of the shot. |
| Make one automatically after every render | Builds the split image as soon as the render finishes. |
| Make split image | Builds the picture. |
| Client package: Title | The heading your client sees. Example: Perfume spot - grade options. |
| Replies go to | Your email for the client Send button. Leave empty and they copy and paste instead. |
| Show the changed values / my notes | Tick only if the client may see them. Example: exposure 1.2 under each picture. |
| Full-size pictures | Untick for a small file you can email. |
| Make client package | Makes the folder and the zip. Double-click client_review/index.html to see what your client sees. |
| Open gallery / Open output folder | Open your own gallery page, or the folder in Explorer. |
About
Version, licence and credits. The grey/black VariantLab_Data node in your Node Graph holds the table and options. Safe to ignore. Leave it there.
VariantLab_Data. It holds your table and options inside the script. Safe to ignore. Leave it there, and your table comes back when you reopen the script.Six examples. Open the script.
Download the Test Pack. Each example is a ready-made Nuke script with a note on the Node Graph. Open it, follow the numbers, and you get the picture below.
Exposure brackets on a 16-bit EXR
See one product shot at five exposures, and keep the over-bright values.
- Open the script. Press Nodes > Variant Lab (or Pane > Variant Lab).
- Tab 1 What changes: the two settings that change are Grade_exposure.multiply and .gamma.
- Tab 2 Versions: your own looks on the left, and on the right Exposure brackets: stops -2, -1, 0, 1, 2. That is 7 versions.
- Tab 3 Output and checks: Format is EXR 16-bit, so values brighter than white are kept.
- Press Render (bottom right). The files appear in a folder called variantlab_out next to the script.
- Tab 4 Share: Make compare sheet. Then Make split image: 3 strips, -2 EV | 0 EV | +2 EV.
You learn: Exposure brackets, EXR output, compare sheet, split image.


Change any setting, not only exposure
Show three colour looks of a sunset: neutral, warm and cool.
- Open the script and open Variant Lab.
- Tab 1: the controls are Grade_look.white (a colour) and Grade_look.gamma. Any knob can be a control: a number, a colour, even text.
- Tab 2: three rows, neutral, warm and cool. They change the colour and gamma. A colour is three numbers, for example 1.12, 1.0, 0.86.
- Press Render. Three pictures appear in variantlab_out.
- Tab 4 Share: Split image, Use versions from: My versions, names: neutral, warm, cool. Press Make split image.
You learn: Add control, My versions table, colour values, split image with names.


Everything together: your versions, brackets and a grid
Build 14 versions of a night street from three sets in one table.
- Open the script and open Variant Lab.
- Tab 2 Versions, left: your own versions night and hero.
- Right: Exposure brackets -1, 0, +1 (3 versions) and a 2-way grid, exposure down and gamma across (3 x 3 = 9). Total 14 versions.
- Each set has a Render these box. Untick one to leave that set out.
- Press Render. Then Tab 4 Share: Make compare sheet gives one sheet for each set.
- Make client package: a folder and a zip you can send, with stars and comments for your client.
You learn: The three version sets, the grid, one sheet per set, client package.


A moving shot (48 frames)
Compare versions of a moving shot as movies, and compare one moment.
- Open the script and open Variant Lab.
- Tab 3 Output and checks: Frames is Range 1 to 48, so each version is a movie (.mov) and not a still.
- Tab 2 Versions: golden (your own look) plus Exposure brackets -1, 0, +1.
- Press Render. Four movies appear in variantlab_out.
- Tab 4 Share: the split image uses frame 24 of each movie (the Frame box), so you compare one moment.
- Make client package: the movies are included and play in the client browser.
You learn: Frame range, movies, the Frame box, movies in the client package.


The Share tab, step by step
Turn rendered versions into a compare sheet, a split image and a client page.
- Open Variant Lab and press Render. Six versions are made: 3 of your own looks and 3 exposure brackets.
- Go to tab 4 Share.
- Compare sheet: press Make compare sheet. One picture with every version, labelled.
- Split image: Layout 3 strips, Use versions from Exposure brackets, -1 EV | 0 EV | +1 EV. Then try Use versions from My versions, or pick by name: calm, golden, moody. Then try Layout 4 quarters (2 x 2).
- Client package: press Make client package, then double-click client_review/index.html in the output folder to see what your client sees.
- Open output folder to find the zip you can email.
You learn: Compare sheet, split layouts, client package, Open output folder.


Auto-fill, 2-way grid and the Output tab
Make a grid of 6 looks and 5 gamma steps of a portrait, with the values printed on each picture.
- Open Variant Lab.
- Tab 2 Versions, Auto-fill column: click the Grade_look.gamma column, press Auto-fill, From 0.7 To 1.3, 5 values. That made the five gamma versions on the left.
- Right, 2-way grid: set up grid. Down = saturation 0, 1. Across = multiply 0.5, 1.0, 2. That makes 2 x 3 = 6 versions, named g1_1 to g2_3.
- Tab 3 Output and checks: Format JPG, File name cafe_{name}, Burn-in on with the changed values, Notes on, Checks on.
- Press Render. 11 JPG pictures in variantlab_out next to this script, each with its label on it.
- Optional: in Tab 3 press Use viewer region while looking at the face. Every version then measures the average colour there.
You learn: Auto-fill, 2-way grid, file naming, burn-in, checks, measure area.


The client package
One click makes a folder and a zip. Your client opens index.html in any browser, stars the versions they like and writes comments, then copies their choices back to you. Everything works offline.
And a gallery for you

Three steps
- Download and unzip VariantLab_v15.zip.
- Run the installer. Open Nuke, press Alt+S for the Script Editor, load
VariantLab_Installer.pyand press Run. It copies the tool into your .nuke folder and adds a menu. It backs up your menu.py first. - Restart Nuke. You will find
Nodes > Variant LabandPane > Variant Lab.
Terminal mode
Render from the command line: nuke -t variantlab_cli.py script.nk --only=1,3 --folder=DIR --frame=24 --split=v3 --client --title="Look options"
FAQ
Does it change my script?
Only while it renders, and it puts every setting back after. It adds one small node, VariantLab_Data, which stores your table.
Which Nuke versions?
Built for Nuke 13 and later. Tested on Nuke 15.2 and 17.1 (Windows). Tell me if it works on yours.
Does it work in Nuke Indie or Non-commercial?
Foundry limits Python in those editions, so it may not load. Try it and tell me how it goes.
Can I use it on the farm?
There is a command line mode (variantlab_cli.py). It has not yet been tested in a render-only licence.
How big is a client package?
Full-size pictures make it large. Untick Full-size pictures to keep it small.
Does it work with ACES?
Yes. Tested in an ACES (OCIO) project on Nuke 15.2 and 17.1 with the ACES 1.3 config that ships with Nuke. JPG and PNG pictures look like your Viewer (with the ACES view transform). EXR files are written in your working space, ACEScg. The Colourspace option on tab 3 lists the ACES spaces if you need a different one.
Is it really free?
Yes. MIT licence. Use it, change it, share it.
Try it on your next review
A free tool by gsmotion · MIT licence