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.4 by greg, Tue Apr 30 17:05:27 2013 UTC vs.
Revision 1.14 by greg, Fri Sep 11 16:53:57 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 "\-u"
17 + ][
18 + .B "\-D sunfile"
19 + [
20 + .B "\-M sunmods"
21 + ]][
22   .B "\-r deg"
23   ][
24   .B "\-m N"
# Line 40 | Line 50 | parameter setting.
50   .PP
51   Increasing the
52   .I \-m
53 < parameter, typically by factors of two, yields a higher resolution
53 > parameter yields a higher resolution
54   sky using the Reinhart patch subdivision.
55   For example, setting
56   .I "\-m 4"
# Line 51 | Line 61 | Thus, an hourly weather tape for an entire year would
61   yield 8760x3 (26280) values per output line (row).
62   .PP
63   The
64 + .I \-A
65 + option tells
66 + .I gendaymtx
67 + to generate a single column corresponding to an average sky
68 + computed over all the input time steps, rather than one
69 + column per time step.
70 + .PP
71 + The
72   .I \-c
73   option may be used to specify a color for the sky.
74 < The gray value should equal 1 for proper energy balance
74 > The gray value should equal 1 for proper energy balance.
75   The default sky color is
76   .I "\-c 0.960 1.004 1.118".
77   Similarly, the
# Line 65 | Line 83 | corresponding to a 20% gray.
83   .PP
84   The
85   .I \-d
86 < option may be used to produce a sun-only matrix, with no sky contributions.
86 > option may be used to produce a sun-only matrix, with no sky contributions,
87 > and the ground patch also set to zero.
88   Alternatively, the
89   .I \-s
90 < option may be used to exclude any direct solar component from the output.
90 > option may be used to exclude any direct solar component from the output,
91 > with the rest of the sky and ground patch unaffected.
92 > If there is a sun in the description,
93 > .I gendaymtx
94 > will include its contribution in the four nearest sky patches,
95 > distributing energy according to centroid proximity.
96   .PP
97 + The
98 + .I \-u
99 + option ignores input times when the sun is below the horizon.
100 + This is a convenient way to average daylight hours only with the
101 + .I \-A
102 + option or to ensure that matrix entries correspond to solar positions
103 + produced with the
104 + .I \-D
105 + option, described below.
106 + .PP
107 + The
108 + .I \-n
109 + option may be used if no matrix output is desired at all.
110 + This may be used to merely check the input, or in combination with the
111 + .I \-D
112 + option, below.
113 + .PP
114 + The
115 + .I \-D
116 + option may be used to specify an output file to contain a list of
117 + solar positions and intensities corresponding to time steps in the
118 + weather tape where the sun has any portion above the horizion.
119 + Sun radiance values may be zero if the direct amount is zero on the input.
120 + Sun modifiers and names will be indexed by the minute, numbered from
121 + midnight, January 1st.
122 + If a hyphen ('-') is given as the argument to
123 + .I \-D,
124 + then the sun descriptions  will be directed to the standard output.
125 + This implies the
126 + .I \-n
127 + option just described.
128 + If the
129 + .I \-M
130 + option is given as well, it will be used to record the modifier
131 + names used in the
132 + .I \-D
133 + output, for convenient input to
134 + .I rcontrib(1)
135 + and
136 + .I rfluxmtx(1).
137 + .PP
138   By default,
139   .I gendaymtx
140   assumes the positive Y-axis points north such that the first sky patch
# Line 101 | Line 166 | The
166   .I \-O1
167   option specifies that output should be total solar radiance rather
168   than visible radiance.
169 + The
170 + .I \-h
171 + option prevents the output of the usual header information.
172   Finally, the
173   .I \-v
174   option will enable verbose reporting, which is mostly useful for
# Line 122 | Line 190 | Ian Ashdown wrote most of the code,
190   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
191   Greg Ward wrote the final parameter parsing and weather tape conversion.
192   .SH "SEE ALSO"
193 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
194 < xform(1)
193 > dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1),
194 > rcollate(1), rcontrib(1), rfluxmtx(1), xform(1)

Diff Legend

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