Page tree


Basic Setup in Katana

Step 1:

Add a PrmanDenoiseChannelDefine node to create all the DisplayChannels required for the denoiser.

Step 2:

Add a PrmanDenoiseRenderOutputDefine node to output a multichannel OpenEXR file for the beauty pass. The file contains all the required denoise channels.

Set the renderLocation parameter to the location of your output image. The denoiser expects images to be in the form <NAME>.<FRAME_NUMBER>.exr (ex. image.1001.exr). In Katana you can specify the number of digits in the frame number by the number of #s in the filename (ex. image.##.exr would result in image.01.exr).

Step 3:

Set pixelfiltermode to importance if you changed it from the default. This is done in PrmanGlobalStatements.

Custom setup in Katana

Both the PrmanDenoiseChannelDefine and PrmanDenoiseRenderOutputDefine nodes are macros. You can command-click to see inside these macros and change settings if necessary.

If your pipeline does not support multichannel EXRs, you can use separate RenderOutputDefine nodes to create an output for each channel defined in PrmanDenoiseChannelDefine. Then use $RMANTREE/bin/exrmerge to combine the AOVs into a multichannel EXR. Use this merged multichannel EXR for the denoiser. Combined EXRs created with Katana's RenderOutputDefine merge will not work with the denoiser.

On any RenderOutputDefine nodes you create for denoising, the type should be set to "raw" to avoid any post-processing by Katana. Then make sure asrgba is set off so that the channel names align with what the denoiser expects. 

See the denoise_teapots.katana example file in RfK's Examples directory to see how to set up denoising. 

Running the Denoiser:

There are several options available to denoise your Katana renders. RenderMan provides both a command line denoise tool called denoise_batch and a Denoise UI. Note that denoising is not supported interactively, so all denoise renders need to be Disk or batch renders.

Option 1: RenderOutputDefine Script (Single Frame)

Create a RenderOutputDefine.
Wire this node to the previous RenderOutputDefine node.
Select script for the type, select primary for the scriptInput, and set the scriptCommand to the following:

$RMANTREE/bin/denoise_batch -o /path/to/directory/for/denoised/images $INPUT

Finally, render your scene with a disk or batch render. 

Option 2: command line (Crossframe or Single Frame)

Render out your images with katana --batch or katana queue. Then run the following command: 

$RMANTREE/bin/denoise_batch -o /path/to/directory/for/denoised/images imagename.*.exr

See the Denoiser Command Line documentation for more information on the settings available.

Option 3: Denoise UI (Crossframe or Single Frame)

  1. Render your images out of Katana as a disk or batch render.
  2. The PRMan 25 shelf has a script called RenderMan Denoiser. Run this script to launch the Denoise UI. You can also access the UI directly from $RMANTREE/bin/denoise 
  3. In the UI, select "Add Directory..." and choose the directory containing the images you have rendered out of Katana.
  4. Next select folder icon next to choose the directory your denoised images will be saved in.
  5. Hit "start" to begin denoising.

See the Denoiser UI documentation for more information on the settings available.