NAME
chan_permute - operate on columns of files.
SYNOPSIS
chan_permute
-i infile1 id id ...
[-i infile2 id ...]
-o outfile1 id id ...
[-o outfile2 id ...]
DESCRIPTION
This program mixes, matches, and merges ASCII files organized in
channels or columns. Each word, separated by whitespaces, should be less
than 40 characters long. The channels in each input file are specified
and then mapped to the desired channels in the output file(s). These are
the sort of things that can be done using
cut
and
paste,
but when
working on animation tables it's often nice to be able to do it in one
step.
Infiles
are files to be read from,
outfiles
are files to be written
to, and each
id
is a small positive integer identifying a channel. All of the
input
id's
should be distinct integers, or the results are not guaranteed.
Chan_permute
interprets
-i stdin
as standard input and
-o stdout
as
standard output.
EXAMPLES
The command
chan_permute -i foo 0 1 2 -o stdout 2 1 0
reverses the order of foo's three columns and sends them to standard output.
The command
chan_permute -i file1 0 1 -i file2 2 3 -o file3 2 0 1 -o file4 3 0 1
creates file3 and file4, each containing one of the columns of file2
followed by both columns of file1.
BUGS
A given file may be referenced
more than once for input, but may not be referenced for input and output
together or output and output together. In the latter case, the second
output reference overrides the other. The
id's
must be integers
somewhere between 0 and the number of arguments, inclusive.
AUTHOR
Carl J. Nuzman
"BUG REPORTS"
Reports of bugs or problems should be submitted via electronic
mail to <devs@brlcad.org>.