man/man1/dctimestep.1

.\" RCSid $Id: dctimestep.1,v 1.2 2010/07/01 21:54:55 greg Exp $"
.TH DCTIMESTEP 1 12/09/09 RADIANCE
.SH NAME
dctimestep - compute annual simulation time-step via matrix multiplication
.SH SYNOPSIS
.B dctimestep
.B DCspec
[
.B skyvec
]
.br
.B dctimestep
.B Vspec
.B Tbsdf.xml
.B Dmat.dat
[
.B skyvec
]
.SH DESCRIPTION
.I Dctimestep
has two invocation forms.
In the first form,
.I dctimestep
is given a daylight coefficient specification and an optional sky
vector, which may be read from the standard input if unspecified.
The daylight coefficients are multiplied against this vector and the results
are written to the standard output.
This may be a list of color values or a combined Radiance image,
as explained below.
.PP
In the second form,
.I dctimestep
takes four input files, forming a matrix expression.
The first argument is the View matrix file that specifies how window output
directions are related to some set of measured values, such as an array of
illuminance points or images.
This matrix is usually computed by
.I rcontrib(1)
for a particular set of windows or skylight openings.
The second argument is the window transmission matrix, or BSDF, given as
a standard XML description.
The third argument is the Daylight matrix file that defines how sky patches
relate to input directions on the same opening.
This is usually computed using
.I genklemsamp(1)
with
.I rcontrib
in a separate run for each window or skylight orientation.
The final input is the sky contribution vector,
usually computed by
.I genskyvec(1),
which may be passed on the standard input.
This data must be in ASCII format, whereas the View and Daylight matrices
are more efficiently represented as binary float data if machine
byte-order is not an issue.
.PP
Sent to the standard output of
.I dctimestep
is either an ASCII color vector with as many RGB triplets
as there are rows in the View matrix, or a combined
.I Radiance
picture.
Which output is produced depends on the first argument.
A regular file name will be loaded and interpreted as a matrix to
generate a color results vector.
A file specification containing a '%d' format string will be
interpreted as a list of
.I Radiance
component pictures, which will be summed according to the computed
vector.
.SH EXAMPLES
To compute workplane illuminances at 3:30pm on Feb 10th:
.IP "" .2i
gensky 2 10 15:30 | genskyvec | dctimestep workplaneDC.dmx > Ill_02-10-1530.dat
.PP
To compute an image at 10am on the equinox from a set of component images:
.IP "" .2i
gensky 3 21 10 | genskyvec | dctimestep viewc%03d.hdr > view_03-21-10.hdr
.PP
To compute a set of illuminance contributions for Window 1 on
the Winter solstice at 2pm:
.IP "" .2i
gensky 12 21 14 | genskyvec | dctimestep IllPts.vmx Blinds20.xml Window1.dmx > Ill_12-21-14.dat
.PP
To compute Window2's contribution to an interior view at 12 noon on the Summer solstice:
.IP "" .2i
gensky 6 21 12 | genskyvec | dctimestep view%03d.hdr Blinds30.xml Window2.dmx > view_6-21-12.hdr
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
genklemsamp(1), genskyvec(1), mkillum(1), rcontrib(1), rtrace(1), vwrays(1)
Revision:	1.3
Committed:	Thu Jun 14 22:42:21 2012 UTC (12 years, 10 months ago) by greg
Branch:	MAIN
Changes since 1.2:	+4 -4 lines
Log Message:	Reworked rtcontrib into rcontrib program
#	User	Rev	Content
1	greg	1.3	.\" RCSid $Id: dctimestep.1,v 1.2 2010/07/01 21:54:55 greg Exp $"
2	greg	1.1	.TH DCTIMESTEP 1 12/09/09 RADIANCE
3			.SH NAME
4			dctimestep - compute annual simulation time-step via matrix multiplication
5			.SH SYNOPSIS
6			.B dctimestep
7	greg	1.2	.B DCspec
8			[
9			.B skyvec
10			]
11			.br
12			.B dctimestep
13	greg	1.1	.B Vspec
14			.B Tbsdf.xml
15			.B Dmat.dat
16			[
17	greg	1.2	.B skyvec
18	greg	1.1	]
19			.SH DESCRIPTION
20			.I Dctimestep
21	greg	1.2	has two invocation forms.
22			In the first form,
23			.I dctimestep
24			is given a daylight coefficient specification and an optional sky
25			vector, which may be read from the standard input if unspecified.
26			The daylight coefficients are multiplied against this vector and the results
27			are written to the standard output.
28			This may be a list of color values or a combined Radiance image,
29			as explained below.
30			.PP
31			In the second form,
32			.I dctimestep
33	greg	1.1	takes four input files, forming a matrix expression.
34			The first argument is the View matrix file that specifies how window output
35			directions are related to some set of measured values, such as an array of
36			illuminance points or images.
37			This matrix is usually computed by
38	greg	1.3	.I rcontrib(1)
39	greg	1.1	for a particular set of windows or skylight openings.
40			The second argument is the window transmission matrix, or BSDF, given as
41			a standard XML description.
42			The third argument is the Daylight matrix file that defines how sky patches
43			relate to input directions on the same opening.
44			This is usually computed using
45			.I genklemsamp(1)
46			with
47	greg	1.3	.I rcontrib
48	greg	1.1	in a separate run for each window or skylight orientation.
49			The final input is the sky contribution vector,
50			usually computed by
51			.I genskyvec(1),
52			which may be passed on the standard input.
53			This data must be in ASCII format, whereas the View and Daylight matrices
54			are more efficiently represented as binary float data if machine
55			byte-order is not an issue.
56			.PP
57			Sent to the standard output of
58			.I dctimestep
59			is either an ASCII color vector with as many RGB triplets
60			as there are rows in the View matrix, or a combined
61			.I Radiance
62			picture.
63	greg	1.2	Which output is produced depends on the first argument.
64	greg	1.1	A regular file name will be loaded and interpreted as a matrix to
65			generate a color results vector.
66			A file specification containing a '%d' format string will be
67			interpreted as a list of
68			.I Radiance
69			component pictures, which will be summed according to the computed
70			vector.
71			.SH EXAMPLES
72	greg	1.2	To compute workplane illuminances at 3:30pm on Feb 10th:
73			.IP "" .2i
74			gensky 2 10 15:30 \| genskyvec \| dctimestep workplaneDC.dmx > Ill_02-10-1530.dat
75			.PP
76			To compute an image at 10am on the equinox from a set of component images:
77			.IP "" .2i
78			gensky 3 21 10 \| genskyvec \| dctimestep viewc%03d.hdr > view_03-21-10.hdr
79			.PP
80	greg	1.1	To compute a set of illuminance contributions for Window 1 on
81			the Winter solstice at 2pm:
82			.IP "" .2i
83			gensky 12 21 14 \| genskyvec \| dctimestep IllPts.vmx Blinds20.xml Window1.dmx > Ill_12-21-14.dat
84			.PP
85			To compute Window2's contribution to an interior view at 12 noon on the Summer solstice:
86			.IP "" .2i
87			gensky 6 21 12 \| genskyvec \| dctimestep view%03d.hdr Blinds30.xml Window2.dmx > view_6-21-12.hdr
88			.SH AUTHOR
89			Greg Ward
90			.SH "SEE ALSO"
91	greg	1.3	genklemsamp(1), genskyvec(1), mkillum(1), rcontrib(1), rtrace(1), vwrays(1)