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

Comparing ray/doc/man/man1/rcollate.1 (file contents):
Revision 1.7 by greg, Sat May 31 21:33:21 2014 UTC vs.
Revision 1.9 by greg, Fri Nov 8 02:10:38 2019 UTC

# Line 20 | Line 20 | rcollate - resize or transpose matrix data
20   .B "\-oc out_col"
21   ][
22   .B "\-or out_row"
23 + ][
24 + .B "\-o RxC[xR1xC2..]"
25   ]
26   [
27   .B input.dat
# Line 30 | Line 32 | reads in a single matrix file (table) and reshapes it
32   the number of columns specified by the
33   .I \-oc
34   option.
35 + The number of rows may be specified with a
36 + .I \-or
37 + option, or may be determined automatically from the size of the input if
38 + it is an even multiple of the number of columns (as it should be).
39 + Alternatively, both may be specified using a
40 + .I \-o
41 + option with the number of rows and columns separated by an 'x', as in "30x14"
42 + for 30 rows by 14 columns.
43 + .I Rcollate
44 + can also reorder the input into nested blocks by continuing the output size
45 + string, "3x10X7x2" would order output data with a 3x10 super-array of 7x2
46 + subblocks.
47 + This is a convenient way to visualize tensor data.
48 + .PP
49   By default, the file is assumed to include an information header, which
50   is copied to the standard output along with the command name.
51   The
# Line 105 | Line 121 | to specify the input file on the command line, rather
121   from the standard input, since
122   .I rcollate
123   can map the file directly into virtual memory.
124 < .SH EXAMPLE
124 > .SH EXAMPLES
125   To change put 8760 color triplets per row in a matrix with no header:
126   .IP "" .2i
127   rcollate -h \-oc 8760 input.dat > col8760.dat
# Line 118 | Line 134 | To create an appropriate header for a binary float mat
134   .I rmtxop(1)\:
135   .IP "" .2i
136   rcollate -hi -ff3 -or 145 -oc 8760 input.smx | rmtxop dcoef.dmx - > res.txt
137 + .PP
138 + To visualize a Shirley-Chiu BTDF matrix where the interior resolution is
139 + 64x64 and the exterior resolution is 32x32:
140 + .IP "" .2i
141 + rcollate -o 64x64X32x32 s-c_bsdf.mtx | rmtxop -fc - > s-c_bsdf.hdr
142   .SH AUTHOR
143   Greg Ward
144   .SH NOTES
# Line 135 | Line 156 | without a transpose,
156   .I rcollate
157   issues a warning and simply copies its input to its standard output.
158   .SH "SEE ALSO"
159 < cnt(1), histo(1), neaten(1), rcalc(1), rlam(1), rmtxop(1), tabfunc(1), total(1)
159 > cnt(1), histo(1), neaten(1), rcalc(1), rlam(1), rmtxop(1),
160 > rsplit(1), tabfunc(1), total(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines