TURBO results gathering functions#

turbo_get_results(subject, ROImodel, VOXmodel)#

Returns the mat file containing the results. Results are fetched from directory at

[getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subject filesep ‘results’ filesep results_mc_elastic filesep ‘roi-modelling’ filesep modelling_options.ROImodel filesep] [getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subject filesep ‘results’ filesep results_no_mc filesep ‘roi-modelling’ filesep modelling_options.ROImodel filesep]

and modelling_options from

getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subject filesep ‘options’ filesep subject ‘_modelling_options.mat’

Parameters:

  • subject (char array) – Modelling results of this subject.

  • ROImodel ({'',   'fit_h2o',  'fit_h2o_bf',   'patlak',      'fur',       'suv',     'logan'}) – Results of this model are fetched for the subject.

  • VOXmodel ({'',   'imgh2o',   'imgh2obf',     'imgpatlak',   'imgfur',   'imgsuv',   'imglogan'}) – Results of this model are fetched for the subject.

Returns:

  • results_mc_elastic (4x1 cell array) –

    • results_mc_elastic{1} : Modelling results in a Matlab table.

    • results_mc_elastic{2} : Full filepath to mat-file containing the

    result table (same as the result_table). - results_mc_elastic{3} : Full filepath to txt-file containing the results in stylised text format. - results_mc_elastic{4} : Full filepath to xlsx-file containing the result table (same as the result_table).

  • results_no_mc (4x1 cell array) –

    • results_no_mc{1} : Modelling results in a Matlab table.

    • results_no_mc{2} : Full filepath to mat-file containing the

    result table (same as the result_table). - results_no_mc{3} : Full filepath to txt-file containing the results in stylised text format. - results_no_mc{4} : Full filepath to xlsx-file containing the result table (same as the result_table).

turbo_compile_roi_results(subjects, ROImodel, mc_type, options)#

Gathers results from all subjects in the list subjects. The subjects are searchd from

[getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subjects(i) filesep]

Works only if all the results are run with the same modelling_options.ROImodel and modelling_options.processed_roi_idx.

All the results need to be same type. If a result file is missing program throws error so no results are accidentally missed.

DOES NOT CHECK THAT THE RESULTS ARE MOST RECENT, USER NEEDS TO CONFIRM THIS FIRST.

Parameters:

  • subjects (Nx1 string array) – List of subjects ac-numbers.

  • ROImodel ({'fit_h2o',    'fit_h2o_bf',    'patlak',    'fur',    'suv',    'logan'}) – Results of this model are fetched for each subect.

  • mc_type ({'mc_elastic', 'no_mc'}) – Results of either from elastic motion correction or no motion correction.

  • result_xlsx (char array) – Output file as xlsx-file.

Returns:

  • results_matrix (NxRxP double array) – Array containing all the results.

    • N is the amount of subjects

    • R is the amount of ROIs

    • P is the amount of parameters.

    For example results_matrix(:,:,1) gives first parameter values for each subject in rows and ROIs in columns.

  • results_table (1x11 table) – Nested table where each column contains the same data as results_matrix(:,:,1) or sheet in the excel file.

  • roinames (Rx1 string array) – All roinames in an arry (same order as in the results).

  • param_names (Px1 string array) – Parameter names (same order as in the results).

turbo_compile_vox_results(subjects, VOXmodel, mc_type, options)#

Gathers results from all subjects in the list subjects. The subjects are searchd from

[getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subjects(i) filesep]

Works only if all the results are run with the same modelling_options.VOXmodel.

All the results need to be same type. If a result file is missing program throws error so no results are accidentally missed.

DOES NOT CHECK THAT THE RESULTS ARE MOST RECENT, USER NEEDS TO CONFIRM THIS FIRST.

Parameters:

  • subjects (Nx1 string array) – List of subjects ac-numbers.

  • VOXmodel ({'',   'imgh2o',   'imgh2obf',    'imgpatlak',   'imgfur',   'imgsuv',   'imglogan'}) – Results of this model are fetched for the subject.

  • mc_type ({'mc_elastic', 'no_mc'}) – Results of either from elastic motion correction or no motion correction.

  • vox_result_xlsx (char array) – Output file as xlsx-file.

Returns:

  • vox_results_matrix (NxRxP double array) – Array containing all the results.

    • N is the amount of subjects

    • R is the amount of ROIs

    • P is the amount of parameters.

    For example vox_results_matrix(:,:,1) gives first parameter values for each subject in rows and ROIs in columns.

  • vox_results_table (1x11 table) – Nested table where each column contains the same data as vox_results_matrix(:,:,1) or sheet in the excel file.

  • vox_roinames (Rx1 string array) – All vox_roinames in an arry (same order as in the results).

  • vox_param_names (Px1 string array) – Parameter names (same order as in the results).

turbo_compile_magia_results(subjects, magia_model, options)#

Gathers results from all subjects in the list subjects. The subjects are searchd from

[getenv(‘TOTAL_BODY_PET_DATA_DIR’) filesep subjects(i) filesep]

Works only if all the results are run with the same magia_options.

All the results need to be same type. If a result file is missing program throws error so no results are accidentally missed.

DOES NOT CHECK THAT THE RESULTS ARE MOST RECENT, USER NEEDS TO CONFIRM THIS FIRST.

Parameters:

  • subjects (Nx1 string array) – List of subjects ac-numbers.

  • magia_model ({'fit_h2o',  'patlak',    'fur',    'suv',    'logan'}) – Results of this model are fetched for each subect.

  • magia_result_xlsx (char array) – Output file as xlsx-file.

Returns:

  • magia_results_matrix (NxRxP double array) – Array containing all the results.

    • N is the amount of subjects

    • R is the amount of ROIs

    • P is the amount of parameters.

    For example magia_results_matrix(:,:,1) gives first parameter values for each subject in rows and ROIs in columns.

  • magia_results_table (1x11 table) – Nested table where each column contains the same data as magia_results_matrix(:,:,1) or sheet in the excel file.

  • magia_roinames (Rx1 string array) – All magia_roinames in an arry (same order as in the results).

  • magia_param_names (Px1 string array) – Parameter names (same order as in the results).