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