Table of Contents

Quick Introduction

In RenderMan, in addition to the built-in AOVs, light path expressions (LPEs), which are adopted from Open Shading Language's Light Path Expression, specify what light transport paths to output to a display channel. In other words, we don't have to modify the shaders or plugins to output a custom AOV that uses the LPE.

The setup is the same as an AOV except we use a light path expression instead of an AOV channel name. Additionally, we can group the outputs by light groups and/or by geometry set up by a lpegroup. 

...

To better understand how an LPE is constructed, the below tokens are used to define interactions. For most users, the pre-built LPE are easily selected and explained below.

C

<type event 'group'>

<L.'group'>

O

.

R

T

D

S

[^ ]

*

+

{n}

{min,}

{min,max}

In RIB

To specify an LPE in RIB, reference a DisplayChannel in the Display. This is the most basic way to view what's being output.

...

For basic workflows, the following LPE are recommended. Note that we are specifying the DisplayChannel and a name (which can be most anything). Note that these LPE will collect the light interaction from different lobes of materials and store them in the same AOV. For example: reflections from the Glass Lobe in PxrSurface will be combined with other specular reflections in the direct and indirectSpecular AOVs. This can simplify the outputs. 

color emissive

color lpe:C[<L.>O]

color directDiffuse

color lpe:C<RD>[<L.>O]

color indirectDiffuse

color lpe:C<RD>.+[<L.>O]

color subsurface

color lpe:C<TD>.*[<L.>O]

color directSpecular

color lpe:C<RS>[<L.>O]

color indirectSpecular

color lpe:C<RS>.+[<L.>O]

color transmissive

color lpe:C<TS>.*[<L.>O]

...

RenderMan Still Life by Dylan Sisson

...

For example, some PxrSurface usage may involve the Clearcoat lobe. Normally this is summed under the S token. Routing this lobe to the S4 token will allow you to use S4 in your LPEs. These name-to-lobe mappings are controlled by render options. Up to 4 diffuse lobes and 8 specular lobes are available for LPEs. By default, S1 contains all unspecified specular lobes, so use any higher tokens such as S2 for explicit per-lobe LPEs. The standard lobe mappings are:

For advanced workflows that want to separate all scattering lobes into separate AOVs, the below LPE are provided. These capture the light interaction for each lobe, direct and indirect, and store them into separate AOVs. This is useful for tweaking individual effects at the cost of added AOVs and image output. The documentation for PxrMarschner and PxrSurface list these user lobes at the bottom of their page under an Advanced Rollout as it is for informational purposes and not actual operation. 

color directDiffuseLobe

color lpe:CD2[<L.>O]

color indirectDiffuseLobe

color lpe:CD2.+[<L.>O]

color subsurfaceLobe

color lpe:CD3.*[<L.>O]

color directSpecularPrimaryLobe

color lpe:CS2[<L.>O]

color indirectSpecularPrimaryLobe

color lpe:CS2.+[<L.>O]

color directSpecularRoughLobe

color lpe:CS3[<L.>O]

color indirectSpecularRoughLobe

color lpe:CS3.+[<L.>O]

color directSpecularClearcoatLobe

color lpe:CS4[<L.>O]

color indirectSpecularClearcoatLobe

color lpe:CS4.+[<L.>O]

color directSpecularIridescenceLobe

color lpe:CS5[<L.>O]

color indirectSpecularIridescenceLobe

color lpe:CS5.+[<L.>O]

color directSpecularFuzzLobe

color lpe:CS6[<L.>O]

color indirectSpecularFuzzLobe

color lpe:CS6.+[<L.>O]

color transmissiveSingleScatterLobe

color lpe:CS7.*[<L.>O]

color directSpecularGlassLobe

color lpe:C<RS8>[<L.>O]

color indirectSpecularGlassLobe

color lpe:C<RS8>.+[<L.>O]

color transmissiveGlassLobe

color lpe:C<TS8>.*[<L.>O]

color emissive

color lpe:C[<L.>O]

...

...

Caustics are not included in the built-in list because they overlap with indirectdiffuse lpe:C<RD>[DS]+[<L.>O] However, you can select caustics with the expression lpe:CDS+[<L.>O]  Below you can find an example of the caustics LPE output, Indirect Diffuse, and the difference between them. Note that the Caustics LPE output doesn't capture indirect lighting from object to object, in this case the red cube. You can create the image on the far right with the indirect diffuse minus the caustic result using the following source: lpe:C<RD>D[DS]*[<L.>O]

LPE Macro

If a custom LPE is useful for your shots, you can add your custom LPE by creating a macro in rendermn.ini file. The custom LPE will appear in the RenderMan for Maya (RfM) LPE list after relaunching Maya.  For example:

...

• U tokens specify a user defined signal. A Bxdf can output any user defined signal via the RixBXLobeWeights class. There are twelve of them, from U1 to U12. By default, all user defined signals are set to U1. More on this can be found in the Developer's Guide.
• If you have more than one user defined signal, it is important to direct each user defined signal to a different U token by setting them in rendermn.ini. Otherwise, all user defined signals that are assigned to the same U token will override each others!
• By default, U2 is set to the albedo output in the installed rendermn.ini:

...

/prman/lpe/user2                 Albedo,DiffuseAlbedo,SubsurfaceAlbedo,HairAlbedo

...