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.14 by greg, Fri Sep 11 16:53:57 2020 UTC vs.
Revision 1.19 by greg, Wed Feb 26 20:39:28 2025 UTC

# Line 29 | 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"
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 81 | 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,
# Line 88 | Line 99 | 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,
102 < 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.
102 > with the other sky and ground patches unaffected.
103   .PP
104   The
105   .I \-u
# Line 115 | Line 122 | 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 horizion.
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.
# Line 155 | 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 190 | 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),
210 < rcollate(1), rcontrib(1), rfluxmtx(1), 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