CIF_SPLIT(1)

📦
version 3.12.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 CIF_SPLIT 💖

okay so bestie, welcome to CIF_SPLIT(1) from the General Commands Manual — yes she's section 1, she's a real one, she's a command, and she's about to make your CIF files behave. 🎀

✨ NAME ✨

cif_split — split CIF files into separate files with one data_ section each. This script parses given CIF files to separate the data blocks, so is capable of splitting non-correctly formatted and nested CIF files.

🦋 SYNOPSIS 🦋

cif_split --options input1.cif input*.cif

like… give her some options, then feed her your files. that's the whole vibe. 💅

🌸 DESCRIPTION 🌸

Split CIF files into separate files with one data_ section each.

This script parses given CIF files to separate the data blocks, so is capable of splitting non-correctly formatted and nested CIF files.

fr fr, she doesn't even care if your CIF file is messy — nested blocks? weird formatting? she eats that up, no notes. 🔥

👑 OPTIONS 👑

  • -o, --output-dir out/ — put all split files into the directory out/. like, all of them, together, cozy. 🫶
  • -p, --prefixed, --output-prefixed — print split data blocks to the STDOUT, each line prefixed by the data block name. Do not create any files.
  • --output-tar — produce TAR archive with split files to the STDOUT. iconic tbh. ⭐
  • -h, --add-cif-header header_file.cif — prepend each of the output files with the comments from the beginning of the specified file.
  • --split-global-data-block — put the 'data_global' data block (if any) to each split file (default). this is the one she does automatically, bestie. ✨
  • --do-not-split-global-data-block, --dont-split-global-data-block, --no-split-global-data-block — do not treat 'data_global' data block (if any) as special. three names, one job, we love a flexible queen. 💜
  • --uniquify-file-names — postfix duplicated data block names with numbers to create unique file names.
  • --no-uniquify-file-names — put data blocks with the same name to the same file, i.e., append (default).
  • -v, --verbose — print names of the generated files to STDERR. she's a talker. 😭
  • -q, --quiet — do not print file names to STDERR. she's not a talker.
  • --use-perl-parser — use Perl parser for CIF parsing.
  • --use-c-parser — use Perl & C parser for CIF parsing.
  • --cif-input — use CIF format for input (default).
  • --json-input — use JSON format for input.
  • --cif-output — use CIF format for output (default).
  • --json-output — use JSON format for output.
  • --cif — use CIF format for both input and output (default).
  • --json — use JSON format for both input and output.
  • --help, --usage — output a short usage message (this message) and exit.
  • --version — output version information and exit.
💀 heads up: --do-not-split-global-data-block and friends flip the default behaviour of --split-global-data-block, and --no-uniquify-file-names flips the default of --uniquify-file-names. pick your fighter, don't do both and get confused, iykyk.

🙈 REPORTING BUGS 🙈

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

and that's the whole page, bestie!! this one's from the General Commands Manual, page name CIF_SPLIT(1) — mwah, go split some CIF files, you absolute main character 💅✨🎀

📦 where this page comes from