FreeBSD Manual Pages
createsummary(1) 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 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 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 op- tion can be used to identify bad simulation/measurement runs by pointing to the log file being created for the simulation/mea- surement. --statusfile=Name Sets the status file for the next scalar file. On an error re- lated to this scalar file, the status file is deleted. This op- tion 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 results. --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" -com- press=5 AUTHORS Thomas Dreibholz https://www.nntb.no/~dreibh/netperfmeter mailto://thomas.dreibholz@gmail.com CreateSummary October 1, 2014 createsummary(1)
NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | EXAMPLE | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=createsummary&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>