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.4 by greg, Mon Jun 13 20:07:56 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 -DSPEED=(MIPS)  Millions of instructions per second for this
9                processor (approximate).  This is used to decide
10                certain unimportant timing issues such as how many
11                rays to trace before checking input in rvu and
12                whether or not to optimize the color table in ximage
13                on 8-bit displays.
14
8   -DWFLUSH=(rays) Override for number of rays before flush in rvu.
9  
10 < -DBSD           Operating system has a strong Berkeley flavor, meaning
11 <                that bcopy() and bzero() are present but maybe memcpy()
12 <                and memset() are not.  (See common/standard.h for other
20 <                things this flag affects.)  Also affects certain system
21 <                calls, such as signal handling and resource tracking.
10 > -DBSD           Operating system has a strong Berkeley flavor, which
11 >                affects certain system calls, such as signal handling and
12 >                resource tracking.
13  
14   -DSMLMEM        The system has little RAM available, so size hash
15                  tables and the like accordingly.  Only allows for
# Line 38 | 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