Batch render

Variant Lab · Free batch render tool for Nuke | gsmotion

Free tool for Nuke · by gsmotion

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.

v1.5 · free, MIT licence · Nuke 13+ · tested on Nuke 15.2 and 17.1 (Windows), also in ACES (OCIO)

Variant Lab split image of an autumn lake at minus one, zero and plus one stop, with a compare sheet underneath
What it does

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.

How it works

Five tabs. One idea each.

Open it from Nodes > Variant Lab or from a pane. Work left to right through the tabs.

Tab 1

What changes

Pick every setting you want to change between versions. Each one becomes a column in the table.

Variant Lab tab 1, What changes
OptionWhat it does and an example
Add controlOpens a list of every node in your script. Pick a node, then a knob. Example: Grade1 > multiply for exposure.
Pick by nodeSearch the node list. Example: type "grade" to see only Grade nodes.
Remove controlTakes a column out of the table. Example: remove Blur1.size if you no longer need it.
Tab 2

Versions

The table of versions. Three sets: My versions, Exposure brackets and a 2-way grid.

Variant Lab tab 2, Versions
OptionWhat it does and an example
My versionsOne 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 columnFills 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 bracketsStops in a row. Example: -2, -1, 0, 1, 2 makes five exposure versions.
2-way gridTwo settings crossed. Example: exposure down (0, 1) and gamma across (0.8, 1, 1.2) gives six versions.
Preview rowShows one row in your Viewer without rendering. Example: select "warm" and press Preview row.
Undo previewPuts every setting back as it was before you previewed.
Use this rowKeeps that row's values in your script. Example: the client chose "warm", press Use this row.
CSVExport the table to a spreadsheet, or import one. Example: edit 40 rows in Excel and import them.
Add control window

Add control

Auto-fill window

Auto-fill

2-way grid window

2-way grid

Tab 3

Output and checks

Where and how the pictures are written, and what is added on top.

Variant Lab tab 3, Output and checks
OptionWhat it does and an example
Write nodeWhich Write node renders. Example: Write_out.
Output folderEmpty means a folder called variantlab_out next to your script. Example: type a path to send it elsewhere.
FramesCurrent frame, a Range, or the whole script. Example: Range 1 to 48 makes movies.
File namePattern with {name}. Example: cafe_{name}.
FormatKeep your Write settings, Review, PNG 16, JPG, EXR 16 or EXR 32. Example: JPG for emails, EXR 16 to keep highlights.
ColourspaceColourspace of the written files. Example: sRGB for JPG.
ThumbnailsSmall pictures for the gallery and client page.
Burn-inPrints the version label on the picture. Example: bottom left, size 28.
Corner / SizeWhere and how big the burn-in text is.
Changed valuesPrints what changed. Example: "Grade1.multiply 1.4".
Also burn inFrame number, colourspace, date, notes.
NoteA comment for one version. Example: "too hot in the sky".
ChecksFlags clipped highlights (CLIP) and crushed blacks.
Measure areaMeasures the average colour in a region. Example: use the Viewer region over a face.
Tab 4

Share

Turn the finished pictures into something you can show.

Variant Lab tab 4, Share
OptionWhat it does and an example
Make compare sheetEvery finished version in one labelled picture. Example: pin it to a review email.
Zoom toCompare 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 regionTakes the Region of Interest from your Viewer instead of typing numbers.
Split image: Layout3 strips (-1 EV | normal | +1 EV side by side), 4 quarters (2 x 2) or Stacked (one above the other).
Use versions fromExposure brackets or My versions. Example: choose Exposure brackets after you made brackets in tab 2.
Or pick by nameChoose the versions and their order. Example: dark, normal, bright.
FrameFor a movie, which frame to show. Example: 1050. First frame uses the start of the shot.
Make one automatically after every renderBuilds the split image as soon as the render finishes.
Make split imageBuilds the picture.
Client package: TitleThe heading your client sees. Example: Perfume spot - grade options.
Replies go toYour email for the client Send button. Leave empty and they copy and paste instead.
Show the changed values / my notesTick only if the client may see them. Example: exposure 1.2 under each picture.
Full-size picturesUntick for a small file you can email.
Make client packageMakes the folder and the zip. Double-click client_review/index.html to see what your client sees.
Open gallery / Open output folderOpen your own gallery page, or the folder in Explorer.
Tab 5

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.

Variant Lab tab 5, About
The grey/black node. After you use Variant Lab your Node Graph has a small black node called 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.
Learn by doing

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.

Example 1 · open script 1_exposure_brackets_exr.nk

Exposure brackets on a 16-bit EXR

See one product shot at five exposures, and keep the over-bright values.

  1. Open the script. Press Nodes > Variant Lab (or Pane > Variant Lab).
  2. Tab 1 What changes: the two settings that change are Grade_exposure.multiply and .gamma.
  3. 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.
  4. Tab 3 Output and checks: Format is EXR 16-bit, so values brighter than white are kept.
  5. Press Render (bottom right). The files appear in a folder called variantlab_out next to the script.
  6. 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.

Example 1 Node GraphExample 1 result
Example 2 · open script 2_parameter_change.nk

Change any setting, not only exposure

Show three colour looks of a sunset: neutral, warm and cool.

  1. Open the script and open Variant Lab.
  2. 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.
  3. 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.
  4. Press Render. Three pictures appear in variantlab_out.
  5. 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.

Example 2 Node GraphExample 2 result
Example 3 · open script 3_all_together.nk

Everything together: your versions, brackets and a grid

Build 14 versions of a night street from three sets in one table.

  1. Open the script and open Variant Lab.
  2. Tab 2 Versions, left: your own versions night and hero.
  3. 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.
  4. Each set has a Render these box. Untick one to leave that set out.
  5. Press Render. Then Tab 4 Share: Make compare sheet gives one sheet for each set.
  6. 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.

Example 3 Node GraphExample 3 result
Example 4 · open script 4_animation.nk

A moving shot (48 frames)

Compare versions of a moving shot as movies, and compare one moment.

  1. Open the script and open Variant Lab.
  2. Tab 3 Output and checks: Frames is Range 1 to 48, so each version is a movie (.mov) and not a still.
  3. Tab 2 Versions: golden (your own look) plus Exposure brackets -1, 0, +1.
  4. Press Render. Four movies appear in variantlab_out.
  5. Tab 4 Share: the split image uses frame 24 of each movie (the Frame box), so you compare one moment.
  6. 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.

Example 4 Node GraphExample 4 result
Example 5 · open script 5_share_tab.nk

The Share tab, step by step

Turn rendered versions into a compare sheet, a split image and a client page.

  1. Open Variant Lab and press Render. Six versions are made: 3 of your own looks and 3 exposure brackets.
  2. Go to tab 4 Share.
  3. Compare sheet: press Make compare sheet. One picture with every version, labelled.
  4. 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).
  5. Client package: press Make client package, then double-click client_review/index.html in the output folder to see what your client sees.
  6. Open output folder to find the zip you can email.

You learn: Compare sheet, split layouts, client package, Open output folder.

Example 5 Node GraphExample 5 result
Example 6 · open script 6_autofill_grid_output.nk

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.

  1. Open Variant Lab.
  2. 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.
  3. 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.
  4. Tab 3 Output and checks: Format JPG, File name cafe_{name}, Burn-in on with the changed values, Notes on, Checks on.
  5. Press Render. 11 JPG pictures in variantlab_out next to this script, each with its label on it.
  6. 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.

Example 6 Node GraphExample 6 result
Share it

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.

Client review page with six look options, two starred as chosen
Tip. Big packages: untick Full-size pictures on tab 4 and the zip stays small enough to email.

And a gallery for you

Gallery of versions with values, clip flags and notes
Install

Three steps

  1. Download and unzip VariantLab_v15.zip.
  2. Run the installer. Open Nuke, press Alt+S for the Script Editor, load VariantLab_Installer.py and press Run. It copies the tool into your .nuke folder and adds a menu. It backs up your menu.py first.
  3. Restart Nuke. You will find Nodes > Variant Lab and Pane > Variant Lab.
Uninstall: delete the VariantLab folder in your .nuke folder and the block marked VARIANT LAB in menu.py.

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"

Downloads

Everything is free

Tested on Nuke 15.2 and 17.1 on Windows 10, with the default colour setup and with ACES (OCIO). Other versions and systems have not been tested yet.

Questions

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