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 compression. 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 prefixes may be specified. If no name prefix is given, all vec- tors will be extracted. A "!" in front of the name turns vector splitting 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 gen- erated for the name part, with the corresponding number in ta- ble column "Split". Example: Vectors "Throughput 1", ..., "Throughput 9" will be written into output table as vector col- umn "Throughput", the number will be in table column "Split". --split is a global option and applies to all vector name pre- fixes 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 Threshold <assoc>:<path>" and "Congestion Window <assoc>:<path>", con- tained with a lot of other vectors in the BZip2-compressed vector file results.vec.bz2. ExtractVectors can be used to extract all vectors be- ginning 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 vec- tor 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.0.quarterly>