| 6 |
|
.B rxfluxmtx |
| 7 |
|
[ |
| 8 |
|
.B \-W |
| 9 |
+ |
][ |
| 10 |
+ |
.B "-bj frac" |
| 11 |
|
] [ |
| 12 |
|
.B "rcontrib options" |
| 13 |
|
] |
| 64 |
|
.I \-t |
| 65 |
|
option sets the number of seconds between progress reports, similar to |
| 66 |
|
.I rcontrib(1). |
| 67 |
+ |
Likewise, the |
| 68 |
+ |
.I \-c |
| 69 |
+ |
option specifies the number of times to repeat each sample. |
| 70 |
|
However, the |
| 71 |
|
.I rcontrib |
| 72 |
|
options |
| 80 |
|
.I rxfluxmtx |
| 81 |
|
and may not be set by the user. |
| 82 |
|
.PP |
| 83 |
+ |
The |
| 84 |
+ |
.I \-bj |
| 85 |
+ |
option sets the amount of bin jittering, which blurs the boundaries of |
| 86 |
+ |
receiver bins and is generally recommended when creating a view that may |
| 87 |
+ |
include direct visibility of the receiver surface(s). |
| 88 |
+ |
It is best used in combination with the |
| 89 |
+ |
.I \-c |
| 90 |
+ |
and |
| 91 |
+ |
.I \-pj |
| 92 |
+ |
options described above. |
| 93 |
+ |
(The default jitter is 0, leaving sharp bin boundaries.)\0 |
| 94 |
+ |
.PP |
| 95 |
|
The sample count, unless set by the |
| 96 |
|
.I \-c |
| 97 |
|
option, defaults to 10000 when a sender file is given, or to 1 for |
| 157 |
|
vector. |
| 158 |
|
.TP |
| 159 |
|
.BI o =output_spec |
| 160 |
< |
Send the matrix data for this receiver to the indicated file or command. |
| 161 |
< |
Single or double quotes may be used to contain strings with spaces. |
| 160 |
> |
Send the matrix data for this receiver to the indicated file specification. |
| 161 |
> |
Single or double quotes may be used to contain strings with spaces, and |
| 162 |
> |
the usual "%s" and "%d" formats incorporate the modifier name and/or |
| 163 |
> |
bin number, as with |
| 164 |
> |
.I rcontrib. |
| 165 |
|
Command (piped) output is not supported. |
| 166 |
< |
The file format will be determined by the command-line |
| 166 |
> |
.PP |
| 167 |
> |
If no output_spec directive is given, it must be specified by a |
| 168 |
> |
.I \-o |
| 169 |
> |
setting on the command-line, since output to stdout is not supported. |
| 170 |
> |
The input and output file formats are controlled by the |
| 171 |
|
.I \-fio |
| 172 |
< |
option, which may use a single letter for identical input and output formats. |
| 173 |
< |
The input file specification matters only in pass-through mode, for which |
| 172 |
> |
option, which may use a single letter for identical i/o formats. |
| 173 |
> |
The input format matters only in pass-through mode, for which |
| 174 |
|
ASCII input is supported. |
| 175 |
+ |
The default setting is |
| 176 |
+ |
.I \-faf. |
| 177 |
|
ASCII output is unsupported, since it interferes with |
| 178 |
< |
efficient recovery in the |
| 178 |
> |
efficient recovery when using the |
| 179 |
|
.I \-r |
| 180 |
< |
mode. |
| 180 |
> |
option. |
| 181 |
|
.PP |
| 182 |
|
In normal execution, only a single sender surface is sampled, but it may be |
| 183 |
|
comprised of any number of subsurfaces, as in a triangle mesh or similar. |
| 214 |
|
To generate a flux transfer matrix connecting input and output apertures |
| 215 |
|
on a light pipe: |
| 216 |
|
.IP "" .2i |
| 217 |
< |
rxfluxmtx int_aperture.rad ext_aperture.rad lpipe.rad > lpipe.mtx |
| 217 |
> |
rxfluxmtx -o lpipe.mtx int_aperture.rad ext_aperture.rad lpipe.rad |
| 218 |
|
.PP |
| 219 |
< |
To generate a set of DC view component pictures with 9 samples/pixel: |
| 219 |
> |
To generate a set of DC view component pictures with 9 jittered samples/pixel: |
| 220 |
|
.IP "" .2i |
| 221 |
< |
rxfluxmtx -vf v1.vf -x 512 -y 512 -c 9 -fc reinhart_M4.rad -i scene1.oct |
| 221 |
> |
rxfluxmtx -vf v1.vf -x 512 -y 512 -c 9 -pj .8 -fc reinhart_M4.rad -i scene1.oct |
| 222 |
|
.PP |
| 223 |
|
To compute a workplane irradiance matrix for each window in a space: |
| 224 |
|
.IP "" .2i |
| 235 |
|
control over i/o. |
| 236 |
|
This allows an unlimited number of receivers, a |
| 237 |
|
.I \-r |
| 238 |
< |
recovery option, and simplifies internal operations. |
| 238 |
> |
recovery option, and streamlines operations. |
| 239 |
|
.SH AUTHOR |
| 240 |
|
Greg Ward |
| 241 |
|
.SH "SEE ALSO" |
