GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
createsummary(1) FreeBSD General Commands Manual createsummary(1)

createsummary
Scalar File Summarization Tool

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

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 variable 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 pointing 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 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.

The following arguments may be provided:
Var Names
A space-separated list of output variable names to be added to the output data tables.
Run in batch mode. The program is aborted on errors.
Run in interactive mode. On errors, the program is continued.
Sets the BZip2 compression level; 1=none, 9=highest (default).
Ignore skalar file erros (that is, missing input files) instead of aborting.

Consider two simulation results test1.sca.bz2 (created with ParameterX=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

Thomas Dreibholz
https://www.uni-due.de/~be0001/netperfmeter
mailto://dreibh@iem.uni-due.de
October 1, 2014 CreateSummary

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.