ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/rfluxmtx.1
(Generate patch)

Comparing ray/doc/man/man1/rfluxmtx.1 (file contents):
Revision 1.2 by greg, Mon Jul 28 18:35:40 2014 UTC vs.
Revision 1.8 by greg, Fri Mar 27 18:58:06 2015 UTC

# Line 11 | Line 11 | rfluxmtx - compute flux transfer matrix(es) for RADIAN
11   ]
12   .B "{ sender.rad | - }"
13   .B receivers.rad
14 < .B "[ scene.rad .. ]"
14 > .B "[ -i system.oct ]"
15 > .B "[ system.rad .. ]"
16   .SH DESCRIPTION
17   .I Rfluxmtx
18   samples rays uniformly over the surface given in
# Line 19 | Line 20 | samples rays uniformly over the surface given in
20   and records rays arriving at surfaces in the file
21   .I receivers.rad,
22   producing a flux transfer matrix per receiver.
23 < Additional scene surfaces are given in optional
24 < .I scene.rad
25 < files, which are compiled with the receivers into an octree sent to the
23 > A system octree to which the receivers will be appended may be given with a
24 > .I \-i
25 > option following the receiver file.
26 > Additional system surfaces may be given in one or more
27 > .I system.rad
28 > files, which are compiled before the receiver file into an octree sent to the
29   .I rcontrib(1)
30   program to do the actual work.
31   If a single hyphen ('-') is given in place of the sender file, then
# Line 68 | Line 72 | option, defaults to 10000 when a sender file is given,
72   .SH VARIABLES
73   The sender and receiver scene files given to
74   .I rfluxmtx
75 < contain controlling parameters in specal comments of the form:
75 > contain controlling parameters in special comments of the form:
76   .nf
77  
78          #@rfluxmtx variable=value ..
# Line 81 | Line 85 | one surface in each file.
85   .BI h =u
86   Set hemisphere sampling to "uniform," meaning a single bin
87   of (cosine-distributed) samples.
88 < In the case of distant "source" primatives, this is the only
88 > In the case of distant "source" primitives, this is the only
89   sampling method that supports arbitrary receiver sizes.
90   The other methods below require a full hemispherical source.
91   .TP
92   .BI h =kf
93   Divide the hemisphere using the LBNL/Klems "full" sampling basis.
94 + (Use "h=-kf" for left-handed coordinates.)
95   .TP
96   .BI h =kh
97   Divide the hemisphere using the LBNL/Klems "half" sampling basis.
98 + (Use "h=-kh" for left-handed coordinates.)
99   .TP
100   .BI h =kq
101   Divide the hemisphere using the LBNL/Klems "quarter" sampling basis.
102 + (Use "h=-kq" for left-handed coordinates.)
103   .TP
104   .BI h =rN
105   Divide the hemisphere using Reinhart's substructuring of the Tregenza
# Line 102 | Line 109 | divisions in each dimension.
109   If it is not given,
110   .I N
111   defaults to 1, which is just the Tregenza sky.
112 + (Use "h=-rN" for left-handed coordinates.)
113   .TP
114   .BI h =scN
115   Subdivide the hemisphere using the Shirley-Chiu square-to-disk mapping with an
116   .I NxN
117   grid over the square.
118 + (Use "h=-scN" for left-handed coordinates.)
119   .TP
120   .BI u =[-]{X|Y|Z|ux,uy,uz}
121   Orient the "up" direction for the hemisphere using the indicated axis or direction
# Line 135 | Line 144 | Other primitives will be silently ignored and will hav
144   In the receiver file, the
145   .I source
146   primitive is supported as well, and multiple receivers (and multiple output
147 < matrices) are identified by different modifier names.
147 > matrices) may be identified by different modifier names.
148 > (Make sure that surfaces using the same modifier are grouped together.)\0
149   Though it may be counter-intuitive, receivers are often light sources,
150   since samples end up there in a backwards ray-tracing system such as RADIANCE.
151   When using local geometry, the overall aperture shape should be close to flat.
152   Large displacements may give rise to errors due to a convex receiver's
153   larger profile at low angles of incidence.
154   .PP
155 < Rays always eminate from the back side of the sender surface and arrive at the
155 > Rays always emanate from the back side of the sender surface and arrive at the
156   front side of receiver surfaces.
157   In this way, a receiver surface may be reused as a sender in a subsequent
158   .I rfluxmtx
# Line 153 | Line 163 | calculation and the resulting matrices will concatenat
163   To generate a flux transfer matrix connecting input and output apertures
164   on a light pipe:
165   .IP "" .3i
166 < rcontrib int_aperture.rad ext_aperture.rad lpipe.rad > lpipe.mtx
166 > rfluxmtx int_aperture.rad ext_aperture.rad lpipe.rad > lpipe.mtx
167   .SH AUTHOR
168   Greg Ward
169   .SH "SEE ALSO"
170 < genBSDF(1), getinfo(1), rcalc(1), rcollate(1), rcontrib(1), rmtxop(1), vwrays(1)
170 > genBSDF(1), getinfo(1), rcalc(1), rcollate(1), rcontrib(1), rmtxop(1),
171 > vwrays(1), wrapBSDF(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines