| 1 |
|
.\" RCSid "$Id$" |
| 2 |
< |
.TH RCOLLATE 1 7/8/97 RADIANCE |
| 2 |
> |
.TH RCOLLATE 1 9/5/2013 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
rcollate - resize or re-order matrix data |
| 5 |
|
.SH SYNOPSIS |
| 9 |
|
][ |
| 10 |
|
.B \-w |
| 11 |
|
][ |
| 12 |
< |
.B \-f[afdb][N] |
| 12 |
> |
.B \-c |
| 13 |
|
][ |
| 14 |
+ |
.B \-f{a|f|d|b}[N] |
| 15 |
+ |
][ |
| 16 |
|
.B \-t |
| 17 |
|
][ |
| 18 |
|
.B "\-ic in_col" |
| 63 |
|
.I \-w |
| 64 |
|
option turns off non-fatal warning messages, such as unexpected EOD. |
| 65 |
|
.PP |
| 66 |
+ |
Normally, |
| 67 |
+ |
.I rcollate |
| 68 |
+ |
detects whether any transformation is actually taking place, and will |
| 69 |
+ |
reproduce the data verbatim if the input size and shape should be unaltered. |
| 70 |
+ |
The |
| 71 |
+ |
.I \-c |
| 72 |
+ |
opiton forces the operation to proceed, even if it appears to be a no-op, |
| 73 |
+ |
which can be useful to correct a misshapen input matrix or check that |
| 74 |
+ |
the data is the proper size and formatted correctly (in the case of ASCII input). |
| 75 |
+ |
.PP |
| 76 |
|
The input format is assumed to be ASCII, with three white-space separated words |
| 77 |
|
(typically numbers) in each record. |
| 78 |
|
A different input format may be specified with the |
| 113 |
|
.I \-f |
| 114 |
|
options are not required, but will be checked against the header |
| 115 |
|
information if provided. |
| 116 |
+ |
An exception is made for |
| 117 |
+ |
.I \-fbN |
| 118 |
+ |
where N>1, when no checks are made against the header, |
| 119 |
+ |
and the given length is assumed |
| 120 |
+ |
to be the exact size (in bytes) of each data record. |
| 121 |
|
.PP |
| 122 |
|
The transpose option, |
| 123 |
|
.I \-t |
| 180 |
|
.I rcollate |
| 181 |
|
issues a warning and simply copies its input to its standard output. |
| 182 |
|
.SH "SEE ALSO" |
| 183 |
< |
cnt(1), histo(1), neaten(1), rcalc(1), rlam(1), rmtxop(1), |
| 184 |
< |
rsplit(1), tabfunc(1), total(1) |
| 183 |
> |
cnt(1), histo(1), neaten(1), rcalc(1), rcomb(1), rcrop(1), rlam(1), |
| 184 |
> |
rsensor(1), rmtxop(1), rsplit(1), tabfunc(1), total(1) |
