man/man1/genklemsamp.1

.\" RCSid $Id: genklemsamp.1,v 1.1 2009/06/14 00:33:15 greg Exp $
.TH GENKLEMSAMP 1 6/13/09 RADIANCE
.SH NAME
genklemsamp - generate ray samples over surfaces using Klems BSDF basis
.SH SYNOPSIS
.B genklemsamp
[
.B "\-c N"
][
.B "\-f{a|f|d}"
]
[
.B "view opts"
]
[
.B "geom.rad .."
]
.SH DESCRIPTION
.I Genklemsamp
generates ray origins and directions to sample planar surfaces
needed to determine incident radiances or daylight coefficients.
This command is typically used in conjunction with
.I rtcontrib(1)
to analyze exterior daylight coefficients
for an annual simulation.
.PP
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.
.PP
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
.I genklemsamp
will originate samples.
The sampled surface normals must correspond to the specified
view direction, and unaligned surfaces are silently ignored.
.PP
The
.I \-c
option specifies the number of rays to sample per Klems direction.
These samples will be distributed evenly over the surface(s).
The default setting is 1000.
.PP
The
.I \-ff
option specifies that output rays should be generated as 32-bit IEEE binary
float values.
This may be more efficient if passed directly to
.I rtcontrib
or
.I rtrace(1)
with the same option.
Likewise, the
.I \-fd
option specifies 64-bit IEEE binary double values.
The default setting of
.I \-fa
produces ASCII floating point values.
.SH EXAMPLE
To generate 500 samples per direction over a set of south-facing windows and
pass to
.I rtcontrib
to compute daylight coefficients in a matrix:
.IP "" .2i
genklemsamp -c 500 -vd 0 -1 0 -vu 0 0 1 south_windows.rad
| rtcontrib -c 500 -f tregenza.cal -b tbin -bn 146 exterior.oct > Dsouth.dat
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
mkillum(1), rtcontrib(1), rtrace(1), vwrays(1)
Revision:	1.2
Committed:	Sun Jun 14 00:40:04 2009 UTC (16 years, 4 months ago) by greg
Branch:	MAIN
Changes since 1.1:	+6 -1 lines
Log Message:	Added statement regarding the meaning of the fore clipping distance
#	User	Rev	Content
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)