dirfile2ascii man page on OpenSuSE
[printable version]
dirfile2ascii(1) GETDATA dirfile2ascii(1)
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 col‐
umns with floating-point conversions with NaN and columns with
integer conversion with 0, which mirrors what occurs when an at‐
tempt is made to print data from before the start of a field.
(Note: the default behaviour cannot be reproduced with this op‐
tion, since STRING is applied to all columns, regardless of con‐
version 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 exam‐
ple, 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)
Version 0.8.0 21 February 2012 dirfile2ascii(1)
[top]
List of man pages available for OpenSuSE
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|