tacweigh - tpcclib 0.8.0 © 2023 by Turku PET Centre

Add or remove the sample (time frame) weighting information to TAC file for
parameter estimations and curve fitting using formula (Mazoyer et al, 1986):
  weight=(frame duration)^2 / (decay corrected trues in a frame)
or optionally:
  weight=(frame duration),
  weight=(frame duration)*exp(-t*ln(2)/halflife),
TACs are assumed to be corrected for decay, and SIFs not corrected.
The relative weights are adjusted using a scan information file (SIF),
or TACs in the file (volume weighted average of all TACs or given TAC);
in the latter case the units in TAC file must be set correctly.
Usage: tacweigh [Options] tacfile [sif | tacname]
     Existing weights are removed.
     Weights are not calculated, but existing weights are printed on screen.
     Return code is non-zero if data does not contain weights.
 -wf | -wfd
     With -wf Weights are based only on frame length or sampling interval.
     With -wfd the late frames are given less weight by using formula:
     weight=(frame duration)*exp(-t*ln(2)/halflife) (Thiele et al, 2008).
 -i=<Isotope code>
     Isotope, for example C-11, in case it is not found inside SIF or TAC
     file. Isotope is only needed with SIF, and with option -wfd.
     Weights are moderated by limiting the ratio of maximum and minimum
     weights to the given ratio (100 by default). Weights that are lower
     than maximum/ratio are set to maximum/ratio. Enter zero to not
     moderate the weights. Otherwise ratio must be larger than one.
     SIF data based on TAC file is written in given file; cannot be used
     if SIF is given as argument.
 -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.
Note that absolute weights cannot be calculated. Relative weights are
scaled so that average weight is 1.0 for frames that have weight above 0.
1. Mazoyer BM, Huesman RH, Budinger TF, Knittel BL. Dynamic PET data
   analysis. J Comput Assist Tomogr 1986; 10:645-653.
2. Thiele F, Buchert R. Evaluation of non-uniform weighting in non-linear
   regression for pharmacokinetic neuroreceptor modelling.
   Nucl Med Commun. 2008; 29:179-188.
See also: sifcat, sifisot, taclist, imgweigh, tacframe, imghead, tacdecay
Keywords: TAC, SIF, modelling, weighting, fitting