USAGE:(1)

🌸 NAME 🌸

okay bestie, welcome to the usage: manual page — section 1, User Commands, the whole vibe 💅 it's the man page for usage: tff_manipulate_datatype [-h], so if you came here looking for how to change the datatype of stuff inside a TRX file, you are SO in the right place 🫶

---

✨ DESCRIPTION ✨

so here's the whole invocation, laid out exactly like the tool prints it:

usage: tff_manipulate_datatype [-h]

[--positions_dtype {float16,float32,float64}]
       [--offsets_dtype {uint32,uint64}] [--dpv NAME DTYPE] [--dps NAME
       DTYPE] [--groups NAME DTYPE] [--dpg GROUP NAME DTYPE] [-f]
       in_tractogram out_tractogram

Manipulate a TRX file internal array to change their data type. that's the whole point of this icon ✨

now the part you actually need to know, no cap: every single instance of --dps, --dpv and --groups wants 2 arguments (FILE, DTYPE). and --dpg? she's extra, she wants 3 arguments (GROUP, FILE, DTYPE) 👑

and the DTYPE menu, your choices are:

• (u)int8, (u)int16, (u)int32, (u)int64
• float16, float32, float64
• bool

here's the example command, copied exactly, do not @ me:

tff_manipulate_datatype.py input.trx output.trx
--position float16 --offsets uint64     --dpv color_x uint8 --dpv
color_y uint8 --dpv color_z uint8     --dpv fa float16 --dps algo uint8
--dps clusters_QB uint16     --dps commit_colors uint8 --dps
commit_weights float16     --group CC uint64 --dpg CC mean_fa float64

---

🎀 positional arguments: 🎀

• in_tractogram — your Input TRX file 💖
• out_tractogram — the Output filename. the format has to be one of trk, tck, vtk, fib, dpy, trx. pick one bestie, those are the options 🦋

---

🧚 options: 🧚

• -h, --help — show this help message and exit, the classic 🫶
• -f — Force overwriting of the output files. yes she will bulldoze your old file, that's the point 💀

---

💜 Data type options: 💜

• --positions_dtype {float16,float32,float64} — Specify the datatype for positions for trx. [float16, float32, float64]
• --offsets_dtype {uint32,uint64} — Specify the datatype for offsets for trx. [uint32, uint64]

---

🌈 Streamlines metadata options: 🌈

• --dpv NAME DTYPE — Specify the datatype for a specific data_per_vertex.
• --dps NAME DTYPE — Specify the datatype for a specific data_per_streamline.
• --groups NAME DTYPE — Specify the datatype for a specific group.
• --dpg GROUP NAME DTYPE — Specify the datatype for a specific data_per_group.

---

and then, because argparse loves to repeat herself, here's that usage block one more time:

[--positions_dtype {float16,float32,float64}]
       [--offsets_dtype {uint32,uint64}] [--dpv NAME DTYPE] [--dps NAME
       DTYPE] [--groups NAME DTYPE] [--dpg GROUP NAME DTYPE] [-f]
       in_tractogram out_tractogram

and the moment we all fear — forgetting your positionals:

tff_manipulate_datatype: error: the following arguments are required:
       in_tractogram, out_tractogram

fr fr, if you see that error it's because you left out in_tractogram and out_tractogram. the tool is not being mysterious, she is telling you exactly what's missing 😭

---

okay that's the whole page, mwah 💋 this came from the usage: source, version tff_manipulate_datatyp..., dated September 2025 — love that for her, periodt 💅✨🎀