GENSAMPLE(1)

💖 NAME 💖

gensample — bestie, this one generates a virtual sample that's suitable for sequence simulation in ODIN. That's the whole vibe. 🦋

---

✨ DESCRIPTION ✨

okay so. gensample generates a virtual sample suitable for sequence simulation in ODIN. periodt. 💅

This program is part of odin 2.0.5 with configuration using_gcc debug gui(:5) standalone dl posix_threads libz gsl nifti vtk dicom png ismrmrd gdb — yes that's a whole mouthful, no cap, but every single one of those tokens matters so I'm keeping them all. 🫶

---

🎀 Usage and options: 🎀

🌸 Create a sample from external maps: 🌸

like, you've got maps already and you just want the sample? say less:

gensample -fr <FOVread> -fp <FOVphase> -fs <FOVslice> -s0 <spin-density>
[-t1 <T1map>] [-t2 <T2map>] [-pm <ppmMap>] [-ir <inplane-reduction>]
[-ss <single-slice number>] [-ft <comma-separated-list of frame-rates
for dymaic phantoms>]
-o <Sample-file>

---

🦋 Create a point-spread function: 🦋

one single point, living its best life:

gensample -psf -t1 <point T1> -t2 <point T2> [-dc
<DiffusionCoeff>] -o <Sample-file>

---

🎀 Create rectangle of uniform spin distribution about origin in all 3 spatial dimensions: 🎀

a whole rectangle of uniform spins, centered on the origin, in all three spatial dims. iconic honestly:

gensample -uni -n <size> -f <FOV> [-t1 <uniform T1>] [-t2
<uniform T2>] -o <Sample-file>

---

⭐ Create an isochromat distribution: ⭐

isochromats!! the moment:

gensample -iso -n <size> -df <freq-distribution-width[kHz]> -t1
<point T1> -t2 <point T2> [-dc <point Dcoeff>] -o <Sample-file>

---

🌈 Create a homogenous disk with given radius: 🌈

a disk. round. homogenous. you give it the radius:

gensample -dsk -n <size> -f <FOV> -R <radius> [-t1 <uniform T1>]
[-t2 <uniform T2>] [-dc <uniform DiffusionCoeff>] -o
<Sample-file>

---

👑 Create coaxial cylinder: 👑

coaxial cylinder arc, fr fr:

gensample -cyl -n <size> -f <FOV> -Xi <inner-suscept[ppm]> -Xo
<outer-suscept[ppm]> -Ri <inner-radius> -Ro <outer-radius> [-t1
<uniform T1> -t2 <uniform T2> -sl <single-line>] -o <Sample-file>

---

💜 Other options: 💜

• -v <loglevel> or <component:loglevel> — debugging/tracing, bestie! 🐛 pass -v <loglevel> to log all components, or -v <component:loglevel> to log just a single component. Possible values for loglevel are: 0 (noLog), 1 (errorLog), 2 (warningLog), 3 (infoLog), 4 (significantDebug), 5 (normalDebug), 6 (verboseDebug).
• -h, --help, -help, --version — print help text or version information. the "help me I'm lost" button and the "who even am I" button. 🫶

---

heads up bestie: -o <Sample-file> shows up in every single usage form up there, so don't forget it, or you'll be sad. 😭

---

and that's the whole page!! this was gensample 2.0.5, dated October 2021. 💖 mwah, go generate something cute, you got this 🎀✨