ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/dctimestep.1
(Generate patch)

Comparing ray/doc/man/man1/dctimestep.1 (file contents):
Revision 1.2 by greg, Thu Jul 1 21:54:55 2010 UTC vs.
Revision 1.7 by greg, Thu Sep 5 17:53:22 2013 UTC

# Line 1 | Line 1
1   .\" RCSid $Id$"
2   .TH DCTIMESTEP 1 12/09/09 RADIANCE
3   .SH NAME
4 < dctimestep - compute annual simulation time-step via matrix multiplication
4 > dctimestep - compute annual simulation time-step(s) via matrix multiplication
5   .SH SYNOPSIS
6   .B dctimestep
7 + [
8 + .B "\-n nsteps"
9 + ][
10 + .B "\-o ospec"
11 + ][
12 + .B "\-i{f|d}
13 + ]
14   .B DCspec
15   [
16 < .B skyvec
16 > .B skyf
17   ]
18   .br
19   .B dctimestep
20 + [
21 + .B "\-n nsteps"
22 + ][
23 + .B "\-o ospec"
24 + ][
25 + .B "\-i{f|d}
26 + ]
27   .B Vspec
28   .B Tbsdf.xml
29   .B Dmat.dat
30   [
31 < .B skyvec
31 > .B skyf
32   ]
33   .SH DESCRIPTION
34   .I Dctimestep
# Line 22 | Line 36 | has two invocation forms.
36   In the first form,
37   .I dctimestep
38   is given a daylight coefficient specification and an optional sky
39 < vector, which may be read from the standard input if unspecified.
40 < The daylight coefficients are multiplied against this vector and the results
41 < are written to the standard output.
39 > vector or matrix, which may be read from the standard input if unspecified.
40 > The daylight coefficients are multiplied against these sky values
41 > and the results are written to the standard output.
42   This may be a list of color values or a combined Radiance image,
43   as explained below.
44   .PP
# Line 35 | Line 49 | The first argument is the View matrix file that specif
49   directions are related to some set of measured values, such as an array of
50   illuminance points or images.
51   This matrix is usually computed by
52 < .I rtcontrib(1)
52 > .I rcontrib(1)
53   for a particular set of windows or skylight openings.
54   The second argument is the window transmission matrix, or BSDF, given as
55   a standard XML description.
# Line 44 | Line 58 | relate to input directions on the same opening.
58   This is usually computed using
59   .I genklemsamp(1)
60   with
61 < .I rtcontrib
61 > .I rcontrib
62   in a separate run for each window or skylight orientation.
63 < The final input is the sky contribution vector,
64 < usually computed by
65 < .I genskyvec(1),
66 < which may be passed on the standard input.
67 < This data must be in ASCII format, whereas the View and Daylight matrices
68 < are more efficiently represented as binary float data if machine
69 < byte-order is not an issue.
63 > The last file is the sky contribution vector or matrix,
64 > typically computed by
65 > .I genskyvec(1)
66 > or
67 > .I gendaymtx(1),
68 > and may be passed on the standard input.
69 > This data is assumed by default to be in ASCII format, whereas the
70 > formats of the View and Daylight matrices
71 > are detected automatically if given as binary data.
72 > The
73 > .I \-if
74 > or
75 > .I \-id
76 > option may be used to specify that sky data is in float or double
77 > format, respectively, which is more efficient for large matrices.
78 > (Note that binary double data may not be read from stdin.)\0
79   .PP
80   Sent to the standard output of
81   .I dctimestep
# Line 68 | Line 91 | interpreted as a list of
91   .I Radiance
92   component pictures, which will be summed according to the computed
93   vector.
94 + .PP
95 + The
96 + .I \-n
97 + option may be used to compute multiple time steps in a
98 + single invocation.
99 + The sky input file must contain the number of
100 + columns specified in each sky patch row, whether it is read
101 + from the standard input or from a file.
102 + The columns do not need to be given on the same
103 + line, so long as the number of values totals 3*Nsteps*Npatches.
104 + Input starts from the first patch at the first time step, then the
105 + first patch at the second time step, and so on.
106 + .PP
107 + The
108 + .I \-o
109 + option may be used to specify a file or a set of output files
110 + to use rather than the standard output.
111 + If the given specification contains a '%d' format string, this
112 + will be replaced by the time step index, starting from 1.
113 + In this way, multiple output pictures may be produced,
114 + or separate result vectors (one per time step).
115   .SH EXAMPLES
116   To compute workplane illuminances at 3:30pm on Feb 10th:
117   .IP "" .2i
# Line 75 | Line 119 | gensky 2 10 15:30 | genskyvec | dctimestep workplaneDC
119   .PP
120   To compute an image at 10am on the equinox from a set of component images:
121   .IP "" .2i
122 < gensky 3 21 10 | genskyvec | dctimestep viewc%03d.hdr > view_03-21-10.hdr
122 > gensky 3 21 10 | genskyvec | dctimestep dcomp%03d.hdr > view_03-21-10.hdr
123   .PP
124   To compute a set of illuminance contributions for Window 1 on
125   the Winter solstice at 2pm:
# Line 84 | Line 128 | gensky 12 21 14 | genskyvec | dctimestep IllPts.vmx Bl
128   .PP
129   To compute Window2's contribution to an interior view at 12 noon on the Summer solstice:
130   .IP "" .2i
131 < gensky 6 21 12 | genskyvec | dctimestep view%03d.hdr Blinds30.xml Window2.dmx > view_6-21-12.hdr
131 > gensky 6 21 12 | genskyvec | dctimestep view%03d.hdr Blinds30.xml
132 > Window2.dmx > view_6-21-12.hdr
133 > .PP
134 > To generate an hourly matrix of sensor value contributions from Skylight3
135 > using a 3-phase calculation, where output columns are time steps:
136 > .IP "" .2i
137 > gendaymtx -of Tampa.wea | dctimestep -if -n 8760 WPpts.vmx
138 > shade3.xml Skylight3.dmx > wp_win3.dat
139 > .IP "" .2i
140 > .PP
141 > Generate a series of pictures corresponding to timesteps
142 > in an annual simulation:
143 > .IP "" .2i
144 > gendaymtx NYCity.wea | dctimestep -n 8760 -o tstep%04d.hdr dcomp%03d.hdr
145   .SH AUTHOR
146   Greg Ward
147   .SH "SEE ALSO"
148 < genklemsamp(1), genskyvec(1), mkillum(1), rtcontrib(1), rtrace(1), vwrays(1)
148 > gendaymtx(1), genklemsamp(1), genskyvec(1),
149 > mkillum(1), rcollate(1), rcontrib(1), rtrace(1), vwrays(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines