Data and Matlab package for Using imaging photoplethysmography for heart rate estimation in non-human primates

Raw data for imaging photoplethysmogram extraction collected in 10 recording sessions from four rhesus monkeys and Matlab scripts for their processing. For details of the study please refer to [1]. INSTRUCTIONS: 1. Please download the zip-archive and unpack its contents. 2. Please launch the script dataset_analysis.m in MATLAB to reproduce the results described in [1]. For a detailed description of the code please see [2].Matlab scripts require Matlab Wavelet Toolbox. DATA DESCRIPTION: Data of session N is placed in a folder SessionN. Data for sessions 1-8 consist of four files: SessionN.bin - raw color signal data in binary file, in format r1 g1 b1 r2 g2 ....; SessionN_ROIdata.txt - metadata of ROI used for data color signal computing; SessionN_interframeDif.txt - interframe differences in the video, proxy for the amount of motion. Format: stream of double values with a new line symbol as delimiter, use a = load('SessionN_interframeDif.txt', '-ascii') to load in Matlab;SessionN_REF.csv - average reference pulse rate values for time intervals of length reported in file summary.txt. Data for session 1 additionally contain the following files: Session1RegionN.bin - raw color signal data in binary file for Section 1 with ROI different from region 3; Session1RegionN_ROIdata.txt - metadata of ROI used for data color signal computing for Section 1 with ROI different from region 3; Data for sessions 2IR, 9IR and 10IR consist of three files: SessionN.bin - raw "color" (effectively - monochrome) signal data in binary file, in format i1 i1 i1 i2 i2 i2 ...; SessionN_ROIdata.txt - metadata of ROI used for signal computing; SessionN_REF.csv - average reference pulse rate values for time intervals of length reported in file summary.txt. REFERENCES: [1] Unakafov AM, Möller S, Kagan I, Gail A, Treue S, Wolf F (2018) Using imaging photoplethysmography for heart rate estimation in non-human primates. bioRxiv. doi:10.1101/252403 [2] Matlab package "Imaging photoplethysmogram extraction and pulse rate estimation". https://de.mathworks.com/matlabcentral/fileexchange/67527-matlab-package--imaging-photoplethysmogram-extraction-and-pulse-rate-estimation-

本数据集包含来自4只恒河猴的10次记录会话中采集的成像光电容积描记（imaging photoplethysmogram）提取原始数据，以及用于数据处理的Matlab脚本。本研究的详细细节请参考文献[1]。
使用说明：
1. 请下载该压缩归档文件并解压其中内容。
2. 请在MATLAB中运行dataset_analysis.m脚本，以复现文献[1]中描述的实验结果。若需了解代码的详细说明，请查阅[2]。本Matlab脚本依赖Matlab小波工具箱（Matlab Wavelet Toolbox）。
数据说明：
第N次会话的数据存储于SessionN文件夹中。会话1至8的数据包含4个文件：
- SessionN.bin：二进制格式的原始彩色信号数据，格式为r1 g1 b1 r2 g2 ……；
- SessionN_ROIdata.txt：用于计算彩色信号数据的感兴趣区域（Region of Interest, ROI）元数据；
- SessionN_interframeDif.txt：视频的帧间差值，可作为运动幅度的代理指标。格式为以换行符分隔的双精度数值流，在Matlab中可通过`a = load('SessionN_interframeDif.txt', '-ascii')`加载；
- SessionN_REF.csv：对应summary.txt文件中记录的时长区间内的平均参考脉搏率数值。
会话1的数据额外包含以下文件：
- Session1RegionN.bin：当感兴趣区域与区域3不同时，第1分区的二进制原始彩色信号数据；
- Session1RegionN_ROIdata.txt：当感兴趣区域与区域3不同时，第1分区彩色信号计算所用感兴趣区域的元数据。
会话2IR、9IR及10IR的数据包含3个文件：
- SessionN.bin：二进制格式的原始“彩色”（实际为单通道）信号数据，格式为i1 i1 i1 i2 i2 i2 ……；
- SessionN_ROIdata.txt：用于信号计算的感兴趣区域元数据；
- SessionN_REF.csv：对应summary.txt文件中记录的时长区间内的平均参考脉搏率数值。
参考文献：
[1] Unakafov AM, Möller S, Kagan I, Gail A, Treue S, Wolf F (2018) 利用成像光电容积描记技术估算非人灵长类动物的心率。bioRxiv. doi:10.1101/252403
[2] Matlab工具包"成像光电容积描记提取与脉搏率估算（Imaging photoplethysmogram extraction and pulse rate estimation）"。https://de.mathworks.com/matlabcentral/fileexchange/67527-matlab-package--imaging-photoplethysmogram-extraction-and-pulse-rate-estimation-