FreeBSD Manual Pages
createsummary(1) FreeBSD 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 https://www.uni-due.de/~be0001/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.2-RELEASE+and+Ports>