Name: STFEEG-Tool: A Spatial-Temporal-Frequency EEG Analysis Tool for Motor Imagery Brain-Computer Interfaces (Video) | JoVE Journal
Uploaded: 2026-03-10T13:00:00.000+00:00
Duration: 5 min 36 s
Description: Learn STFEEG-Tool for motor imagery EEG analysis using spatial-temporal-frequency segmentation and visualization. This GUI-based workflow standardizes reproducible brain-computer interface decoding.

ai_agent_IP

ai_agent

maintenance

instantTrialDurationMinutes

isBiopharma

enableNewMyJoveSectionDesign

educationFeatures

seoMetaApi

ai_copilot_institution_blacklist

ai_chat_institution_blacklist

freeAccessWindow

ssoRoleCapture

scheduledMaintenanceBanner

joveLabsFeatures

disable_autoplay_for_bots

extended_trial_duration

5 minutes

This work was supported in part by the National Natural Science Foundation of China (No.62401342 and No.62271291), the Natural Science Foundation of Shandong Province (No.ZR2024QF092, ZR2024LZH007, and ZR2025ZD24), the Guangdong Basic and Applied Basic Research Foundation (No.2025A1515011826), the Shenzhen Fundamental Research Program (No.JCYJ20250604124702003), the Sichuan Provincial Key Laboratory of Philosophy and Social Science for Language Intelligence in Special Education (No.YYZN-2025-11), the National Key Research and Development Program of China (No.2024YFC2418300 and 2024YFC2418303), and the Key Laboratory of Social Computing and Cognitive Intelligence (Dalian University of Technology), Ministry of Education (No. SCCl2025YB02).

The data used in this protocol were obtained from publicly available, de-identified datasets. The original data collection procedures were conducted in accordance with the ethical standards of the respective institutions; therefore, no additional institutional approval was required for this secondary analysis.
Figure 1 illustrates the overall workflow of the Spatial-Temporal-Frequency Electroencephalography Analysis Tool. Follow the steps below to configure each module and reproduce the fine-grained spatial-frequency-time decoding protocol. The software used in this study is listed in the Table of Materials.
1. Preparation of the software and STFEEG-Tool package
<ol>
	<li>Install a numerical computing environment that supports MAT-file processing and GUI execution (see Table of Materials).</li>
	<li>Download STFEEG - Tool from the online repository, unzip it to a local folder, and locate the installer file STFEEG-Tool.mlappinstall.</li>
	<li>Double-click on STFEEG - Tool.mlappinstall, and follow the on-screen instructions to complete the installation.</li>
	<li>Open the App tab, confirm that STFEEG-Tool appears in the installed apps list (Figure 2), and click on it to launch the GUI (Figure 3).</li>
</ol>
2. Preparation of the input data MAT-file
<ol>
	<li>Create a MAT - file (.mat) containing four variables named TrainData, TrainLabel, TestData, and TestLabel.
	<ol>
		<li>Store TrainData and TestData as 3-D arrays of size Ntrials &#215; Nchannels &#215; Ntimepoints.</li>
		<li>Store TrainLabel and TestLabel as Ntrials &#215; 1 column vectors of integer class labels, using a consistent encoding across training and test sets. 
		NOTE: Construct TrainData and TestData from non-overlapping sessions or recording blocks to prevent information leakage.</li>
	</ol>
	</li>
	<li>Ensure that TrainData and TestData share the same channel order and sampling frequency (Hz).</li>
	<li>(Optional) Download the provided example MAT-file (Data.mat) based on BCI Competition IV 2a from the public repository to quickly test the software.</li>
</ol>
3. Launching the GUI and set paths
<ol>
	<li>Launch the STFEEG - Tool GUI to open the MI-EEG Analysis window (Figure 3).</li>
	<li>In the Data Loading panel, click on Browser next to Data Path and select the folder that contains the prepared MAT-file.</li>
	<li>Confirm that the sampling frequency Fs displayed in the GUI matches the dataset sampling frequency (Hz).</li>
	<li>Click on Browser next to Save Path and select an output folder to store results (e.g., configuration files, model files, and predicted labels).</li>
	<li>(Optional) Specify Model Path based on the intended use.
	<ol>
		<li>To save a model during training, click on Browser next to Model Path and select a destination folder; if Model Path is left empty, the software automatically saves the model in Save Path.</li>
		<li>To load a pretrained model for testing, click on Browser next to Model Path and select the folder that contains the saved model files.</li>
	</ol>
	</li>
	<li>Click on Load in the Data Loading panel to import the MAT-file. The software automatically checks the required variables and selected paths, and loads the dataset if no errors are reported.</li>
</ol>
4. Configuring the preprocessing (band-pass filtering)
<ol>
	<li>Use the default band-pass filter settings shown in the GUI (Order = 5, Fc1 = 5 Hz, Fc2 = 35 Hz, filter type = IIR) unless a different preprocessing configuration is required.</li>
	<li>(Optional) Enter the filter Order to override the default value.</li>
	<li>(Optional) Enter the lower and upper cutoff frequencies (Fc1 and Fc2) in Hz to override the default values.</li>
	<li>(Optional) Select the filter type from the drop-down menu to override the default option.</li>
	<li>Click on OK to confirm the preprocessing configuration. If no changes are made, the software applies the default settings shown in the panel.</li>
</ol>
5. Configuring the fine-grained segmentation strategy
<ol>
	<li>In the Segmentation Strategy panel of the main GUI, click on Edit to open the Segmentation configuration window.</li>
	<li>Configure temporal windows.
	<ol>
		<li>Select the Temporal Windows tab.</li>
		<li>Review the existing window list shown in the table (Figure 4).</li>
		<li>(Optional) To add windows, enter the Start, End, and Interval values, and click on Add to append the generated windows to the list.</li>
		<li>(Optional) To delete an existing window, right-click on the corresponding row in the table and select Delete.</li>
	</ol>
	</li>
	<li>Configure filter-bank frequency bands.
	<ol>
		<li>Select the Frequency Bands tab (Figure 5).</li>
		<li>Review the existing frequency-band list shown in the table.</li>
		<li>(Optional) To add bands, enter the Start (Hz), End (Hz), and Interval values, and click on Add to append the generated bands to the list.</li>
		<li>(Optional) To delete an existing band, right-click on the corresponding row in the table and select Delete.</li>
	</ol>
	</li>
	<li>Configure spatial segmentation by channel groups (Figure 6).
	<ol>
		<li>Select the Spatial Segmentation tab.</li>
		<li>Review the channel-group assignments in the Groups of Channel Number list.</li>
		<li>(Optional) To replace the current channel-group configuration, click on Browser next to Channel Groups to select a channel-group definition MAT-file.</li>
		<li>(Optional) To enable scalp visualizations, click on Browser next to Channel Location to select the channel-location file for the dataset channels. 
		NOTE: The public repository provides savedChCell.mat (channel-group definitions) and channel_locations_22ch.txt (22-channel scalp coordinates for BCI Competition IV 2a), which can be used directly with the included example data.</li>
		<li>(Optional) Click on Replace to load the selected channel-group file and update the Groups of Channel Number list. If a channel-location file has been selected in Channel Location, the tool also loads it for subsequent scalp visualizations (Figure 7).</li>
	</ol>
	</li>
	<li>Apply and verify the segmentation settings.
	<ol>
		<li>After completing the settings in all tabs, click on OK at the bottom of the Segmentation window to apply the updated temporal windows, frequency bands, and spatial segmentation.</li>
		<li>Return to the main GUI and confirm that the updated time bands, frequency bands, and channel groups are reflected in the Segmentation Strategy panel.</li>
	</ol>
	</li>
</ol>
6. Configuring the feature extraction, classifiers, and cross-validation
<ol>
	<li>In the Classification Configuration panel, select the Feature Extraction method from the drop-down menu. 
	NOTE: Detailed descriptions of CSP and div-CSP are provided in Supplementary File 1.</li>
	<li>Set nCSP to select CSP features from both ends of the feature vector. The tool retains the first nCSP and the last nCSP components (2 &#215; nCSP features in total).</li>
	<li>Select the classifier(s) by checking the corresponding boxes (SVM, Ridge-Optimal, Lasso-Optimal). 
	NOTE: Descriptions of the three classifiers are provided in Supplementary File 2.</li>
	<li>Set Selection Bands Number to specify how many fine-grained segments/features are retained in wrapper-based selection.</li>
	<li>Set Cross-Validation to specify the number of folds for k-fold cross-validation on TrainData/TrainLabel.</li>
	<li>(Optional) Enable Parallel to accelerate computation when multiple segments and classifiers are evaluated, if sufficient computational resources are available.</li>
	<li>Click on Cross - Validation to perform k-fold cross-validation on TrainData/TrainLabel and train the final model, then test the final model on TestData/TestLabel. 
	NOTE: If multiple classifiers are selected, the tool automatically selects and saves the model with the highest cross-validation accuracy, then uses it for test-set evaluation.</li>
</ol>
7. Viewing the results and visualizations
<ol>
	<li>After clicking on Cross - Validation&#160;in Step 6, review the performance summary displayed in the Results panel, including Validation Accuracy/Kappa, Test Accuracy/Kappa, and the Per-fold Training Time and Per-fold Testing Time. Record these values for reporting. 
	NOTE: Validation Accuracy/Kappa is reported as the mean k-fold cross-validation accuracy/kappa25 computed on TrainData/TrainLabel. Test Accuracy/Kappa is reported as the mean test-set accuracy/kappa25 obtained by evaluating the best model from each fold on TestData/TestLabel and averaging the test results across folds.</li>
	<li>Inspect the visualization outputs displayed in the Results panel.
	<ol>
		<li>Review the time-frequency topographical map to identify discriminative patterns across time, frequency, and scalp regions.</li>
		<li>Review the Electrode Group Significance Map to identify channel groups that contribute most to decoding. 
		NOTE: Detailed definitions, construction procedures, and interpretation guidelines for both maps are provided in Supplementary File 3.</li>
	</ol>
	</li>
	<li>(Optional) Run test-only evaluation using a previously trained model.
	<ol>
		<li>Click on Test Load Model&#160;to load a pretrained model from Model Path and evaluate it on the current input TestData/TestLabel.</li>
		<li>Select the Model Path folder saved during training (Step 3.5) and keep its directory structure unchanged. Ensure that model.mat is in the selected folder and param.mat is in the parent folder, as both are required to load the model and reproduce the visualizations.</li>
		<li>Confirm that, in this mode, the GUI reports Test Accuracy and Per-fold Testing Time for the loaded model, and the visualization panels update accordingly.</li>
		<li>(Optional) Locate the exported results in the save directory, which include predicted and true labels for further statistical testing.</li>
	</ol>
	</li>
</ol>

<ol><li>Guger, C., Ramoser, H., Pfurtscheller, G. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Real-time+EEG+analysis+with+subject-specific+spatial+patterns+for+a+brain-computer+interface+%28BCI%29%5BTitle%5D)+AND+%22IEEE+Trans+Rehabil+Eng%22%5BJournal%5D)">Real-time EEG analysis with subject-specific spatial patterns for a brain-computer interface (BCI).</a> IEEE Trans Rehabil Eng. 8 (4), 447-456 (2000).</li>
<li>Chaudhary, U., Birbaumer, N., Ramos-Murguialday, A. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Brain-computer+interfaces+for+communication+and+rehabilitation%5BTitle%5D)+AND+%22Nat+Rev+Neurol%22%5BJournal%5D)">Brain-computer interfaces for communication and rehabilitation.</a> Nat Rev Neurol. 12 (9), 513-525 (2016).</li>
<li>Khan, M. A., Das, R., Iversen, H. K., Puthusserypady, S. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Review+on+motor+imagery-based+BCI+systems+for+upper+limb+post-stroke+neurorehabilitation%3A+From+designing+to+application%5BTitle%5D)+AND+%22Comput+Biol+Med%22%5BJournal%5D)">Review on motor imagery-based BCI systems for upper limb post-stroke neurorehabilitation: From designing to application.</a> Comput Biol Med. 123, 103843(2020).</li>
<li>Pfurtscheller, G., Neuper, C. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Motor+imagery+and+direct+brain-computer+communication%5BTitle%5D)+AND+%22Proc+IEEE%22%5BJournal%5D)">Motor imagery and direct brain-computer communication.</a> Proc IEEE. 89 (7), 1123-1134 (2001).</li>
<li>Jiang, A., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Efficient+CSP+algorithm+with+spatio-temporal+filtering+for+motor+imagery+classification%5BTitle%5D)+AND+%22IEEE+Trans+Neural+Syst+Rehabil+Eng%22%5BJournal%5D)">Efficient CSP algorithm with spatio-temporal filtering for motor imagery classification.</a> IEEE Trans Neural Syst Rehabil Eng. 28 (4), 1006-1016 (2020).</li>
<li>Samek, W., Kawanabe, M., Müller, K. -R. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Divergence-based+framework+for+common+spatial+patterns+algorithms%5BTitle%5D)+AND+%22IEEE+Rev+Biomed+Eng%22%5BJournal%5D)">Divergence-based framework for common spatial patterns algorithms.</a> IEEE Rev Biomed Eng. 7, 50-72 (2013).</li>
<li>Filter bank common spatial pattern (FBCSP) in motor imagery BCI. Ang, K. K., Chin, Z. Y., Zhang, H., Guan, C. Proc IEEE Int Joint Conf Neural Netw. (IJCNN), Hong Kong, , 2390-2397 (2008).</li>
<li>Kumar, S., Sharma, A., Tsunoda, T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((An+improved+discriminative+filter+bank+selection+approach+for+motor+imagery+EEG+signal+classification+using+mutual+information%5BTitle%5D)+AND+%22BMC+Bioinformatics%22%5BJournal%5D)">An improved discriminative filter bank selection approach for motor imagery EEG signal classification using mutual information.</a> BMC Bioinformatics. 18 (16), 545(2017).</li>
<li>Zhang, X., She, Q., Chen, Y., Kong, W., Mei, C., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Sub-band+target+alignment+common+spatial+pattern+in+brain-computer+interface%5BTitle%5D)+AND+%22Comput+Methods+Programs+Biomed%22%5BJournal%5D)">Sub-band target alignment common spatial pattern in brain-computer interface.</a> Comput Methods Programs Biomed. 207, 106150(2021).</li>
<li>Yang, J., Ma, Z., Shen, T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Multi-time+and+multi-band+CSP+motor+imagery+EEG+feature+classification+algorithm%5BTitle%5D)+AND+%22Appl+Sci%22%5BJournal%5D)">Multi-time and multi-band CSP motor imagery EEG feature classification algorithm.</a> Appl Sci. 11 (21), 10294(2021).</li>
<li>Hwang, J., Park, S., Chi, J. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Improving+multi-class+motor+imagery+EEG+classification+using+overlapping+sliding+window+and+deep+learning+model%5BTitle%5D)+AND+%22Electronics%22%5BJournal%5D)">Improving multi-class motor imagery EEG classification using overlapping sliding window and deep learning model.</a> Electronics. 12 (5), 1186(2023).</li>
<li>Liu, G., Tian, L., Zhou, W. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Multiscale+time-frequency+method+for+multiclass+motor+imagery+brain+computer+interface%5BTitle%5D)+AND+%22Comput+Biol+Med%22%5BJournal%5D)">Multiscale time-frequency method for multiclass motor imagery brain computer interface.</a> Comput Biol Med. 143, 105299(2022).</li>
<li>Liu, A., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Feature+selection+for+motor+imagery+EEG+classification+based+on+the+firefly+algorithm+and+learning+automata%5BTitle%5D)+AND+%22Sensors%22%5BJournal%5D)">Feature selection for motor imagery EEG classification based on the firefly algorithm and learning automata.</a> Sensors. 17 (11), 2576(2017).</li>
<li>Kabir, M. H., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Investigating+feature+selection+techniques+to+enhance+the+performance+of+EEG-based+motor+imagery+tasks+classification%5BTitle%5D)+AND+%22Mathematics%22%5BJournal%5D)">Investigating feature selection techniques to enhance the performance of EEG-based motor imagery tasks classification.</a> Mathematics. 11 (8), 1921(2023).</li>
<li>Wang, A., An, N., Chen, G., Li, L., Alterovitz, G. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Accelerating+wrapper-based+feature+selection+with+k-nearest-neighbor%5BTitle%5D)+AND+%22Knowl+Based+Syst%22%5BJournal%5D)">Accelerating wrapper-based feature selection with k-nearest-neighbor.</a> Knowl Based Syst. 83, 81-91 (2015).</li>
<li>Andrews, S., Tsochantaridis, I., Hofmann, T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Support+vector+machines+for+multiple-instance+learning%5BTitle%5D)+AND+%22Adv+Neural+Inf+Process+Syst%22%5BJournal%5D)">Support vector machines for multiple-instance learning.</a> Adv Neural Inf Process Syst. 15, 577-584 (2002).</li>
<li>You, Y., Chen, W., Zhang, T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Motor+imagery+EEG+classification+based+on+flexible+analytic+wavelet+transform%5BTitle%5D)+AND+%22Biomed+Signal+Process+Control%22%5BJournal%5D)">Motor imagery EEG classification based on flexible analytic wavelet transform.</a> Biomed Signal Process Control. 62, 102069(2020).</li>
<li>Jin, J., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Correlation-based+channel+selection+and+regularized+feature+optimization+for+MI-based+BCI%5BTitle%5D)+AND+%22Neural+Netw%22%5BJournal%5D)">Correlation-based channel selection and regularized feature optimization for MI-based BCI.</a> Neural Netw. 118, 262-270 (2019).</li>
<li>Chen, S., Li, N., Kong, X., Huang, D., Zhang, T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Electroencephalography-based+motor+imagery+classification+using+multi-scale+feature+fusion+and+adaptive+lasso%5BTitle%5D)+AND+%22Big+Data+and+Cogn+Comput%22%5BJournal%5D)">Electroencephalography-based motor imagery classification using multi-scale feature fusion and adaptive lasso.</a> Big Data and Cogn Comput. 8 (12), 169(2024).</li>
<li>Swartz Center for Computational Neuroscience. <a target="_blank" href="http://scholar.google.com/scholar?hl=en&safe=off&q=%22What+is+EEGLAB%22">What is EEGLAB</a>. , SCCN, University of California San Diego. https://sccn.ucsd.edu/eeglab/index.php (2025).</li>
<li>Zander, T. O. <a target="_blank" href="http://scholar.google.com/scholar?hl=en&safe=off&q=author%3aZander%2C+TO+%22BCILAB+Documentation%22">BCILAB Documentation</a>. , Available at:Â https://github.com/sccn/BCILAB/wiki/BCILAB-documentation (2020).</li>
<li>Tarara, P., Przybył, I., Schöning, J., Gunia, A. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Motor+imagery-based+brain-computer+interfaces%3A+An+exploration+of+multiclass+motor+imagery-based+control+for+Emotiv+EPOC+X%5BTitle%5D)+AND+%22Front+Neuroinform%22%5BJournal%5D)">Motor imagery-based brain-computer interfaces: An exploration of multiclass motor imagery-based control for Emotiv EPOC X.</a> Front Neuroinform. 19, 1625279(2025).</li>
<li>Singh, G., Chharia, A., Upadhyay, R., Kumar, V., Longo, L. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Pynoetic%3A+A+modular+Python+framework+for+no-code+development+of+EEG+brain-computer+interfaces%5BTitle%5D)+AND+%22PLoS+ONE%22%5BJournal%5D)">Pynoetic: A modular Python framework for no-code development of EEG brain-computer interfaces.</a> PLoS ONE. 20 (1), e0327791(2025).</li>
<li>Liu, G., Zhang, R., Tian, L., Zhou, W. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Fine-grained+spatial-frequency-time+framework+for+motor+imagery+brain-computer+interface%5BTitle%5D)+AND+%22IEEE+J+Biomed+Health+Inform%22%5BJournal%5D)">Fine-grained spatial-frequency-time framework for motor imagery brain-computer interface.</a> IEEE J Biomed Health Inform. 29, 4121-4133 (2025).</li>
<li>Allison, B. Z., Dunne, S., Leeb, R., Millán, J. D. R., Nijholt, A. <a target="_blank" href="http://scholar.google.com/scholar?hl=en&safe=off&q=author%3aAllison%2C+BZ+%22Towards+Practical+Brain-Computer+Interfaces%3A+Bridging+the+Gap+from+Research+to+Real-World+Applications%22">Towards Practical Brain-Computer Interfaces: Bridging the Gap from Research to Real-World Applications</a>. , Springer. Berlin. (2012).</li>
<li>Ang, K. K., Chin, Z. Y., Wang, C., Guan, C., Zhang, H. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Filter+bank+common+spatial+pattern+algorithm+on+BCI+competition+IV+datasets+2a+and+2b%5BTitle%5D)+AND+%22Front+Neurosci%22%5BJournal%5D)">Filter bank common spatial pattern algorithm on BCI competition IV datasets 2a and 2b.</a> Front Neurosci. 6, 39(2012).</li>
<li>Dornhege, G., Blankertz, B., Curio, G., Muller, K. -R. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((Boosting+bit+rates+in+noninvasive+EEG+single-trial+classifications+by+feature+combination+and+multiclass+paradigms%5BTitle%5D)+AND+%22IEEE+Trans+Biomed+Eng%22%5BJournal%5D)">Boosting bit rates in noninvasive EEG single-trial classifications by feature combination and multiclass paradigms.</a> IEEE Trans Biomed Eng. 51 (6), 993-1002 (2004).</li>
<li>Das, R. K., Martin, A., Zurales, T., Dowling, D., Khan, A. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/pubmed?term=((A+survey+on+EEG+data+analysis+software%5BTitle%5D)+AND+%22Sci%22%5BJournal%5D)">A survey on EEG data analysis software.</a> Sci. 5 (2), 23(2023).</li>
<li>Omar, L. <a target="_blank" href="http://scholar.google.com/scholar?hl=en&safe=off&q=%22VT2%3A+A+Python+Pipeline+for+EEG+Processing+%5BMaster%27s+%5D%22">VT2: A Python Pipeline for EEG Processing [Master's thesis]</a>. , ZHAW - Zurich University of Applied Sciences. Available at:Â https://www.zhaw.ch/storage/engineering/institute-zentren/cai/studentische_arbeiten/Spring_2024/VT2_MSE_24_PyThon_pipeline_lone.pdf (2024).</li>
</ol>

The authors have no conflicts of interest to declare.

STFEEG-Tool is designed as an MI-EEG-specific toolbox that complements established EEG ecosystems such as EEGLAB20, BCILAB21, OpenViBE22, PyNoetic23. While these platforms provide flexible components for MI decoding, fine-grained spatial-temporal-frequency configuration and model-informed interpretation may involve additional integration across processing steps. This is particularly relevant when explicit electrode-group decom...

Motor imagery brain-computer interfaces (MI-BCIs) enable direct communication between the human brain and external devices without requiring peripheral muscle activity1. In recent years, MI-BCI technology has been widely applied in neurorehabilitation2, assistive control3, and human-computer interaction4. These applications highlight the need for accessible and reproducible analysis workflows that can be reliably adopted by researchers and clinicians, including users with limited programming expertise.
Conventional MI-EEG decoding approaches are predominantly based on spatial filtering and linear classification frameworks. Methods such as Common Spatial Pattern5 (CSP) and divergence-based CSP6 (div-CSP) have been widely used to extract discriminative spatial features from multi-channel EEG signals. To further extract features across distinct frequency components, Filter Bank CSP7 (FBCSP) and Sub-band CSP8,9 (SBCSP) have been extensively explored. In addition, temporal segmentation has been integrated into the feature extraction process by dividing each trial into multiple time intervals, allowing the capture of evolving discriminative patterns and further enhancing decoding performance10,11,12. To enhance the discriminability of extracted features, various feature selection strategies have been introduced to reduce redundancy and mitigate overfitting13,14,15. For classification, traditional machine learning models such as support vector machines16 and regularized regression classifiers17,18,19 continue to be widely used because of their interpretability and computational efficiency.
Despite their effectiveness, these approaches are typically implemented in customized, dataset-specific codebases, which complicates systematic reuse and independent verification. Several graphical user interface (GUI)-based software platforms have been developed to support EEG analysis and BCI research. For example, EEGLAB20 offers a comprehensive suite of functions for EEG preprocessing, time-frequency analysis, feature extraction, classification, and advanced visualization. Its highly modular and extensible architecture has enabled broad adoption within the EEG research field. BCILAB21, in integration with EEGLAB, incorporates over 100 signal processing and machine learning algorithms spanning the entire decoding pipeline, from preprocessing to classification. Similarly, OpenViBE22 offers a visual programming environment for designing real-time BCI workflows, in which users can assemble signal-processing pipelines by graphically linking modular components. The platform is particularly suited for online EEG acquisition and real-time stimulus-response paradigms, and has been widely used in the development and testing of interactive BCI applications. In addition, PyNoetic, a modular Python framework for no-code EEG brain-computer interface development, enables end-to-end BCI workflow construction through an integrated GUI supporting data acquisition, preprocessing, feature extraction, and classification23. Unlike earlier tools that require substantial manual configuration or scripting, PyNoetic offers a higher level of abstraction for pipeline design, enabling flexible assembly and reconfiguration of processing stages without low-level programming. In many MI-EEG studies, these platforms can already support routine preprocessing, conventional feature extraction, and baseline decoding and evaluation.
Several GUI-based platforms support MI-EEG analysis through standardized preprocessing, feature extraction, and baseline decoding (Table 1). However, they lack optimization for fine-grained spatial-frequency-time decomposition, including user-defined spatial partitioning and cross-domain visualization. To address these methodological needs, a fine-grained spatial-temporal-frequency decoding framework for MI-EEG24 was previously proposed, jointly modeling spatial electrode groups, frequency sub-bands, and temporal segments to improve decoding performance and enhance multi-domain interpretability. Building on this framework, the Spatial-Temporal-Frequency EEG analysis tool (STFEEG-Tool) was developed as a graphical user interface (GUI)-based toolbox that standardizes fine-grained MI-EEG decoding within a configurable and reproducible workflow while remaining compatible with existing EEG toolchains.
STFEEG-Tool integrates data preparation, preprocessing, spatial-temporal-frequency segmentation, feature extraction, wrapper-based feature selection, classification, and visualization into a unified pipeline. Rather than replacing established EEG toolboxes, it complements them through transparent parameter specification, consistent pipeline execution, and model-informed visualization to support fine-grained analysis.
The main contributions of this work are threefold. First, STFEEG-Tool provides a user-friendly, end-to-end GUI workflow with standardized parameter configuration for fine-grained MI-EEG decoding. Second, it enables multiscale spatial-temporal-frequency segmentation, including user-defined spatial decomposition, which is not consistently available on general-purpose platforms. Third, it enhances interpretability through time-frequency topographical maps and electrode-group significance maps that summarize discriminative contributions and reveal subject-specific MI-relevant patterns across domains.
The toolbox is open-source and available at:&#160;https://github.com/CissyZR/Spatial-Frequency-Temporal_EEG_Analysis_Tool&#160;

<table><tbody><tr><td>MATLAB</td><td>MathWorks</td><td>&lt;strong&gt;Version R2024a&lt;/strong&gt;</td><td>Software environment for numerical computing, signal processing, and GUI development.</td></tr><tr><td>Signal Processing Toolbox</td><td>MathWorks</td><td>https://ww2.mathworks.cn/en/products/signal.html</td><td>Toolbox for digital filtering and time-frequency analysis</td></tr><tr><td>Statistics and Machine Learning Toolbox</td><td>MathWorks</td><td>https://ww2.mathworks.cn/en/products/statistics.html</td><td>Toolbox for model training and statistical analysis</td></tr></tbody></table>

stfeeg-tool: a spatial-temporal-frequency eeg analysis tool for motor imagery brain-computer interfaces

STFEEG-Tool: A Spatial-Temporal-Frequency EEG Analysis Tool for Motor Imagery Brain-Computer Interfaces

Motor imagery-brain-computer interfaces (MI-BCIs) have demonstrated significant potential for neurorehabilitation and cognitive neuroscience. However, a standardized and reproducible MI-EEG workflow for configurable spatial-temporal-frequency feature analysis remains limited, and many pipelines require complex configuration and parameter tuning with limited interpretability, hindering practical deployment and generalization. To address these challenges, an STFEEG-Tool was developed to provide a user-friendly, standardized, and interpretable workflow for EEG decoding in MI paradigms. STFEEG-Tool enables fine-grained configuration of temporal, frequency-band, and spatial segmentation, allowing the extraction of multiscale MI features. The toolbox integrates multiple feature extraction algorithms, including common spatial patterns (CSP) and divergence-based CSP (div-CSP), along with various classifiers, such as support vector machines (SVMs), Ridge Regression Classifier, and Lasso Classifier. A dynamic time-frequency scalp topographical map is provided to summarize spatial patterns across time-frequency segments and support interpretation of decoding results. Overall, STFEEG-Tool serves as a reproducible and extensible platform for fine-grained MI-EEG analysis, facilitating the translation of fine-grained decoding pipelines into practical, user-oriented applications.

The STFEEG-Tool was validated on both the BCI Competition IV 2a26 and the BCI Competition III 3a27, and the system successfully executed the complete decoding pipeline in both cases. The fixed cross-session protocol of BCI Competition IV 2a was followed: training on Session 1 and evaluation on the held-out Session 2, recorded on two separate days. Under the same configuration used in the previously reported fine-grained spatial-temporal-frequency framework...

This study presents a standardized and reproducible protocol for implementing the Spatial-Temporal-Frequency EEG analysis tool (STFEEG) for motor imagery EEG decoding, incorporating configurable spatial-temporal-frequency segmentation, Common Spatial Patterns (CSP)-based feature extraction, multiple classification algorithms, and visualization capabilities.

Motor imagery-brain-computer interfaces (MI-BCIs) have demonstrated significant potential for neurorehabilitation and cognitive neuroscience. However, a ...

This work develops a GUI-based toolbox for fun grid motor imagery EEG decoding and interpretable spatial-temporal-frequency analysis. Existing platforms lack integrated fun grid spatial, temporal, and frequency configuration with intuitive visualization for motor imagery EEG analysis. To begin, download STFEEG Tool from the online repository.Unzip the downloaded file to a local folder and locate the installer file, STFEEG-Tool. mlappinstall, in the extracted contents. Double-click on STFEEG-Tool.mlappinstall to launch the installer and follow the onscreen instructions to complete the installation. After downloading the example MAT-file, launch the STFEEG Tool graphical user interface to open the Motor Imagery EEG Analysis window. In the Data Loading panel, click on Browser next to Data Path and select the folder containing the prepared MAT-file.Now, click on Browser next to Save Path and select an output folder for results. Click on Load in the Data Loading panel to import the MAT-file. In the Segmentation Strategy panel of the main graphical user interface, click on Edit to open the Segmentation configuration window where the default parameter settings are already provided.To configure the temporal windows, select the Temporal Windows tab in the configuration window. Enter the start, end, and interval values to define temporal windows. Then click on Add to append the generated windows to the list.To delete an existing window, right-click on the corresponding row in the table and select Delete. To configure filter bank frequency bands, select the Frequency Bands tab in the configuration window. Enter the start, end, and interval values to define frequency bands.Then click on Add to append the generated bands to the list. To delete an existing frequency band, right-click on the corresponding row in the table and select Delete. To configure spatial segmentation by channel groups, select the Spatial Segmentation tab in the configuration window.Click on Browser next to Channel Groups to select a channel group definition MAT-file. Click on Replace to load the selected channel group file and update the Groups of Channel Number list. If a channel location file has been selected in Channel Location, the tool also loads it for subsequent scalp visualizations.Click on OK at the bottom of the Segmentation window to apply the updated temporal windows, frequency bands, and spatial segmentation. The Segmentation Strategy panel of the main graphical user interface is updated accordingly. In the Classification Configuration panel, select the Feature Extraction method from the dropdown menu.Set nCSP to retain features from both ends of the feature vector. Then select the classifiers by checking the corresponding boxes. Set the Selection Bands Number to specify how many fine-grained segments or features are retained in wrapper-based selection.Set Cross-Validation to specify the number of folds for k-fold cross-validation on train data and train label. Then click on Cross-Validation to perform k-fold cross-validation. Review the performance summary displayed in the Results panel.Review the Time-Frequency Topographical Map to identify discriminative patterns across time, frequency, and scalp regions. Review the Electrode Group Significance Map to identify channel groups that contribute most to decoding. The Time-Frequency Topographical Map illustrated the spatial distribution of discriminative EEG patterns across frequency and temporal segments.The Electrode Group Significance Map quantified the contribution of predefined electrode groups to decoding performance. This protocol both standardized decoding quantitative evaluation and visualization of subject-specific motor imagery EEG patterns. A key challenge is ensuring that pre-processing classification and multi-scale segmentation remain flexible and practicable across different datasets.This workflow can spot interpretable analysis of subject-specific differences, and guide the development of more adaptive and generalizable MI-EEG decoding models.

stfeeg-tool-spatial-temporal-frequency-eeg-analysis-tool-for-motor

Research

JoVE Journal

Neuroscience

We present a method for collecting electrocorticographic signals for research purposes from humans who are undergoing invasive epilepsy monitoring.  We show how to use the BCI2000 software platform for data collection, signal processing and stimulus presentation.  Specifically, we demonstrate SIGFRIED, a BCI2000-based tool for real-time functional brain mapping.

Recording Human Electrocorticographic (ECoG) Signals for Neuroscientific Research and Real-time Functional Cortical Mapping

We use magneto- and electroencephalography (MEG/EEG), combined with anatomical information captured by magnetic resonance imaging (MRI), to map the dynamics of the cortical network associated with auditory attention.

Mapping Cortical Dynamics Using Simultaneous MEG/EEG and Anatomically-constrained Minimum-norm Estimates: an Auditory Attention Example

This paper describes a method for collecting and analyzing electroencephalography (EEG) data during concurrent transcranial magnetic stimulation (TMS) guided by activations revealed with functional magnetic resonance imaging (fMRI). A method for TMS artifact removal and extraction of event related potentials is described as well as considerations in paradigm design and experimental setup.

Extracting Visual Evoked Potentials from EEG Data Recorded During fMRI-guided Transcranial Magnetic Stimulation

Monitoring brain activity during upright motor tasks is of great value when investigating the neural source of movement disorders. Here, we demonstrate a protocol that combines functional near infrared spectroscopy with continuous monitoring of muscle and kinematic activity during 4 types of motor tasks.

Functional Near Infrared Spectroscopy of the Sensory and Motor Brain Regions with Simultaneous Kinematic and EMG Monitoring During Motor Tasks

Resting-state functional-connectivity MRI has identified abnormalities in patients with a wide range of neuropsychiatric disorders, including epilepsy due to malformations of cortical development. Transcranial Magnetic Stimulation in combination with EEG can demonstrate that patients with epilepsy have cortical hyperexcitability in regions with abnormal connectivity.

A Multimodal Imaging- and Stimulation-based Method of Evaluating Connectivity-related Brain Excitability in Patients with Epilepsy

An EEG-fMRI multimodal imaging method, known as the spatiotemporal fMRI-constrained EEG source imaging method, is described here. The presented method employs conditionally-active fMRI sub-maps, or priors, to guide EEG source localization in a manner that improves spatial specificity and limits erroneous results.

Concurrent EEG and Functional MRI Recording and Integration Analysis for Dynamic Cortical Activity Imaging

The purpose of this study is to provide an important reference for the standard clinical operation of motor imagery brain-computer interface (MI-BCI) for upper limb motor dysfunction after stroke.

Motor Imagery Brain-Computer Interface in Rehabilitation of Upper Limb Motor Dysfunction After Stroke

Magnetoencephalography (MEG) and high-density electroencephalography (HD-EEG) are rarely recorded simultaneously, although they yield confirmatory and complementary information. Here, we illustrate the experimental setup for recording simultaneous MEG and HD-EEG and the methodology for analyzing these data aiming to localize epileptogenic and eloquent brain areas in children with drug-resistant epilepsy.

Electromagnetic Source Imaging in Presurgical Evaluation of Children with Drug-Resistant Epilepsy

Motor imagery in a virtual reality environment has wide applications in brain-computer interface systems. This manuscript outlines the use of personalized digital avatars that resemble the participants performing movements imagined by the participant in a virtual reality environment to enhance immersion and a sense of body ownership.

Motor Imagery Performance Through Embodied Digital Twins in a Virtual Reality-Enabled Brain-Computer Interface Environment

A novel protocol for personalized transcranial magnetic stimulation in combination with electroencephalography (TMS–EEG) mapping of cortical networks, informed by multiple magnetic resonance imaging (MRI) data modalities.

Neuroimaging-Guided TMS&#8211;EEG for Real-Time Cortical Network Mapping

Learn STFEEG-Tool for motor imagery EEG analysis using spatial-temporal-frequency segmentation and visualization. This GUI-based workflow standardizes reproducible brain-computer interface decoding.

STFEEG-Tool: A Spatial-Temporal-Frequency EEG Analysis Tool for Motor Imagery Brain-Computer Interfaces

Explore More Videos