GBQUANT(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

💖 GBQUANT 💖

okay bestie, listen up — this is gbquant from the User Commands corner of the manual-verse, and she is that girl for anything quantile-shaped. 🎀

✨ NAME ✨

gbquant — print quantiles of data distribution. that's it, that's the whole job, and she does it gorgeously. 💅

🌸 SYNOPSIS 🌸

gbquant [options]

no filenames, no positional drama — just vibes and flags. ✨

🦋 DESCRIPTION 🦋

okay so, gbquant prints distribution quantiles. the data comes in through standard input — she reads from stdin, periodt.

if you don't hand her any -x or -q options, she just plots a quantiles table for you. iconic default behaviour, honestly.

how many quantiles are in that table? that's your call — set it with -n.

now the main character options:

  • -x #1 prints the quantile (interpolated) associated with the value #1
  • -q #2 prints the value (interpolated) associated with the quantile #2

and like, obviously #2 has to be between 0 and 1 — it's a quantile, bestie, that's the whole range. 🫶

you can pass multiple values to -x or -q, separated with commas. go off.

with -w #1,#2 she prints all the observations inside the quantile range [#1,#2) — note that bracket situation, it's closed on the left, open on the right, no cap. 🙈

if you gave her more than one column with the -t option, the specified action gets repeated on each column. without -t, columns get pooled — unless -w is specified, in which case all rows whose first element is inside the range get printed. little plot twist, but we move. 💀

want a different column for sorting? that's -W. and if you set it to 0, the cut is applied with respect to all columns. slay.

and with -Q, each entry gets replaced with the quantile range it belongs to — with respect to the distribution obtained from the entries in its column. very "know your place in the distribution" of her. 👑

💅 OPTIONS 💅

  • -n — number of quantiles to print (default 10)
  • -x — print the quantile (interpolated) associated with the value
  • -q — print the value (interpolated) associated with the quantile
  • -e — print the (asymptotic) error for -x or -q; doesn't work with -t 🚫
  • -Q — replace each element with the quantile range it belongs to
  • -w — print observations inside a quantile windows
  • -W — set the column to use (default 1)
  • -t — consider separately each column of input
  • -F — specify the input fields separators (default " \t")
  • -h — this help
  • -v — verbose mode

🌈 EXAMPLES 🌈

the "cut the middle, keep the middle" move:

gbquant -W 0 -w 0.1,0.9 < file
print the rows whose fields are all in the center deciles. 🎯

and the classic "just gimme the middle number" serve:

gbquant -q 0.5 < file
print the median of the observations in 'file'. 💖

👑 AUTHOR 👑

Written by Giulio Bottazzi. legend behaviour.

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it to <gbutils@googlegroups.com>. they wanna hear it fr fr.

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.

no warranty bestie, she's doing her best and that's the legal situation. 😭

and that's the whole page!! this was gbquant 6.1 from March 2019 — same manual section GBQUANT(1) as always. go forth and quantile, queen. ✨🦋💖

📦 where this page comes from