avgbolus 1.4.6 © 2003-2013 by Turku PET Centre
Calculate an average curve of several bolus input curves with different
sample times. For simulations.
Usage: avgbolus [Options] <bolus datafiles> <avg datafile>
Options:
-nr=<Sample nr>
Set the nr of samples to use for bolus appearance time; default is 2.
Set nr=0, if different appearance time is not to be considered.
-ns
TACs are not scaled to a common AUC.
-ne
Standard deviations are not written in output file.
-h or --help
Print this message and exit.
--version or --build
Print software build information and exit.
--silent
Program works silently, printing only error and warning messages.
--verbose
Program prints more information about what it is doing.
Example 1:
avgbolus up????ap.kbq apmean.kbq
Example 2:
dir /b *.kbq > filelist.txt
avgbolus filelist.txt apmean.dat
Datafiles must contain a time column, and one or more concentration columns
separated by space(s) or tabulator(s). Only the first concentration column
is used in calculations.
If only one input datafile is given, it is assumed to contain a list of
bolus datafiles with paths if necessary. Tabs, commas and newlines can be
used to separate filenames in the list file.
Output datafile will contain three columns: time, avg concentration and s.d.
Program will determine the new sample times based on the shortest of input
datafiles.
Detailed program description:
1) Read first curve from each datafile
2) Replace NaNs with interpolated values.
3) Determine bolus appearance time in each curve based on certain number
of samples with highest slope.
4) Move all curves in time to have a common appearance time.
5) Search the bolus curve with shortest sampling duration.
6) Calculate AUC from 0 to that time from all curves separately.
7) Scale all bolus curves to have the same average AUC.
8) Interpolate all bolus curves to common sample times.
9) Calculate the mean and s.d. curve of all bolus curves.
10) Write the mean and s.d. data in a specified ASCII datafile.
See also:
avgfract,
dftavg,
dftadd,
interpol,
dftadd,
dft2svg
Keywords: DFT, simulation, modelling, input
This program comes with ABSOLUTELY NO WARRANTY. This is free software, and
you are welcome to redistribute it under GNU General Public License.