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.17 by greg, Fri Apr 26 23:10:59 2024 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 19 | Line 29 | gendaymtx - generate an annual Perez sky matrix from a
29   ][
30   .B "-o{f|d}"
31   ][
32 < .B "-O{0|1}"
32 > .B "\-O{0|1}"
33 > ][
34 > .B "\-i intvl"
35   ]
36   [
37   .B "tape.wea"
# Line 40 | Line 52 | parameter setting.
52   .PP
53   Increasing the
54   .I \-m
55 < parameter, typically by factors of two, yields a higher resolution
55 > parameter yields a higher resolution
56   sky using the Reinhart patch subdivision.
57   For example, setting
58   .I "\-m 4"
# Line 51 | Line 63 | Thus, an hourly weather tape for an entire year would
63   yield 8760x3 (26280) values per output line (row).
64   .PP
65   The
66 + .I \-A
67 + option tells
68 + .I gendaymtx
69 + to generate a single column corresponding to an average sky
70 + computed over all the input time steps, rather than one
71 + column per time step.
72 + .PP
73 + The
74   .I \-c
75   option may be used to specify a color for the sky.
76 < The gray value should equal 1 for proper energy balance
76 > The gray value should equal 1 for proper energy balance.
77   The default sky color is
78   .I "\-c 0.960 1.004 1.118".
79   Similarly, the
# Line 63 | Line 83 | The default value is
83   .I "\-g 0.2 0.2 0.2"
84   corresponding to a 20% gray.
85   .PP
86 + If there is a sun in the description,
87 + .I gendaymtx
88 + will include its contribution in the four nearest sky patches,
89 + distributing energy according to centroid proximity.
90   The
91   .I \-d
92 < option may be used to produce a sun-only matrix, with no sky contributions.
92 > option may be used to produce a sun-only matrix, with no sky contributions,
93 > and the ground patch also set to zero.
94   Alternatively, the
95   .I \-s
96 < option may be used to exclude any direct solar component from the output.
96 > option may be used to exclude any direct solar component from the output,
97 > with the other sky and ground patches unaffected.
98   .PP
99 + The
100 + .I \-u
101 + option ignores input times when the sun is below the horizon.
102 + This is a convenient way to average daylight hours only with the
103 + .I \-A
104 + option or to ensure that matrix entries correspond to solar positions
105 + produced with the
106 + .I \-D
107 + option, described below.
108 + .PP
109 + The
110 + .I \-n
111 + option may be used if no matrix output is desired at all.
112 + This may be used to merely check the input, or in combination with the
113 + .I \-D
114 + option, below.
115 + .PP
116 + The
117 + .I \-D
118 + option may be used to specify an output file to contain a list of
119 + solar positions and intensities corresponding to time steps in the
120 + weather tape where the sun has any portion above the horizon.
121 + Sun radiance values may be zero if the direct amount is zero on the input.
122 + Sun modifiers and names will be indexed by the minute, numbered from
123 + midnight, January 1st.
124 + If a hyphen ('-') is given as the argument to
125 + .I \-D,
126 + then the sun descriptions  will be directed to the standard output.
127 + This implies the
128 + .I \-n
129 + option just described.
130 + If the
131 + .I \-M
132 + option is given as well, it will be used to record the modifier
133 + names used in the
134 + .I \-D
135 + output, for convenient input to
136 + .I rcontrib(1)
137 + and
138 + .I rfluxmtx(1).
139 + .PP
140   By default,
141   .I gendaymtx
142   assumes the positive Y-axis points north such that the first sky patch
# Line 90 | Line 157 | through
157   using a similar transform.
158   .PP
159   The
160 + .I \-i
161 + option specifies the actual capture interval in minutes of the original
162 + weather data.
163 + Please see the man page for
164 + .I gendaylit
165 + to understand this correction, which is applied only near sunrise and
166 + sunset.
167 + .PP
168 + The
169   .I \-of
170   or
171   .I \-od
# Line 101 | Line 177 | The
177   .I \-O1
178   option specifies that output should be total solar radiance rather
179   than visible radiance.
180 + The
181 + .I \-h
182 + option prevents the output of the usual header information.
183   Finally, the
184   .I \-v
185   option will enable verbose reporting, which is mostly useful for
# Line 122 | Line 201 | Ian Ashdown wrote most of the code,
201   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
202   Greg Ward wrote the final parameter parsing and weather tape conversion.
203   .SH "SEE ALSO"
204 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
205 < xform(1)
204 > dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1),
205 > rcollate(1), rcontrib(1), rfluxmtx(1), xform(1)

Diff Legend

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