استيراد ملف خام: EDF و BDF و BrainVision

كيف أطبّقها في EEGLAB؟

1. نزّل ملف التمرين

نستخدم ملفاً واحداً من داتاست (dataset) PhysioNet المفتوحة لحركة اليد وتخيّلها: S001R03.edf. فيه 64 قناة بمعدل 160 هرتز، ومدته حوالي دقيقتين، وأحداثه مخزّنة داخل الملف.

1. افتح صفحة الداتاست: EEG Motor Movement/Imagery Dataset.
2. ادخل مجلد S001 ونزّل الملف S001R03.edf.
3. ضعه في مجلد خاص بهذه الدروس، بعيداً عن مجلد EEGLAB.

2. استورد الملف

1. من نافذة EEGLAB افتح: File › ثم Import data › ثم Using EEGLAB functions and plugins › ثم From EDF/EDF+/GDF files (BIOSIG toolbox)
2. إذا لم تكن Biosig مثبّتة، يسألك EEGLAB عن تنزيلها. اضغط Yes.
3. اختر الملف S001R03.edf.
4. تظهر نافذة Load data using BIOSIG — pop_biosig(). اترك كل الخانات على قيمها الافتراضية:
   • Channel list (default all): فارغة، أي كل القنوات.
   • Data range (in seconds) to read (default all [0 …]) فارغة، أي التسجيل كله.
   • Import EDF+ annotations (try also mexSLOAD below) مفعّلة. الـ annotations ملاحظات نصية مخزّنة داخل ملف EDF+ مع توقيتها (latency)، ومنها تأتي الأحداث في هذا الملف.
5. اضغط OK.

3. سمِّ الداتاست واحفظها

1. تظهر نافذة لتسمية الداتاست الجديدة. في خانة Name it: اكتب S001R03.
2. فعّل خانة Save it as file: واختر اسماً مثل S001R03.set في مجلد الدروس.
3. اضغط OK.

الحفظ بصيغة .set يعني أنك لن تكرر الاستيراد في الدرس التالي. والملف الأصلي .edf يبقى كما هو.

4. ملف BDF أو BrainVision بدل EDF

• BDF (أجهزة BioSemi): نفس الإضافة (plugin) من File › ثم Import data › ثم Using EEGLAB functions and plugins › ثم From Biosemi BDF file (BIOSIG toolbox). اكتب رقم قناة مرجع في خانة Reference chan(s) indices - recommended for BIOSEMI، مثل قناتي الماستويد. رقم القناة يختلف حسب ترتيب أقطابك (electrode)، فارجع لملف التخطيط (montage) الخاص بجهازك. السبب في «أخطاء شائعة».
• BrainVision (أجهزة Brain Products): التسجيل ثلاثة ملفات بنفس الاسم: .vhdr و .vmrk و .eeg. افتح File › ثم Import data › ثم Using EEGLAB functions and plugins › ثم From Brain Vis. Rec. .vhdr file واختر ملف .vhdr. إذا لم تكن إضافة bva-io مثبّتة، يعرض EEGLAB تنزيلها. بعد تثبيتها يصبح اسم القائمة From Brain Vis. Rec. .vhdr or .ahdr file.
• صيغة لا تعرفها: جرّب File › ثم Import data › ثم Using the FILE-IO interface ثم File › ثم Import data › ثم Using the BIOSIG interface. وإذا فشل الاثنان، ابحث باسم جهازك في File › ثم Manage EEGLAB extensions. يقول التوثيق إن هذه الخطوات تكفي في حوالي 90% من الحالات.

ومن سكربت، تبدو الصيغتان الأوليان هكذا. أسماء الملفات أمثلة:

% BioSemi BDF: pick a temporary reference at import. Here: the average of
% the external mastoid electrodes EXG1 and EXG2 (channels 65 and 66 in a
% 64-channel cap). Check the channel order of your own montage.
EEG = pop_biosig(fullfile(dataFolder, 'sub01.bdf'), 'ref', [65 66]);

% BrainVision: give the folder and the .vhdr header file (needs bva-io)
EEG = pop_loadbv(dataFolder, 'sub01.vhdr');

كيف أكتبها بالكود؟

% Start EEGLAB and get its main variables
[ALLEEG, EEG, CURRENTSET, ALLCOM] = eeglab;

% Folder where you saved S001R03.edf (change it)
dataFolder = 'C:\Users\me\Documents\eeg-course';

% Biosig is required for EDF/BDF files
if ~exist('sopen', 'file')
    plugin_askinstall('Biosig', 'sopen', true);
end

% Import the EDF+ file (all channels, events from annotations)
EEG = pop_biosig(fullfile(dataFolder, 'S001R03.edf'));

% Store it as a new dataset and save it as .set
[ALLEEG, EEG, CURRENTSET] = pop_newset(ALLEEG, EEG, 0, ...
    'setname', 'S001R03', 'gui', 'off');
EEG = pop_saveset(EEG, 'filename', 'S001R03.set', 'filepath', dataFolder);
eeglab redraw;

أي قيمة أختار؟

القرار الأساسي: أي إضافة تقرأ ملفات جهازك؟ كل القوائم أدناه تحت File › ثم Import data › ثم Using EEGLAB functions and plugins. إذا لم تكن الإضافة مثبّتة، يعرض EEGLAB تنزيلها أول مرة تفتح قائمتها، كما حدث مع Biosig.

• ملف .cnt من Neuroscan وملف .cnt من ANT صيغتان مختلفتان بنفس الامتداد. اختر حسب الجهاز، لا حسب الامتداد.
• إذا لم تجد جهازك، ابحث باسم صيغته في File › ثم Manage EEGLAB extensions.

خانتان تستحقان الانتباه في نافذة Biosig:

كيف أتأكد أنها نجحت؟

1. النافذة الرئيسية: تحت اسم الداتاست تقرأ Channels per frame = 64، و Sampling rate (Hz) = 160، و Events أكبر من صفر. أما Channel locations فقيمتها No (labels only)، أي أن أسماء القنوات موجودة بلا مواقع. هذا متوقع الآن، ونضيف المواقع في الدرس التالي.
2. من الـ Command Window: EEG.nbchan يعطي 64، و EEG.srate يعطي 160، و EEG.pnts / EEG.srate يعطي الطول بالثواني (حوالي دقيقتين).
3. الأحداث: eeg_eventtypes(EEG) يعرض الرموز الثلاثة T0 (راحة)، و T1 و T2 (حركتان حسب المهمة). إذا كان عدد الأحداث صفراً، أعد الاستيراد وتأكد من خانة الـ annotations.
4. بالعين: افتح Plot › ثم Channel data (scroll). يجب أن ترى القنوات بإشارة متغيّرة، وخطوطاً عمودية ملوّنة عند الأحداث.
5. الملف المحفوظ: يجب أن يظهر S001R03.set في مجلد الدروس.

احتفظ بهذا الملف. الدرسان التاليان (مواقع الأقطاب والأحداث) يكملان عليه.

ما الأخطاء التي يقع فيها كثيرون؟

• اختيار الملف الخطأ في BrainVision. افتح ملف .vhdr دائماً، لا .eeg ولا .vmrk. ولا تغيّر اسم أحد الملفات الثلاثة يدوياً، لأن ملف .vhdr يحفظ أسماء الملفين الآخرين بداخله. إذا احتجت إعادة التسمية، استخدم File › ثم Export › ثم Copy and Rename Brain Vis. exchange files بعد تثبيت bva-io.
• ملف BDF بلا مرجع. تفقد جزءاً كبيراً من جودة الإشارة كما في الجدول أعلاه. اختر قناة مرجع عند الاستيراد.
• إلغاء استيراد الأحداث. في نافذة Biosig خانتان للأحداث، وكلتاهما مفعّلة افتراضياً لكل الصيغ: Import EDF+ annotations، و Extract event from marker channel. إذا ألغيتهما، قد يصبح عدد الأحداث صفراً، فلا تستطيع التقطيع لاحقاً.
• عدم الحفظ بعد الاستيراد. ستعيد الاستيراد كل مرة. احفظ نسخة .set واحدة بعد الاستيراد، ولا تكتب فوق الملف الأصلي.
• أسماء قنوات غريبة في هذا الملف. أسماء القنوات في هذه الداتاست تنتهي بنقاط، مثل Fc5. و C3... هذا ليس خطأ في الاستيراد، لكنه يمنع EEGLAB من التعرّف على مواقع الأقطاب. نصلحه في الدرس التالي.

كيف أكتبها في ورقتي؟

قالب: عدّل البيانات والإعدادات والإصدارات لتطابق ما نفّذته.

EEG recordings in EDF+ format (64 channels, 160 Hz) were imported into EEGLAB 2026.1 with pop_biosig (Biosig plugin [version]), and event markers were read from the EDF+ annotations.

للتوسّع

• EEGLAB Tutorial: https://eeglab.org/tutorials/04_Import/Importing_Continuous_and_Epoched_Data.html (4.a Continuous data: Four steps to easily import continuous raw data files)
• EEGLAB Extensions: https://eeglab.org/others/EEGLAB_Extensions.html (Data import)
• EEGLAB preprocessing #1: Importing raw data: https://www.youtube.com/watch?v=gEk33jWB0MY (الفيديو كاملاً)
• EEG Motor Movement/Imagery Dataset (PhysioNet): https://physionet.org/content/eegmmidb/1.0.0/ (Experimental Protocol; Montage)