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.1 by greg, Sun Jan 20 02:07:16 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"
21   ][
22   .B "\-g r g b"
# Line 16 | Line 24 | gendaymtx - generate an annual Perez sky matrix from a
24   .B "\-c r g b"
25   ][
26   .B "-o{f|d}"
27 + ][
28 + .B "-O{0|1}"
29   ]
30   [
31   .B "tape.wea"
# Line 36 | 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 47 | 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 61 | 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
109 + is in the Y-axis direction on the horizon, the second patch is just
110 + west of that, and so on spiraling around to the final patch near the zenith.
111 + The
112 + .I \-r
113 + (or
114 + .I \-rz)
115 + option rotates the sky the specified number of degrees counter-clockwise
116 + about the zenith, i.e., west of north.
117 + This is in keeping with the effect of passing the output of
118 + .I gensky(1)
119 + or
120 + .I gendaylit(1)
121 + through
122 + .I xform(1)
123 + using a similar transform.
124 + .PP
125 + The
126   .I \-of
127   or
128   .I \-od
# Line 74 | Line 130 | option may be used to specify binary float or double o
130   This is much faster to write and to read, and is therefore preferred on
131   systems that support it.
132   (MS Windows is not one of them.)\0
133 + 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 95 | 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), genskyvec(1), rcontrib(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