--- ray/doc/man/man1/gendaymtx.1 2020/04/13 17:12:19 1.12 +++ ray/doc/man/man1/gendaymtx.1 2022/08/13 17:24:56 1.16 @@ -1,4 +1,4 @@ -.\" RCSid $Id: gendaymtx.1,v 1.12 2020/04/13 17:12:19 greg Exp $ +.\" RCSid $Id: gendaymtx.1,v 1.16 2022/08/13 17:24:56 greg Exp $ .TH GENDAYMTX 1 01/19/13 RADIANCE .SH NAME gendaymtx - generate an annual Perez sky matrix from a weather tape @@ -13,10 +13,12 @@ gendaymtx - generate an annual Perez sky matrix from a ][ .B "\-d|\-s|\-n" ][ -.B "\-D sunfile" +.B "\-u" ][ +.B "\-D sunfile" +[ .B "\-M sunmods" -][ +]][ .B "\-r deg" ][ .B "\-m N" @@ -79,6 +81,10 @@ 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, @@ -86,15 +92,21 @@ 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, -with the rest of the sky and ground patch unaffected. -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. +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. +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. @@ -103,7 +115,7 @@ 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 horizion. +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.