Radiance (software)


Radiance is a suite of tools for performing lighting simulation originally written by Greg Ward. It includes a renderer as well as many other tools for measuring the simulated light levels. It uses ray tracing to perform all lighting calculations, accelerated by the use of an octree data structure. It pioneered the concept of high dynamic range imaging, where light levels are open-ended values instead of a decimal proportion of a maximum or integer fraction of a maximum. It also implements global illumination using the Monte Carlo method to sample light falling on a point.
Greg Ward started developing Radiance in 1985 while at Lawrence Berkeley National Laboratory. The source code was distributed under a license forbidding further redistribution. In January 2002 Radiance 3.4 was relicensed under a less restrictive license.
One study found Radiance to be the most generally useful software package for architectural lighting simulation. The study also noted that Radiance often serves as the underlying simulation engine for many other packages.

HDR image format

Radiance defined an image format for storing HDR images, now described as RGBE image format. Since it was the first HDR image format, this format is supported by many other software packages.
The file starts with the signature '#?RADIANCE' and then several lines listing the commands used to generate the image. This information allows the renderer rpict to continue a partially completed render. There are also key=value declarations, including the line 'FORMAT=32-bit_rle_rgbe'.
After this is a blank line signifying the end of the header. A single line describes the resolution and pixel order. As produced by the Radiance tools this always takes the form of '-Y height +X width'. After this line follows the binary pixel data.
Radiance calculates light values as floating point triplets, one each for red, green and blue. But storing a full double precision float for each channel is a burden even for modern systems. Two stages are used to compress the image data. The first scales the three floating point values to share a common 8-bit exponent, taken from the brightest of the three. Each value is then truncated to an 8-bit mantissa. The result is four bytes, 32 bits, for each pixel. This results in a 6:1 compression, at the expense of reduced colour fidelity.
The second stage performs run length encoding on the 32-bit pixel values. This has a limited impact on the size of most rendered images, but it is fast and simple.

Scene description format

A radiance scene is made from one or more object files. The .rad format is a simple text file. It can specify individual geometric objects, as well as call programs by starting a line with an exclamation point '!'.
When specifying geometry the first line is
modifier type name
The following three lines contain parameters starting with an integer specifying the number of parameters. The parameters need not be on the same line, they can be continued on multiple lines to aid in readability.
Modifiers create materials and can be chained together, one modifying the next.
For example:
myball.rad
chrome sphere ball
0
0
4 0 0 10
10
This can then be arrayed in another file using the xform program :
scene.rad
void metal chrome
0
0
5 0.8 0.8 0.8
0.9 0.0
!xform -a 5 -t 20 0 0 myball.rad
This creates a chrome material and five chrome spheres spaced 20 units apart along the X-axis.
Before a scene can be used, it must be compiled into an octree file using the oconv tool. Most of the rendering tools use an octree file as input.

Tools

The Radiance suite includes over 50 tools. They were designed for use on Unix and Unix-like systems. Many of the tools act as filters, taking input on standard input and sending the processed result to standard output. These can be used on the Unix command line and piped to a new file, or included in Radiance scene files themselves, as shown above.

Geometry manipulation

Several radiance programs manipulate Radiance scene data by reading from either a specified file or their standard input, and writing to standard output.
Generators simplify the task of modelling a scene, they create certain types of geometry from supplied parameters.
Radiance includes a number of programs for converting scene geometry from other formats. These include: