USAGE:(1)

✨ NAME ✨

okay so bestie, welcome to the manual page for usage: — aka the little doc that ships with usage: tff_validate_trx [-h] [--out_tractogram OUT_TRACTOGRAM] 💅

---

🌸 DESCRIPTION 🌸

here's the whole vibe, in one block, no edits:

usage: tff_validate_trx [-h] [--out_tractogram OUT_TRACTOGRAM]
       [--remove_identical_streamlines]
       [--precision PRECISION] [--reference REFERENCE] [-f]
       in_tractogram

Validate TRX file. that's the whole job, she's a validator, she validates, periodt 👑

so what does she actually do? she removes streamlines that are out of the volume bounding box. and like, in voxel space, there is literally no such thing as a negative coordinate, and no such thing as a coordinate above the volume dimension. those are the two conditions, and any streamline that does not respect them gets removed. gone. not invited to the function 🙈

she also removes streamlines with single or no point — like, girl, a streamline with one point or zero points is not a streamline, it's a vibe, and it's getting deleted 😭

and then there's the --remove_identical_streamlines option, which does exactly what the name says: it removes identical streamlines from the set. and before you ask what "identical" means (because you were gonna ask, i can feel it 🫶), "identical" is defined as having the same number of points and the same points coordinates — to a specified precision, using a hash table. so it's not vibes-based, it's hash-table-based, which is way more iconic honestly ✨

---

🎀 positional arguments 🎀

• in_tractogram — Tractogram filename. Format must be one of trk, tck, vtk, fib, dpy, trx. that's the list, those are the six, no substitutions bestie 💖

---

🦋 options 🦋

• -h, --help — show this help message and exit. the classic. the icon. the one you run first 💅
• --out_tractogram OUT_TRACTOGRAM — Filename of the tractogram after removing invalid streamlines. yes, this is where the survivors go 🫶
• --remove_identical_streamlines — Remove identical streamlines from the set. (see above re: hash table, precision, the whole thing ✨)
• --precision PRECISION — Number of decimals to keep when hashing the points of streamlines. default is [1] 🌸
• --reference REFERENCE — Reference anatomy for tck/vtk/fib/dpy file support (.nii or .nii.gz). so like, if your format needs a reference anatomy, this is her 🧚
• -f — Force overwriting of the output files. she will NOT ask twice, she will simply replace them 👑

---

💜 and then this part 💜

yes, this is also in the original, and yes, i am also including it, because we keep every single detail around here:

[--remove_identical_streamlines]
       [--precision PRECISION] [--reference REFERENCE] [-f]
       in_tractogram

---

💀 the error 💀

if you forget the positional argument, she will tell you, loudly, like this:

tff_validate_trx: error: the following arguments are required: in_tractogram

not me forgetting in_tractogram and getting absolutely read for filth by an argparse error 😭 give her the tractogram. she needs the tractogram.

---

🌈 SEE YOU LATER 🌈

and that's the page, bestie — brought to you by User Commands, and if you squint at the bottom of the original it's signed off with usage: tff_validate_trx [-h] ... and the date September 2025 🎀 so consider this the cute little sign-off: go validate those TRX files, stay in your bounding box, keep no negative coordinates, and remember — no points, no streamline, no exceptions. mwah 💖✨🦋