1Fsdb::Filter::dbcolscorUrseelratCeo(n3t)ributed Perl DocFusmdebn:t:aFtiilotner::dbcolscorrelate(3)
2
3
4

NAME

6       dbcolscorrelate - find the coefficient of correlation over columns
7

SYNOPSIS

9           dbcolscorrelate column1 column2 [column3...]
10

DESCRIPTION

12       Compute the coefficient of correlation over two (or more) columns.
13
14       The output is one line of correlations.
15
16       With exactly two columns, a new column correlation is created.
17
18       With more than two columns, correlations are computed for each pairwise
19       combination of rows, and each output column is given a name which is
20       the concatenation of the two source rows, joined with an underscore.
21
22       By default, we compute the population correlation coefficient (usually
23       designed rho, ρ) and assume we see all members of the population.  With
24       the --sample option we instead compute the sample correlation
25       coefficient, usually designated r.  (Be careful in that the default
26       here to full-population is the opposite of the default in dbcolstats.)
27
28       This program requires a complete copy of the input data on disk.
29

OPTIONS

31       --sample
32           Select a the Pearson product-moment correlation coefficient (the
33           "sample correlation coefficient", usually designated r).
34
35       --nosample
36           Select a the Pearson product-moment correlation coefficient (the
37           "sample correlation coefficient", usually designated r).
38
39       -f FORMAT or --format FORMAT
40           Specify a printf(3)-style format for output statistics.  Defaults
41           to "%.5g".
42
43       -T TmpDir
44           where to put tmp files.  Also uses environment variable TMPDIR, if
45           -T is not specified.  Default is /tmp.
46
47       This module also supports the standard fsdb options:
48
49       -d  Enable debugging output.
50
51       -i or --input InputSource
52           Read from InputSource, typically a file name, or "-" for standard
53           input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue
54           objects.
55
56       -o or --output OutputDestination
57           Write to OutputDestination, typically a file name, or "-" for
58           standard output, or (if in Perl) a IO::Handle, Fsdb::IO or
59           Fsdb::BoundedQueue objects.
60
61       --autorun or --noautorun
62           By default, programs process automatically, but Fsdb::Filter
63           objects in Perl do not run until you invoke the run() method.  The
64           "--(no)autorun" option controls that behavior within Perl.
65
66       --help
67           Show help.
68
69       --man
70           Show full manual.
71

SAMPLE USAGE

73   Input:
74           #fsdb name id test1 test2
75           a 1 80 81
76           b 2 70 71
77           c 3 65 66
78           d 4 90 91
79           e 5 70 71
80           f 6 90 91
81
82   Command:
83           cat DATA/more_grades.fsdb | dbcolscorrelate test1 test2
84
85   Output:
86           #fsdb correlation:d
87           0.83329
88           #  | dbcolscorrelate test1 test2
89

SEE ALSO

91       Fsdb, dbcolstatscores, dbcolsregression, dbrvstatdiff.
92

CLASS FUNCTIONS

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

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