MRS_TOOLS-SPLIT(1)

💖 MRS_TOOLS-SPLIT(1) 💖

okay bestie, welcome to mrs_tools-split, a lil User Commands girly from the mrs_tools family 🌸

---

✨ NAME ✨

mrs_tools split — split NIfTI-MRS along higher dimensions 🦋

like, it takes your big multidimensional MRS file and goes snip snip along one of the higher dims. it's giving scalpel energy 💅

---

✨ SYNOPSIS ✨

mrs_tools split [-h] --file FILE --dim DIM
(--indices INDICES [INDICES ...] | --index INDEX) [--output OUTPUT]
[--filename FILENAME]

so basically you HAVE to give it a --file and a --dim, and then you gotta pick ONE of the two splitting vibes: either --indices (a whole list of them, queen) or --index (just the one). the --output and --filename are optional little treats 🎀

---

✨ OPTIONS ✨

🌈 OPTIONAL ARGUMENTS 🌈

• -h, --help — shows you a help message and dips. iconic behaviour, honestly 🫶
• --indices INDICES [INDICES ...] — a list of indices to extract into the second file ✨ and yes, all of these indices are zero-indexed, so we start counting from 0 like the little programmers we are. no cap.
• --index INDEX — the index to split at, and it splits after that index. also zero-indexed 💜 so it's not "split here", it's "split right after here", okay?? important distinction, bestie.
• --output OUTPUT — the output folder 📁 and if you don't say anything it just defaults to the current directory. lowkey polite of it.
• --filename FILENAME — override the output file name 🎀 you wanna name it something else? go off.

👑 REQUIRED ARGUMENTS 👑

• --file FILE — the file you wanna split. the main character of this whole operation, fr fr 💖
• --dim DIM — the NIFTI-MRS dimension tag to merge across 🔥 (yes bestie, that's what the manpage says, we're keeping it exactly like that)

⚠️ heads up: you literally cannot run this without --file and --dim. they're required, periodt.

---

✨ SEE ALSO ✨

• mrs_tools(1)
• mrs_tools-info(1), mrs_tools-vis(1), mrs_tools-merge(1), mrs_tools-reorder(1), mrs_tools-reshape(1), mrs_tools-conjugate(1)

the whole friend group 💅 go say hi to mrs_tools-merge(1) if you change your mind and want to put things back together again lol 😭

---

and that's the whole page bestie!! this one's from November 2023, part of the MRS_TOOLS-SPLIT(1) saga — ily, go split something responsibly 💜✨🎀