| 1 |
.\" RCSid $Id: genklemsamp.1,v 1.1 2009/06/14 00:33:15 greg Exp $ |
| 2 |
.TH GENKLEMSAMP 1 6/13/09 RADIANCE |
| 3 |
.SH NAME |
| 4 |
genklemsamp - generate ray samples over surfaces using Klems BSDF basis |
| 5 |
.SH SYNOPSIS |
| 6 |
.B genklemsamp |
| 7 |
[ |
| 8 |
.B "\-c N" |
| 9 |
][ |
| 10 |
.B "\-f{a|f|d}" |
| 11 |
] |
| 12 |
[ |
| 13 |
.B "view opts" |
| 14 |
] |
| 15 |
[ |
| 16 |
.B "geom.rad .." |
| 17 |
] |
| 18 |
.SH DESCRIPTION |
| 19 |
.I Genklemsamp |
| 20 |
generates ray origins and directions to sample planar surfaces |
| 21 |
needed to determine incident radiances or daylight coefficients. |
| 22 |
This command is typically used in conjunction with |
| 23 |
.I rtcontrib(1) |
| 24 |
to analyze exterior daylight coefficients |
| 25 |
for an annual simulation. |
| 26 |
.PP |
| 27 |
The view options are needed to specify (at minimum) the view direction, |
| 28 |
which corresponds to the orientation of the surfaces, and the view up |
| 29 |
vector, which corresponds to the azimuth=90-degree position on the Klems |
| 30 |
sampling hemisphere. |
| 31 |
The view fore clipping distance is also quite useful, as it provides |
| 32 |
a means to pass through some thickness in a fenestration system before |
| 33 |
samples are sent out. |
| 34 |
Other view options such as the view type and aft |
| 35 |
clipping distance are overridden or ignored. |
| 36 |
.PP |
| 37 |
If no Radiance scene files are provided, then the specified parallel |
| 38 |
view defines the width, height, center, and orientation of the window |
| 39 |
or facade of interest. |
| 40 |
If one or more scene files are given, they |
| 41 |
are presumed to contain planar surfaces over which |
| 42 |
.I genklemsamp |
| 43 |
will originate samples. |
| 44 |
The sampled surface normals must correspond to the specified |
| 45 |
view direction, and unaligned surfaces are silently ignored. |
| 46 |
.PP |
| 47 |
The |
| 48 |
.I \-c |
| 49 |
option specifies the number of rays to sample per Klems direction. |
| 50 |
These samples will be distributed evenly over the surface(s). |
| 51 |
The default setting is 1000. |
| 52 |
.PP |
| 53 |
The |
| 54 |
.I \-ff |
| 55 |
option specifies that output rays should be generated as 32-bit IEEE binary |
| 56 |
float values. |
| 57 |
This may be more efficient if passed directly to |
| 58 |
.I rtcontrib |
| 59 |
or |
| 60 |
.I rtrace(1) |
| 61 |
with the same option. |
| 62 |
Likewise, the |
| 63 |
.I \-fd |
| 64 |
option specifies 64-bit IEEE binary double values. |
| 65 |
The default setting of |
| 66 |
.I \-fa |
| 67 |
produces ASCII floating point values. |
| 68 |
.SH EXAMPLE |
| 69 |
To generate 500 samples per direction over a set of south-facing windows and |
| 70 |
pass to |
| 71 |
.I rtcontrib |
| 72 |
to compute daylight coefficients in a matrix: |
| 73 |
.IP "" .2i |
| 74 |
genklemsamp -c 500 -vd 0 -1 0 -vu 0 0 1 south_windows.rad |
| 75 |
| rtcontrib -c 500 -f tregenza.cal -b tbin -bn 146 exterior.oct > Dsouth.dat |
| 76 |
.SH AUTHOR |
| 77 |
Greg Ward |
| 78 |
.SH "SEE ALSO" |
| 79 |
mkillum(1), rtcontrib(1), rtrace(1), vwrays(1) |
