CIF_SELECT(1)

💖 CIF_SELECT(1) 💖

okay bestie, welcome to the General Commands Manual glow-up of cif_select — she's a little command-line queen and she's about to hand you exactly the tags you asked for 🎀

✨ NAME ✨

cif_select — reads CIFs and prints out the tags you picked, with all their values, no cap 💅

🦋 SYNOPSIS 🦋

cif_select --options input1.cif input*.cif

🌸 DESCRIPTION 🌸

Read CIFs and print out selected tags with their values. That's the whole vibe, and she ate. 🔥

👑 OPTIONS 👑

• -t, --tags _tag1,_tag2,_tag3_
• --tags "_tag1 _tag2 _tag3"_ — prints out the values of tags _tag1_, _tag2_, and _tag3_, and like, the tag list you just gave becomes the new list of printed tags. fresh start energy ✨
• -a, --add-tag _tag4_ — adds tag _tag4_ onto the list of printed tags. it's giving "one more for the road" 🫶
• -f, --file-with-tags tag.lst — reads the tags to be extracted from the file tag.lst. comments (any line starting with #) inside tag.lst are ignored, so go ahead and annotate your little heart out 💜
• -c, --clear-tags — clears the list of printed data items accumulated so far. total reset, main character rebirth moment 🌈
• --invert — inverts the sense of selection: it excludes the values of the data items from the list you supplied. flip the script, literally 🙈
• --treat-dots-as-underscores — converts all dots in data names into underscores. glow-up for your names ✨
• --dont-treat-dots-as-underscores, --no-treat-dots-as-underscores — leaves the original data names as they are (default). she's staying true to herself 💅
• --tabular, --output-tabular — outputs the selected data names and their values in tabular format. very organized, very demure 📊
• --cif, --output-cif — outputs the selected data names and their values in CIF format (default). the classic, the icon 👑
• --one-data-item-per-row — prints the values of each data item on its own line (row) in tabular format:

<data block name> <data name> <value> <value> ... <value>

this one's the default when you've got --output-tabular on. 🍓

• --one-data-item-per-column — prints the values of each data item in its own column in tabular format:

<data block name> <data block name> ...
<data name>       <data name>       ...
<value>           <value>           ...

⚠️ this one requires --output-tabular, and it's only available if all of the selected data items have the same number of values. if they don't match up, bestie, it's not happening 😭

• --canonicalize-tag-names — outputs data names in the canonical form. put together, polished, iconic ✨
• --dont-canonicalize-tag-names, --no-canonicalize-tag-names — outputs data names as they are given in the original file(s) (default). no edits, no notes 🎀
• --use-c-parser — uses the Perl & C parser for CIF parsing (default). the duo, the dynamic pair 🫶
• --use-perl-parser — uses the Perl parser for CIF parsing. flying solo 🌸
• --help, --usage — outputs a short usage message (this message) and exits. she's helpful and she's leaving 🦋
• --version — outputs version information and exits. numbers, but make it a moment ⭐

🐛 REPORTING BUGS 🐛

if cif_select is acting up, report those cif_select bugs by e-mail to: cod-bugs@ibt.lt — snitch lovingly, bestie 💌

and that's the whole page, periodt 💅 this lil beauty lives in the General Commands Manual section as CIF_SELECT(1) — that's her whole header and her whole footer, iykyk, she's compact like that 👑✨