imgbfk3 - tpcclib 0.8.2 © 2025 by Turku PET Centre

Computation of parametric images from dynamic PET image in ECAT, NIfTI,
or Analyze format applying irreversible two-tissue compartmental model with
arterial plasma input, using the basis function method (1).
 
Dynamic PET image and plasma and blood time-activity curves (PTAC and BTAC)
must be corrected for decay to the tracer administration time.
Enter 'none' in place of the name of btacfile, if you want to assume Vb=0.
 
Usage: imgbfk3 [Options] ptacfile btacfile imgfile k3file
 
Options:
 -thr=<threshold%>
     Pixels with AUC less than (threshold/100 x PTAC AUC) are set to zero;
     default is 1%.
 -end=<Fit end time (min)>
     Use data from 0 to end time; by default, model is fitted to all frames.
 -dv=<filename>
     Parametric K1/(k2+k3) image is saved.
 -K1=<filename>
     Parametric K1 image is saved.
 -k2=<filename>
     Parametric k2 image is saved.
 -Ki=<filename>
     Parametric Ki image is saved.
 -Vb=<filename>
     Parametric Vb image is saved.
 -min=<Min k2+k3> and -max=<Max k2+k3>
     Enter the basis functions minimum and maximum k2+k3 (=alpha) in units 1/min;
     defaults are 0.15 and 0.60, respectively.
 -nr=<value>
     Set number of basis functions; default is 200, minimum 50.
 -k2k3=<filename>
     Parametric k2+k3 (=alpha) image is saved.
 -t1=<filename>
     Parametric theta1 image is saved.
 -t2=<filename>
     Parametric theta2 image is saved.
 -bf=<filename>
     Basis function curves are written in specified TAC file.
 -err=<filename>
     Save image where the pixels that had k2+k3 at min or max value are
     set to values 1 and 2, respectively, and other pixels are set to value 0.
 -w1, -wf, -wfa
     By default, all weights are set to 1.0 (no weighting, option -w1); option -wf
     sets weights based on frame lengths, and option -wfa based on both frame lengths
     and mean activity during each frame.
 -h, --help
     Display usage information on standard output and exit.
 -v, --version
     Display version and compile information on standard output and exit.
 -d[n], --debug[=n], --verbose[=n]
     Set the level (n) of debugging messages and listings.
 -q, --quiet
     Suppress displaying normal results on standard output.
 -s, --silent
     Suppress displaying anything except errors.
 
Example 1. Calculation of K1, Ki, k3, and Vb images:
  imgbfk3 -k1=s2345k1.v -ki=s2345ki.v -Vb=s2345vb.v s2345ap.kbq s2345ab.kbq s2345dy.v s2345k3.v
Example 2. Calculation with assumption Vb=0:
  imgbfk3 -k1=s2345k1.v -ki=s2345ki.v s2345ap.kbq none s2345dy.v s2345k3.v
 
The units of pixel values in the parametric images are 1/min for k3,
ml/(min*ml) for K1 and Ki, and ml/ml for DV and Vb.
 
References:
1. Hong YT et al. J Cereb Blood Flow Metab. 2011;31:648-657.
 
See also: imglhk3, imgki, imgcbv, imgunit, fitdelay
 
Keywords: image, modelling, irreversible uptake, Ki, basis function method