التثبيت والإضافات

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

1. نزّل EEGLAB

1. افتح صفحة التنزيل الرسمية: Download EEGLAB.
2. املأ النموذج: الاسم والبريد، وفعّل خانة قبول رخصة BSD، ثم اضغط Submit.
3. ستحصل على ملف ZIP لآخر إصدار مستقر.

2. فُكّ الملف في مكان ثابت

فُكّ الملف في مجلد لن تنقله لاحقاً، مثل مجلد Documents/MATLAB. ستحصل على مجلد اسمه يبدأ بـ eeglab ثم رقم الإصدار.

3. احفظ المسار قبل أول تشغيل

احفظ المسار قبل أن تكتب eeglab. السبب: عند التشغيل يضيف EEGLAB مجلداته الفرعية إلى المسار، وزر الحفظ يحفظ المسار كله كما هو في تلك اللحظة.

1. افتح MATLAB، ولا تشغّل EEGLAB بعد. إذا كنت شغّلته في هذه الجلسة، أغلق MATLAB وافتحه من جديد.
2. اكتب pathtool في الـ Command Window (أو افتح Set Path من واجهة MATLAB).
3. اضغط Add Folder واختر مجلد EEGLAB الرئيسي فقط.
4. اضغط Save ثم Close.

4. شغّل EEGLAB

اكتب eeglab في الـ Command Window واضغط Enter.

تظهر النافذة الرئيسية لـ EEGLAB بسبع قوائم: File و Edit و Tools و Plot و Study و Datasets و Help. عند التشغيل يضيف EEGLAB مجلداته الفرعية إلى مسار الجلسة الحالية بنفسه، ولا يحفظها.

من الآن يكفي أن تكتب eeglab في أي جلسة MATLAB جديدة.

5. ثبّت إضافة Biosig

1. من نافذة EEGLAB افتح File › ثم Manage EEGLAB extensions. يحتاج هذا اتصالاً بالإنترنت.
2. تظهر قائمة الإضافات. الإضافات المكتوبة بخط عريض مثبّتة عندك، والحمراء تحتاج تحديثاً.
3. اضغط زر البحث في أعلى النافذة واكتب Biosig.
4. اختر Biosig من القائمة، ثم اضغط Install/Update.
5. ينزّل EEGLAB الإضافة ويعيد بناء نافذته. Biosig تقرأ ملفات EDF و BDF وصيغاً أخرى كثيرة.

يعرض مدير الإضافات لكل إضافة تقييمها بالنجوم وعدد مرات تنزيلها، ويرتّب القائمة حسب التنزيلات. إذا وجدت إضافتين لنفس العمل، فهذان الرقمان دليل أوّلي سريع. ولتعرف ماذا تفعل كل إضافة شائعة ومتى تحتاجها، افتح دليل الإضافات.

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

نفس الخطوات من السطر. شغّله مرة واحدة بعد فكّ EEGLAB، في جلسة MATLAB جديدة لم تشغّل فيها EEGLAB بعد.

% Go to the EEGLAB folder (change the path to yours)
cd('C:\Users\me\Documents\MATLAB\eeglab2026.1');

% Save the root EEGLAB folder in the path BEFORE starting EEGLAB,
% so its subfolders are not saved too
addpath(pwd);
savepath;

% Start EEGLAB; it adds its own subfolders for this session only
eeglab;

% Install Biosig only if it is not installed yet (needs internet)
if ~exist('sopen', 'file')
    plugin_askinstall('Biosig', 'sopen', true);
end

• addpath(pwd) ثم savepath يحفظان المجلد الرئيسي فقط، لأنهما قبل eeglab. لو جاءا بعده، لحفظ savepath كل المجلدات الفرعية التي أضافها EEGLAB، وهذا ما يحذّر منه التوثيق.
• sopen دالة من Biosig. إذا وُجدت، فالإضافة مثبّتة ولا داعي لإعادة تثبيتها.
• الوسيط الثالث true يثبّت الإضافة بدون نافذة سؤال، فيصلح داخل السكربت.

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

القرار الوحيد هنا: من أين تحصل على MATLAB؟ الخيارات مرتّبة من الأفضل للدروس إلى الأضعف.

نسخة MATLAB: يوصي فريق EEGLAB بإصدار حديث من MATLAB، وليس بالضرورة الأحدث. إذا كان عندك MATLAB 2016a أو أقدم، فصفحة التنزيل توجّهك إلى EEGLAB 2020.0، وهذا الموقع لا يغطّي ذلك الإصدار.

التحديث: في نسخة MATLAB تجد Help › ثم Check for EEGLAB update، ويطبع EEGLAB عند التشغيل إن كان عندك آخر إصدار. لكن هذه الدروس مكتوبة على EEGLAB 2026.1، فلا تحدّث في منتصف المسار. أسماء القوائم والأرقام قد تتغيّر في إصدار أحدث.

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

1. النافذة: نافذة EEGLAB الرئيسية ظهرت بالقوائم السبع.
2. المسار: أغلق MATLAB وافتحه من جديد، ثم اكتب which eeglab. يجب أن يظهر مسار الملف eeglab.m داخل مجلدك. وعند تشغيل eeglab يجب ألا يظهر تحذير أحمر عن المجلدات الفرعية (subfolders).
3. الإصدار: اكتب eeg_getversion. يجب أن يظهر رقم إصدار يبدأ بـ 2026.1.
4. الإضافة: اكتب exist('sopen', 'file'). الناتج 2 يعني أن Biosig مثبّتة. وفي مدير الإضافات يظهر اسمها بخط عريض.
5. سطور الإقلاع: عند كل تشغيل يطبع EEGLAB في الـ Command Window سطراً لكل إضافة يحمّلها، يبدأ بـ EEGLAB: adding ثم اسم الإضافة ورقم نسختها. ابحث فيها عن Biosig.

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

• تنزيل ZIP من GitHub بدل صفحة التنزيل. تنقصك إضافات أساسية مثل ICLabel و clean_rawdata و firfilt. تظهر رسائل تحذير حمراء عند التشغيل للأولين، ويطلب EEGLAB تنزيل firfilt عند أول فلترة.
• حفظ المجلد مع كل مجلداته الفرعية. يحدث هذا بزر Add with Subfolders، أو بحفظ المسار بعد تشغيل eeglab في نفس الجلسة. التوثيق ينصح بحفظ المجلد الرئيسي فقط، و EEGLAB يطبع تحذيراً أحمر عند التشغيل إذا وجد مجلداته الفرعية محفوظة.
• إبقاء إصدار قديم من EEGLAB في المسار. إذا ثبّتّ إصداراً جديداً، احذف القديم من Set Path بزر Remove. وإلا قد يستدعي MATLAB دوال قديمة.
• البحث عن مدير الإضافات في النسخة المجمّعة. القائمة غير موجودة فيها أصلاً. إذا احتجت plugin غير موجود فيها، فأنت تحتاج نسخة MATLAB.
• فشل savepath أو زر Save. يحدث هذا غالباً عندما لا يملك حسابك صلاحية الكتابة في مجلد MATLAB. شغّل MATLAB بصلاحية المسؤول مرة واحدة. أو أنشئ ملفاً اسمه startup.m في المجلد الذي يطبعه الأمر userpath، واكتب فيه سطراً واحداً: addpath ثم مسار مجلد EEGLAB بين قوسين. يشغّل MATLAB هذا الملف تلقائياً في بداية كل جلسة، ولا يحتاج صلاحيات.

للتوسّع

• EEGLAB Tutorial: https://eeglab.org/tutorials/01_Install/Install.html (1. Installing EEGLAB)
• EEGLAB Extensions: https://eeglab.org/others/EEGLAB_Extensions.html (To install or update a plugin)
• Download EEGLAB: https://eeglab.org/others/How_to_download_EEGLAB.html (Download the EEGLAB ZIP file archive)
• The compiled version of EEGLAB: https://eeglab.org/others/Compiled_EEGLAB.html (Installation)
• Running EEGLAB on Octave: https://eeglab.org/others/Running_EEGLAB_on_Octave.html (Running EEGLAB on Octave)
• MATLAB Online Versions (MathWorks): https://www.mathworks.com/products/matlab-online/matlab-online-versions.html (MATLAB Online (basic))