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.3 by greg, Tue Feb 5 19:31:40 2013 UTC vs.
Revision 1.19 by greg, Wed Feb 26 20:39:28 2025 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 18 | Line 28 | gendaymtx - generate an annual Perez sky matrix from a
28   .B "\-c r g b"
29   ][
30   .B "-o{f|d}"
31 + ][
32 + .B "\-O{0|1}"
33 + ][
34 + .B "\-i intvl"
35   ]
36   [
37   .B "tape.wea"
38 + or
39 + .B "tape.epw"
40   ]
41   .SH DESCRIPTION
42   .I Gendaymtx
43   takes a weather tape as input and produces a matrix of sky patch
44   values using the Perez all-weather model.
45 < The weather tape is assumed to be in the simple ASCII format understood
45 > The weather tape may be in the simple ASCII format understood
46   by DAYSIM, which contains a short header with the site parameters followed
47   by the month, day, standard time, direct normal and diffuse horizontal
48   irradiance values, one time step per line.
49 + Alternatively, a standard EPW (Energy Plus Weather) input may be provided,
50 + in which case additional information such as the dew point temperature may
51 + be used in the calculation.
52   Each time step line is used to compute a column in the output matrix,
53   where rows correspond to sky patch positions, starting with 0 for
54   the ground and continuing to 145 for the zenith using the default
# Line 38 | Line 57 | parameter setting.
57   .PP
58   Increasing the
59   .I \-m
60 < parameter, typically by factors of two, yields a higher resolution
60 > parameter yields a higher resolution
61   sky using the Reinhart patch subdivision.
62   For example, setting
63   .I "\-m 4"
# Line 49 | Line 68 | Thus, an hourly weather tape for an entire year would
68   yield 8760x3 (26280) values per output line (row).
69   .PP
70   The
71 + .I \-A
72 + option tells
73 + .I gendaymtx
74 + to generate a single column corresponding to an average sky
75 + computed over all the input time steps, rather than one
76 + column per time step.
77 + .PP
78 + The
79   .I \-c
80   option may be used to specify a color for the sky.
81 < The gray value should equal 1 for proper energy balance
81 > The gray value should equal 1 for proper energy balance.
82   The default sky color is
83   .I "\-c 0.960 1.004 1.118".
84   Similarly, the
# Line 61 | Line 88 | The default value is
88   .I "\-g 0.2 0.2 0.2"
89   corresponding to a 20% gray.
90   .PP
91 + If there is a sun in the description,
92 + .I gendaymtx
93 + will include its contribution in the four nearest sky patches,
94 + distributing energy according to centroid proximity.
95   The
96   .I \-d
97 < option may be used to produce a sun-only matrix, with no sky contributions.
97 > option may be used to produce a sun-only matrix, with no sky contributions,
98 > and the ground patch also set to zero.
99   Alternatively, the
100   .I \-s
101 < option may be used to exclude any direct solar component from the output.
101 > option may be used to exclude any direct solar component from the output,
102 > with the other sky and ground patches unaffected.
103   .PP
104 + The
105 + .I \-u
106 + option ignores input times when the sun is below the horizon.
107 + This is a convenient way to average daylight hours only with the
108 + .I \-A
109 + option or to ensure that matrix entries correspond to solar positions
110 + produced with the
111 + .I \-D
112 + option, described below.
113 + .PP
114 + The
115 + .I \-n
116 + option may be used if no matrix output is desired at all.
117 + This may be used to merely check the input, or in combination with the
118 + .I \-D
119 + option, below.
120 + .PP
121 + The
122 + .I \-D
123 + option may be used to specify an output file to contain a list of
124 + solar positions and intensities corresponding to time steps in the
125 + weather tape where the sun has any portion above the horizon.
126 + Sun radiance values may be zero if the direct amount is zero on the input.
127 + Sun modifiers and names will be indexed by the minute, numbered from
128 + midnight, January 1st.
129 + If a hyphen ('-') is given as the argument to
130 + .I \-D,
131 + then the sun descriptions  will be directed to the standard output.
132 + This implies the
133 + .I \-n
134 + option just described.
135 + If the
136 + .I \-M
137 + option is given as well, it will be used to record the modifier
138 + names used in the
139 + .I \-D
140 + output, for convenient input to
141 + .I rcontrib(1)
142 + and
143 + .I rfluxmtx(1).
144 + .PP
145   By default,
146   .I gendaymtx
147   assumes the positive Y-axis points north such that the first sky patch
# Line 88 | Line 162 | through
162   using a similar transform.
163   .PP
164   The
165 + .I \-i
166 + option specifies the actual capture interval in minutes of the original
167 + weather data.
168 + Please see the man page for
169 + .I gendaylit
170 + to understand this correction, which is applied only near sunrise and
171 + sunset.
172 + .PP
173 + The
174   .I \-of
175   or
176   .I \-od
# Line 95 | Line 178 | option may be used to specify binary float or double o
178   This is much faster to write and to read, and is therefore preferred on
179   systems that support it.
180   (MS Windows is not one of them.)\0
181 + The
182 + .I \-O1
183 + option specifies that output should be total solar radiance rather
184 + than visible radiance.
185 + The
186 + .I \-h
187 + option prevents the output of the usual header information.
188   Finally, the
189   .I \-v
190   option will enable verbose reporting, which is mostly useful for
# Line 116 | Line 206 | Ian Ashdown wrote most of the code,
206   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
207   Greg Ward wrote the final parameter parsing and weather tape conversion.
208   .SH "SEE ALSO"
209 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
210 < xform(1)
209 > dctimestep(1), genBSDF(1), gendaylit(1), gensdaymtx(1), gensky(1),
210 > genskyvec(1), genssky(1),
211 > rcollate(1), rcontrib(1), rfluxmtx(1), rmtxop(1), xform(1)

Diff Legend

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