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.8 by greg, Sat Feb 8 01:28:05 2014 UTC vs.
Revision 1.11 by greg, Mon May 4 20:53:21 2015 UTC

# Line 7 | Line 7 | dctimestep - compute annual simulation time-step(s) vi
7   [
8   .B "\-n nsteps"
9   ][
10 + .B "\-h"
11 + ][
12   .B "\-o ospec"
13   ][
14   .B "\-i{f|d}
# Line 22 | Line 24 | dctimestep - compute annual simulation time-step(s) vi
24   [
25   .B "\-n nsteps"
26   ][
27 + .B "\-h"
28 + ][
29   .B "\-o ospec"
30   ][
31   .B "\-i{f|d}
# Line 73 | Line 77 | and may be passed on the standard input.
77   This data is assumed by default to be in ASCII format, whereas the
78   formats of the View and Daylight matrices
79   are detected automatically if given as binary data.
80 + .PP
81 + If the input sky data lacks a header, the
82 + .I \-n
83 + option may be used to indicate the number of time steps, which
84 + will be 1 for a sky vector.
85 + The sky input file must contain the number of
86 + columns specified in each sky patch row, whether it is read
87 + from the standard input or from a file.
88 + Input starts from the first patch at the first time step, then the
89 + first patch at the second time step, and so on.
90   The
91   .I \-if
92   or
93   .I \-id
94   option may be used to specify that sky data is in float or double
95   format, respectively, which is more efficient for large matrices.
96 < (Note that binary double data may not be read from stdin.)\0
96 > These options are unnecessary in the when the sky
97 > input has a header.
98   .PP
99 < Sent to the standard output of
99 > Any of the matrix or vector files may be read from a command
100 > instead of a file by
101 > using quotes and a beginning exclamation point ('!').
102 > .PP
103 > The standard output of
104   .I dctimestep
105   is either a color vector with as many RGB triplets
106   as there are rows in the View matrix, or a combined
# Line 97 | Line 116 | component pictures, which will be summed according to
116   vector.
117   .PP
118   The
100 .I \-n
101 option may be used to compute multiple time steps in a
102 single invocation.
103 The sky input file must contain the number of
104 columns specified in each sky patch row, whether it is read
105 from the standard input or from a file.
106 The columns do not need to be given on the same
107 line, so long as the number of values totals 3*Nsteps*Npatches.
108 Input starts from the first patch at the first time step, then the
109 first patch at the second time step, and so on.
110 .PP
111 The
119   .I \-o
120   option may be used to specify a file or a set of output files
121   to use rather than the standard output.
# Line 116 | Line 123 | If the given specification contains a '%d' format stri
123   will be replaced by the time step index, starting from 1.
124   In this way, multiple output pictures may be produced,
125   or separate result vectors (one per time step).
119 If the standard output is used or the
120 .I \-o
121 option specifies a single output file, then an information header
122 will precede the output.
123 This can be removed if desired using the
124 .I getinfo\(1\)
125 command with a single hyphen ('-') argument.
126   .PP
127 + A header will normally be produced on the output, unless the
128 + .I \-h
129 + option is specified.
130   The
131   .I \-of
132   or
133   .I \-od
134   option may be used to specify IEEE float or double binary output
135   data, respectively.
133 This enables
134 .I dctimestep
135 to be used as a pure matrix multiplier, as the output file with
136 header specifying the format is suitable for subsequent calls.
136   .SH EXAMPLES
137   To compute workplane illuminances at 3:30pm on Feb 10th:
138   .IP "" .2i
# Line 156 | Line 155 | Window2.dmx > view_6-21-12.hdr
155   To generate an hourly matrix of sensor value contributions from Skylight3
156   using a 3-phase calculation, where output columns are time steps:
157   .IP "" .2i
158 < gendaymtx -of Tampa.wea | dctimestep -if -n 8760 WPpts.vmx
158 > gendaymtx -of Tampa.wea | dctimestep WPpts.vmx
159   shade3.xml Skylight3.dmx > wp_win3.dat
160   .IP "" .2i
161   .PP
162   Generate a series of pictures corresponding to timesteps
163   in an annual simulation:
164   .IP "" .2i
165 < gendaymtx NYCity.wea | dctimestep -n 8760 -o tstep%04d.hdr dcomp%03d.hdr
165 > gendaymtx NYCity.wea | dctimestep -o tstep%04d.hdr dcomp%03d.hdr
166   .PP
167 < To multiply two color matrices (second matrix is IEEE-float with
169 < 145 RGB columns) into a IEEE-double result (also 145 RGB columns):
167 > To multiply two matrices into a IEEE-float result with header:
168   .IP "" .2i
169 < getinfo - < Inp2.fmx | dctimestep -n 145 -if -od Inp1.fmx > Inp1xInp2.dmx
169 > dctimestep -of Inp1.fmx Inp2.fmx > Inp1xInp2.fmx
170   .SH AUTHOR
171   Greg Ward
172   .SH "SEE ALSO"
173   gendaymtx(1), genklemsamp(1), genskyvec(1), getinfo(1),
174 < mkillum(1), rcollate(1), rcontrib(1), rtrace(1), vwrays(1)
174 > mkillum(1), rcollate(1), rcontrib(1), rmtxop(1), rtrace(1), vwrays(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines