CIF_VALUES(1)

💖 CIF_VALUES — the manual page, but make it make sense 💖

okay bestie, welcome to CIF_VALUES(1), straight out of the General Commands Manual ✨ this is the little command-line icon that reads CIF files and spits out the tag values you asked for in a cute lil table. no cap. let's get into it 🫶

🌸 NAME 🌸

cif_values — read CIFs and print out requested tag values in a tabular form. that's the whole job. she's focused. she's employed. she's slaying 💅

✨ SYNOPSIS ✨

cif_values --options input1.cif input*.cif

yes the glob is doing what you think it's doing, she eats many files at once 🍓

🦋 DESCRIPTION 🦋

Read CIFs and print out requested tag values in a tabular form.

that's it. that's the vibe. you feed her CIFs, she hands you back the tags you asked for, all lined up in rows like a group photo where everyone actually showed up 📸

👑 OPTIONS 👑

• -t, --tags _tag1,_tag2,_tag3_
• --tags "_tag1 _tag2 _tag3"_ — Print out values of tags _tag1_, _tag2_, and _tag3_; the specified tag list becomes a new list of printed tags. lowkey this one replaces whatever tag list you had going, it doesn't add to it, so use it with intention bestie 🎀
• -a, --add-tag _tag4_ — Add tag _tag4_ to the list of printed tags. this one's the additive queen, she stacks onto what's already there ✨
• -c, --clear-tags — Clear the list of printed tags accumulated so far. poof. gone. fresh start energy 🌈
• -h, --header — Print out header with the names of selected tags at the beginning (default). yes this is the default, she labels her columns, she's organized 💖
• -h-, --no-header — Do not print out any header. no labels, just raw data, mysterious and minimal 💀
• -r, --replace-spaces — Replace spaces into underscores (default).
• -r-, --dont-replace-spaces, --no-replace-spaces — Do not replace spaces into underscores (works satisfactory only when tabs are used as separators). > heads up bestie: this one only really works right when tabs are your separators, so don't come for her if you used spaces 🙈
• -s, --separator=", " — Use the specified string as a separator between tag values on a line. you pick the string, she puts it between your values, matching set, cute 🎀
• -u, --uniquify-tags _tag1,_tag2_ — Print only unique values of specified tags, not the whole list of values. dedupe era, we love to see it 👑
• --add-uniquified-tag _tag1_ — Add tag '_tag' to the uniquified tag list. another one for the unique-values pile ✨
• -u-, --dont-uniquify-tags, --no-uniquify-tags — Print all values of all tags, do not uniquify any tags (default). everything, all of it, no filtering, the full unedited director's cut 😭
• --tab-separator — Use TAB character as a separator between tag values on a line (default). tabs, iconic, classic, default 🦋
• --vseparator, --value-separator ',' — Use the specified string to separate multiple values of a given tag (default: ','). note she's the value separator, different job from the line separator, don't confuse the two sisters 💅
• --treat-dots-as-underscores — Convert all dots in tag names into underscores (default).
• --dont-treat-dots-as-underscores, --no-treat-dots-as-underscores — Leave original tags as they are. untouched, unbothered, exactly as the file wrote them 🌸
• --filename — Print out full filename at the beginning of each line. full path and everything, so you know exactly which file each row came from 📁
• --fix-syntax-errors — Try to fix those syntax errors in input CIFs that can be corrected unambiguously. she'll attempt the rescue, but only where there's genuinely one right answer, no guessing games ✨
• --no-fix-syntax-errors,
• --dont-fix-syntax-errors — Do not try to fix syntax errors in input CIFs (default). default behavior, errors stay errors, she's not your editor 💀
• --basename — Print out basename of each file at the beginning of each line. just the filename itself, no directory drama 🎀
• --no-filename — Do not print file names (default).
• --dataname — Print out data block name at the beginning of each line (default).
• --no-dataname — Do not print data block names.
• --use-perl-parser
• --use-c-parser — Specify parser to parse CIF files (default: C parser). pick your fighter, but she defaults to the C parser fr fr 🔥
• --help, --usage — Output a short usage message (this message) and exit. she tells you how to use her, then she dips 🫶
• --version — Output version information and exit.

🧚 REPORTING BUGS 🧚

Report cif_values bugs using e-mail: cod-bugs@ibt.lt

if something's acting up, tell the devs, don't just suffer in silence bestie 😭

and that's the whole page, no notes 💜

okay so this was CIF_VALUES(1) from the General Commands Manual — go forth, read your CIFs, print your tags, and stay iconic. periodt. 👑✨🎀