rttherm — raytrace a hyper-spectral thermal image of an mged model
is a member of the RTUIF family of programs,
and implements the same options as
with the exception that the
option is currently not implemented and reserved for future use.
creates a hyper-spectral ray-trace into
the output file
specified with the
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.
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
which is the default. (20 degrees C is 293 degrees Kelvin).
The spectral sampling density may be set from the command line
-c set spectrum=nsamp/lo_nm/hi_nm
option, or in the animation script with the command
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
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 ##
where "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.
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.
This software is Copyright (c) 1999-2016 United States Government as represented by the U.S. Army Research Laboratory.