ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/notes/compile_switches
(Generate patch)

Comparing ray/doc/notes/compile_switches (file contents):
Revision 1.5 by schorsch, Mon Sep 19 11:35:38 2005 UTC vs.
Revision 1.7 by rschregle, Mon May 30 12:21:56 2016 UTC

# Line 1 | Line 1
1   Here is a list of compile switches, used to customize Radiance code
2   for specific machines and users:
3  
4 < -DALIGN=(type)  Alignment type, machine-dependent.  Most RISC
4 > -DALIGNT=(type) Alignment type, machine-dependent.  Most RISC
5                  architectures align on 8-word boundaries (double).
6                  The default alignment type is int.
7  
8   -DWFLUSH=(rays) Override for number of rays before flush in rvu.
9  
10 < -DBSD   Operating system has a strong Berkeley flavor, which
10 > -DBSD           Operating system has a strong Berkeley flavor, which
11                  affects certain system calls, such as signal handling and
12                  resource tracking.
13  
# Line 29 | Line 29 | for specific machines and users:
29   -DAVGREFL=R     Set the average surface reflectance for the purpose
30                  of indirect irradiance calculations to R, where
31                  R is a real number in the range (0,1.0).  The
32 <                default value is 0.50 (50%).  This value indirectly
33 <                controls the maximum number of ambient bounces,
34 <                which can never be more than the log of the -ad
35 <                setting times the log of AVGREFL.
32 >                default value is 0.50 (50%).
33 >
34 > -DPMAP_OOC      Builds the out-of-core photon map. The photon data resides
35 >                in a leaf file on disk with suffix ".leaf" and is loaded on
36 >                demand. This is intended for very large photon maps (up to
37 >                4.3 billion photons) particularly for annual simulations
38 >                with rcontrib. This switch is disabled by default, which
39 >                builds the in-core photon map used in previous releases;
40 >                this resides entirely in main memory. These options are
41 >                mutually exclusive, and the resulting photon map files are
42 >                incompatible.
43 >                
44 > -DPMAP_PRIMARYPOS      
45 >                Stores photon primary hitpoints for binning using the -f
46 >                option with rcontrib if the function file requires them.
47 >                This consumes an additional 3 floats and is disabled per
48 >                default to reduce the size of the resulting photon maps.
49 >                
50 > -DPMAP_FLOAT_FLUX
51 >                Stores photon flux as floats instead of more compact RGBE
52 >                (the default). In terms of accuracy, the difference would
53 >                only be noticeable with highly saturated colours.
54 >                
55 > -DPMAP_ROI      Enables the -api option to mkpmap. This constrains photon
56 >                deposition only to the specified region of interest (defined
57 >                as a bounding volume) for situations where it is known a
58 >                priori that photon map lookups will occur outside this
59 >                region. This is disabled per default as it can lead to
60 >                biased results outside the ROI, or near its boundaries. Ziss
61 >                option for ze eckspertz only!
62 >
63 > -DPMAP_RUNAWAY_WARN
64 >                Causes mkpmap to issue a warning if a photon reaches the
65 >                maximum number of bounces (as specified with -apm) and is
66 >                terminated.
67 >                                
68 > -DPMAP_LOOKUP_WARN
69 >                Causes rtrace et al to issue warnings when short photon
70 >                lookups occur, i.e.  fewer photons are found than specified
71 >                as lookup bandwidth with -ap.  This is generally not fatal,
72 >                but can increase noise, and may indicate a higher bandwidth
73 >                is needed. This is disabled per default as it can result in
74 >                excessive console clutter.
75 >
76 > -DPMAP_LOOKUP_REDO
77 >                Causes rtrace et al to repeat short photon map
78 >                lookups with a progressively larger radius until the
79 >                target photon count specified with -ap is met. This switch
80 >                has no effect in conjunction with the -am option, since this
81 >                disables lookup radius adaptation.
82 >
83 > -DPMAP_EPANECHNIKOV
84 >                Causes rtrace et al to apply an Epanechnikov filter during
85 >                photon density estimates. This weights photons according to
86 >                the inverse distance to the lookup point in order to reduce
87 >                bias. The default behaviour does not perform filtering.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines