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.6 by greg, Mon Sep 19 15:27:19 2005 UTC vs.
Revision 1.7 by rschregle, Mon May 30 12:21:56 2016 UTC

# Line 30 | Line 30 | for specific machines and users:
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%).
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