STILTS-CALC(1)

✨ STILTS-CALC ✨ (that's stilts-calc from section 1 of the manual, bestie 🫢)

okay so literally picture this: you just want to know what an expression evaluates to, and you don't wanna spin up a whole table pipeline for it. boom. that's stilts-calc. it's a little cutie with a calculator brain and zero drama.


🌸 NAME 🌸

stilts-calc β€” it evaluates expressions πŸ’… that's it that's the job


πŸŽ€ SYNOPSIS πŸŽ€

stilts calc [expression=<expr>] [table=<table>]

πŸ¦‹ DESCRIPTION πŸ¦‹

so calc is a very simple utility for evaluating expressions. like, uncomplicated on purpose. it runs on the exact same expression evaluator that tpipe and the other generic table tasks use when they're doing stuff like creating new columns. which is honestly iconic, because it means you can use calc as a quick little test to see what expressions actually work πŸ‘‘

you can also just use it to evaluate expressions with all the various algebraic functions documented over in SUN/256. those functions? all yours. go wild.

here's the one thing to keep in your notes app though: since usually no table is involved, you can't refer to column names in the expressions. no table, no columns, no cap. 🚫

it's got one mandatory parameter β€” the expression to evaluate β€” and it writes the result straight to the screen. instant gratification fr fr.


🌈 OPTIONS 🌈

  • expression=<expr> β€” an expression to evaluate. the functions in SUN/256 can be used here, every single one of them. this is the mandatory one, don't skip it bestie.
  • table=<table> β€” a table that provides the context within which expression is evaluated. this parameter is optional, and usually you won't need it at all. its only purpose is to let you use constant expressions (aka table parameters) that are associated with the table. you reference those using identifiers of the form param$*, ucd$* or utype$* β€” see SUN/256 for more detail. that's the whole vibe of this flag, it's very much a niche queen. πŸ‘‘

πŸ’– SEE ALSO πŸ’–

if the package stilts-doc is installed, the full documentation SUN/256 is available in HTML format:

file:///usr/share/doc/stilts/sun256/index.html

πŸ’€ VERSION πŸ’€

STILTS version 3.5.4-debian

heads up: this is the Debian version of Stilts, which lack the support of some file formats and network protocols 😭 (yes, it really says "lack", we're keeping it, we don't edit the source material). for differences see:

file:///usr/share/doc/stilts/README.Debian

🧚 AUTHOR 🧚

Mark Taylor (Bristol University) β€” the icon, the legend, the moment 🫢


ok that's the whole page bestie, every flag, every path, every caveat, all of it. nothing skipped, nothing invented. periodt. πŸ’…

signing off with all the love: this is the Debian Stilts STILTS version 3.5.4-debian, and the page itself is dated Mar 2017. slay. πŸŽ€βœ¨

πŸ“¦ where this page comes from