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

🌸 GBRAND — like, the manual page, but make it make sense 💖

ok bestie, sit down, hydrate, because we're about to talk about gbrand, a real one from the User Commands section. This is gbrand(1) and she is serving random numbers. 🎲✨

✨ NAME ✨

gbrand — sampling from random distributions. that's it. that's the whole vibe. 🦋

🎀 SYNOPSIS 🎀

gbrand [options] NAME PARAMETERS...

💅 DESCRIPTION 💅

So what does she do, you ask? She generates a grid of i.i.d. samples from a distribution. Iconic behavior, honestly. 🔥

The name of the distribution and its parameters? You just say them right there on the command line. No config file, no ceremony, no "have you tried reading the docs" energy. Just vibes and parameters. 💖

Also, the page says this, and I'm quoting it exactly because I refuse to gatekeep information:

the column index. Indeces start from 1.

(not me wondering which column 😭 but okay bestie, it's in there, it's canon, we move on. Also yes, it's spelled "Indeces" in the original and I am not fixing it, that's not my job, my job is vibes.)

And if you pass more than one function? they get printed one after the other. No drama, no merge, just a little parade of numbers. 🎀

Now, the type of random number generator and the default seed can be set with the environment variables GSL_RNG_TYPE and GSL_RNG_SEED, respectively — as documented in the GSL manual. 📚 (iykyk)

✨ OPTIONS ✨

short flags, big energy:

  • -r — specify number of rows (default 1) 🍓
  • -c — specify number of columns (default 1) 🍓
  • -R — set the seed (default 1) 🎲
  • -v — verbose mode (she talks more, we love that) 🗣️
  • -h — this help. the classic. the goat. 👑

🌈 List of valid distributions (with parameters): 🌈

ok this is the main character section, the whole reason we're here, and I am listing every single one because skipping options is not the move. no cap. 💜

  • beta — a, b = shape parameters
  • binomial — p = probability, N = number of trials
  • bivariate-gaussian — sigmax = x std.dev., sigmay = y std.dev., rho = correlation
  • cauchy — a = scale parameter
  • chisq — nu = degrees of freedom
  • dir-2d — none
  • dir-3d — none
  • dir-nd — n1 = number of dimensions of hypersphere
  • erlang — a = scale parameter, b = order
  • exponential — mu = mean value
  • exppow — a = scale parameter, b = power (1=exponential, 2=gaussian)
  • aexppow — m = mode, al = left scale, ar = right scale, bl = left shape, br = right shape
  • fdist — nu1, nu2 = degrees of freedom parameters
  • flat — a = lower limit, b = upper limit
  • gamma — a = order, b = scale
  • gaussian-tail — a = lower limit, sigma = standard deviation
  • gaussian — sigma = standard deviation
  • geometric — p = bernoulli trial probability of success
  • gumbel1 — a = order, b = scale parameter
  • gumbel2 — a = order, b = scale parameter
  • hypergeometric — n1 = # tagged, n2 = # untagged, t = number of trials
  • laplace — a = scale parameter
  • landau — none
  • levy — c = scale, a = power (1=cauchy, 2=gaussian)
  • levy-skew — c = scale, a = power (1=cauchy, 2=gaussian), b = skew
  • logarithmic — p = probability
  • logistic — a = scale parameter
  • lognormal — zeta = location parameter, sigma = scale parameter
  • negative-binomial — p = probability, a = order
  • pareto — a = power, b = scale parameter
  • pascal — p = probability, n = order (integer)
  • poisson — mu = scale parameter
  • rayleigh-tail — a = lower limit, sigma = scale parameter
  • rayleigh — sigma = scale parameter
  • tdist — nu = degrees of freedom
  • ugaussian-tail — a = lower limit
  • ugaussian — none
  • weibull — a = scale parameter, b = exponent
  • pareto3 — a = power, b = exponential parameter, s = scale parameter

forty-ish distributions and every single one got her moment. ate. 👑

🔥 EXAMPLES 🔥

bestie, examples are where it clicks. watch:

gbrand -c 2 -r 100 gaussian 2.5

generate two columns of 100 rows each sampling from a Gaussian distribution with mean 0 and standard deviation 2.5. so 2 columns, 100 rows, gaussian, sigma of 2.5. slay. ✨

gbrand -R 145 -r 1000 exponential 1

one hundredth exponantial variates with parameters 1, the the seed of the RNG is set to 145. 🎲 (and yes, "exponantial" and "the the" are literally what the page says, I'm not touching them, they're part of the lore now 💀)

gbrand -r 10 flat 3 4

ten realizations of the r.v. uniformly distributed in [3,4]. cute, tidy, flat. 🍓

🫶 AUTHOR 🫶

Written by Giulio Bottazzi. thank you king. 👑

😭 REPORTING BUGS 😭

Found a bug? Don't suffer in silence, bestie, that's not the vibe.

Report bugs 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. ⚠️

(no warranty bestie, she's free and she's honest about it 💅)

🦋 SEE ALSO 🦋

hmm, the original doesn't list any SEE ALSO references. so there's nothing to cross-reference here, and I'm not about to invent one — that would be lying and lying is not the vibe. 🙈

ok that's the whole page, you made it, I'm so proud of you. 🌈 go forth and sample some distributions, you absolute icon. 🧚

this was gbrand 6.2, and the page is dated June 2021 💖

📦 where this page comes from