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.11 by greg, Tue Jan 7 01:42:30 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 "\-D sunfile"
17 + ][
18   .B "\-r deg"
19   ][
20   .B "\-m N"
# Line 40 | Line 46 | parameter setting.
46   .PP
47   Increasing the
48   .I \-m
49 < parameter, typically by factors of two, yields a higher resolution
49 > parameter yields a higher resolution
50   sky using the Reinhart patch subdivision.
51   For example, setting
52   .I "\-m 4"
# Line 51 | Line 57 | Thus, an hourly weather tape for an entire year would
57   yield 8760x3 (26280) values per output line (row).
58   .PP
59   The
60 + .I \-A
61 + option tells
62 + .I gendaymtx
63 + to generate a single column corresponding to an average sky
64 + computed over all the input time steps, rather than one
65 + column per time step.
66 + .PP
67 + The
68   .I \-c
69   option may be used to specify a color for the sky.
70 < The gray value should equal 1 for proper energy balance
70 > The gray value should equal 1 for proper energy balance.
71   The default sky color is
72   .I "\-c 0.960 1.004 1.118".
73   Similarly, the
# Line 65 | Line 79 | corresponding to a 20% gray.
79   .PP
80   The
81   .I \-d
82 < option may be used to produce a sun-only matrix, with no sky contributions.
82 > option may be used to produce a sun-only matrix, with no sky contributions,
83 > and the ground patch also set to zero.
84   Alternatively, the
85   .I \-s
86 < option may be used to exclude any direct solar component from the output.
86 > option may be used to exclude any direct solar component from the output,
87 > with the rest of the sky and ground patch unaffected.
88 > If there is a sun in the description,
89 > .I gendaymtx
90 > will include its contribution in the four nearest sky patches,
91 > distributing energy according to centroid proximity.
92   .PP
93 + The
94 + .I \-n
95 + option may be used if no matrix output is desired.
96 + This may be used to merely check the input, or in combination with the
97 + .I \-D
98 + option, below.
99 + .PP
100 + The
101 + .I \-D
102 + option may be used to specify an output file to contain a list of
103 + solar positions and intensities corresponding to time steps in the
104 + weather tape where the sun is visible above the horizion.
105 + .PP
106   By default,
107   .I gendaymtx
108   assumes the positive Y-axis points north such that the first sky patch
# Line 101 | Line 134 | The
134   .I \-O1
135   option specifies that output should be total solar radiance rather
136   than visible radiance.
137 + The
138 + .I \-h
139 + option prevents the output of the usual header information.
140   Finally, the
141   .I \-v
142   option will enable verbose reporting, which is mostly useful for
# Line 122 | Line 158 | Ian Ashdown wrote most of the code,
158   based on Jean-Jacques Delaunay's original gendaylit(1) implementation.
159   Greg Ward wrote the final parameter parsing and weather tape conversion.
160   .SH "SEE ALSO"
161 < dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1),
162 < xform(1)
161 > dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1),
162 > rcollate(1), rcontrib(1), xform(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines