hmrR_MotionCorrectSpline - BUNPC/Homer3 GitHub Wiki

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)

Join the Homer3 community on openfnirs.org!

⚠️ **GitHub.com Fallback** ⚠️