--- ray/doc/man/man1/gendaymtx.1	2020/01/07 01:42:30	1.11
+++ ray/doc/man/man1/gendaymtx.1	2024/08/05 17:23:56	1.18
@@ -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.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
@@ -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"
@@ -25,7 +29,9 @@ gendaymtx - generate an annual Perez sky matrix from a
 ][
 .B "-o{f|d}"
 ][
-.B "-O{0|1}"
+.B "\-O{0|1}"
+][
+.B "\-i intvl"
 ]
 [
 .B "tape.wea"
@@ -77,6 +83,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,
@@ -84,15 +94,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.
@@ -101,7 +117,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 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
@@ -123,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
@@ -158,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),
-rcollate(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)