UI Name :
Spline_Motion_Correction

Syntax :
data_dod = hmrR_MotionCorrectSpline(data_dod, mlAct, tIncCh, p, turnon)

Description :
Perform a cubic spline correction of the motion artifacts identified in tIncCh. The algorithm follows the procedure describe by Scholkmann et al., Physiol. Meas. 31, 649-662 (2010). Set p = -1 to skip this function.

Inputs :

• data_dod:SNIRF data structure containing delta_OD
• mlAct:
• tIncCh: Matrix of included time points (1=included; 0=not included (movement) The matrix is #time points x #channels and usually comes from hmrR_MotionArtifactByChannel().
• p:Parameter p used in the spline interpolation. The value recommended in the literature is 0.99. Use -1 if you want to skip this motion correction.
• turnon: Optional argument to enable/disable this function in a processing stream chain.

Outputs :

• dod: SNIRF data structure containing delta_OD after spline interpolation correction, the same size as dod (Channels that are not in the active ml remain unchanged)

Usage Options :

• Spline_Motion_Correction: dod = hmrR_MotionCorrectSpline(dod, mlActAuto, tIncAutoCh, p, turnon)

Default Parameters :

• p=0.99
• turnon=1

Prerequisites :

• Motion_Artifact_By_Channel: [tIncAuto, tIncAutoCh] = hmrR_MotionArtifactByChannel(dod, probe, mlActMan, tIncMan, tMotion, tMask, STDEVthresh, AMPthresh)