OnWorks favicon

genBSDF - Online in the Cloud

Run genBSDF in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command genBSDF that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



genBSDF - generate BSDF description from Radiance or MGF input


genBSDF [ -c Nsamp ][ -n Nproc ][ -r 'rtcontrib opts...' ][ -t{3|4} Nlog2 ][ {+|-}forward
][ {+|-}backward ][ {+|-}mgf ][ {+|-}geom unit ][ -dim Xmin Xmax Ymin Ymax Zmin Zmax ] [
geom .. ]


GenBSDF computes a bidirectional scattering distribution function from a Radiance or MGF
scene description given on the input. The program assumes the input is in Radiance format
unless the +mgf option is specified. The output conforms to the LBNL Window 6 XML
standard for BSDF data, and will include an MGF representation of the input geometry if
the +geom option is given, followed by one of "meter," "foot," "inch," "centimeter," or
"millimeter," depending on the scene units. The default is to include the provided
geometry, which is assumed to be in meters. Geometry output can be supressed with the
-geom option, which must also be followed by one of the above length units.

Normally, genBSDF computes components needed by a backwards ray-tracing process,
+backward. If both forward and backward (front and back) distributions are needed, the
+forward option may be given. To turn off backward components, use the -backward option.
Computing both components takes about twice as long as one component.

The geometry must fit a rectangular profile, whose width is along the X-axis, height is in
the Y-axis, and depth is in the Z-axis. The positive Z-axis points into the room, and the
input geometry should not extend into the room. (I.e., it should not contain any positive
Z values, since the putative emitting surface is assumed to lie at Z=0.) The entire
window system should be modeled, including sills and edge geometry anticipated in the
final installation, otherwise accuracy will be impaired. Similarly, materials in the
description should be carefully measured.

Normally, the input geometry will be positioned according to its actual bounding box, but
this may be overridden with the -dim option. Use this in cases where the fenestration
system is designed to fit a smaller (or larger) opening or is offset somehow.

The variance in the results may be reduced by increasing the number of samples per
incident direction using the -c option. This value defaults to 2000 samples distributed
over the incoming plane for each of the 145 Klems hemisphere directions.

In some cases, the processing time may be reduced by the -n option, which specifies the
number of simultaneous rtrace(1) processes to run in rtcontrib(1). The -r option may be
used to specify a set of quoted arguments to be included on the rtcontrib command line.

The -t4 mode computes a non-uniform BSDF represented as a rank 4 tensor tree, suitable for
use in the Radiance rendering tools. The parameter given to this option is the log to the
base 2 of the sampling resolution in each dimension, and must be an integer. The -c
setting should be adjusted so that an appropriate number of samples lands in each region.
A -t4 parameter of 5 corresponds to 32x32 or 1024 output regions, so a -c setting of 10240
would provide 10 samples per region on average. Increasing the resolution to 6
corresponds to 64x64 or 4096 regions, so the -c setting would need to be increased by a
factor of 4 to provide the same accuracy in each region.

The -t3 mode is similar to -t4 but computes a rank 3 tensor tree rather than rank 4. This
provides a much faster computation, but only works in special circumstances.
Specifically, do NOT use this option if the system is not in fact isotropic. I.e., only
use -t3 when you are certain that the system has a high degree of radial symmetry. Again,
the parameter to this option sets the maximum resolution as a power of 2 in each
dimension, but in this case there is one less dimension being sampled.


To create a BSDF description including geometry from a set of venetian blinds:

genblinds blind_white blind1 .07 3 1.5 30 40 | xform -rz -90 -rx 90 > blind1.rad
genBSDF -r @rtc.opt blind_white.mat glazing.rad blind1.rad > blind1.xml

To create a non-uniform, anisotropic BSDF distribution with a maximum resolution of
128x128 from the same description:

genBSDF -r @rtc.opt -t4 7 -c 160000 blind_white.mat glazing.rad blind1.rad > blind12.xml


The variable resolution (tensor tree) BSDF representation is not supported by all software
and applicatons, and should be used with caution. It provides practical, high-resolution
data for use in the Radiance rendering programs, but does not work in the matrix
formulation of the daylight coefficient method for example. Also, third party tools
generally expect or require a fixed number of sample directions using the Klems directions
or similar.

Use genBSDF online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    ExpressLuke GSI
    ExpressLuke GSI
    This SourceForge download page was to
    grant users to download my source built
    GSIs, based upon phhusson's great
    work. I build both Android Pie and
    Android 1...
    Download ExpressLuke GSI
  • 2
    PyQt is the Python bindings for
    Digia's Qt cross-platform
    application development framework. It
    supports Python v2 and v3 and Qt v4 and
    Qt v5. PyQt is avail...
    Download PyQt
  • 3
    Gambas3* coding tools and examples for
    use in SMB or other organizations that
    make internal programs. E.g. from
    database fields to class sourcecode with
    Download garlic3
  • 4
    Sardi is a complete restyling and
    optimisation of svg code. 6 choices for
    your applications and 10 kind of folders
    to use in your file manager. The sardi
    Download Sardi
  • 5
    LMMS Digital Audio Workstation
    LMMS Digital Audio Workstation
    LMMS is a free cross-platform software
    which allows you to produce music with
    your computer. If you like this project
    consider getting involved in the project
    Download LMMS Digital Audio Workstation
  • 6
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS Real Time Kernel (RTOS)
    FreeRTOS is a market-leading real-time
    operating system (RTOS) for
    microcontrollers and small
    microprocessors. Distributed freely
    under the MIT open source lice...
    Download FreeRTOS Real Time Kernel (RTOS)
  • 7
    Avogadro is an advanced molecular
    editor designed for cross-platform use
    in computational chemistry, molecular
    modeling, bioinformatics, materials
    science and ...
    Download Avogadro
  • More »

Linux commands