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 accepts  the  fol-
     lowing 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 variable 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 column 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 $'Parame-
     terX\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.1.quarterly>

home | help