| 1 |
greg |
1.2 |
.\" RCSid $Id: genklemsamp.1,v 1.1 2009/06/14 00:33:15 greg Exp $ |
| 2 |
greg |
1.1 |
.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 |
greg |
1.2 |
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 |
greg |
1.1 |
.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) |
