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.

AUTHOR¶

dirfile2ascii was written by Matthew Truch and D. V. Wiebe.

REPORTING BUGS¶

Please send reports of bugs to getdata-devel@lists.sourceforge.net

The GetData home page: <http://getdata.sourceforge.net/>

COPYRIGHT¶

Copyright © 2010 Matthew Truch.

dirfile2ascii is licenced under the GNU LPGL version 2.1 or later.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO¶

defile(1), dirfile(5), printf(3)