interpol - tpcclib 0.8.0 © 2023 by Turku PET Centre

Linear (dot-to-dot) interpolation and integration of PET time-activity data.
 
Usage: interpol [options] tacfile [outputfile]
 
Options:
 -y or -i or -ii
     TACs are interpolated (-y, default), integrated (-i), or the 2nd
     integral (-ii) is calculated.
 -X=<x1;x2;...> or -C=<start;stop;step> or -F=<xfile>
     The sample times for interpolated or integral TACs can be specified with
     these options; if none of these is given, the sample times of the
     original datafile are used. Definite sample times can be given after
     -X; regular sample timing can be specified using option -C; with -F the
     sample times can be read from given TAC file.
 -A[=<t>]
     Input TACs are interpolated and integrated with sample (0,0) or (t,0)
     as their first measurement points.
 -0=<y|F>
     Input TACs are interpolated and integrated with sample (0,y) added
     if TAC starts later than at zero time. With option -0=F the first
     existing sample value is used as y value.
 -header=<Yes|no>
     Descriptive title lines (if header information is available) can be
     included (default), or not included.
 -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.
 
Input TAC data is considered to be non-framed even if it contains frame
start and end times; if necessary, frame mid times are calculated and used.
The interpolated or integrated values are calculated exactly at the
specified sample times, except when the start and end times of PET frames
are given with -F=<xfile>; then the time frame average values or integrals
at the frame mid time are calculated.
 
If output filename is not specified, the results are written to stdout.
 
If result consists of only one value, output file is not given, and option
-header=no is given, then just the value is printed, without time, for
easier use in scripts. For example in bash:
 
  auc=$(interpol -i -x=50 -header=no plasma.dat)
  printf "AUC=%s\n" $auc 
 
See also: taccalc, dftinteg, simframe, tacframe, ainterp, taccut, extrapol
 
Keywords: TAC, modelling, simulation, tool, AUC, interpolation