GENKLEMSAMP(1)                                                  GENKLEMSAMP(1)



NNAAMMEE
       genklemsamp - generate ray samples over surfaces using Klems BSDF basis

SSYYNNOOPPSSIISS
       ggeennkklleemmssaammpp [ --cc NN ][ --ff{{aa||ff||dd}} ] [ vviieeww ooppttss ] [ ggeeoomm..rraadd ....  ]

DDEESSCCRRIIPPTTIIOONN
       _G_e_n_k_l_e_m_s_a_m_p generates ray origins and directions to sample planar  sur-
       faces  needed to determine incident radiances or daylight coefficients.
       This command is typically used in conjunction with _r_t_c_o_n_t_r_i_b_(_1_) to ana-
       lyze exterior daylight coefficients for an annual simulation.

       The view options are needed to specify (at minimum) the view direction,
       which corresponds to the orientation of the surfaces, and the  view  up
       vector,  which  corresponds  to  the  azimuth=90-degree position on the
       Klems sampling hemisphere.  The view fore  clipping  distance  is  also
       quite  useful, as it provides a means to pass through some thickness in
       a fenestration system before samples are sent out.  Other view  options
       such  as  the  view  type  and  aft clipping distance are overridden or
       ignored.

       If no Radiance scene files are provided, then  the  specified  parallel
       view  defines  the width, height, center, and orientation of the window
       or facade of interest.  If one or more scene files are given, they  are
       presumed  to contain planar surfaces over which _g_e_n_k_l_e_m_s_a_m_p will origi-
       nate samples.  The sampled surface normals must correspond to the spec-
       ified view direction, and unaligned surfaces are silently ignored.

       The  _-_c  option specifies the number of rays to sample per Klems direc-
       tion.  These samples will be distributed evenly  over  the  surface(s).
       The default setting is 1000.

       The _-_f_f option specifies that output rays should be generated as 32-bit
       IEEE binary float  values.   This  may  be  more  efficient  if  passed
       directly to _r_t_c_o_n_t_r_i_b or _r_t_r_a_c_e_(_1_) with the same option.  Likewise, the
       _-_f_d option specifies 64-bit IEEE binary  double  values.   The  default
       setting of _-_f_a produces ASCII floating point values.

EEXXAAMMPPLLEE
       To  generate  500 samples per direction over a set of south-facing win-
       dows and pass to  _r_t_c_o_n_t_r_i_b  to  compute  daylight  coefficients  in  a
       matrix:

         genklemsamp -c 500 -vd 0 -1 0 -vu 0 0 1 south_windows.rad | rtcontrib
         -c 500 -e MF:1 -f reinhart.cal -b  rbin  -bn  Nrbins  exterior.oct  >
         Dsouth.dat

AAUUTTHHOORR
       Greg Ward

SSEEEE AALLSSOO
       dctimestep(1),   genskyvec(1),   mkillum(1),  rtcontrib(1),  rtrace(1),
       vwrays(1)



RADIANCE                            6/13/09                     GENKLEMSAMP(1)
