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

Comparing ray/doc/man/man1/gendaymtx.1 (file contents):
Revision 1.2 by greg, Tue Feb 5 06:00:19 2013 UTC vs.
Revision 1.13 by greg, Sat Aug 15 03:28:56 2020 UTC

# Line 7 | Line 7 | gendaymtx - generate an annual Perez sky matrix from a
7   [
8   .B "\-v"
9   ][
10 < .B "\-d|\-s"
10 > .B "\-h"
11   ][
12 + .B "\-A"
13 + ][
14 + .B "\-d|\-s|\-n"
15 + ][
16 + .B "\-D sunfile"
17 + [
18 + .B "\-M sunmods"
19 + ]][
20   .B "\-r deg"
21   ][
22   .B "\-m N"
# Line 18 | Line 26 | gendaymtx - generate an annual Perez sky matrix from a
26   .B "\-c r g b"
27   ][
28   .B "-o{f|d}"
29 + ][
30 + .B "-O{0|1}"
31   ]
32   [
33   .B "tape.wea"
# Line 38 | Line 48 | parameter setting.
48   .PP
49   Increasing the
50   .I \-m
51 < parameter, typically by factors of two, yields a higher resolution
51 > parameter yields a higher resolution
52   sky using the Reinhart patch subdivision.
53   For example, setting
54   .I "\-m 4"
# Line 49 | Line 59 | Thus, an hourly weather tape for an entire year would
59   yield 8760x3 (26280) values per output line (row).
60   .PP
61   The
62 + .I \-A
63 + option tells
64 + .I gendaymtx
65 + to generate a single column corresponding to an average sky
66 + computed over all the input time steps, rather than one
67 + column per time step.
68 + .PP
69 + The
70   .I \-c
71   option may be used to specify a color for the sky.
72 < The gray value should equal 1 for proper energy balance
72 > The gray value should equal 1 for proper energy balance.
73   The default sky color is
74   .I "\-c 0.960 1.004 1.118".
75   Similarly, the
# Line 63 | Line 81 | corresponding to a 20% gray.
81   .PP
82   The
83   .I \-d
84 < option may be used to produce a sun-only matrix, with no sky contributions.
84 > option may be used to produce a sun-only matrix, with no sky contributions,
85 > and the ground patch also set to zero.
86   Alternatively, the
87   .I \-s
88 < option may be used to exclude any direct solar component from the output.
88 > option may be used to exclude any direct solar component from the output,
89 > with the rest of the sky and ground patch unaffected.
90 > If there is a sun in the description,
91 > .I gendaymtx
92 > will include its contribution in the four nearest sky patches,
93 > distributing energy according to centroid proximity.
94   .PP
95   The
96 + .I \-u
97 + option ignores input times when the sun is below the horizon.
98 + This is a convenient way to average daylight hours only with the
99 + .I \-A
100 + option or to ensure that matrix entries correspond to solar positions
101 + produced with the
102 + .I \-D
103 + option, described below.
104 + .PP
105 + The
106 + .I \-n
107 + option may be used if no matrix output is desired at all.
108 + This may be used to merely check the input, or in combination with the
109 + .I \-D
110 + option, below.
111 + .PP
112 + The
113 + .I \-D
114 + option may be used to specify an output file to contain a list of
115 + solar positions and intensities corresponding to time steps in the
116 + weather tape where the sun has any portion above the horizion.
117 + Sun radiance values may be zero if the direct amount is zero on the input.
118 + Sun modifiers and names will be indexed by the minute, numbered from
119 + midnight, January 1st.
120 + If a hyphen ('-') is given as the argument to
121 + .I \-D,
122 + then the sun descriptions  will be directed to the standard output.
123 + This implies the
124 + .I \-n
125 + option just described.
126 + If the
127 + .I \-M
128 + option is given as well, it will be used to record the modifier
129 + names used in the
130 + .I \-D
131 + output, for convenient input to
132 + .I rcontrib(1)
133 + and
134 + .I rfluxmtx(1).
135 + .PP
136 + By default,
137 + .I gendaymtx
138 + assumes the positive Y-axis points north such that the first sky patch
139 + is in the Y-axis direction on the horizon, the second patch is just
140 + west of that, and so on spiraling around to the final patch near the zenith.
141 + The
142   .I \-r
143   (or
144   .I \-rz)
145   option rotates the sky the specified number of degrees counter-clockwise
146 < about the zenith, i.e., east of South.
146 > about the zenith, i.e., west of north.
147   This is in keeping with the effect of passing the output of
148   .I gensky(1)
149   or
# Line 90 | Line 160 | option may be used to specify binary float or double o
160   This is much faster to write and to read, and is therefore preferred on
161   systems that support it.
162   (MS Windows is not one of them.)\0
163 + The
164 + .I \-O1
165 + option specifies that output should be total solar radiance rather
166 + than visible radiance.
167 + The
168 + .I \-h
169 + option prevents the output of the usual header information.
170   Finally, the
171   .I \-v
172   option will enable verbose reporting, which is mostly useful for
# Line 111 | Line 188 | Ian Ashdown wrote most of the code,
188   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
189   Greg Ward wrote the final parameter parsing and weather tape conversion.
190   .SH "SEE ALSO"
191 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
192 < xform(1)
191 > dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1),
192 > rcollate(1), rcontrib(1), rfluxmtx(1), xform(1)

Diff Legend

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