CIF2TSV(1)

💖 cif2tsv — the CIF2TSV(1) page, bestie edition 💖

okay so. welcome to cif2tsv(1), straight out of the General Commands Manual. grab a strawberry 🍓, sit down, we're gonna get every last byte of this thing.

✨ NAME ✨

cif2tsv — get specified data values from a CIF file(s). that's it, that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

src/components/codcif/cif2tsv --options < input.cif

src/components/codcif/cif2tsv --options input.cif

src/components/codcif/cif2tsv --options input1.cif input2.cif
inputs*.cif

read from stdin, read from a file, read from a whole lil squad of files — the range is giving versatility, no cap. ✨

🌸 DESCRIPTION 🌸

Get specified data values from a CIF file(s). that's the mission statement, and she stays on mission. 🎀

👑 OPTIONS 👑

one bullet per option, no skips, no summarising, we are NOT that girl. every single one is here. 🫶

• -h, --header, -h-, --no-header — print / do not print the column name header. and bestie, the default is do not print it. so --header turns it on, --no-header (and its lil twin -h-) turns it back off. 💖
• -a, --all-tags — extract data for all data names. this is the default. and it overrides --tags. so if you're out here passing both, --all-tags wins the argument, periodt. 🔥
• -t, --tags _cell_length_a,_cell_volume — extract the specified data items. that's your little comma-separated wishlist, like _cell_length_a,_cell_volume. ✨
• -g, --group-separator $'0, --newline-characters $'0 — specify a group separator that separates TSV/CSV/ADT "lines" (default "0)). 💀
• -r, --record-separator $'', --separator $'' — use the specified string to separate values of different data items (default " "). 🎀
• -u, --unit-separator "|", --value-separator "|", --vseparator "|" — use the specified string to separate multiple values of each looped data item (default "|"). 🦋
• -p, --replacement " " — a character to which all separators are replaced in the non-quoting output formats (TSV and ADT). remember this one, she's doing the quiet work behind the scenes. 💅
• -D, --dos-newlines
• -M, --mac-newlines
• -U, --unix-newlines — set new line convention to DOS, MAC or Unix (Unix is the default). same as --group-separator with an appropriate string (e.g. --dos-newlines in bash is --group-sep $' '$'0)). 🌈
• --tsv-output, --csv-output, --adt-output — set separators for the TSV, CSV or ADT (ASCII delimited text, using ASCII GS, RS and US chars) output. the default depends on how the program is called: 'cif2csv', 'cif2tsv' or 'cif2adt'. she picks her outfit based on the name you call her, iconic. ✨
• --filename — print filename in the output. 👑
• --no-filename — don't print filename in the output. this is the default. 🙈
• --datablock-name, --dataname — print data block names in the output. this is the default. 🌟
• --no-datablock-name, --no-dataname — do not print data block names in the output. 🚫
• -d, --debug — print internal program data structures for debugging. peek behind the curtain, it's giving backstage pass. 🔍
• --version — print program version (SVN Id) and exit. 📜
• --help — print short usage message (this message) and exit. the "wait what were the flags again" button, we've all been there. 😭

📮 REPORTING BUGS 📮

found a bug? spill it. report cif2tsv bugs using e-mail: cod-bugs@ibt.lt. the maintainers wanna hear from you, fr fr. 💌

okay so that's the entire CIF2TSV(1) page, from the General Commands Manual, every flag and default accounted for, nothing dropped, nothing invented. 🧚 signing off as CIF2TSV(1) — mwah, go read your CIFs bestie 💋💖