10 |
|
.B "\-o ospec" |
11 |
|
][ |
12 |
|
.B "\-i{f|d} |
13 |
+ |
][ |
14 |
+ |
.B "\-o{f|d} |
15 |
|
] |
16 |
|
.B DCspec |
17 |
|
[ |
25 |
|
.B "\-o ospec" |
26 |
|
][ |
27 |
|
.B "\-i{f|d} |
28 |
+ |
][ |
29 |
+ |
.B "\-o{f|d} |
30 |
|
] |
31 |
|
.B Vspec |
32 |
|
.B Tbsdf.xml |
83 |
|
.PP |
84 |
|
Sent to the standard output of |
85 |
|
.I dctimestep |
86 |
< |
is either an ASCII color vector with as many RGB triplets |
86 |
> |
is either a color vector with as many RGB triplets |
87 |
|
as there are rows in the View matrix, or a combined |
88 |
|
.I Radiance |
89 |
|
picture. |
116 |
|
will be replaced by the time step index, starting from 1. |
117 |
|
In this way, multiple output pictures may be produced, |
118 |
|
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 |
+ |
The |
128 |
+ |
.I \-of |
129 |
+ |
or |
130 |
+ |
.I \-od |
131 |
+ |
option may be used to specify IEEE float or double binary output |
132 |
+ |
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. |
137 |
|
.SH EXAMPLES |
138 |
|
To compute workplane illuminances at 3:30pm on Feb 10th: |
139 |
|
.IP "" .2i |
164 |
|
in an annual simulation: |
165 |
|
.IP "" .2i |
166 |
|
gendaymtx NYCity.wea | dctimestep -n 8760 -o tstep%04d.hdr dcomp%03d.hdr |
167 |
+ |
.PP |
168 |
+ |
To multiply two color matrices (second matrix is IEEE-float with |
169 |
+ |
145 RGB columns) into a IEEE-double result (also 145 RGB columns): |
170 |
+ |
.IP "" .2i |
171 |
+ |
getinfo - < Inp2.fmx | dctimestep -n 145 -if -od Inp1.fmx > Inp1xInp2.dmx |
172 |
|
.SH AUTHOR |
173 |
|
Greg Ward |
174 |
|
.SH "SEE ALSO" |
175 |
< |
gendaymtx(1), genklemsamp(1), genskyvec(1), |
175 |
> |
gendaymtx(1), genklemsamp(1), genskyvec(1), getinfo(1), |
176 |
|
mkillum(1), rcollate(1), rcontrib(1), rtrace(1), vwrays(1) |