--- ray/doc/man/man1/gendaymtx.1 2013/02/05 19:31:40 1.3 +++ ray/doc/man/man1/gendaymtx.1 2024/08/05 17:23:56 1.18 @@ -1,4 +1,4 @@ -.\" RCSid $Id: gendaymtx.1,v 1.3 2013/02/05 19:31:40 greg Exp $ +.\" RCSid $Id: gendaymtx.1,v 1.18 2024/08/05 17:23:56 greg Exp $ .TH GENDAYMTX 1 01/19/13 RADIANCE .SH NAME gendaymtx - generate an annual Perez sky matrix from a weather tape @@ -7,8 +7,18 @@ gendaymtx - generate an annual Perez sky matrix from a [ .B "\-v" ][ -.B "\-d|\-s" +.B "\-h" ][ +.B "\-A" +][ +.B "\-d|\-s|\-n" +][ +.B "\-u" +][ +.B "\-D sunfile" +[ +.B "\-M sunmods" +]][ .B "\-r deg" ][ .B "\-m N" @@ -18,6 +28,10 @@ gendaymtx - generate an annual Perez sky matrix from a .B "\-c r g b" ][ .B "-o{f|d}" +][ +.B "\-O{0|1}" +][ +.B "\-i intvl" ] [ .B "tape.wea" @@ -38,7 +52,7 @@ parameter setting. .PP Increasing the .I \-m -parameter, typically by factors of two, yields a higher resolution +parameter yields a higher resolution sky using the Reinhart patch subdivision. For example, setting .I "\-m 4" @@ -49,9 +63,17 @@ Thus, an hourly weather tape for an entire year would yield 8760x3 (26280) values per output line (row). .PP The +.I \-A +option tells +.I gendaymtx +to generate a single column corresponding to an average sky +computed over all the input time steps, rather than one +column per time step. +.PP +The .I \-c option may be used to specify a color for the sky. -The gray value should equal 1 for proper energy balance +The gray value should equal 1 for proper energy balance. The default sky color is .I "\-c 0.960 1.004 1.118". Similarly, the @@ -61,13 +83,60 @@ The default value is .I "\-g 0.2 0.2 0.2" corresponding to a 20% gray. .PP +If there is a sun in the description, +.I gendaymtx +will include its contribution in the four nearest sky patches, +distributing energy according to centroid proximity. The .I \-d -option may be used to produce a sun-only matrix, with no sky contributions. +option may be used to produce a sun-only matrix, with no sky contributions, +and the ground patch also set to zero. Alternatively, the .I \-s -option may be used to exclude any direct solar component from the output. +option may be used to exclude any direct solar component from the output, +with the other sky and ground patches unaffected. .PP +The +.I \-u +option ignores input times when the sun is below the horizon. +This is a convenient way to average daylight hours only with the +.I \-A +option or to ensure that matrix entries correspond to solar positions +produced with the +.I \-D +option, described below. +.PP +The +.I \-n +option may be used if no matrix output is desired at all. +This may be used to merely check the input, or in combination with the +.I \-D +option, below. +.PP +The +.I \-D +option may be used to specify an output file to contain a list of +solar positions and intensities corresponding to time steps in the +weather tape where the sun has any portion above the horizon. +Sun radiance values may be zero if the direct amount is zero on the input. +Sun modifiers and names will be indexed by the minute, numbered from +midnight, January 1st. +If a hyphen ('-') is given as the argument to +.I \-D, +then the sun descriptions will be directed to the standard output. +This implies the +.I \-n +option just described. +If the +.I \-M +option is given as well, it will be used to record the modifier +names used in the +.I \-D +output, for convenient input to +.I rcontrib(1) +and +.I rfluxmtx(1). +.PP By default, .I gendaymtx assumes the positive Y-axis points north such that the first sky patch @@ -88,6 +157,15 @@ through using a similar transform. .PP The +.I \-i +option specifies the actual capture interval in minutes of the original +weather data. +Please see the man page for +.I gendaylit +to understand this correction, which is applied only near sunrise and +sunset. +.PP +The .I \-of or .I \-od @@ -95,6 +173,13 @@ option may be used to specify binary float or double o This is much faster to write and to read, and is therefore preferred on systems that support it. (MS Windows is not one of them.)\0 +The +.I \-O1 +option specifies that output should be total solar radiance rather +than visible radiance. +The +.I \-h +option prevents the output of the usual header information. Finally, the .I \-v option will enable verbose reporting, which is mostly useful for @@ -116,5 +201,6 @@ Ian Ashdown wrote most of the code, based on Jean-Jacques Delaunay's original gendaylit(1) implementation. Greg Ward wrote the final parameter parsing and weather tape conversion. .SH "SEE ALSO" -dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), rcontrib(1), -xform(1) +dctimestep(1), genBSDF(1), gendaylit(1), gensdaymtx(1), gensky(1), +genskyvec(1), genssky(1), +rcollate(1), rcontrib(1), rfluxmtx(1), rmtxop(1), xform(1)