TFF_CONVERT_DSI_STUDIO.PY(1)

📦
version 0.3 · 3 versions
, in debian trixie, ubuntu questing

💖 tff_convert_dsi_studio.py — the manual, bestie edition 💖

okay so you found the man page for tff_convert_dsi_studio.py, a User Command, and honestly? you're in the right place. welcome. pull up a chair. 🫶

✨ NAME ✨

tff_convert_dsi_studio.py — fix DSI-Studio TRK file 💅

🌸 DESCRIPTION 🌸

here's the vibe, literally:

usage: tff_convert_dsi_studio.py [-h] [--remove_invalid | --keep_invalid] [-f]

       IN_DSI_TRACTOGRAM IN_DSI_FA OUT_TRACTOGRAM

so this script exists to fix DSI-Studio TRK file (unknown space/convention) and make it compatible with TrackVis, MI-Brain, Dipy Horizon (Stateful Tractogram). like, it takes your chaotic little tractogram and gives it a glow-up so the other tools will actually talk to it. ✨

and what does it do with all that fixing? it either makes it match with an anatomy from DSI-Studio. yes queen, that's the whole deal.

ngl, this script was tested on various datasets and worked on all of them. ate and left no crumbs. BUT — and I need you to hear me on this — always verify the results, and if a specific case does not work, open an issue on the Scilpy GitHub repository. don't just suffer in silence, okay? 🥺

⚠️ WARNING: This script is still experimental. DSI-Studio evolves quickly and results may vary depending on the data itself as well as DSI-studio version. it's giving "brilliant but unpredictable." proceed with your eyes open, bestie. 👀

🎀 positional arguments 🎀

  • IN_DSI_TRACTOGRAM — Path of the input tractogram file from DSI studio (.trk). the messy one. the before picture. 💀
  • IN_DSI_FA — Path of the input FA from DSI Studio (.nii.gz). the anatomy bestie it's matching up with. 🧚
  • OUT_TRACTOGRAM — Path of the output tractogram file. the after picture. the main character. 👑

💅 options 💅

  • -h, --help — show this help message and exit. the classic. the "wait what was I doing" button. 🙈
  • --remove_invalid — Remove the streamlines landing out of the bounding box. bye felicia to the strays that wandered off the map. 🦋
  • --keep_invalid — Keep the streamlines landing out of the bounding box. no streamline left behind, we're loyal here. 💜
  • -f — Force overwriting of the output files. no questions asked, no permission slips, it just goes. 🔥

and that's the whole page, gorgeous. this manual came to you from tff_convert_dsi_studio.py version 0.3, dated July 2024 — so go forth, fix those TRK files, and slay 💅💖✨ periodt.

📦 where this page comes from