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

FreeBSD Manual Pages

  
 
  

home | help
createsummary(1)	  BSD General Commands Manual	      createsummary(1)

NAME
     createsummary -- Scalar File Summarization	Tool

SYNOPSIS
     createsummary [Var	Names] -batch -interactive -compress=Level
		   -ignore-scalar-file-errors

DESCRIPTION
     createsummary is a	summarization tool for scalar files: it	creates	one
     GNU R data	table file for each scalar. CreateSummary supports on-the-fly
     BZip2 compression.	After startup, the program accepts the following com-
     mands 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 scalar	file
	    to the provided space-separated values. One	value for each vari-
	    able has to	be provided.

     --logfile=Name
	    Sets the log file for the next scalar file.	On an error related to
	    this scalar	file, the log file's name is displayed.	This option
	    can	be used	to identify bad	simulation/measurement runs by point-
	    ing	to the log file	being created for the simulation/measurement.

     --statusfile=Name
	    Sets the status file for the next scalar file. On an error related
	    to this scalar file, the status file is deleted. This option can
	    be used to repeat bad simulation/measurement runs by re-running
	    the	simulation/measurement on missing status files.

     --input=Filename
	    Process the	given scalar file.

     --skip=Prefix
	    All	scalars	beginning with the given prefix	are not	written	to
	    output tables.  This option	can be used to filter out unneeded re-
	    sults.

     --simulationdirectory=Directory
	    Sets the directory where to	find the scalar	files.

     --resultsdirectory=Directory
	    Sets the directory where to	write the summary tables to.

     --ignore-scalar-file-errors
	    Ignore skalar file erros (that is, missing input files) instead of
	    aborting.

ARGUMENTS
     The following arguments may be provided:

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

     -batch  Run in batch mode.	The program is aborted on errors.

     -interactive
	     Run in interactive	mode. On errors, the program is	continued.

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

     -ignore-scalar-file-errors
	     Ignore skalar file	erros (that is,	missing	input files) instead
	     of	aborting.

EXAMPLE
     Consider two simulation results test1.sca.bz2 (created with Parame-
     terX=One) and test2.sca.bz2 (created with ParameterX=Two).	The scalar
     files are located in the current directory, the output tables should be
     written to	/tmp with compression level 5:
     ( echo "--simulationsdirectory=."	&& \
       echo "--resultsdirectory=/tmp"	&& \
       echo "--values=One"		&& \
       echo "--input=test1.sca.bz2"	&& \
       echo "--values=Two"		&& \
       echo "--input=test2.sca.bz2" ) |	createsummary "ParameterX" -compress=5

AUTHORS
     Thomas Dreibholz
     http://www.iem.uni-due.de/~dreibh/netperfmeter
     mailto://dreibh@iem.uni-due.de

CreateSummary			October	1, 2014			 CreateSummary

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | EXAMPLE | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=createsummary&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help