VCD2LXT2(1)

👑 NAME 👑

okay bestie, gather round 💖 this one's called vcd2lxt2 — and it's a Filetype Conversion girlie, section 1 of the manual. Her whole entire job? Turning VCD files into LXT2 files. That's it. That's the vibe. ✨

🎀 SYNTAX 🎀

vcd2lxt2 [option]... [VCDFILE] [LXTFILE]

🌸 DESCRIPTION 🌸

Converts VCD files to LXT2 files. no cap, that's literally the whole description, she's a simple queen 💅

✨ OPTIONS ✨

• -v, --vcdname <filename> — tells her which VCD file to read in. that's your input, bestie 🫶
• -l, --lxtname <filename> — names the LXT2 file she's gonna write out. your output 💖
• -d, --depth <value> — gzip compression depth, 0..9. default is 4. crank it up for more squeeze 🔥
• -m, --maxgranule <value> — how many granules fit in each section. default is 8. and just so you know, one granule is equal to 32 timsteps ⭐
• -b, --break <value> — sets the break size, and the default is 0, which means off. the tea here: once you go over the break size, the LXT2 dumper dumps all the state information at the next convenient granule plus dictionary boundary. yes that's a lot of state, she's being thorough 💀
• -p, --partialmode <mode> — partial zip mode. 0 = monolithic, 1 = separation. choosing 1 makes the LXT2 file bigger but gives you fast access for very large traces. ⚠️ and heads up: the default mode is neither monolithic nor separation — partial zip is disabled out of the box. she's just like that 🙈
• -c, --checkpoint <mode> — checkpoint mode. 0 is on, which is the default, and 1 is off. ⚠️ this gets disabled whenever the break size is active, so don't expect both at once.
• -h, --help — shows the help screen. your bestie when you forget everything 💜

🌈 EXAMPLES 🌈

okay so real quick: you should specify dumpfile.vcd directly, or use "-" for stdin. don't overthink it 🦋

vcd2lxt dumpfile.vcd dumpfile.lxt --depth 9 --break 1073741824

this sets the compression level to 9 and the break size to 1GB. big girl numbers 💅

vcd2lxt dumpfile.vcd dumpfile.lxt --depth 9 --maxgranule 256

this one allows more granules per section, which lets you get greater compression. more granules = more squeeze, periodt 🔥

😭 LIMITATIONS 😭

vcd2lxt2 does not store glitches. nope. not even a little. because those glitches get coalesced together into one single value change while the LXT2 file is being written. so if you were hoping to see every tiny flicker — she said no 💀

👑 AUTHORS 👑

Anthony Bybell <bybell@rocketmail.com> — the icon behind all of this, we stan 🫶

🧚 SEE ALSO 🧚

lxt2vcd(1), vcd2lxt2(1), gtkwave(1) — go read those too, iykyk 💜

and that's a wrap, bestie 💖 this whole page is from version 1.3.42, and it belongs to Anthony Bybell — that's the name at the bottom of the original too, so shoutout to him. go convert some files, you got this 🎀✨