QView CSV format

QView software from QSPECT project in Osaka saves regional tissue time-activity curves (TTACs) in a specific CSV format. Example of an QView data file:

directory,file name,num,slice,mean,sd,cov,max,min,pixel,total,group
H:\work,us956dy1.v,1(01),12,41062.664,11120.688,27.082,62027.320,18816.471,62,2545885.158,
H:\work,us956dy1.v,2(01),10,33093.772,5516.248,16.669,50261.043,21246.332,41,1356844.650,
H:\work,us956dy1.v,3(01),9,157091.192,29167.109,18.567,190810.016,93902.805,8,1256729.539,
H:\work,us956dy1.v,1(02),12,60882.180,11147.969,18.311,83997.500,34051.816,62,3774695.164,
H:\work,us956dy1.v,2(02),10,71267.459,22862.744,32.080,120751.125,31244.354,41,2921965.822,
H:\work,us956dy1.v,3(02),9,240509.820,42680.965,17.746,322662.094,181066.313,8,1924078.563,
H:\work,us956dy1.v,1(03),12,123311.758,29844.436,24.202,193184.625,46768.797,62,7645328.992,
H:\work,us956dy1.v,2(03),10,154417.874,42220.152,27.341,239690.078,85883.242,41,6331132.836,
H:\work,us956dy1.v,3(03),9,320861.775,71224.157,22.198,443864.688,207264.422,8,2566894.203,
...

The third column (num) tells the number of ROI, and the number of time frame in parenthesis. The fourth column (slice) contains the image plane number.

Notice that lines may not be ordered numerically, but alphabetically.

ROI groups

QView can also calculate and save the means of selected ROIs as 'group'; in that case, the data of those group TACs are in the end of the CSV file, the ROI number in the 3rd column and the slice number in 4th column are missing, and the last column (group) that may otherwise be empty will contain the group name.

Frame times

QView CSV files do not contain the frame times, only the frame numbers. Time information can be retrieved and saved from PET images in SIF format, and added to the TTAC data after it has been converted to other file formats that support time information, such as PMOD CRV or TPC DFT.

Conversion to other formats

Because of the missing frame time information, original QView CSV files cannot be used by analysis and modelling software as such, but need to be converted to other formats.

Program tacformat, starting from version 0.6.17, can read QView CSV file, and save it in certain other formats. For example, to convert file us956_kidney_left.csv to PMOD format (with extension .tac), and to add time frame information from SIF, you would enter the following commands:

tacformat -f=pmod us956_kidney_left.csv
tacframe us956_kidney_left.tac us956dy1.sif

Radioactivity concentration units are also missing. If needed, program tacunit can be used to set the correct units to the converted file, for example:

tacunit -yset=Bq/mL us956_kidney_left.tac

See also:



Tags: , ,


Updated at: 2019-12-21
Created at: 2017-10-12
Written by: Vesa Oikonen