Skip to content

Add EMG-ERP tutorial with EEGLAB #101

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 15 commits into from
Nov 27, 2025
Merged

Add EMG-ERP tutorial with EEGLAB #101

merged 15 commits into from
Nov 27, 2025

Conversation

@neuromechanist
Copy link
Member

@neuromechanist neuromechanist commented Nov 26, 2025 •
edited
Loading

Summary

  • Add new tutorial for processing EMG data with EEGLAB
  • Demonstrates loading BIDS-format EMG data
  • Shows EMG-specific preprocessing (bandpass 20-250 Hz)
  • Explains linear envelope computation for EMG-ERP analysis
  • Includes burst-initial keystroke methodology for cleaner ERPs
  • Documents that topoplots are not meaningful for forearm EMG

Figures included

  • Raw EMG data viewer
  • Power spectral density (spectopo without topoplots)
  • Preprocessing comparison
  • Envelope computation stages
  • Why envelope is needed (raw vs envelope ERP)
  • EMG-ERP lateralization results

Key points

  • Uses 20 Hz envelope cutoff (faster response for keystroke detection)
  • Burst-initial approach: only uses keystrokes preceded by >500ms pause
  • Correct channel assignment: Ch 1-16 = LEFT, Ch 17-32 = RIGHT
  • spectopo with 'freq', [] disables meaningless topoplots for forearm EMG

Test plan

  • Verify figures display correctly in markdown
  • Manual review of tutorial content
  • Test on Jekyll local build if available

@neuromechanist
update EMG tutorial: use 20Hz envelope, disable topoplots, add burst-…
7b679a3 
…initial approach

Key updates:
- Use 20Hz envelope cutoff for faster response in typing tasks
- Disable spectopo topoplots with freq=[] (not meaningful for EMG)
- Document burst-initial keystroke approach for rapid typing data
- Update channel assignment information
- Clarify workflow recommendation
@neuromechanist
Add EMG tutorial figures and update image paths
d6cfaf5 
- Add 6 tutorial figures for EMG processing workflow
- Update markdown to use consistent image paths in /assets/images/
- Figures: raw data, spectopo, preprocessing, envelope computation,
  envelope needed demo, ERP lateralization
@neuromechanist
Add individual channel ERPs figure to EMG tutorial
3982827
@neuromechanist
Replace generated figures with GUI screenshots for EMG tutorial
0f3e124 
- Add BIDS import dialog, result, and EEGLAB interface screenshots
- Add raw data viewer and spectopo screenshots
- Remove old programmatically generated figures
- Update markdown to reference new screenshots
@neuromechanist
Fix methodology inconsistencies in EMG tutorial
e5d7d1d 
- Fix envelope cutoff description (10 Hz -> 10-20 Hz)
- Fix variable names (left_channels -> left_wristband)
- Update figure descriptions to match actual figures
@neuromechanist
Update envelope computation figure with cleaner 4-stage visualization
a187972 
- Show raw, bandpass, rectified, and envelope stages vertically
- Two channels side-by-side (left and right wristband)
- Red dashed line marks keystroke event
- Update description to match new figure
@neuromechanist
Add Ruby 3.4 compatibility gems (csv, logger, base64, bigdecimal)
64fca34
@neuromechanist
Remove redundant envelope figure - figure 3c is sufficient
af8da20
@neuromechanist
Cleanup EMG tutorial: remove redundant sections and figures
8a2acb3 
- Remove preprocessing comparison section (envelope visualization is sufficient)
- Remove aggregate ERP visualization, keep only all-channels ERP
- Remove script sharing section
- Delete unused images: emg_erp_lateralization.png, emg_preprocessed_comparison.png
@neuromechanist
Resize dialog box screenshots to 60% width
dc755c9
@neuromechanist
Clarify all-channels figure: keystroke 'a', envelope data, trial coun…
7516c1f 
…t rationale
@neuromechanist
Update all-channels figure description: burst-initial keystrokes by h…
aa7694a 
…and/wristband
@neuromechanist
Add trial selection details and epoch counts to all-channels figure d…
a9d045b 
…escription
@neuromechanist
Update all-channels figure with descriptive subplot titles and epoch …
6e398b9 
…counts
@neuromechanist
remove unavailable links
98a5b85
@neuromechanist neuromechanist marked this pull request as ready for review November 27, 2025 16:07
@neuromechanist neuromechanist merged commit 8502de0 into master Nov 27, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@neuromechanist