التثبيت والبدء
تم اقتباس هذا القسم وتعديله بإذن من OpenDroneMap: الدليل المفقود, by Piero Toffanin.
Quickstart
Installers for OpenDroneMap are available for purchase from UAV4Geo, and are the easiest way to get started and come with support.
https://opendronemap.org/webodm/download/#installer
That said, OpenDroneMap is a free and open source ecoystem. Community support is available for those looking to install themselves and directions follow:
توصيات الأجهزة
الحد الأدنى من المتطلبات لتشغيل البرنامج هي:
تم تصنيع وحدة المعالجة المركزية 64 بت في أو بعد عام 2010
20 غيغابايت من مساحة القرص
4 جيجا بايت رام
لا يمكن معالجة أكثر من 100-200 صورة بالمواصفات المذكورة أعلاه (ستنفد ذاكرة البرنامج). المتطلبات الموصى بها هي:
أحدث جيل من وحدة المعالجة المركزية
100 غيغابايت من مساحة القرص
ذاكرة رام 16 جيجا
سيسمح ما سبق بمعالجة بضع مئات من الصور دون مشاكل كثيرة. ستسمح وحدة المعالجة المركزية (CPU) المزودة بمزيد من النوى بمعالجة أسرع ، بينما لا تؤثر بطاقة الرسومات (GPU) حاليًا على الأداء. لمعالجة المزيد من الصور ، أضف المزيد من مساحة القرص وذاكرة الوصول العشوائي خطيًا إلى عدد الصور التي تحتاج إلى معالجتها.
Number of images |
RAM or RAM + Swap |
|---|---|
40 |
4 |
250 |
16 |
500 |
32 |
1500 |
64 |
2500 |
128 |
3500 |
192 |
5000 |
256 |
التركيب
نوصي باستخدام الناس docker أو تشغيل ODM ، سواء كنت تستخدم نظام التشغيل Windows أو macOS أو Linux.
Windows
لتشغيل OpenDroneMap ، تحتاج إلى Windows 7. على الأقل. الإصدارات السابقة من Windows غير مدعومة.
الخطوة 1. تحقق من دعم المحاكاة الافتراضية
يتطلب Docker ميزة من وحدة المعالجة المركزية الخاصة بك تسمى المحاكاة الافتراضية ، والتي تسمح لها بتشغيل الأجهزة الافتراضية (VMs). تأكد من تمكينه! في بعض الأحيان يتم تعطيل هذا. للتحقق ، في Windows 8 أو أعلى ، يمكنك فتح Task Manager (اضغط CTRL + SHIFT + ESC) والتبديل إلى علامة التبويب علامة التبويب الأداء.
Virtualization should be enabled
في نظام التشغيل Windows 7 لمعرفة ما إذا تم تمكين المحاكاة الافتراضية ، يمكنك استخدام أداة الكشف عن المحاكاة الافتراضية المدعومة بالأجهزة من Microsoft® <http:// www.microsoft.com/en-us/download/details.aspx?id=592>`_ في حين أن.
إذا تم تعطيل المحاكاة الافتراضية ، فستحتاج إلى تمكينها. للأسف ، يختلف الإجراء قليلاً بالنسبة لكل طراز كمبيوتر ، لذا فإن أفضل طريقة للقيام بذلك هي البحث في محرك بحث "كيفية تمكين vtx لـ <اكتب طراز الكمبيوتر الخاص بك هنا>". غالبًا ما يكون الأمر يتعلق بإعادة تشغيل الكمبيوتر ، والضغط على الفور على F2 أو F12 أثناء بدء التشغيل ، والتنقل في قائمة التمهيد وتغيير الإعدادات لتمكين التمثيل الافتراضي (غالبًا ما يسمى "VT-X")
Common keys to press at computer startup to access the boot menu for various PC vendors
الخطوة 2. تثبيت المتطلبات
أولاً ، ستحتاج إلى تثبيت:
Python (latest version 3): https://www.python.org/downloads/windows/
بالنسبة إلى Python 3 ، تأكد من تحديد ** إضافة Python 3.x إلى PATH ** أثناء التثبيت.
Don’t forget to add the Python executable to your PATH (so that you can run commands with it)
بعد ذلك ، فقط إذا كنت تستخدم Windows 10 Home أو Windows 8 (أي إصدار) أو Windows 7 (أي إصدار) ، قم بتثبيت:
Docker Toolbox: https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe
إذا كنت تستخدم Windows 10 Professional أو إصدارًا أحدث ، فيجب عليك التثبيت بدلاً من ذلك:
Docker for Windows: https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe
أرجوك** لا** تثبيت كل من برامج عامل الميناء. إنهما مختلفان وسيحدثان فوضى إذا تم تثبيتهما
بعد تثبيت docker ، قم بتشغيله من أيقونة سطح المكتب التي تم إنشاؤها من التثبيت (** Docker Quickstart ** في حالة Docker Toolbox ، ** Docker for Windows ** for Docker for Windows). هذا مهم ، لا تتخطى هذه الخطوة. إذا كانت هناك أخطاء ، فاتبع المطالبات التي تظهر على الشاشة لإصلاحها.
الخطوة 3. تحقق من تخصيص الذاكرة ووحدة المعالجة المركزية
يعمل Docker على Windows عن طريق تشغيل VM في الخلفية (فكر في VM كـ "محاكي كمبيوتر"). يحتوي هذا الجهاز الظاهري على مقدار معين من الذاكرة المخصصة ولا يمكن أن يستخدم WebODM سوى قدر الذاكرة المخصصة.
إذا قمت بتثبيت Docker Toolbox (انظر أدناه إذا قمت بتثبيت Docker لنظام Windows بدلاً من ذلك):
افتح تطبيق ** VirtualBox Manager **
نقر بزر الماوس الأيمن على ** الافتراضي ** VM واضغط على ** إغلاق (إيقاف تشغيل ACPI) ** لإيقاف الجهاز
انقر بزر الماوس الأيمن على ** افتراضي ** VM واضغط على ** الإعدادات ... **
Move the Base Memory slider from the System panel and allocate 60-70% of all available memory, optionally adding 50% of the available processors from the Processor tab also
إعدادات VirtualBox الافتراضية VM
ثم اضغط على OK ، انقر بزر الماوس الأيمن على default **VM واضغط على **Start.
إذا قمت بتثبيت Docker لنظام Windows بدلاً من ذلك:
ابحث في علبة النظام وانقر بزر الماوس الأيمن على أيقونة "الحوت الأبيض".
من القائمة ، اضغط الإعدادات ...
من اللوحة ، انقر فوق متقدم واستخدم أشرطة التمرير لتخصيص 60-70٪ من الذاكرة المتوفرة واستخدام نصف جميع وحدات المعالجة المركزية المتاحة.
اضغط تطبيق.
Step 1 Docker icon
Step 3 & 4 Docker settings
الخطوة 4. قم بتنزيل WebODM
افتح برنامج ** Git Gui ** الذي يأتي مثبتًا مع Git. من هناك:
عندما يفتح Git Gui ، انقر فوق خيار "Clone Existing Repository"
ي ** موقع المصدر ** ، اكتب: https://github.com/OpenDroneMap/WebODM
في ** Target Directory ** انقر فوق تصفح وانتقل إلى مجلد من اختيارك (قم بإنشاء مجلد إذا لزم الأمر)
اضغط ** استنساخ **
Git Gui
إذا نجح التنزيل ، فمن المفترض أن ترى هذه النافذة الآن:
Git Gui after successful download (clone)
انتقل إلى قائمة Repository ، ثم انقر فوق Create Desktop Icon. هذا سيسمح لك بالعودة إلى هذا التطبيق بسهولة في المستقبل.
الخطوة 4. قم بتشغيل WebODM
من Git Gui ، انتقل إلى قائمة Repository ، ثم انقر فوق Git Bash. من نوع سطر الأوامر:
$ ./webodm.sh start &
سيتم تنزيل العديد من المكونات على جهازك في هذه المرحلة ، بما في ذلك WebODM و NodeODM و ODM. بعد التنزيل ، يجب أن تستقبل الشاشة التالية:
إخراج وحدة التحكم بعد بدء WebODM لأول مرة
إذا كنت تستخدم Docker لنظام التشغيل Windows ، فافتح متصفح الويب على http: // localhost: 8000
إذا كنت تستخدم Docker Toolbox ، فابحث عن عنوان IP للاتصال به عن طريق كتابة:
$ docker-machine ip
يجب أن تحصل على نتيجة مثل ما يلي:
192.168.1.100
ثم اتصل بـ http://192.168.1.100:8000 (استبدال عنوان IP بالعنوان المناسب).
macOS
يمكن لمعظم أجهزة الكمبيوتر الحديثة Mac (التي تعمل بعد عام 2010) التي تعمل بنظام macOS Sierra 10.12 أو أعلى تشغيل OpenDroneMap باستخدام عامل الإرساء ، طالما أن دعم الأجهزة الافتراضية (انظر أدناه).
الخطوة 1. تحقق من دعم المحاكاة الافتراضية
افتح نافذة طرفية واكتب:
$ sysctl kern.hv_support
ستحصل على رد مشابه لما يلي:
kern.hv_support: 1
إذا كانت النتيجة kern.hv_support: 1 ، فهذا يعني أن جهاز Mac الخاص بك مدعوم! تابع مع الخطوة 2.
إذا كانت النتيجة هي kern.hv_support: 0 ، فهذا يعني للأسف أن جهاز Mac قديم جدًا بحيث لا يمكنه تشغيل OpenDroneMap. :(
الخطوة 2. تثبيت المتطلبات
يوجد برنامجان فقط للتثبيت:
بعد تثبيت عامل الميناء ، يجب أن تجد رمزًا يشبه الحوت في شريط المهام.
تطبيق Docker قيد التشغيل
يمكنك التحقق من أن عامل الميناء يعمل بشكل صحيح من خلال فتح تطبيق Terminal وكتابة:
$ docker run hello-world
الذي يجب أن يعود
Hello from Docker!
للتحقق من تثبيت git ، اكتب ببساطة:
$ git --version
والتي يجب أن تُرجع شيئًا مشابهًا لما يلي:
git version 2.20.1 (Apple Git-117)
إذا حصلت على "bash: git: command not found" ، فحاول إعادة تشغيل تطبيق Terminal وتحقق جيدًا من أي أخطاء أثناء عملية التثبيت.
الخطوة 3. تحقق من تخصيص الذاكرة ووحدة المعالجة المركزية
عمل Docker على macOS عن طريق تشغيل VM في الخلفية (فكر في الأمر على أنه "محاكي كمبيوتر"). يحتوي هذا الجهاز الظاهري على مقدار معين من الذاكرة المخصصة ولا يمكن أن يستخدم WebODM سوى قدر الذاكرة المخصصة.
انقر بزر الماوس الأيمن على رمز الحوت من شريط المهام وانقر على** التفضيلات** ...
حدد علامة التبويب** متقدم**
اضبط شريط تمرير وحدات المعالجة المركزية لاستخدام نصف جميع وحدات المعالجة المركزية المتاحة والذاكرة لاستخدام 60-70٪ من جميع الذاكرة المتاحة
اضغط التقديم وإعادة التشغيل
إعدادات Docker المتقدمة
الخطوة 4. قم بتحميل وتشغيل WebODM
من نوع Terminal:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
ثم افتح متصفح الويب على http://localhost:8000.
Linux
يمكن تشغيل OpenDroneMap على أي توزيع Linux يدعم عامل الإرساء. وفقًا لموقع وثائق docker على الويب التوزيعات المدعومة رسميًا هي CentOS و Debian و Ubuntu و Fedora ، مع ثنائيات ثابتة متاحة للآخرين. إذا كان عليك اختيار توزيع فقط لتشغيل OpenDroneMap ، فإن Ubuntu هو الطريقة الموصى بها للذهاب.
الخطوة 1. تثبيت المتطلبات
هناك أربعة برامج تحتاج للتثبيت:
Docker
Git
Python (2 or 3)
Pip
لا يمكننا تغطية عملية التثبيت لكل توزيع Linux هناك ، لذلك سنقصر التعليمات على التوزيعات التي تدعمها شركة docker رسميًا. في جميع الحالات ، يكون الأمر مجرد فتح موجه طرفية وكتابة بعض الأوامر.
التثبيت على Ubuntu / Debian
أوامر للكتابة:
$ sudo apt update
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo apt install -y git python python-pip
التثبيت على CentOS / RHEL
أوامر للكتابة:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo yum -y install git python python-pip
التثبيت على Fedora
أوامر للكتابة:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo dnf install git python python-pip
التثبيت على Arch
أوامر للكتابة:
$ sudo pacman -Sy docker git python python-pip
الخطوة 2. تحقق من المتطلبات الإضافية
بالإضافة إلى البرامج الثلاثة أعلاه ، هناك حاجة أيضًا إلى البرنامج النصي المكون من docker. في بعض الأحيان يتم تثبيته بالفعل مع عامل الميناء ، ولكن في بعض الأحيان لم يتم تثبيته. للتحقق مما إذا كان مثبتًا ، حاول الكتابة:
$ docker-compose --version
يجب أن تشاهد أشياء مشابهة لما يلي:
docker-compose version 1.22.0, build f46880f
إذا حصلت بدلاً من ذلك على شيء مشابه لما يلي
docker-compose: command not found
يمكنك تثبيته باستخدام pip:
$ sudo pip install docker-compose
الخطوة 3. قم بتحميل وتشغيل WebODM
من نوع المحطة الطرفية:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
ثم افتح متصفح الويب على http://localhost:8000.
الأوامر الأساسية واستكشاف الأخطاء وإصلاحها
الشيء الرائع في استخدام عامل الإرساء هو أن 99٪ من المهام التي ستحتاج إلى تنفيذها أثناء استخدام WebODM يمكن إجراؤها عبر النص البرمجي .webodm.sh/. لقد واجهت بالفعل أحدهم:
$ ./webodm.sh start
الذي يعتني ببدء WebODM وإعداد عقدة معالجة افتراضية (node-odm-1). إذا كنت تريد إيقاف WebODM ، يمكنك بالفعل تخمين ما هو الأمر:
$ ./webodm.sh stop
هناك العديد من الأوامر الأخرى التي يمكنك استخدامها ، بالإضافة إلى إشارات مختلفة. العلامات هي معلمات يتم تمريرها إلى الأمر. / webodm.sh وعادة ما تكون مسبوقة بـ "-". ترشد علامة port على سبيل المثال WebODM إلى استخدام منفذ شبكة مختلف:
$ ./webodm.sh start --port 80
يتم سرد أوامر مفيدة أخرى أدناه:
# Restart WebODM (useful if things get stuck)
$ ./webodm.sh restart
# Reset the admin user's password if you forget it
$ ./webodm.sh resetadminpassword newpass
# Update everything to the latest version
$ ./webodm.sh update
# Store processing results in the specified folder instead of the default location (inside docker)
$ ./webodm.sh restart --media-dir /path/to/webodm_results
# See all options
$ ./webodm.sh --help
The community forum is a great place to ask for help if you get stuck during any of the installation steps and for general questions on using the ./webodm.sh script.
مرحبًا WebODM!
بعد تشغيل .webodm.sh/ بدء وفتح WebODM في المتصفح ، سيتم الترحيب بك برسالة ترحيب وسيطلب منك إنشاء المستخدم الأول. خصص بعض الوقت للتعرف على واجهة الويب واستكشاف قوائمها المختلفة.
لوحة تحكم WebODM
لاحظ أنه تحت قائمة Processing Nodes ، تم بالفعل تكوين عقدة "node-odm-1" لتتمكن من استخدامها. هذه عقدة NodeODM وتم إنشاؤها تلقائيًا بواسطة WebODM. تعمل هذه العقدة على نفس جهاز WebODM.
إذا وصلت إلى هذا الحد ، تهانينا! حان الوقت الآن لبدء معالجة بعض البيانات.
يعمل على أكثر من جهاز
اختياريًا: إذا كان لديك جهاز كمبيوتر آخر ، يمكنك تكرار عملية التثبيت (تثبيت docker و git و python وما إلى ذلك) وتشغيل عقدة NodeODM جديدة من خلال الكتابة من نافذة Terminal / Git Bash:
docker run --rm -it -p 3000:3000 opendronemap/nodeodm -q 1 --token secret
يطلب الأمر أعلاه من docker تشغيل حاوية جديدة باستخدام صورة opendronemap / nodeodm من Docker Hub (أحدث إصدار من NodeODM) ، باستخدام المنفذ 3000 ، وتعيين الحد الأقصى لعدد المهام المتزامنة إلى 1 وحماية العقدة من الوصول غير المصرح به باستخدام كلمة السر "سرية".
من WebODM يمكنك بعد ذلك الضغط على زر Add New تحت Nodes العقد. بالنسبة للحقل hostname / IP ، اكتب عنوان IP للكمبيوتر الثاني. بالنسبة للحقل المنفذ ، اكتب "3000". بالنسبة إلى الحقل الرمز المميز ، اكتب "سري". يمكنك أيضًا إضافة تسمية اختيارية للعقدة ، مثل "الكمبيوتر الثاني". ثم اضغط حفظ.
إذا سار كل شيء على ما يرام ، يجب أن يكون لديك الآن عقدتان للمعالجة! ستتمكن من معالجة مهام متعددة بالتوازي باستخدام جهازين مختلفين.
Learn to edit and help improve this page!