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.10 by greg, Tue Jun 25 00:09:45 2019 UTC

# Line 7 | Line 7 | gendaymtx - generate an annual Perez sky matrix from a
7   [
8   .B "\-v"
9   ][
10 + .B "\-h"
11 + ][
12 + .B "\-A"
13 + ][
14   .B "\-d|\-s"
15   ][
16   .B "\-r deg"
# Line 18 | Line 22 | gendaymtx - generate an annual Perez sky matrix from a
22   .B "\-c r g b"
23   ][
24   .B "-o{f|d}"
25 + ][
26 + .B "-O{0|1}"
27   ]
28   [
29   .B "tape.wea"
# Line 49 | Line 55 | Thus, an hourly weather tape for an entire year would
55   yield 8760x3 (26280) values per output line (row).
56   .PP
57   The
58 + .I \-A
59 + option tells
60 + .I gendaymtx
61 + to generate a single column corresponding to an average sky
62 + computed over all the input time steps, rather than one
63 + column per time step.
64 + .PP
65 + The
66   .I \-c
67   option may be used to specify a color for the sky.
68 < The gray value should equal 1 for proper energy balance
68 > The gray value should equal 1 for proper energy balance.
69   The default sky color is
70   .I "\-c 0.960 1.004 1.118".
71   Similarly, the
# Line 63 | Line 77 | corresponding to a 20% gray.
77   .PP
78   The
79   .I \-d
80 < option may be used to produce a sun-only matrix, with no sky contributions.
80 > option may be used to produce a sun-only matrix, with no sky contributions,
81 > and the ground patch also set to zero.
82   Alternatively, the
83   .I \-s
84 < option may be used to exclude any direct solar component from the output.
84 > option may be used to exclude any direct solar component from the output,
85 > with the rest of the sky and ground patch unaffected.
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   .PP
91 + By default,
92 + .I gendaymtx
93 + assumes the positive Y-axis points north such that the first sky patch
94 + is in the Y-axis direction on the horizon, the second patch is just
95 + west of that, and so on spiraling around to the final patch near the zenith.
96   The
97   .I \-r
98   (or
99   .I \-rz)
100   option rotates the sky the specified number of degrees counter-clockwise
101 < about the zenith, i.e., east of South.
101 > about the zenith, i.e., west of north.
102   This is in keeping with the effect of passing the output of
103   .I gensky(1)
104   or
# Line 90 | Line 115 | option may be used to specify binary float or double o
115   This is much faster to write and to read, and is therefore preferred on
116   systems that support it.
117   (MS Windows is not one of them.)\0
118 + The
119 + .I \-O1
120 + option specifies that output should be total solar radiance rather
121 + than visible radiance.
122 + The
123 + .I \-h
124 + option prevents the output of the usual header information.
125   Finally, the
126   .I \-v
127   option will enable verbose reporting, which is mostly useful for
# Line 111 | Line 143 | Ian Ashdown wrote most of the code,
143   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
144   Greg Ward wrote the final parameter parsing and weather tape conversion.
145   .SH "SEE ALSO"
146 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
147 < xform(1)
146 > dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1),
147 > rcollate(1), rcontrib(1), xform(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines