DBCOLSCORRELATE(1)

💖 dbcolscorrelate(1) — find the coefficient of correlation over columns 💖

okay bestie, welcome to the dbcolscorrelate(1) manual from the User Contributed Perl Documentation crew ✨ this is the correlation girlie, and we're gonna make it make sense. 💅

🌸 NAME 🌸

dbcolscorrelate — find the coefficient of correlation over columns 🎀

🦋 SYNOPSIS 🦋

dbcolscorrelate column1 column2 [column3...]

✨ DESCRIPTION ✨

So like, this computes the Pearson coefficient of correlation over two (or more) columns. Iconic. 💖

The output is literally one line of correlations.

With exactly two columns, a new column correlation is created. slay.

With more than two columns, correlations are computed for each pairwise combination of rows, and each output column gets a name that's the concatenation of the two source rows, joined with an underscore. periodt.

By default, we compute the population correlation coefficient (usually designated rho, ρ) and assume we see all members of the population. With the --sample option we instead compute the sample correlation coefficient, usually designated r. 🫶

⚠️ Careful, bestie: the default here is full-population, and that is the opposite of the default in dbcolstats. not me warning you twice 👀

🧚 Heads up: this program requires a complete copy of the input data on disk.

💅 OPTIONS 💅

• --sample — selects the sample Pearson product-moment correlation coefficient (the “sample correlation coefficient”, usually designated r). 🍓
• --no-sample — selects the Pearson product-moment correlation coefficient (the “correlation coefficient”, usually designated ρ). 🌈
• --weight COL — weights the correlation by column COL.
• -f FORMAT or --format FORMAT — gives a printf(3)-style format for output statistics. Defaults to "%.5g". ✨
• -T TmpDir — where to put tmp files. Also uses environment variable TMPDIR, if -T is not specified. Default is /tmp. 🎀

This module also supports the standard fsdb options:

• -d — enable debugging output.
• -i or --input InputSource — read from InputSource, typically a file name, or "-" for standard input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects.
• -o or --output OutputDestination — write to OutputDestination, typically a file name, or "-" for standard output, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects.
• --autorun or --noautorun — by default, programs process automatically, but Fsdb::Filter objects in Perl do not run until you invoke the run() method. The "--(no)autorun" option controls that behavior within Perl.
• --help — show help.
• --man — show full manual.

🍓 SAMPLE USAGE 🍓

🌈 Input:

#fsdb i_x i_y
10.0   8.04
8.0    6.95
13.0   7.58
9.0    8.81
11.0   8.33
14.0   9.96
6.0    7.24
4.0    4.26
12.0  10.84
7.0    4.82
5.0    5.68

🌟 Command:

cat TEST/anscombe_quartet.in | dbcolscorrelate i_x i_y

💫 Output:

#fsdb correlation:d
0.81642
#  | dbcolscorrelate i_x i_y

🔥 SEE ALSO 🔥

go peek at these too, bestie:

• Fsdb
• dbcolstatscores
• dbcolsregression
• dbrvstatdiff

👑 AUTHOR and COPYRIGHT 👑

Copyright (C) 1998-2024 by John Heidemann <johnh@isi.edu> 💌

This program is distributed under terms of the GNU general public license, version 2. See the file COPYING with the distribution for details.

---

made with 💖 by the manual fairy — perl v5.32.1, dated 2024-08-02 — mwah! 🫶