Demographics Demo

Demographics, Stimulus

Demographics, Stimulus

Please contact Ted ([email protected]) or Hendrik ([email protected]) to request more demos, suggestions, feedback, etc. We will update this script as needed.

2.1 Demographics

2.1.1 Adding demographics from excel file

This example show how to add demographic frome an Excel file to raw data.
clear all
clc
load(‘AnalyzIR_Dataset1.mat’);
 
demo = readtable(‘AnalyzIR_Demographic1.xlsx’);
 
job=nirs.modules.AddDemographics;
job.allowMissing = true;
job.demoTable=demo;
job.varToMatch=‘subject’;
raw=job.run(raw);
 
nirs.createDemographicsTable(raw)
ans = 68×8 table
 groupsubjectAgeMonthsSexHeadSizeADHDRiskScore
1‘G1’‘S11’14‘M’437‘A’1
2‘G1’‘S12’14‘M’458‘B’6
3‘G1’‘S13’30‘F’427‘C’5
4‘G1’‘S15’13‘M’459‘C’6
5‘G1’‘S17’36‘F’448‘B’4
6‘G1’‘S19’29‘F’441‘B’3
7‘G1’‘S22’25‘M’437‘C’6
8‘G1’‘S23’19‘F’453‘A’4
9‘G1’‘S27’19‘M’432‘B’4
10‘G1’‘S28’32‘F’441‘C’2
11‘G1’‘S29’20‘M’428‘A’5
12‘G1’‘S30’27‘F’4210‘C’1
13‘G2’‘S32’35‘F’4410‘A’6
14‘G1’‘S36’12‘M’448‘C’5
â‹®

2.1.2 Adding demographics manually

This example show how to add demographic information manually
raw(1).demographics
ans =
Dictionary Class Containing: group : G1 subject : S11 AgeMonths : 14 Sex : M HeadSize : 43 ADHD : 7 Risk : A Score : 1
raw(1).demographics(‘ClinicalScore’) = 10;
raw(1).demographics(‘Covariates’) = ‘population1’;
raw(1).demographics
ans =
Dictionary Class Containing: group : G1 subject : S11 AgeMonths : 14 Sex : M HeadSize : 43 ADHD : 7 Risk : A Score : 1 ClinicalScore : 10 Covariates : population1

2.1.3 Modify demographics

This example show how to modify Score demographics (between 1-6) to Low (1-2), Medium (3-4), and High (5-6)
tblDemo = nirs.createDemographicsTable(raw);
for i = 1:length(raw)
if tblDemo.Score(i) <= 2
raw(i).demographics(‘ScoreEdit’) = ‘Low’;
elseif tblDemo.Score(i) >= 5
raw(i).demographics(‘ScoreEdit’) = ‘High’;
else
raw(i).demographics(‘ScoreEdit’) = ‘Medium’;
end
end
nirs.createDemographicsTable(raw)
ans = 68×11 table
 groupsubjectAgeMonthsSexHeadSizeADHDRiskScoreClinicalScoreCovariatesScoreEdit
1‘G1’‘S11’14‘M’437‘A’110‘population1’‘Low’
2‘G1’‘S12’14‘M’458‘B’6NaN”‘High’
3‘G1’‘S13’30‘F’427‘C’5NaN”‘High’
4‘G1’‘S15’13‘M’459‘C’6NaN”‘High’
5‘G1’‘S17’36‘F’448‘B’4NaN”‘Medium’
6‘G1’‘S19’29‘F’441‘B’3NaN”‘Medium’
7‘G1’‘S22’25‘M’437‘C’6NaN”‘High’
8‘G1’‘S23’19‘F’453‘A’4NaN”‘Medium’
9‘G1’‘S27’19‘M’432‘B’4NaN”‘Medium’
10‘G1’‘S28’32‘F’441‘C’2NaN”‘Low’
11‘G1’‘S29’20‘M’428‘A’5NaN”‘High’
12‘G1’‘S30’27‘F’4210‘C’1NaN”‘Low’
13‘G2’‘S32’35‘F’4410‘A’6NaN”‘High’
14‘G1’‘S36’12‘M’448‘C’5NaN”‘High’
â‹®

2.2 Stimulus Events

2.2.1 Rename stimulus events

This example show how to rename stimulus events ‘A’ and ‘B’ to ‘TaskA’, and ‘TaskB’
job = nirs.modules.RenameStims();
job.listOfChanges = {‘A’, ‘TaskA’; ‘B’, ‘TaskB’};
raw = job.run(raw);
figure; raw(1).draw

2.2.2 Edit stimulus events

This example show how to change duration (TaskA and TaskB has 2-s), change to 4-s
for i = 1:length(raw)
stimA = nirs.design.StimulusEvents;
stimA.name = ‘TaskA’;
stimA.onset = raw(i).stimulus(‘TaskA’).onset;
stimA.amp = ones(21,1);
stimA.dur = ones(21,1)*4;
raw(i).stimulus(‘TaskA’) = stimA;
stimB = nirs.design.StimulusEvents;
stimB.name = ‘TaskB’;
stimB.onset = raw(i).stimulus(‘TaskB’).onset;
stimB.amp = ones(21,1);
stimB.dur = ones(21,1)*4;
raw(i).stimulus(‘TaskB’) = stimB;
end
figure; raw(1).draw
 
%Another alternative, we can automatically change all duration to 3-s
raw = nirs.design.change_stimulus_duration(raw, ‘TaskA’, 3);
raw = nirs.design.change_stimulus_duration(raw, ‘TaskB’, 3);

2.2.3 Adding stimulus events

This example show how to add stimulus events
stim = nirs.design.StimulusEvents;
stim.name = ‘TaskC’;
stim.onset = [50 150 250];
stim.amp = ones(3,1);
stim.dur = ones(3,1)*75;
raw(1).stimulus(‘Newstim’) = stim;
figure; raw(1).draw

2.2.3 Keep stimulus

This example show how to Keep stimulus
job = nirs.modules.KeepStims();
job.listOfStims = {‘TaskA’, ‘TaskB’};
raw = job.run(raw);
figure; raw(1).draw