PsPM-FR pre-processed data
==========================

Repository Version: 2021.11.06

This file refers to the data stored in data_pp.zip and should be read in conjunction with the main README.txt, which comments on how the data were generated.

The preprocessed dataset data_pp.zip builds on the main data set contained in data.zip and includes raw and preprocessed skin conductance response (SCR), electrocardiogram (ECG), and respiration measurements, as well as raw electromyogram measurements (EMG), for experimental session 1 only. Time indices of this data set correspond to the main data set. Preprocessing steps are listed below.
--------------------------------------------------------------
General
Preprocessing was done with Matlab R2019a and PsPM version 5.1.1 as well as custom-written code. To read pupil files, a PsPM version higher than 5.5.1 is required.
--------------------------------------------------------------
SCR
SCR artefacts were detected via an initial automatic quality assessment (using standard settings in pspm_scr_pp). Data were then visually examined to detect additional artefacts. Artefact epochs are stored in separate files, as described below.
--------------------------------------------------------------
ECG
QRS complexes were detected from ECG data using a modified Pan & Tompkins algorithm to create heartbeat time stamps (using pspm_ecg2hb). Heartbeat was then transformed into an interpolated heart rate signal (using a heart period limit of 0.4-1.2 s in pspm_hb2hp) at 100 Hz sampling rate. 
--------------------------------------------------------------
RAR 
Raw respiratory traces were converted to interpolated respiration amplitude time series with a respiratory cycle detection algorithm (using standard settings in pspm_resp_pp) at 10 Hz sampling rate.

--------------------------------------------------------------
This repository is curated by the PsPM team, bachlab.org/pspm
--------------------------------------------------------------
The preprocessed dataset is described and used in following references:
N/A
--------------------------------------------------------------
File Structure:
-README_pp.txt               	// This document
-+Data_pp                    	// Folder Containing all data files
 |-FR_wdq_XX_sn1_pp.mat      	// 31 files holding measurements for SCR, ECG, EMG and respiration
 |-missing_epochs_FR_wdq_XX_sn1 // 31 files holding detected SCR artefact epochs
 |-...

--------------------------------------------------------------
Data Files:
- Files holding SCR, ECG, EMG, respiration traces and time markers, recorded with WDQ software.
   - Skin conductance (channel 1)
   - Electromyogram (channel 2)
   - Electrocardiogram (channel 3)
   - Respiration (channel 4)
   - Event markers used for synchronization with Cogent files, markers are set at CS presentation onset (channel 5)
   - Heart beat time stamps (channel 6)
   - Interpolated heart period (channel 7)
   - Interpolated respiration amplitude (channel 8)
- Files holding SCR artefact epochs, created with pspm_data_editor

The data file name is composed of:
 - missing_epochs_	for missing epochs files 
 - FR        		The dataset name
 - wdq    		The type of data recorded (see above)
 - XX           	The subject number
 - 1           	  	The session number

Data are stored as .mat files for use with MATLAB (The MathWorks Inc., Natick, USA) in a format readable by the PsPM toolbox (bachlab.org/pspm). All Matlab files are saved in MATLAB 9.6 (R2019a) format.