extractvectors(1)

💖 extractvectors(1) — bestie edition 💖

General Commands Manual energy, but make it a group chat. This is extractvectors, the Vector Extraction Tool for OMNeT++ Vector Files, and she is lowkey iconic 🦋

---

✨ NAME ✨

extractvectors — Vector Extraction Tool for OMNeT++ Vector Files 🎀

---

🌸 SYNOPSIS 🌸

extractvectors [Input File] [Output File] [Vector Name Prefix] [...]
               -quiet

---

💅 DESCRIPTION 💅

Okay so picture this: extractvectors is an extraction tool for vectors written by OMNeT++ into a data table. That's the whole gig, and she does it flawlessly ✨

And here's the part that's giving main character: ExtractVectors supports on-the-fly BZip2 decompression and compression. No cap. She'll unzip and rezip as she goes, no extra steps, no drama 💖

---

🫶 ARGUMENTS 🫶

The following arguments may be provided, bestie — read them, love them, use them:

• Input File — the name of the input vector file. That's where we're reading from, periodt.
• Output File — the name of the output data table to be created. That's where the magic lands 🌈
• Vector Name Prefix — name prefix of vectors to be extracted. And yes, multiple vector name prefixes may be specified — stack them, queen 👑 If no name prefix is given, then all vectors will be extracted. Everything. The whole menu. We love a generous icon.
• -quiet — do not print verbose status information. She'll just do the job silently, like a mysterious fairy 🧚 No commentary, just results.

---

🔥 EXAMPLE 🔥

So consider an OMNeT++ vector file containing the vectors "Slow Start Threshold <assoc>:<path>" and "Congestion Window <assoc>:<path>", chilling with a lot of other vectors inside 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 with 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

Like… look at that output. She ate and left no crumbs 💀🍓

---

💜 AUTHORS 💜

• Thomas Dreibholz
• https://www.nntb.no/~dreibh/omnetpp
• mailto://thomas.dreibholz@gmail.com

---

And that's the whole page, bestie! This little beauty is ExtractVectors, dated June 27, 2010 — old enough to have a driver's license but still serving immaculate vector-extraction vibes. Go extract something gorgeous 💖✨🎀