RTTHERM(1)

NAME
rttherm - raytrace a hyper-spectral thermal image of an mged model

SYNOPSIS
rttherm [ options ... ] -o output.ssamp model.g objects ...

DESCRIPTION
rttherm(1) is a member of the RTUIF family of programs, and implements the same options as rt(1), with the exception that the -F (framebuffer) option is currently not implemented and reserved for future use. rttherm(1) creates a hyper-spectral ray-trace into the output file specified with the -o option. It also writes a second file (using bn_table_write) with the suffix ".spect" which describes the spectral sampling pattern used when creating the output file.

SPECIFYING TEMPERATURES
Temperatures are always specified in degrees Kelvin ("Kelvins").

The background (ambient) temperature may be set from the command line with the -c set bg_temp=degK command, or in the animation script with the command

 set bg_temp=293.0

which is the default. (20 degrees C is 293 degrees Kelvin).

The spectral sampling density may be set from the command line with the -c set spectrum=nsamp/lo_nm/hi_nm option, or in the animation script with the command

 set spectrum=nsamp/lo_nm/hi_nm

The default setting is 100/380/12000, which takes 100 samples equally spaced from 380nm (low end of the optical band) to 12microns (upper end of the "Far-IR" band).

rttherm(1) is built using libmultispectral(3) rather than liboptical(3), which provides a similar set of shaders. Most notable is the "temp" shader, which applies a two-dimensional temperature map to a region in exactly the same way as the "texture" and "bwtexture" shaders apply colors to the surface.

The temperature of a region may be modified by the rt animation script which is read by rttherm(1) when the -M flag is specified. The syntax of the anim command is:

 anim path temp ## ;

where "anim" is a keyword, "path" is the path specification for the affected combination(s), "temp" is a keyword ("temperature" is also accepted), and ## is the new temperature for the combination(s) in Kelvins.

The Tcl interface to the database supports adjusting region temperatures. The syntax of the anim command is:

 db put|adjust combname temp ##

were "db" is the name of the Tcl database object for the desired database (typically "db" or ".inmem"), "put" and "adjust" are keywords, "combname" is the name of the combination, "temp" is a keyword, and ## is the new temperature for the combination in Kelvins. Note that the BRL-CAD v4 database has no place for storing region temperatures on disk, so this command won't have any effect on v4 databases.

POST PROCESSING
ssampview(1) is a GUI tool for viewing the multi-spectral output files created by rttherm(1). In the works is a post-processing tool which will extract a spectral window into a conventional 8-bit/pixel bw(5) file, probably in two steps: (1) extracting a representative power value per pixel into a dbw(5) (double-precision .bw file), and then (2) using cv(1) to perform a direct conversion, or using dpix-pix(1) or similar tool to perform scaling and/or auto-ranging.

SEE ALSO
brlcad(1), mged(1), rt(1), librt(3).

AUTHOR
Michael John Muuss

SOURCE
The U. S. Army Research Laboratory
Aberdeen Proving Ground, Maryland 21005

COPYRIGHT
This software is Copyright (c) 1999-2006 United States Government as represented by the U.S. Army Research Laboratory. All rights reserved.

BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.