1DBROWDIFF(1)          User Contributed Perl Documentation         DBROWDIFF(1)
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
93       Copyright (C) 1991-2022 by John Heidemann <johnh@isi.edu>
94
95       This program is distributed under terms of the GNU general public
96       license, version 2.  See the file COPYING with the distribution for
97       details.
98
99
100
101perl v5.36.0                      2022-11-22                      DBROWDIFF(1)
Impressum