FreeBSD Manual Pages
extractvectors(1) General Commands Manual extractvectors(1) NAME extractvectors -- Vector Extraction Tool for OMNeT++ Vector Files SYNOPSIS extractvectors [input_file] [output_file] [[!]vector_name_prefix] [...] [-s | --split | -a | --no-split] [-c level | --compress level] [-q | --quiet] -quiet extractvectors [-h | --help] extractvectors [-v | --version] DESCRIPTION extractvectors is an extraction tool for vectors written by OMNeT++ to a data table. ExtractVectors supports on-the-fly BZip2 decompression and com- pression. ARGUMENTS The following arguments may be provided: input_file The name of the input vector file. output_file The name of the output data table to be created. [!]vector_name_prefix Name prefix of vectors to be extracted. Multiple vector name pre- fixes may be specified. If no name prefix is given, all vectors will be extracted. A "!" in front of the name turns vector split- ting for this prefix on (see --split option below). -s | --split Try to split the vector name ending in a number into the name part as well as the number. A vector output table is then generated for the name part, with the corresponding number in table column "Split". Example: Vectors "Throughput 1", ..., "Throughput 9" will be written into output table as vector column "Throughput", the number will be in table column "Split". --split is a global option and applies to all vector name prefixes provided. To use vector name splitting for just a single prefix, prepend the prefix with "!". -a | --no-split Turns vector splitting off (default). -c level | --compress level Sets the BZip2 compression level; 1=none, 9=highest (default). -q | --quiet Do not print verbose status information. -quiet Do not print verbose status information. EXAMPLE Consider an OMNeT++ vector file containing the vectors "Slow Start Thresh- old <assoc>:<path>" and "Congestion Window <assoc>:<path>", contained with a lot of other vectors in the BZip2-compressed vector file results.vec.bz2. ExtractVectors can be used to extract all vectors beginning with "Slow Start Threshold" or "Congestion Window" into a BZip2-compressed data table results.data.bz2 by the following command: extractvectors results.vec.bz2 results.data.bz2 \ "Slow Start Threshold" \ "Congestion Window" For each vector entry, an output line containing time (Time), event number (Event), object name (Object), vector name (Vector) and the vector value (Value) will be created. Example: Time Event Object Vector Value 0.003672 174 "net.client[0].sctp" "Slow Start Threshold 2:Total" 10000000 0.003672 174 "net.client[0].sctp" "Slow Start Threshold 2:Total" 10000000 0.003672 174 "net.client[0].sctp" "Congestion Window 2:Total" 4380 0.003672 174 "net.client[0].sctp" "Congestion Window 2:Total" 8760 0.003913 238 "net.server[0].sctp" "Slow Start Threshold 4:Total" 10000000 0.003913 238 "net.server[0].sctp" "Slow Start Threshold 4:Total" 10000000 0.003913 238 "net.server[0].sctp" "Congestion Window 4:Total" 3000 0.003913 238 "net.server[0].sctp" "Congestion Window 4:Total" 6000 AUTHORS Thomas Dreibholz https://www.nntb.no/~dreibh/omnetpp mailto://dreibh@simula.no ExtractVectors August 1, 2025 extractvectors(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=extractvectors&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>