1Fsdb::Filter::dbrowdiffU(s3e)r Contributed Perl DocumentaFtsidobn::Filter::dbrowdiff(3)
2
3
4

NAME

6       dbrowdiff - compute row-by-row differences of some column
7

SYNOPSIS

9       dbrowdiff [-B|-I] column
10

DESCRIPTION

12       For a given column, compute the differences between each row of the
13       table.  Differences are output to two new columns, "absdiff" and
14       "pctdiff".
15
16       Differences are either relative to the previous column (incremental
17       mode), or relative to the first row (baseline mode), the default.
18

OPTIONS

20       -B or --baseline
21           Select baseline mode (the default), where differences are relative
22           to the first row.
23
24       -I or --incremental
25           Select incremental mode, where differences are relative to the
26           previous row.
27
28       -f FORMAT or --format FORMAT
29           Specify a printf(3)-style format for output statistics.  Defaults
30           to "%.5g".
31
32       This module also supports the standard fsdb options:
33
34       -d  Enable debugging output.
35
36       -i or --input InputSource
37           Read from InputSource, typically a file name, or "-" for standard
38           input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
39           objects.
40
41       -o or --output OutputDestination
42           Write to OutputDestination, typically a file name, or "-" for
43           standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
44           Fsdb::BoundedQueue objects.
45
46       --autorun or --noautorun
47           By default, programs process automatically, but Fsdb::Filter
48           objects in Perl do not run until you invoke the run() method.  The
49           "--(no)autorun" option controls that behavior within Perl.
50
51       --help
52           Show help.
53
54       --man
55           Show full manual.
56

SAMPLE USAGE

58   Input:
59           #fsdb      event   clock:d
60           _null_getpage+128       815812813.281756
61           _null_getpage+128       815812813.328709
62           _null_getpage+128       815812813.353830
63           _null_getpage+128       815812813.357169
64           _null_getpage+128       815812813.375844
65           _null_getpage+128       815812813.378358
66           #  | /home/johnh/BIN/DB/dbrow
67           #  | /home/johnh/BIN/DB/dbcol event clock
68
69   Command:
70           cat DATA/kitrace.fsdb | dbrowdiff clock
71
72   Output:
73           #fsdb      event   clock:d   absdiff:d pctdiff:d
74           _null_getpage+128       815812813.281756        0       0
75           _null_getpage+128       815812813.328709        0.046953        5.7554e-09
76           _null_getpage+128       815812813.353830        0.072074        8.8346e-09
77           _null_getpage+128       815812813.357169        0.075413        9.2439e-09
78           _null_getpage+128       815812813.375844        0.094088        1.1533e-08
79           _null_getpage+128       815812813.378358        0.096602        1.1841e-08
80           #  | /home/johnh/BIN/DB/dbrow
81           #  | /home/johnh/BIN/DB/dbcol event clock
82           #  | dbrowdiff clock
83

SEE ALSO

85       Fsdb.  dbcolmovingstats.  dbrowuniq.  dbfilediff.
86
87       dbrowdiff, dbrowuniq, and dbfilediff are similar but different.
88       dbrowdiff computes row-by-row differences for a column, dbrowuniq
89       eliminates rows that have no differences, and dbfilediff compares
90       fields of two files.
91

CLASS FUNCTIONS

93   new
94           $filter = new Fsdb::Filter::dbrowdiff(@arguments);
95
96       Create a new dbrowdiff object, taking command-line arguments.
97
98   set_defaults
99           $filter->set_defaults();
100
101       Internal: set up defaults.
102
103   parse_options
104           $filter->parse_options(@ARGV);
105
106       Internal: parse command-line arguments.
107
108   setup
109           $filter->setup();
110
111       Internal: setup, parse headers.
112
113   run
114           $filter->run();
115
116       Internal: run over each rows.
117

119       Copyright (C) 1991-2022 by John Heidemann <johnh@isi.edu>
120
121       This program is distributed under terms of the GNU general public
122       license, version 2.  See the file COPYING with the distribution for
123       details.
124
125
126
127perl v5.36.0                      2023-01-20        Fsdb::Filter::dbrowdiff(3)
Impressum