NAME¶
dirfile2ascii — output dirfile database vectors as ASCII text
SYNOPSIS¶
- dirfile2ascii [ OPTION ]... DIRFILE
- [ [ -a | -A | -e | -E | -F | -g
| -G | -o | -i | -u | -x | -X ]
FIELD ]...
DESCRIPTION¶
Fetches data from a
dirfile(5) database specified by
DIRFILE and writes
it as ASCII to standard output. Any number of vector
FIELDs may be
specified. Each specified field is printed in a separate column.
Mandatory arguments to long options are mandatory for short options too.
- -d, --delimeter=delim
- separate columns by delim. (Default: a single space.)
- -f,
--first-frame=first_frame-last_frame
- read from frame first_frame to frame last_frame
(inclusive).
- -f,
--first-frame=first_frame:nframes
- equivalent to --first-frame=first_frame
--num-frames=nframes.
- -f, --first-frame=first_frame
- If first_frame >= 0, start reading at frame
first_frame. If first_frame is -1 and
--num-frames=nframes is specified, read the last
nframes frames. If --first-frame is not specified, reading
starts at frame zero.
- -n, --num-frames=nframes
- read at most nframes frames. If not specified, or if
nframes = 0, all frames to the end-of-field are
read.
- -p, --precision=format
- use format to format output. format may contain any of the
flag characters, a field width, and/or a precision as specified in
printf(3). It may not contain a length modifier.
- -q, --quiet
- don't write diagnostic messages on standard error. (This is the default
behaviour).
- -s, --skip=frame_skip
- if frame_skip > 0, output only one sample for
every frame_skip frames.
- -v, --verbose
- write diagnostic messages on standard error.
- -z, --fill=STRING
- Fill columns which go past the end of their corresponding field with the
string STRING. The default behaviour is to fill columns with
floating-point conversions with NaN and columns with integer
conversion with 0, which mirrors what occurs when an attempt is
made to print data from before the start of a field. (Note: the default
behaviour cannot be reproduced with this option, since STRING is
applied to all columns, regardless of conversion type.)
In addition to the above, each
FIELD argument may be preceded by a short
option, one of:
-a,
-A,
-e,
-E,
-F,
-g,
-G,
-i,
-o,
-u,
-x,
-X,
indicating the conversion to be used. See
printf(3) for the meaning of
these conversion specifiers. The output flags, width, and precision may be
specified by using
--precision. If no conversion specifier is given,
%f is used.
For conversion specifiers
%a,
%A,
%e,
%E,
%f,
%F,
%g,
%G, data is read from the dirfile as double
precision floats. For conversion specifier
%i, data is read as 64-bit
signed integers. For conversion specifiers
%o,
%u,
%x,
%X, data is read as 64-bit unsigned integers.
LIMITATIONS¶
No native support for printing complex data is provided. This may be worked
around by using
dirfile(5) representation suffixes. For example, the command
- $ dirfile2ascii DIRFILE FIELD.r
FIELD.i
will print the real and imaginary parts of the complex valued field
FIELD
in the first and second columns, respectively.
SEE ALSO¶
dirfile(5),
printf(3)