--- ray/doc/man/man1/gendaymtx.1 2020/01/07 01:42:30 1.11 +++ ray/doc/man/man1/gendaymtx.1 2020/09/11 16:53:57 1.14 @@ -1,4 +1,4 @@ -.\" RCSid $Id: gendaymtx.1,v 1.11 2020/01/07 01:42:30 greg Exp $ +.\" RCSid $Id: gendaymtx.1,v 1.14 2020/09/11 16:53:57 greg Exp $ .TH GENDAYMTX 1 01/19/13 RADIANCE .SH NAME gendaymtx - generate an annual Perez sky matrix from a weather tape @@ -13,8 +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" @@ -91,8 +95,18 @@ will include its contribution in the four nearest sky distributing energy according to centroid proximity. .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. @@ -101,7 +115,25 @@ 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 is visible above the horizion. +weather tape where the sun has any portion above the horizion. +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 @@ -159,4 +191,4 @@ based on Jean-Jacques Delaunay's original gendaylit(1) Greg Ward wrote the final parameter parsing and weather tape conversion. .SH "SEE ALSO" dctimestep(1), genBSDF(1), gendaylit(1), gensky(1), genskyvec(1), -rcollate(1), rcontrib(1), xform(1) +rcollate(1), rcontrib(1), rfluxmtx(1), xform(1)