dirfile2ascii(1)

1dirfile2ascii(1)                    GETDATA                   dirfile2ascii(1)
2
3
4

NAME

6       dirfile2ascii — output dirfile database vectors as ASCII text
7

SYNOPSIS

9       dirfile2ascii [ OPTION ]... DIRFILE [ [ -a | -A | -e | -E | -F | -g |
10              -G | -o | -i | -u | -x | -X ] FIELD ]...
11

DESCRIPTION

13       Fetches data from a dirfile(5) database specified by DIRFILE and writes
14       it  as  ASCII  to  standard output.  Any number of vector FIELDs may be
15       specified.  Each specified field is printed in a separate column.
16
17       Mandatory arguments to long options are  mandatory  for  short  options
18       too.
19
20       -d, --delimeter=delim
21              separate columns by delim.  (Default: a single space.)
22
23       -f, --first-frame=first_frame-last_frame
24              read from frame first_frame to frame last_frame (inclusive).
25
26       -f, --first-frame=first_frame:nframes
27              equivalent to --first-frame=first_frame --num-frames=nframes.
28
29       -f, --first-frame=first_frame
30              If  first_frame  >=  0,  start reading at frame first_frame.  If
31              first_frame is -1 and --num-frames=nframes  is  specified,  read
32              the  last  nframes  frames.   If --first-frame is not specified,
33              reading starts at frame zero.
34
35       -n, --num-frames=nframes
36              read  at  most  nframes  frames.   If  not  specified,   or   if
37              nframes = 0, all frames to the end-of-field are read.
38
39       -p, --precision=format
40              use format to format output.  format may contain any of the flag
41              characters, a field width, and/or a precision  as  specified  in
42              printf(3).  It may not contain a length modifier.
43
44       -q, --quiet
45              don't write diagnostic messages on standard error.  (This is the
46              default behaviour).
47
48       -s, --skip=frame_skip
49              if frame_skip > 0, output only one sample for  every  frame_skip
50              frames.
51
52       -v, --verbose
53              write diagnostic messages on standard error.
54
55       -z, --fill=STRING
56              Fill  columns which go past the end of their corresponding field
57              with the string STRING.  The default behaviour is to  fill  col‐
58              umns  with  floating-point conversions with NaN and columns with
59              integer conversion with 0, which mirrors what occurs when an at‐
60              tempt  is  made  to print data from before the start of a field.
61              (Note: the default behaviour cannot be reproduced with this  op‐
62              tion, since STRING is applied to all columns, regardless of con‐
63              version type.)
64
65       In addition to the above, each FIELD argument  may  be  preceded  by  a
66       short  option,  one of: -a, -A, -e, -E, -F, -g, -G, -i, -o, -u, -x, -X,
67       indicating the conversion to be used.  See printf(3) for the meaning of
68       these  conversion  specifiers.   The output flags, width, and precision
69       may be specified by using --precision.  If no conversion  specifier  is
70       given, %f is used.
71
72       For  conversion specifiers %a, %A, %e, %E, %f, %F, %g, %G, data is read
73       from the dirfile as double precision floats.  For conversion  specifier
74       %i,  data is read as 64-bit signed integers.  For conversion specifiers
75       %o, %u, %x, %X, data is read as 64-bit unsigned integers.
76
77

LIMITATIONS

79       No native support for printing complex data is provided.  This  may  be
80       worked  around  by using dirfile(5) representation suffixes.  For exam‐
81       ple, the command
82
83              dirfile2ascii DIRFILE FIELD.r FIELD.i
84
85       will print the real and imaginary parts of  the  complex  valued  field
86       FIELD in the first and second columns, respectively.
87
88

AUTHOR

90       dirfile2ascii was written by Matthew Truch and D. V. Wiebe.
91
92

REPORTING BUGS

94       Please send reports of bugs to getdata-devel@lists.sourceforge.net
95
96       The GetData home page: <http://getdata.sourceforge.net/>
97
98

COPYRIGHT

100       Copyright © 2010 Matthew Truch.
101
102       dirfile2ascii is licenced under the GNU LPGL version 2.1 or later.
103
104       This  is  free  software:  you  are free to change and redistribute it.
105       There is NO WARRANTY, to the extent permitted by law.
106
107