The following datasets are available to explore the read-in and modeling capabilities of PhysIO. They can be downloaded by running the function tapas_download_example_data() in Matlab, which is located in the misc subfolder of the TAPAS software release you downloaded (probably here).
Afterwards, the examples can be found in tapas/examples/<tapasVersion>/PhysIO as different subfolders (vendor/device) and shall be run directly from within these individual folders.
Besides the raw physiological logfiles, each example contains example scripts to run PhysIO as
SPM job (*spm_job.mat)
editable SPM job (*spm_job.m)
plain matlab script (*matlab_script.m)
Courtesy of Steffen Bollmann, Kinderspital Zurich and ETH Zurich
PPU (finger plethysmograph) and breathing belt, General Electric 3T
Description: Similar to PPU, but acquired on a GE system with two
separate output logfiles for pulse oximetry and breathing amplitude,
sampled with 40 Hz. The quality of the signal is particularly
challenging, stemming from a patient population.
Courtesy of Sandra Iglesias, Translational Neuromodeling Unit, ETH &
University of Zurich
4-electrode ECG and breathing belt, Philips 3T Achieva scanner
Description: Standard example; shows how to use volume counting either
from beginning or end of run to synchronize physiological logfile with
acquisition onsets of fMRI scans.
Courtesy of Zina-Mary Manjaly, University Hospital Zurich
4-electrode ECG and breathing belt, Philips 7T Achieva scanner
Description: The ECG data for ultra-high field data is typically much
noisier than at 3 Tesla. Therefore, R-wave peaks are frequently missed
by prospective trigger detection and not marked correctly in the
logfile. This example shows how to select typical R-wave-peaks manually
and let the algorithm find the heartbeat events.
Courtesy of Diana Wotruba, University and University Hospital of Zurich
PPU (finger plethysmograph) and breathing belt, Philips 3T Achieva
Description: Similar to ECG3T, but a plethysmograph instead of an ECG
was used to monitor the cardiac pulsation. Example shows how to extract
heart and breathing rate.
Siemens - VB
Siemens has different physiological logfile formats, for which examples are provided here. A detailed description of these formats is on a different wiki page.
This is the older Siemens log file format (also available via manual recording), which is part of software release VB, and can be determined by the file extensions .resp, .ecg, .puls, in combination with an optional .dcm DICOM header file for the first acquired volume.
A lot of 7T scanners still use this format.
Courtesy of Miriam Sebold, Charite Berlin, and Quentin Huys, TNU Zurich
4-electrode ECG data, Siemens 3T scanner
Description: Similar to ECG 3T, but acquired on a Siemens system with only one logfile for ECG data. The quality of the signal is challenging, stemming from a patient population.
Siemens - HCP
The Human Connectome Project uses Siemens scanners, and the logfile format that comes with their published data seems to be pre-converted and custom (even though the documentation desribes the VB format). We have implemented an own reader for that and written a little tutorial for a single subject dataset of the HCP.
If you download the whole dataset (including functional image files), this example with the additional batches mentioned below also demonstrates how to use the toolbox for model assessment using statistical maps (F-contrasts).
HCP (Subject 178748)
You will have to download the dataset from the HCP yourself, we just provide the matlab batches and the physiological logfile tfMRI_MOTOR_LR_Physio_log.txt here.
For consistency with the other example files, the batch files have been renamed compared to the blog entry:
batch_preproc.m -> batch_preproc.m
batch_physio.m -> siemens_hcp_ppu3t_spm_job.m
batch_glm.m -> batch_glm.m
If you want to run the preproc and glm batch, place them on the same level as the subject folder 178748 for the downloaded data. The physio-batch shall reside in the same folder as the physiological logfile tfMRI_MOTOR_LR_Physio_log.txt.
Siemens - VD/VE Tics
This is the most recent logfile format of Siemens, included in Software releases VD, VE and sometimes referred to as the Tics format, because all time stamps in all files refer to the same reference point (start of the day) and count in the same intervals or "tics" of 2.5 ms from there.
You will recognize this file format via the extensions _Info.log (or _AcquisitionInfo.log), _RESP.log, _ECG.log and _PULS.log. Sometimes, it is also written into the DICOM header (.dcm) file of your functional data directly. In this case, use extractCMRRPhysio.m to convert it to the above separate files before using PhysIO.
Most modern Siemens scanners, such as the Prisma or 7T Terra, use this format.
There are a couple of variants for this format around (e.g., with the WIP Multiband Protocol that is distributed to multiple sites), and PhysIO tries to support all of them.
Courtesy of Saskia Bollmann, Centre for Advanced Imaging, University of Queensland, Brisbane, Australia
Pulse oximetry and breathing belt data, Siemens Prisma 3T, logfile version EJA_1, multi-echo fMRI (3 echoes)
The UUID and date/time stamps were altered for anonymization.