genskyvec(1) [debian man page]

GENSKYVEC(1)						      General Commands Manual						      GENSKYVEC(1)

NAME

       genskyvec - compute patch radiance averages for a specific sky

SYNOPSIS

       genskyvec [ -m N ][ -c r g b ]

DESCRIPTION

       Genskyvec  samples  the	Radinace sky description given on the standard input to generate a list of average patch radiances.  If there is a
       sun in the description, genskyvec will include its contribution in the three nearest sky patches, distributing energy according to centroid
       proximity.

       By  default,  genskyvec	divides the sky into 2305 patches, plus one patch for the ground.  This corresponds to Reinhart's extension of the
       Tregenza sky, where the original 145 patches are subdivided into 16 subpatches, except at the zenith.  A different subdivision may be spec-
       ified  via  the	-m  option.   The value given will be used to subdivide each dimension, so the default of 4 yields almost 16 times as many
       patches as the original Tregenza sky, which can be specified with -m 1.	A higher resolution sky is generally better for  daylight  coeffi-
       cient analysis where solar position is important.

       The -c option may be used to specify a color for the sky.  The gray value should equal 1 for proper energy balance The default sky color is
       -c 0.960 1.004 1.118 .

EXAMPLE

       To generate 578 patches corresponding to a 2x2 subdivision of the Tregenza sky on a sunny equinox noon:

	 gensky 9 21 12 | genskyvec -m 2 > sky09_21_12.dat

AUTHOR

       Greg Ward

SEE ALSO

       dctimestep(1), genBSDF(1), gensky(1), gentregvec(1), rtcontrib(1), rtrace(1)

RADIANCE
							     12/09/09							      GENSKYVEC(1)

DCTIMESTEP(1)						      General Commands Manual						     DCTIMESTEP(1)

NAME

       dctimestep - compute annual simulation time-step via matrix multiplication

SYNOPSIS

       dctimestep DCspec [ skyvec ]
       dctimestep Vspec Tbsdf.xml Dmat.dat [ skyvec ]

DESCRIPTION

       Dctimestep  has two invocation forms.  In the first form, dctimestep is given a daylight coefficient specification and an optional sky vec-
       tor, which may be read from the standard input if unspecified.  The daylight coefficients  are  multiplied  against  this  vector  and  the
       results are written to the standard output.  This may be a list of color values or a combined Radiance image, as explained below.

       In the second form, dctimestep takes four input files, forming a matrix expression.  The first argument is the View matrix file that speci-
       fies how window output directions are related to some set of measured values, such as an array  of  illuminance	points	or  images.   This
       matrix  is usually computed by rtcontrib(1) for a particular set of windows or skylight openings.  The second argument is the window trans-
       mission matrix, or BSDF, given as a standard XML description.  The third argument is the Daylight matrix file that defines how sky  patches
       relate  to  input  directions on the same opening.  This is usually computed using genklemsamp(1) with rtcontrib in a separate run for each
       window or skylight orientation.	The final input is the sky contribution vector, usually computed by genskyvec(1), which may be	passed	on
       the  standard  input.  This data must be in ASCII format, whereas the View and Daylight matrices are more efficiently represented as binary
       float data if machine byte-order is not an issue.

       Sent to the standard output of dctimestep is either an ASCII color vector with as many RGB triplets as there are rows in the  View  matrix,
       or  a  combined	Radiance  picture.  Which output is produced depends on the first argument.  A regular file name will be loaded and inter-
       preted as a matrix to generate a color results vector.  A file specification containing a '%d' format string will be interpreted as a  list
       of Radiance component pictures, which will be summed according to the computed vector.

EXAMPLES

       To compute workplane illuminances at 3:30pm on Feb 10th:

	 gensky 2 10 15:30 | genskyvec | dctimestep workplaneDC.dmx > Ill_02-10-1530.dat

       To compute an image at 10am on the equinox from a set of component images:

	 gensky 3 21 10 | genskyvec | dctimestep viewc%03d.hdr > view_03-21-10.hdr

       To compute a set of illuminance contributions for Window 1 on the Winter solstice at 2pm:

	 gensky 12 21 14 | genskyvec | dctimestep IllPts.vmx Blinds20.xml Window1.dmx > Ill_12-21-14.dat

       To compute Window2's contribution to an interior view at 12 noon on the Summer solstice:

	 gensky 6 21 12 | genskyvec | dctimestep view%03d.hdr Blinds30.xml Window2.dmx > view_6-21-12.hdr

AUTHOR

       Greg Ward

SEE ALSO

       genklemsamp(1), genskyvec(1), mkillum(1), rtcontrib(1), rtrace(1), vwrays(1)

RADIANCE
							     12/09/09							     DCTIMESTEP(1)