GBTEST(1)

πŸ“¦
version 6.3 Β· 2 versions
  • 6.3 Β· debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 6.0 Β· ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– GBTEST πŸ’–

okay bestie, welcome to gbtest β€” it lives in the User Commands section of the manual (that's section 1, iykyk) and it is literally your girl for computing statistical tests on data. no cap.


✨ NAME ✨

gbtest β€” compute statistical tests on data πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

gbtest [options] <tests list>

🌸 DESCRIPTION 🌸

So the whole vibe is: compute statistical tests on data. Every test gets its own unique name, and then any optional params you wanna give it just trail along after, separated by commas. cute, right?

Depending on which test you pick, it wants one, two, or three columns of data. here's the tea:

  • 1 dist tests want data in [0,1] from a distribution function.
  • 1 sample tests want a single column.
  • tests on pairs want two columns of equal length.
  • tests on 2 samples want two columns of data, and honestly they can be different lengths, we don't judge.
  • tests on 2+ and 3+ samples expect a varying number of columns.

and if you hand over more columns than the test strictly needs? it just runs it again:

  • for a 1 sample test β†’ repeated for any column
  • for a 2 sample test β†’ repeated for any <em>couple</em> of columns

and in that last case the output comes out in matrix format, with the estimated statistics chilling on the lower triangle and the p-scores (if you asked for them) up on the upper. iconic layout, honestly.

removing nan entries? automatic ✨ and it's done consistently with the nature of the test, because of course it is.


🧚 the tests 🧚

tests typically assume 1, 2, or 3+ samples. here's the full roster, no skips:

  • D+, D-, D, V β€” 1 dist β€” Kolmogorov-Smirnov tests on cumulated data
  • W2, A2, U2 β€” 1 dist β€” Cramer-von Mises tests on cumulated data
  • CHI2-1 β€” 1 samp β€” Chi-Sqrd, 1 samp. 2nd column: th. prob.
  • WILCO β€” 1 samp β€” Wilcoxon signed-rank test (mode=0)
  • TS β€” 1 samp β€” Student's T (mean=0)
  • TR-TP β€” 1 samp β€” Test of randomness: turning points
  • TR-DS β€” 1 samp β€” Test of randomness: difference sign
  • TR-RT β€” 1 samp β€” Test of randomness: rank test
  • R β€” pairs β€” Pearson's correlation coefficient
  • RHO β€” pairs β€” Spearman's Rho rank correlation
  • TAU β€” pairs β€” Kendall's Tau correlation
  • CHI2-2 β€” pairs β€” Chi-Sqrd, 2 samples
  • TP β€” pairs β€” Student's T with paired samples
  • WILCO2 β€” pairs β€” Wilcoxon test on paired samples
  • KS β€” 2 samp β€” Kolmogorov-Smirnov test
  • T β€” 2 samp β€” Student's T with same variances
  • TH β€” 2 samp β€” Student's T with different variances
  • F β€” 2 samp β€” F-Test for different variances
  • WMW β€” 2 samp β€” Wilcoxon-Mann-Whitney U
  • FP β€” 2 samp β€” Fligner-Policello standardized U^
  • LEV-MEAN β€” 2+ samp β€” Levene equality of variances using means
  • LEV-MED β€” 2+ samp β€” Levene equality of variances using medians
  • KW β€” 3+ samp β€” Kruscal-Wallis test on 3+ samples
  • CHI2-N β€” 3+ samp β€” Multi-columns contingency table analysis

πŸ’… OPTIONS πŸ’…

the flags, bestie. all of them. not one skipped 🫢

  • -p β€” compute associated significance
  • -s β€” input data are already sorted in ascending order
  • -F β€” specify the input fields separators (default " \t")
  • -o β€” set the output format (default '%12.6e')
  • -v β€” verbosity: 0 none, 1 headings, 2+ description (default 0)
  • -h β€” this help

🌈 EXAMPLES 🌈

fr fr, here's how it looks in the wild:

gbtest FP < file

compute the Fligner-Policello test on the columns of file, considering all possible pairings. every single one. she's thorough πŸ’…

gbtest KW -p < file

compute the Kruscal-Wallis test and its p-score on the first three columns of data in file. three columns, that's the assignment, periodt ✨


πŸ‘‘ AUTHOR πŸ‘‘

Written by Giulio Bottazzi πŸŽ€


😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, report it to:

<gbutils@googlegroups.com>

Package home page: <http://cafim.sssup.it/~giulio/software/gbutils/index.html>


Copyright Β© 2001-2018 Giulio Bottazzi This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License (version 2) as published by the Free Software Foundation;

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

okay bestie real talk for one sec: that all-caps warranty disclaimer is not a vibe, it's a legal thing and it means what it says. no promises, no guarantees. πŸ’€

and that's the whole page, you ate it πŸ’– this was gbtest version 6.3, from March 2022, living its best life in the User Commands section as GBTEST(1). go run some tests, queen πŸŒˆβ­πŸ¦‹