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

Comparing ray/doc/man/man1/rmtxop.1 (file contents):
Revision 1.25 by greg, Mon Nov 27 22:04:45 2023 UTC vs.
Revision 1.36 by greg, Fri Apr 4 18:06:48 2025 UTC

# Line 9 | Line 9 | rmtxop - concatenate, add, multiply, divide, transpose
9   ][
10   .B \-f[afdc]
11   ][
12 < .B \-t
12 > .B "\-C {symbols|file}"
13   ][
14   .B "\-c ce .."
15   ][
16   .B "\-s sf .."
17   ][
18 + .B \-t
19 + ][
20   .B "\-rf|\-rb"
21   ]
22   .B m1
# Line 26 | Line 28 | rmtxop - concatenate, add, multiply, divide, transpose
28   .I Rmtxop
29   loads and concatenates or adds/multiplies/divides
30   together component matrix files given on the command line.
31 < Each file must have a header containing the following variables:
31 > Each file must have a header containing the following metadata:
32   .sp
33   .nf
34   NROWS={number of rows}
# Line 36 | Line 38 | FORMAT={ascii|float|double|32-bit_rle_rgbe|32-bit_rle_
38   .fi
39   .sp
40   The number of components indicates that each matrix element is actually
41 < composed of multiple elements, most commonly an RGB triple.
41 > composed of multiple channels, most commonly an RGB triple.
42   This is essentially dividing the matrix into planes, where each component
43   participates in a separate calculation.
44   If an appropriate header is not present, it may be added with a call to
45   .I rcollate(1).
46   A matrix may be read from the standard input using a hyphen by itself ('-')
47   in the appropriate place on the command line.
48 < .PP
47 < Any of the matrix inputs may be read from a command
48 > Similarly, any of the inputs may be read from a command
49   instead of a file by
50   using quotes and a beginning exclamation point ('!').
51   .PP
# Line 75 | Line 76 | These are typically produced by
76   or
77   .I rfluxmtx(1).
78   .PP
79 < Before each file, the
79 > Before each input, the
80   .I \-t
81   and
82   .I \-c
# Line 99 | Line 100 | the first new component, and the second four coefficie
100   yield the second new component.
101   Note that the number of coefficients must be an even multiple of the number
102   of original components.
103 < Alternatively, a set of symbolic output components can be specified as capital
104 < letters, with the following definitions:
103 > .PP
104 > Alternatively, a set of symbolic output components may be given to the
105 > .I \-c
106 > option, with the following definitions:
107   .sp
108   .nf
109   R       - red channel
# Line 111 | Line 114 | Y      - CIE Y channel (aka., luminance or illuminance)
114   Z       - CIE Z channel
115   S       - scotopic luminance or illuminance
116   M       - melanopic luminance or illuminance
117 + A       - average component value
118   .fi
119   .sp
120   These letters may be given in any order as a single string, and if
121   .I "-c RGB"
122   or
123   .I "-c XYZ"
124 < is specified along with a
124 > is specified for an input picture or the
125   .I "-fc"
126 < option, the output will be written as a RGBE or XYZE picture, respectively.
126 > option is given, the output will be written as a RGBE or XYZE picture.
127   Note that conversion from a float or RGBE color space applies a conversion
128   of 179 lumens/watt (for CIE or melanopic output) or 412 (for scotopic output),
129   and the reverse happens for conversion from XYZE input to RGB or RGBE output.
130 + Lower case versions of all these components are also supported, the only
131 + difference is that the aforementioned efficacy factors
132 + will be left out of the conversion.
133   .PP
134 + If a matrix or picture file path is given to the
135 + .I \-c
136 + option, then the color space of that file will be used, instead.
137 + .PP
138 + The
139 + .I \-C
140 + option takes either a symbolic color space or an input file, and will be
141 + applied to all subsequent matrices that do not have their own associated
142 + .I \-c
143 + option.
144 + .PP
145   Additionally, the
146   .I \-s
147   option applies the given scalar factor(s) to the elements of the matrix.
# Line 134 | Line 152 | components
152   .I after
153   application of any
154   .I \-c
155 < option for this input matrix or picture.
155 > option for this input matrix or picture, even if the
156 > .I \-s
157 > option appears first.
158   .PP
159   If present, the second and subsequent matrices on the command
160   line are concatenated together, unless separated by a plus ('+'),
# Line 183 | Line 203 | and/or
203   options after the last matrix on the command line.
204   .PP
205   Results are sent to the standard output.
206 < By default, the values will be written in the lowest resolution format
206 > By default, the values will be written in the lowest precision format
207   among the inputs, but the
208 < .I \-f
208 > .I \-f[adfc]
209   option may be used to explicitly output components
210   as ASCII (-fa), binary doubles (-fd), floats (-ff), or common-exponent
211   colors/spectra (-fc).
212 < In the latter case, the actual matrix dimensions are written in the resolution
213 < string rather than the header.
212 > In the latter case, the actual matrix dimensions are written in
213 > the resolution string rather than the header.
214   Also, matrix results will be written as standard
215   Radiance pictures if they have either one
216   or three components.
# Line 204 | Line 224 | The
224   option turns on verbose reporting, which announces each operation.
225   .SH EXAMPLES
226   To concatenate two matrix files with a BTDF between them and write
227 < the result as binary double:
227 > the result as binary float:
228   .IP "" .2i
229 < rmtxop -fd view.vmx blinds.xml exterior.dmx > dcoef.dmx
229 > rmtxop -ff view.vmx blinds.xml exterior.dmx > dcoef.dmx
230   .PP
231   To convert a BTDF matrix into a Radiance picture:
232   .IP "" .2i
# Line 253 | Line 273 | be the same.
273   Note that this only applies to concatenation;
274   element-wise addition, multiplication, and division are always
275   evaluated from left to right.
276 + .PP
277 + All calculations are peformed internally using 32-bit floating-point,
278 + so there is little benefit in either reading or writing 64-bit double
279 + data.
280 + This may be overridden at compile time using the macro
281 + "-DDTrmx_native=DTdouble".
282 + .SH BUGS
283 + The
284 + .I rmtxop
285 + command currently ignores the "PRIMARIES" setting in input
286 + headers, and does not produce any on output, even in
287 + circumstances where it would make sense to.
288   .SH AUTHOR
289   Greg Ward
290   .SH "SEE ALSO"
291 < cnt(1), getinfo(1), histo(1), neaten(1), pcomb(1),
292 < ra_xyze(1), rcalc(1),
293 < rcollate(1), rcontrib(1), rcrop(1), rfluxmtx(1), rlam(1),
294 < rsplit(1), rtrace(1), tabfunc(1), total(1), vwrays(1),
263 < wrapBSDF(1)
291 > cnt(1), dctimestep(1), getinfo(1), pcomb(1), pfilt(1),
292 > pvsum(1), ra_xyze(1), rcalc(1),
293 > rcollate(1), rcomb(1), rcontrib(1), rcrop(1), rfluxmtx(1),
294 > rtpict(1), rtrace(1), vwrays(1), wrapBSDF(1)

Diff Legend

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