Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
combinesummaries(1)	    General Commands Manual	   combinesummaries(1)

NAME
       combinesummaries	-- Scalar Summary Combination Tool

SYNOPSIS
       combinesummaries	output_file [variable_names]
			[-c level | --compress level]
			[-s separator |	--separator separator]
			[-n | --line-numbers]
			[-q | --quiet]
       combinesummaries	[-h | --help]
       combinesummaries	[-v | --version]

DESCRIPTION
       combinesummaries	 is  a	combination  tool for CSV/GNU R	data files: it
       creates a single	data table from	multiple input files. CombineSummaries
       supports	on-the-fly BZip2 compression. After startup, the  program  ac-
       cepts the following commands from standard input	(*not* as command-line
       arguments!):

       --varnames=variables
	      A	 space-separated  list of output variable names	to be added to
	      the output data tables.

       --values=values
	      Sets the values of the output variables for the next input  file
	      to the provided space-separated values. One value	for each vari-
	      able has to be provided.

       --input=filename
	      Process the given	input file.

       --simulationdirectory=directory
	      Sets the directory where to find the input files.

ARGUMENTS
       The following arguments may be provided:

       output_file
	       The name	of the output file to be created.

       variable_names
	       A  space-separated list of output variable names	to be added to
	       the output data tables.

       -c level	| --compress level
	       Sets the	BZip2 compression level; 1=none, 9=highest (default).

       -s separator | --separator separator
	       Sets the	separator for the tables. Default: tabulator character
	       (i.e. $'').

       -n | --line-numbers
	       Generate	line numbers for output	rows (GNU R:  row  names).  In
	       this  case,  the	 input files must contain line numbers (GNU R:
	       row names) as well! The original	line numbers are kept in  col-
	       umn SubLineNo. Default: off.

       -quiet  Do not print verbose status information.

EXAMPLE
       Consider	 two  data tables: v1.data.bz2 (created	with ParameterY=Alpha)
       and v2.data.bz2 (created	with ParameterY=Beta).	The output data	 table
       should be written to output.data.bz2.
       ( echo -e "--values=\"Alpha\"\t\"Test 1\"" && \
	 echo "--input=v1.data.bz2"		  && \
	 echo -e "--values=\"Beta\"\t\"Test 2\""  && \
	 echo "--input=v2.data.bz2" ) |	combinesummaries output.data.bz2 $'Pa-
       rameterX\tParameterY'

AUTHORS
       Thomas Dreibholz
       https://www.nntb.no/~dreibh/netperfmeter
       mailto://dreibh@simula.no

CombineSummaries	       November	11, 2025	   combinesummaries(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=combinesummaries&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help