1 |
|
.\" RCSid "$Id$" |
2 |
|
.TH RTCONTRIB 1 5/25/05 RADIANCE |
3 |
|
.SH NAME |
4 |
< |
rtcontrib - compute contributions in a RADIANCE scene |
4 |
> |
rtcontrib - compute contribution coefficients in a RADIANCE scene |
5 |
|
.SH SYNOPSIS |
6 |
|
.B rtcontrib |
7 |
|
[ |
8 |
|
.B "\-n nprocs" |
9 |
|
][ |
10 |
+ |
.B \-r |
11 |
+ |
][ |
12 |
|
.B "\-e expr" |
13 |
|
][ |
14 |
|
.B "\-f source" |
15 |
|
][ |
16 |
< |
.B "\-o fspec" |
16 |
> |
.B "\-o ospec" |
17 |
|
][ |
18 |
|
.B "\-b binv" |
19 |
|
] |
53 |
|
.I Rtcontrib |
54 |
|
calls |
55 |
|
.I rtrace(1) |
56 |
< |
to calculate the contributions for each input ray, |
57 |
< |
and the output tallies are sent to one or more files according to the |
56 |
> |
with the -oTW option to calculate the daughter ray |
57 |
> |
contributions for each input ray, and the output tallies |
58 |
> |
are sent to one or more destinations according to the given |
59 |
|
.I \-o |
60 |
|
specification. |
61 |
+ |
If a destination begins with an exclamation mark ('!'), then |
62 |
+ |
a pipe is opened to a command and data is sent to its standard input. |
63 |
+ |
Otherwise, the destination is treated as a file. |
64 |
+ |
An existing file of the same name is clobbered, unless the |
65 |
+ |
.I \-r |
66 |
+ |
option is specified, in which case data recovery is attempted. |
67 |
|
If an output specification contains a "%s" format, this will be |
68 |
|
replaced by the modifier name. |
69 |
|
The |
107 |
|
described in the |
108 |
|
.I rcalc(1) |
109 |
|
man page. |
110 |
+ |
Unlike |
111 |
+ |
.I rcalc, |
112 |
+ |
.I rtcontrib |
113 |
+ |
will search the RADIANCE library directories for each file given in a |
114 |
+ |
.I \-f |
115 |
+ |
option. |
116 |
+ |
(No search takes place if a file name begins with a '.', '/' or '~' |
117 |
+ |
character.)\0 |
118 |
|
.PP |
119 |
|
If no |
120 |
|
.I \-o |
121 |
|
specification is given, results are written on the standard output in order |
122 |
|
of modifier (as given on the command line) then bin number. |
123 |
< |
Concatenated data is also sent to a lone output file (i.e., an initial |
123 |
> |
Concatenated data is also sent to a single destination (i.e., an initial |
124 |
|
.I \-o |
125 |
|
specification without formatting strings). |
126 |
|
If a "%s" format appears but no "%d" in the |
197 |
|
.IP "" .2i |
198 |
|
rtcontrib -b tbin -o sky.dat -m skyglow -b 0 -o ground.dat -m groundglow |
199 |
|
@render.opt -f tregenza.cal scene.oct < test.dat |
200 |
+ |
.SH ENVIRONMENT |
201 |
+ |
RAYPATH path to search for -f files |
202 |
|
.SH AUTHOR |
203 |
|
Greg Ward |
204 |
|
.SH "SEE ALSO" |