combinesummaries(1)

📦
version 1.9.6 · 3 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 combinesummaries — the Scalar Summary Combination Tool 💅

okay bestie, gather round, because this little icon is called combinesummaries and it is a Scalar Summary Combination Tool. she's a General Commands Manual girlie, she lives in section 1, and she is about to make your life so much easier. 🫶

✨ SYNOPSIS ✨

combinesummaries [Output File] [Var Names] -quiet

that's the whole vibe check. Output File, Var Names, and -quiet if you're feeling quiet. 💖

🦋 DESCRIPTION 🦋

so here's the tea ☕ — combinesummaries is a combination tool for GNU R data files. what does that mean? it means she takes a whole bunch of input files and smushes them together into a single data table. one table. one destiny. main character energy fr fr. ✨

and the best part? CombineSummaries supports on-the-fly BZip2 compression. no cap. she just does that. 🎀

okay but here's the thing you HAVE to know, and I need you to hear me on this one: after startup, the program accepts the following commands from standard input — and that is not as command-line arguments! like, do not try to pass these on the command line, bestie, I am begging. 🙈 stdin only. periodt.

  • --values=Values — sets the values of the output variables for the next input file to the provided space-separated values. and yes, you have to give one value for each variable. no skipping, no shortcuts, all the variables get a value. 💅
  • --input=Filename — processes the given input file. that's it, that's the whole job. feed her a file. 🍓
  • --simulationdirectory=Directory — sets the directory where to find the input files. so if your files are living somewhere else, this is how you tell her where to look. 🧚

💜 ARGUMENTS 💜

these are the ones you do pass the normal way. the following arguments may be provided:

  • Output File — the name of the output file to be created. she's gonna make this file. name it, and she'll birth it. 👑
  • Var Names — a space-separated list of output variable names to be added to the output data tables. so like, the column names you want. space-separated, bestie, not commas. 🌈
  • -quiet — do not print verbose status information. she'll shut up and just work. sometimes that's the energy you need. ⭐

🔥 EXAMPLE 🔥

okay so picture this: you've got two data tables — v1.data.bz2 (created with ParameterY=Alpha) and v2.data.bz2 (created with ParameterY=Beta). and the output data table? that should be written to output.data.bz2. cute, right? watch her work:

( echo "--values=\"Alpha\""   && \
  echo "--input=v1.data.bz2"  && \
  echo "--values=\"Beta\""    && \
  echo "--input=v2.data.bz2" ) | combinesummaries output.data.bz2
"ParameterY"

see how the --values and --input commands get piped in through stdin? exactly like we said. that's the whole trick, iykyk. 💖 and the "ParameterY" on the end there is your Var Names argument, so the output table knows what to call that column. ate. 🔥

👑 AUTHORS 👑

and that's the page, bestie!! this was CombineSummaries, dated June 27, 2010, and honestly she's still serving. go combine some summaries. slay. 💅✨🎀

📦 where this page comes from