openeb
v5.0.0
OpenEB هو مشروع مفتوح المصدر مرتبط بـ Metavision SDK
فهو يمكّن أي شخص من الحصول على فهم أفضل للرؤية القائمة على الأحداث، والتفاعل المباشر مع الأحداث وإنشاء تطبيقاته الخاصة أو المكونات الإضافية للكاميرا. باعتبارك شركة مصنعة للكاميرات، تأكد من استفادة عملائك من مجموعة البرامج المتوفرة القائمة على الأحداث الأكثر تقدمًا من خلال إنشاء البرنامج الإضافي الخاص بك. باعتبارك مبدعًا وعالمًا وأكاديميًا، انضم إلى مجتمع الرؤية القائم على الأحداث سريع النمو وساهم فيه.
يتكون OpenEB من الوحدات المفتوحة لـ Metavision SDK:
HAL: طبقة تجريد الأجهزة لتشغيل أي جهاز رؤية قائم على الحدث.
القاعدة: الأسس والتعاريف الشائعة للتطبيقات القائمة على الأحداث.
الأساسية: خوارزميات عامة للتصور ومعالجة تدفق الأحداث.
Core ML: وظائف عامة لخطوط أنابيب التعلم الآلي وevent_to_video وvideo_to_event.
البث: تجريد عالي المستوى مبني على الجزء العلوي من HAL للتفاعل بسهولة مع الكاميرات القائمة على الأحداث.
واجهة المستخدم: وحدات تحكم العارض والعرض للبيانات المستندة إلى الأحداث.
يحتوي OpenEB أيضًا على الكود المصدري للمكونات الإضافية لكاميرا Prophesee، مما يتيح دفق البيانات من كاميراتنا المستندة إلى الأحداث وقراءة تسجيلات البيانات المستندة إلى الأحداث. الكاميرات المدعومة هي:
EVK2-HD
EVK3-VGA/320/HD
EVK4-HD
يصف هذا المستند كيفية تجميع قاعدة تعليمات OpenEB وتثبيتها. لمزيد من المعلومات، راجع وثائقنا عبر الإنترنت حيث ستجد بعض البرامج التعليمية لتبدأ في لغة C++ أو Python، وبعض العينات لاكتشاف كيفية استخدام واجهة برمجة التطبيقات (API) الخاصة بنا ووصفًا أكثر تفصيلاً لوحداتنا وحزمنا.
تم اختبار التجميع والتنفيذ على منصات تفي بالمتطلبات التالية:
لينكس: أوبونتو 22.04 أو 24.04 64 بت
البنية: AMD64 (المعروف أيضًا باسم x64)
بطاقة رسومية تدعم OpenGL 3.0 كحد أدنى
وحدة المعالجة المركزية مع دعم AVX2
لم يتم اختبار التجميع على منصات أخرى (توزيعات Linux البديلة، وإصدارات مختلفة من Ubuntu، وبنية معالج ARM، وما إلى ذلك). بالنسبة لهذه الأنظمة الأساسية، قد تكون هناك حاجة لبعض التعديلات على هذا الدليل أو على الكود نفسه.
إذا كنت تقوم بترقية OpenEB من إصدار سابق، فيجب عليك أولاً قراءة ملاحظات الإصدار بعناية لأن بعض التغييرات قد تؤثر على استخدامك لـ SDK (مثل تحديثات واجهة برمجة التطبيقات) والكاميرات (على سبيل المثال، قد يكون تحديث البرامج الثابتة ضروريًا).
بعد ذلك، تحتاج إلى تنظيف نظامك من برنامج Prophesee المثبت مسبقًا. إذا اخترت، بعد التحويل البرمجي السابق، نشر ملفات Metavision في مسار النظام الخاص بك، فانتقل إلى مجلد build في دليل التعليمات البرمجية المصدر وقم بتشغيل الأمر التالي لإزالة هذه الملفات:
سودو جعل إلغاء التثبيت
بالإضافة إلى ذلك، قم بإجراء فحص شامل لمسارات نظامك ( /usr/lib و /usr/local/lib و /usr/include و /usr/local/include ) وفي متغيرات البيئة لديك ( PATH و PYTHONPATH و LD_LIBRARY_PATH ) لإزالة حدوث ملفات Prophesee أو Metavision.
لاسترداد كود مصدر OpenEB، يمكنك فقط استنساخ مستودع GitHub:
استنساخ بوابة https://github.com/prophesee-ai/openeb.git --branch 5.0.0
في الأقسام التالية، المسار المطلق لهذا الدليل يسمى OPENEB_SRC_DIR
إذا اخترت تنزيل أرشيف OpenEB من GitHub بدلاً من استنساخ المستودع، فستحتاج إلى التأكد من تحديد أرشيف Full.Source.Code.* بدلاً من استخدام أرشيفات Source.Code.* التي تم إنشاؤها تلقائيًا. وذلك لأن الأخير لا يتضمن وحدة فرعية ضرورية.
تثبيت التبعيات التالية:
سودو التحديث المناسب Sudo apt -y install apt-utils بناء البرامج الأساسية-الخصائص المشتركة wget unzip curly git cmake Sudo apt -y install libopencv-dev libboost-all-dev libusb-1.0-0-dev libprotobuf-dev protobuf-compiler Sudo apt -y install libhdf5-dev hdf5-tools libglew-dev libglfw3-dev libcanberra-gtk-module ffmpeg
اختياريًا، إذا كنت تريد إجراء الاختبارات، فستحتاج إلى تثبيت حزم Google Gtest وGmock. لمزيد من التفاصيل، راجع دليل مستخدم اختبار Google:
Sudo apt -y install libgtest-dev libgmock-dev
بالنسبة لـ Python API، ستحتاج إلى Python وبعض المكتبات الإضافية. نحن ندعم Python 3.9 و3.10 على Ubuntu 22.04 وPython 3.11 و3.12 على Ubuntu 24.04.
نوصي باستخدام Python مع virtualenv لتجنب التعارض مع حزم Python المثبتة الأخرى. لذا، قم أولاً بتثبيته مع بعض أدوات تطوير Python:
Sudo apt -y install python3.x-venv python3.x-dev# حيث يكون "x" هو 9 أو 10 أو 11 أو 12 اعتمادًا على إصدار Python الخاص بك
بعد ذلك، قم بإنشاء بيئة افتراضية وقم بتثبيت التبعيات الضرورية:
python3 -m venv /tmp/prophesee/py3venv --حزم موقع النظام /tmp/prophesee/py3venv/bin/python -m pip install pip --upgrade /tmp/prophesee/py3venv/bin/python -m pip install -r OPENEB_SRC_DIR/utils/python/python_requirements/requirements_openeb.txt
لاحظ أنه عند إنشاء البيئة الافتراضية، من الضروري استخدام خيار --system-site-packages لضمان إمكانية الوصول إلى حزم SDK المثبتة في أدلة النظام. ومع ذلك، فإن هذا الخيار أيضًا يجعل حزم موقع المستخدم المحلي (الموجودة عادةً في ~/.local/lib/pythonX.Y/site-packages ) مرئية بشكل افتراضي. لمنع ذلك والحفاظ على بيئة افتراضية أكثر نظافة، يمكنك ضبط متغير البيئة PYTHONNOUSERSITE على true.
اختياريًا، يمكنك تشغيل أمر activate ( source /tmp/prophesee/py3venv/bin/activate ) لتعديل متغيرات بيئة shell الخاصة بك، وتعيين مترجم Python والبرامج النصية للبيئة الافتراضية كإعداد افتراضي لجلستك الحالية. يتيح لك ذلك استخدام أوامر بسيطة مثل python دون الحاجة إلى تحديد المسار الكامل في كل مرة.
تعتمد روابط Python الخاصة بـ C++ API على مكتبة pybind11، وتحديدًا الإصدار 2.11.0.
لاحظ أن pybind11 مطلوب فقط إذا كنت تريد استخدام روابط Python الخاصة بواجهة برمجة تطبيقات C++. يمكنك إلغاء الاشتراك في إنشاء هذه الارتباطات عن طريق تمرير الوسيطة -DCOMPILE_PYTHON3_BINDINGS=OFF في الخطوة 3 أثناء التجميع (انظر أدناه). في هذه الحالة، لن تحتاج إلى تثبيت pybind11، لكنك لن تتمكن من استخدام واجهة Python الخاصة بنا مع C++ API.
لسوء الحظ، لا يتوفر إصدار مُجمَّع مسبقًا من pybind11، لذا تحتاج إلى تثبيته يدويًا:
wget https://github.com/pybind/pybind11/archive/v2.11.0.zip بفك v2.11.0.zipcd pybind11-2.11.0/ بناء mkdir && بناء القرص المضغوط cmake .. -DPYBIND11_TEST=OFF cmake --build .sudo cmake --build . --تثبيت الهدف
لاستخدام ميزات التعلم الآلي، تحتاج إلى تثبيت بعض التبعيات الإضافية.
أولاً، إذا كان لديك بعض أجهزة Nvidia المزودة بوحدات معالجة الرسومات، فيمكنك اختياريًا تثبيت CUDA (11.6 أو 11.7) وcuDNN للاستفادة منها باستخدام pytorch وlibtorch.
تأكد من تثبيت إصدار CUDA المتوافق مع وحدات معالجة الرسومات الخاصة بك عن طريق التحقق من صفحة توافق Nvidia.
لاحظ أننا، في الوقت الحالي، لا ندعم وحدات معالجة الرسوميات OpenCL وAMD.
قم بإنشاء دليل البناء وفتحه OPENEB_SRC_DIR : mkdir build && cd build
قم بإنشاء ملفات makefiles باستخدام CMake: cmake .. -DBUILD_TESTING=OFF . إذا كنت تريد تحديد إصدار Python الذي يجب مراعاته، فيجب عليك استخدام الخيار -DPython3_EXECUTABLE=<path_to_python_to_use> . يعد هذا مفيدًا، على سبيل المثال، عندما يكون لديك إصدار أحدث من Python مقارنة بالإصدارات التي ندعمها والمثبتة على نظامك. في هذه الحالة، سيحدده cmake وقد يفشل التجميع.
تجميع: cmake --build . --config Release -- -j 4
بمجرد الانتهاء من التجميع، لديك خياران: يمكنك اختيار العمل مباشرة من مجلد build أو يمكنك نشر ملفات OpenEB في مسار النظام ( /usr/local/lib ، /usr/local/include ...) .
الخيار 1 - العمل من مجلد build
لاستخدام OpenEB مباشرة من مجلد build ، تحتاج إلى تحديث بعض متغيرات البيئة باستخدام هذا البرنامج النصي (الذي يمكنك إضافته إلى ~/.bashrc الخاص بك لجعله دائمًا):
المصدر utils/scripts/setup_env.sh
يتم تضمين المكونات الإضافية للكاميرا Prophesee في OpenEB، لكنك لا تزال بحاجة إلى نسخ ملفات قواعد udev في مسار النظام وإعادة تحميلها حتى يتم اكتشاف الكاميرا الخاصة بك باستخدام هذا الأمر:
Sudo cp <OPENEB_SRC_DIR>/hal_psee_plugins/resources/rules/*.rules /etc/udev/rules.d التحكم في sudo udevadm - قواعد إعادة التحميل سودو أوديفادم الزناد
الخيار 2 - النشر في مسار النظام
لنشر OpenEB، قم بتشغيل الأمر التالي:
سودو cmake --build . --تثبيت الهدف
لاحظ أنه يمكنك أيضًا نشر ملفات OpenEB (التطبيقات والعينات والمكتبات وما إلى ذلك) في دليل من اختيارك باستخدام المتغير CMAKE_INSTALL_PREFIX ( -DCMAKE_INSTALL_PREFIX=<OPENEB_INSTALL_DIR> ) عند إنشاء ملفات التكوين في الخطوة 2. وبالمثل، يمكنك تكوين الدليل الذي سيتم نشر حزم Python به باستخدام المتغير PYTHON3_SITE_PACKAGES ( -DPYTHON3_SITE_PACKAGES=<PYTHON3_PACKAGES_INSTALL_DIR> ).
تحتاج أيضًا إلى تحديث LD_LIBRARY_PATH و HDF5_PLUGIN_PATH (والذي يمكنك إضافته إلى ~/.bashrc الخاص بك لجعله دائمًا):
تصدير LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/libexport HDF5_PLUGIN_PATH=$HDF5_PLUGIN_PATH:/usr/local/hdf5/lib/plugin # في Ubuntu 22.04export HDF5_PLUGIN_PATH=$HDF5_PLUGIN_PATH:/usr/local/lib/hdf5/plugin # على Ubuntu 24.04
لاحظ أنه إذا كنت تستخدم كاميرا تابعة لجهة خارجية، فستحتاج إلى تثبيت البرنامج الإضافي الذي يوفره بائع الكاميرا وتحديد موقع البرنامج الإضافي باستخدام متغير البيئة MV_HAL_PLUGIN_PATH .
للبدء في استخدام OpenEB، يمكنك تنزيل بعض نماذج التسجيلات وتصورها باستخدام metavision_viewer أو يمكنك دفق البيانات من الكاميرا المستندة إلى الأحداث المتوافقة مع Prophesee.
يعد تشغيل مجموعة الاختبار طريقة مؤكدة لضمان قيامك بكل شيء بشكل جيد في عملية التجميع والتثبيت.
قم بتنزيل الملفات اللازمة لإجراء الاختبارات. انقر فوق Download في المجلد العلوي الأيمن. احذر من حجم الأرشيف الذي تم الحصول عليه والذي يبلغ وزنه حوالي 1.5 جيجا بايت.
قم باستخراج محتوى هذا الأرشيف ووضعه في <OPENEB_SRC_DIR>/datasets . على سبيل المثال، المسار الصحيح للتسلسل gen31_timer.raw يجب أن يكون <OPENEB_SRC_DIR>/datasets/openeb/gen31_timer.raw .
قم بإعادة إنشاء ملفات makefiles مع تمكين خيارات الاختبار:
مؤتمر نزع السلاح <OPENEB_SRC_DIR>/build cmake .. -DBUILD_TESTING=ON
تجميع مرة أخرى. cmake --build . --config Release -- -j 4
أخيرًا، قم بتشغيل مجموعة الاختبار: ctest --verbose
حاليًا، ندعم نظام التشغيل Windows 10 فقط. ولم يتم اختبار التجميع على الإصدارات الأخرى من Windows. بالنسبة لهذه الأنظمة الأساسية، قد تكون هناك حاجة لبعض التعديلات على هذا الدليل أو على الكود نفسه.
إذا كنت تقوم بترقية OpenEB من إصدار سابق، فيجب عليك أولاً قراءة ملاحظات الإصدار بعناية لأن بعض التغييرات قد تؤثر على استخدامك لـ SDK (مثل تحديثات واجهة برمجة التطبيقات) والكاميرات (على سبيل المثال، قد يكون تحديث البرامج الثابتة ضروريًا).
بعد ذلك، إذا كنت قد قمت مسبقًا بتثبيت أي برنامج من برامج Prophesee، فستحتاج إلى إلغاء تثبيته أولاً. قم بإزالة المجلدات التي قمت بتثبيت عناصر Metavision فيها (تحقق من مجلد build التعليمات البرمجية المصدر و C:Program FilesProphesee وهو مسار التثبيت الافتراضي لخطوة النشر).
لاسترداد كود مصدر OpenEB، يمكنك فقط استنساخ مستودع GitHub:
استنساخ بوابة https://github.com/prophesee-ai/openeb.git --branch 5.0.0
في الأقسام التالية، المسار المطلق لهذا الدليل يسمى OPENEB_SRC_DIR
إذا اخترت تنزيل أرشيف OpenEB من GitHub بدلاً من استنساخ المستودع، فستحتاج إلى التأكد من تحديد أرشيف Full.Source.Code.* بدلاً من استخدام أرشيفات Source.Code.* التي تم إنشاؤها تلقائيًا. وذلك لأن الأخير لا يتضمن وحدة فرعية ضرورية.
لا تعمل بعض خطوات هذا الإجراء على نظام الملفات FAT32 وexFAT. ومن ثم، تأكد من أنك تستخدم نظام ملفات NTFS قبل المضي قدمًا.
يجب عليك تمكين الدعم للمسارات الطويلة:
اضغط على مفتاح Windows، واكتب gpedit.msc ثم اضغط على Enter
انتقل إلى سياسة الكمبيوتر المحلي > تكوين الكمبيوتر > قوالب الإدارة > النظام > نظام الملفات
انقر نقرًا مزدوجًا فوق الخيار "تمكين مسارات Win32 الطويلة"، وحدد الخيار "ممكّن" وانقر فوق "موافق"
لتجميع OpenEB، ستحتاج إلى تثبيت بعض الأدوات الإضافية:
تثبيت بوابة
تثبيت سي ميك 3.26
تثبيت برنامج التحويل البرمجي Microsoft C++ (64 بت). يمكنك اختيار أحد الحلول التالية:
قم بتنزيل وتشغيل برنامج التثبيت "Build Tools for Visual Studio 2022".
حدد "أدوات إنشاء C++"، وتأكد من تحديد Windows 10 SDK، ثم قم بإضافة حزمة اللغة الإنجليزية
للبناء فقط، يمكنك تثبيت MS Build Tools (مجاني، جزء من حزمة Windows 10 SDK)
للتطوير، يمكنك أيضًا تنزيل Visual Studio Installer وتشغيله
قم بتثبيت vcpkg الذي سيتم استخدامه لتثبيت التبعيات:
قم بتنزيل واستخراج إصدار vcpkg 2024.04.26 في مجلد سنشير إليه باسم VCPKG_SRC_DIR
cd <VCPKG_SRC_DIR>
bootstrap-vcpkg.bat
vcpkg update
انسخ الملف vcpkg-openeb.json الموجود في كود مصدر OpenEB على utils/windows إلى VCPKG_SRC_DIR وأعد تسميته إلى vcpkg.json
تثبيت المكتبات عن طريق تشغيل:
vcpkg install --triplet x64-windows --x-install-root installed
أخيرًا، قم بتنزيل ffmpeg وتثبيته وإضافة دليل bin إلى المسار الخاص بك.
لاحظ أنه إذا كنت تستخدم vcpkg عبر مشاريع أو إصدارات متعددة من OpenEB، فمن المفيد تبسيط عدد عمليات تثبيت vcpkg التي تديرها. لتحقيق ذلك، ستحتاج إلى الإصدارات المحددة من المكتبات المطلوبة. يمكنك العثور على هذه الإصدارات من خلال الرجوع إلى ملف vcpkg.json الخاص بنا مع مستودع vcpkg الرسمي، ولكن من أجل راحتك، قمنا بإدراجها أدناه:
ليبوسب: 1.0.27
التعزيز: 1.78.0
اوبن سي في: 4.8.0
المباشر: 1.24.0
اختبار: 1.14.0
pybind11: 2.12.0
توهج: 2.2.0
جلفو3: 3.4.0
hdf5: 1.14.2
بروتوبوف: 3.21.12
قم بتنزيل "مثبت Windows x86-64 القابل للتنفيذ" لأحد إصدارات Python التالية:
بايثون 3.9
بايثون 3.10
بايثون 3.11
بايثون 3.12
أضف أدلة تثبيت Python والبرامج النصية في PATH الخاص بك وتأكد من إدراجها قبل مجلد WindowsApps الذي يحتوي على اسم Python المستعار الذي يقوم بتشغيل متجر Microsoft. لذا، إذا قمت بتثبيت Python 3.9 في المسار الافتراضي، فيجب أن يحتوي PATH الخاص بالمستخدم على هذه الأسطر الثلاثة بهذا الترتيب:
%USERPROFILE%AppDataLocalProgramsPythonPython39 %USERPROFILE%AppDataLocalProgramsPythonPython39Scripts %USERPROFILE%AppDataLocalMicrosoftWindowsApps
نوصي باستخدام Python مع virtualenv لتجنب التعارضات مع حزم Python المثبتة الأخرى.
قم بإنشاء بيئة افتراضية وقم بتثبيت التبعيات اللازمة:
python -m venv C:tmppropheseepy3venv --حزم موقع النظام C:tmppropheseepy3venvScriptspython -m pip install pip --upgrade C:tmppropheseepy3venvScriptspython -m pip install -r OPENEB_SRC_DIRutilspythonpython_requirementsrequirements_openeb.txt
عند إنشاء البيئة الافتراضية، من الضروري استخدام خيار --system-site-packages لضمان إمكانية الوصول إلى حزم SDK المثبتة في أدلة النظام. ومع ذلك، فإن هذا الخيار أيضًا يجعل حزم موقع المستخدم المحلي الخاصة بك مرئية بشكل افتراضي. لمنع ذلك والحفاظ على بيئة افتراضية أكثر نظافة، يمكنك ضبط متغير البيئة PYTHONNOUSERSITE على true.
اختياريًا، يمكنك تشغيل أمر activate ( C:tmppropheseepy3venvScriptsactivate ) لتعديل متغيرات بيئة shell الخاصة بك، وتعيين مترجم Python والبرامج النصية للبيئة الافتراضية كإعداد افتراضي لجلستك الحالية. يتيح لك ذلك استخدام أوامر بسيطة مثل python دون الحاجة إلى تحديد المسار الكامل في كل مرة.
لاستخدام ميزات التعلم الآلي، تحتاج إلى تثبيت بعض التبعيات الإضافية.
أولاً، إذا كان لديك بعض أجهزة Nvidia المزودة بوحدات معالجة الرسومات، فيمكنك اختياريًا تثبيت CUDA (11.6 أو 11.7) وcuDNN للاستفادة منها باستخدام pytorch وlibtorch.
افتح موجه الأوامر داخل المجلد OPENEB_SRC_DIR :
قم بإنشاء دليل البناء وفتحه، حيث سيتم إنشاء الملفات المؤقتة: mkdir build && cd build
أنشئ ملفات التكوين باستخدام CMake: cmake .. -A x64 -DCMAKE_TOOLCHAIN_FILE=<OPENEB_SRC_DIR>cmaketoolchainsvcpkg.cmake -DVCPKG_DIRECTORY=<VCPKG_SRC_DIR> . لاحظ أن القيمة التي تم تمريرها إلى المعلمة -DCMAKE_TOOLCHAIN_FILE يجب أن تكون مسارًا مطلقًا، وليس مسارًا نسبيًا.
تجميع: cmake --build . --config Release --parallel 4
بمجرد الانتهاء من التجميع، لديك خياران: يمكنك اختيار العمل مباشرة من مجلد build أو يمكنك نشر ملفات OpenEB (التطبيقات والعينات والمكتبات وما إلى ذلك) في دليل من اختيارك.
الخيار 1 - العمل من مجلد build
لاستخدام OpenEB مباشرة من مجلد build ، تحتاج إلى تحديث بعض متغيرات البيئة باستخدام هذا البرنامج النصي:
utilsscriptssetup_env.bat
الخيار 2 - النشر في دليل من اختيارك
إلحاق <OPENEB_INSTALL_DIR>bin بـ PATH ( C:Program FilesPropheseebin إذا كنت تستخدم التكوين الافتراضي)
إلحاق <OPENEB_INSTALL_DIR>libmetavisionhalplugins بـ MV_HAL_PLUGIN_PATH ( C:Program FilesPropheseelibmetavisionhalplugins إذا كنت تستخدم التكوين الافتراضي)
إلحاق <OPENEB_INSTALL_DIR>libhdf5plugin بـ HDF5_PLUGIN_PATH ( C:Program FilesPropheseelibhdf5plugin إذا كنت تستخدم التكوين الافتراضي)
إلحاق <PYTHON3_PACKAGES_INSTALL_DIR> بـ PYTHONPATH (غير مطلوب إذا كنت تستخدم التكوين الافتراضي)
لنشر OpenEB في المجلد الافتراضي ( C:Program FilesProphesee )، قم بتنفيذ هذا الأمر (يجب تشغيل وحدة التحكم الخاصة بك كمسؤول):
cmake --build . - إصدار التكوين - تثبيت الهدف
لنشر OpenEB في مجلد آخر، يجب عليك إنشاء الحل مرة أخرى (الخطوة 2 أعلاه) باستخدام المتغير الإضافي CMAKE_INSTALL_PREFIX الذي يحمل قيمة المجلد الهدف ( OPENEB_INSTALL_DIR ).
وبالمثل، لتحديد مكان نشر حزم Python ( PYTHON3_PACKAGES_INSTALL_DIR )، يجب عليك استخدام المتغير PYTHON3_SITE_PACKAGES .
فيما يلي مثال لأمر يقوم بتخصيص هذين المجلدين:
cmake .. -A x64 -DCMAKE_TOOLCHAIN_FILE=<OPENEB_SRC_DIR>cmaketoolchainsvcpkg.cmake -DVCPKG_DIRECTORY=<VCPKG_SRC_DIR> -DCMAKE_INSTALL_PREFIX=<OPENEB_INSTALL_DIR> -DPYTHON3_SITE_PACKAGES=<PYTHON3_PACKAGES_INSTALL_DIR> -DBUILD_TESTING=OFF
بعد هذا الأمر، يجب عليك تشغيل التجميع والتثبيت الفعلي لـ OpenEB (يجب تشغيل وحدة التحكم الخاصة بك كمسؤول):
cmake --build . - إصدار التكوين - الموازي 4 cmake --build . - إصدار التكوين - تثبيت الهدف
تحتاج أيضًا إلى تعديل بعض متغيرات البيئة يدويًا:
افتح موجه الأوامر داخل المجلد OPENEB_SRC_DIR :
قم بإنشاء دليل البناء وفتحه، حيث سيتم إنشاء الملفات المؤقتة: mkdir build && cd build
أنشئ ملفات Visual Studio باستخدام CMake: cmake .. -G "Visual Studio 17 2022" -A x64 -DCMAKE_TOOLCHAIN_FILE=<OPENEB_SRC_DIR>cmaketoolchainsvcpkg.cmake -DVCPKG_DIRECTORY=<VCPKG_SRC_DIR> (يتكيف مع إصدار Visual Studio الخاص بك) . لاحظ أن القيمة التي تم تمريرها إلى المعلمة -DCMAKE_TOOLCHAIN_FILE يجب أن تكون مسارًا مطلقًا، وليس مسارًا نسبيًا.
افتح ملف الحل metavision.sln ، وحدد تكوين Release وقم ببناء مشروع ALL_BUILD .
بمجرد الانتهاء من التجميع، يمكنك اختيار العمل مباشرة من مجلد build أو يمكنك نشر ملفات OpenEB (التطبيقات والعينات والمكتبات وما إلى ذلك) في دليل من اختيارك.
الخيار 1 - العمل من مجلد build
لاستخدام OpenEB مباشرة من مجلد build ، تحتاج إلى تحديث متغيرات البيئة كما هو الحال في البرنامج النصي utilsscriptssetup_env.bat
الخيار 2 - نشر OpenEB
لنشر OpenEB، تحتاج إلى إنشاء مشروع INSTALL . افتراضيًا، سيتم نشر الملفات في C:Program FilesProphesee
تم تضمين المكونات الإضافية للكاميرا Prophesee في OpenEB، لكنك تحتاج إلى تثبيت برامج التشغيل حتى تكون الكاميرات متاحة على نظام التشغيل Windows. للقيام بذلك، اتبع هذا الإجراء:
قم بتنزيل wdi-simple.exe من خادم الملفات الخاص بنا
قم بتنفيذ الأوامر التالية في موجه الأوامر الذي تم تشغيله كمسؤول:
wdi-simple.exe -n "EVK" -m "Prophesee" -v 0x04b4 -p 0x00f4 wdi-simple.exe -n "EVK" -m "Prophesee" -v 0x04b4 -p 0x00f5 wdi-simple.exe -n "EVK" -m "Prophesee" -v 0x04b4 -p 0x00f3
إذا كنت تمتلك EVK2 أو RDK2، فهناك بعض الخطوات الإضافية التي يجب إكمالها والموضحة بالتفصيل في وثائقنا عبر الإنترنت في قسم Camera Plugin في دليل تثبيت OpenEB.
إذا كنت تستخدم كاميرا تابعة لجهة خارجية، فستحتاج إلى اتباع الإرشادات المقدمة من بائع الكاميرا لتثبيت برنامج التشغيل والمكون الإضافي للكاميرا. تأكد من الإشارة إلى موقع المكون الإضافي في متغير البيئة MV_HAL_PLUGIN_PATH .
للبدء في استخدام OpenEB، يمكنك تنزيل بعض نماذج التسجيلات وتصورها باستخدام metavision_viewer أو يمكنك دفق البيانات من الكاميرا المستندة إلى الأحداث المتوافقة مع Prophesee.
يعد تشغيل مجموعة الاختبار طريقة مؤكدة لضمان قيامك بكل شيء بشكل جيد في عملية التجميع والتثبيت.
قم بتنزيل الملفات اللازمة لإجراء الاختبارات. انقر فوق Download في المجلد العلوي الأيمن. احذر من حجم الأرشيف الذي تم الحصول عليه والذي يبلغ وزنه حوالي 1.5 جيجا بايت.
قم باستخراج محتوى هذا الأرشيف ووضعه في <OPENEB_SRC_DIR>/datasets . على سبيل المثال، المسار الصحيح للتسلسل gen31_timer.raw يجب أن يكون <OPENEB_SRC_DIR>/datasets/openeb/gen31_timer.raw .
لتشغيل مجموعة الاختبار، تحتاج إلى إعادة تكوين بيئة البناء الخاصة بك باستخدام CMake وإعادة الترجمة
التجميع باستخدام MS Visual Studio
التجميع باستخدام CMake
قم بإنشاء ملفات Visual Studio باستخدام CMake (قم بتكييف الأمر مع إصدار Visual Studio الخاص بك ولاحظ أن -DCMAKE_TOOLCHAIN_FILE يجب أن يكون المسار المطلق، وليس المسار النسبي):
cmake .. -G "Visual Studio 17 2022" -A x64 -DCMAKE_TOOLCHAIN_FILE=<OPENEB_SRC_DIR>cmaketoolchainsvcpkg.cmake -DVCPKG_DIRECTORY=<VCPKG_SRC_DIR> -DBUILD_TESTING=ON
افتح ملف الحل metavision.sln ، وحدد تكوين Release وقم ببناء مشروع ALL_BUILD .
أعد إنشاء البنية باستخدام CMake (لاحظ أن -DCMAKE_TOOLCHAIN_FILE يجب أن يكون مسارًا مطلقًا، وليس مسارًا نسبيًا)::
cd <OPENEB_SRC_DIR>/build cmake .. -A x64 -DCMAKE_TOOLCHAIN_FILE=<OPENEB_SRC_DIR>cmaketoolchainsvcpkg.cmake -DVCPKG_DIRECTORY=<VCPKG_SRC_DIR> -DBUILD_TESTING=ON
تجميع: cmake --build . --config Release --parallel 4
إن تشغيل مجموعة الاختبار هو ببساطة ctest -C Release
