man/man1/genklemsamp.1

.\" RCSid $Id: genklemsamp.1,v 1.4 2010/09/03 23:53:49 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 rcontrib(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 rcontrib
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 rcontrib
to compute daylight coefficients in a matrix:
.IP "" .2i
genklemsamp -c 500 -vd 0 -1 0 -vu 0 0 1 south_windows.rad
| rcontrib -c 500 -e MF:1 -f reinhart.cal -b rbin -bn Nrbins exterior.oct > Dsouth.dat
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
dctimestep(1), genBSDF(1), genskyvec(1), mkillum(1),
rcontrib(1), rtrace(1), vwrays(1)
Revision:	1.5
Committed:	Thu Jun 14 22:42:21 2012 UTC (13 years, 4 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad5R3, rad5R0, rad5R1, rad4R2, rad6R0, rad4R2P1, rad4R2P2, HEAD
Changes since 1.4:	+6 -6 lines
Log Message:	Reworked rtcontrib into rcontrib program
#	Content
1	.\" RCSid $Id: genklemsamp.1,v 1.4 2010/09/03 23:53:49 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 rcontrib(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 rcontrib
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 rcontrib
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	\| rcontrib -c 500 -e MF:1 -f reinhart.cal -b rbin -bn Nrbins exterior.oct > Dsouth.dat
76	.SH AUTHOR
77	Greg Ward
78	.SH "SEE ALSO"
79	dctimestep(1), genBSDF(1), genskyvec(1), mkillum(1),
80	rcontrib(1), rtrace(1), vwrays(1)