Instalación y Guía de Introducción
Esta sección es extraída y modificada con el permiso de OpenDroneMap: The Missing Guide, realizada por Piero Toffanin.
Quickstart
Installers for OpenDroneMap are available for purchase, 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:
Recomendaciones de Hardware
Los requisitos mínimos para ejecutar el software son:
CPU de 64bit manufacturada durante o después del 2010
20GB de espacio en el disco
4GB de RAM
No más de 100-200 imágenes pueden ser procesadas con las especificaciones descritas arribas (el software se quedaría sin memoria). Los requisitos recomendados son:
CPU de última generación
100GB de espacio en disco
16GB de RAM
Las especificaciones de arriba permitirán que unos cuantos cientos de imágenes sean procesados sin muchos problemas. Una CPU con más cores permitirán un procesamiento más rápido, mientras que una tarjeta gráfica (GPU) en el momento no tiene impacto alguno en el desempeño. Para procesar más imágenes, agregue más espacio en el disco y agregue más RAM de manera lineal con respecto al número de imágenes que necesita procesar
Number of images |
RAM or RAM + Swap |
|---|---|
40 |
4 |
250 |
16 |
500 |
32 |
1500 |
64 |
2500 |
128 |
3500 |
192 |
5000 |
256 |
Instalación
Recomendamos utilizar docker para ejecutar ODM, ya sea si está utilizando Windows, macOS o Linux.
Windows
Para ejecutar OpenDroneMap necesita al menos Windows 7. Versiones anteriores de Windows no están soportadas.
Paso 1. Verificar el Soporte de Virtualización
Docker requiere una función de la CPU llamada virtualización, la que permite ejecutar máquinas virtuales (VMs). Asegúrese de que la tiene activada! Ya que algunas veces está desactivada. En Windows 8 o versiones más actuales, esto se puede verificar abriendo el Administrador de Tareas (presionar CTRL+SHIFT+ESC) y cambiando a la ventana de Rendimiento.
Virtualización debería estar activada
En Windows 7 para ver si la opción de virtualización está activada, se puede usar la herramienta Microsoft® Hardware-Assisted Virtualization Detection Tool <http:// www.microsoft.com/en-us/download/details.aspx?id=592>.
Si Ia opción de virtualización está desactivada, necesitará activarla. El procedimiento desafortunamente es un poco diferente para cada modelo de computador, así que la mejor manera de hacerlo es averiguando en un motor de búsqueda “cómo activar vtx para <type your computer model here>». Muchas veces es una cuestión de reiniciar el computador, inmediatamente presionando F2 o F12 durante el arranque, navegando por el menú de arranque y cambiando las configuraciones para activar la opción de virtualización (frecuentemente llamada “VT-X”).
Teclas comunes para presionar en el momento de arranque del computador, para acceder al menú de arranque para varios vendedores de PCs
Paso 2. Requisitos de instalación
Primero, deberá instalar:
Python (la última versión 3): https://www.python.org/downloads/windows/
Para Phyton 3, asegurese de marcar Agregar Phyton 3 a la ruta durante la instalación.
No olvides agregar el ejecutable de Phyton 3 a la ruta (para que puedas correr los comandos con el)
Luego, solo si estas en Windows 10 Home, Windows 8 (cualquier versión) o Windows 7 (cualquier versión), instalar:
Caja de Herramientas Docker: https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe
Si estas en Windows 10 Professional o una versión más reciente, deberias instalar en su lugar:
Docker for Windows:https://docs.docker.com/desktop/install/windows-install/
Por favor NO instalar ambos programas de Docker. Ellos son diferentes y crearán conflictos si están ambos instalados.
Después de instalar Docker, ábrelo desde el ícono en el Escritorio que es creado desde la instalación (Inicio Rápido de Docker en el caso de la caja de herramientas Docker, Docker para Windows en el caso de Docker para Windows).
Paso 3. Revisa la memoria y la asignación del procesador
Docker en Windows funciona ejecutando una VM en segundo plano (piensa en una VM como un «emulador de computador»). Esta VM tiene una cierta cantidad de memoria asignada y WebODM sólo puede usar tanta memoria como esté asignada.
Si instalaste la Caja de Herramientas Docker (observa abajo si instalaste Docker para Windows):
Abra la aplicación Administrador de VirtualBox
Haga clic con el botón derecho en la VM predeterminada y presione Cerrar (Apagar ACPI) para deterner la máquina.
Haga clic con el botón derecho en la ** VM predeterminada ** y presione ** Configuración…**
Mueva el control deslizante de Base Memory desde el panel System y asigne el 60-70% de toda la memoria disponible, agregando opcionalmente el 50% de los procesadores disponibles desde la pestaña Processor también
Configuración predeterminada de la VM de VirtualBox
Luego presione OK, haga clic derecho en la VM predeterminada y presione Iniciar.
Si instalaste Docker para Windows en su lugar:
Busca el ícono de la «ballena blanca» en la bandeja del sistema.
Desde el menú, presione Configuraciones…
Desde el panel, haga clic en Avanzado y use los controles deslizantes para asignar el 60-70% de la memoria disponible y utilice la mitad de los CPUs disponibles.
Clic en Aplicar
Paso 1 Ícono de Docker
Paso 3 y 4 Configuración de Docker
Paso 4. Descarga WebODM
Abra el programa Git GUI que viene instalado con Git. Desde ahí:
Cuando Git Gui se abra, haga clic en la opción “Clone Existing Repository”
En Source Location teclee: https://github.com/OpenDroneMap/WebODM
En Target Directory haga clic en Browse y navegue a la carpeta que elija (cree una si es necesario)
Presione Clone
Git Gui
Si la descarga se realizó correctamente, ahora debería ver esta ventana:
Git Gui después de una descarga exitosa (clone)
Vaya al menú Repository, luego haga clic en Create Desktop Icon. Esto le permitirá volver fácilmente a esta aplicación en el futuro.
Paso 4. Inicie WebODM
Desde Git Gui, vaya al menú Repository, luego haga clic en Git Bash. Desde la terminal de línea de comando teclee:
$ ./webodm.sh start &
En este punto, se descargarán varios componentes en su máquina, incluidos WebODM, NodeODM y ODM. Después de la descarga, debería aparecer la siguiente pantalla:
Salida de consola después de iniciar WebODM por primera vez
Si está utilizando Docker para Windows, abra un navegador web en http://localhost:8000
Si está utilizando Docker Toolbox, busque la dirección IP a la que conectarse escribiendo:
$ docker-machine ip
Debería obtener un resultado como el siguiente:
192.168.1.100
Luego conéctese a http://192.168.1.100:8000 (reemplazando la dirección IP por la correcta).
macOS
La mayoría de las computadoras Mac modernas (posteriores a 2010) que ejecutan macOS Sierra 10.12 o superior pueden ejecutar OpenDroneMap mediante la ventana acoplable, siempre que se admita la virtualización de hardware (ver más abajo).
Paso 1. Verificar el Soporte de Virtualización
Abre una ventana de Terminal y teclea:
$ sysctl kern.hv_support
Obtendrás una respuesta similar a la siguiente:
kern.hv_support: 1
Si el resultado es kern.hv_support: 1, ¡tu Mac es compatible! Continúa con el paso 2.
Si el resultado es kern.hv_support: 0, desafortunadamente significa que tu Mac es demasiado vieja para ejecutar OpenDroneMap. :(
Paso 2. Requisitos de instalación
Solo hay dos programas para instalar:
Después de instalar Docker, deberías encontrar un icono que parece una ballena en la barra de tareas.
Aplicación Docker en ejecución
Puedes verificar que la ventana acoplable se esté ejecutando correctamente abriendo la aplicación Terminal y escribiendo:
$ docker run hello-world
Que debería devolver
Hello from Docker!
Para verificar que Git está instalado, solo teclee:
$ git --version
Que debería devolver algo similar a lo siguiente:
git version 2.20.1 (Apple Git-117)
Si obtiene un «bash: git: comando no encontrado», intente reiniciar su aplicación Terminal y verifique si hay errores durante el proceso de instalación.
Paso 3. Revisa la memoria y la asignación del procesador
Docker en macOS funciona ejecutando una VM en segundo plano (considérelo como un «emulador de computadora»). Esta VM tiene una cierta cantidad de memoria asignada y WebODM solo puede usar la cantidad de memoria asignada.
Haga clic derecho en el icono de la ballena de la barra de tareas y haga clic en Preferencias …
Seleccione la pestaña Avanzado
Ajuste el control deslizante de las CPU para usar la mitad de todas las CPU disponibles y la memoria para usar el 60-70% de toda la memoria disponible
Presione Aplicar y reiniciar
Configuración avanzada de Docker
Paso 4. Descargue y ejecute WebODM
Desde la Terminal teclee:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
Luego abra un navegador web en http://localhost:8000.
Linux
OpenDroneMap puede ejecutarse en cualquier distribución de Linux que admita Docker. Según el sitio web de documentación de docker <https://docs.docker.com/install/> _ las distribuciones oficialmente soportadas son CentOS, Debian, Ubuntu y Fedora, con binarios estáticos disponibles para otros. Si tiene que elegir una distribución únicamente para ejecutar OpenDroneMap, Ubuntu es la distribución recomendada.
Paso 1. Requerimientos de instalación
Hay cuatro programas que deben instalarse:
Docker
Git
Python (2 o 3)
Pip
No podemos cubrir el proceso de instalación de todas las distribuciones de Linux que existen, por lo que limitaremos las instrucciones a aquellas que son distribuciones oficialmente compatibles con Docker. En todos los casos, solo es cuestión de abrir un indicador de terminal y escribir algunos comandos.
Instalar en Ubuntu / Debian
Comandos para escribir:
$ 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
Instalar en CentOS / RHEL
Comandos para escribir:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo yum -y install git python python-pip
Instalar en Fedora
Comandos para escribir:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo dnf install git python python-pip
Instalar en Arch
Comandos para escribir:
$ sudo pacman -Sy docker git python python-pip
Paso 2. Verifique los requisitos adicionales
Además de los tres programas anteriores, también se necesita el script de Dockercompose. A veces, ya está instalado con Docker, pero a veces no. Para verificar si está instalado, intente escribir:
$ docker compose --version
Debería ver algo similar a lo siguiente:
docker compose version 24.0.5, build ced0996600
Paso 3. Descargue y ejecute WebODM
Desde la Terminal escriba:
$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start
Luego abra un navegador web en http://localhost:8000.
Comandos básicos y resolución de problemas
Lo bueno de usar Docker es que el 99% de las tareas que necesitará realizar mientras usa WebODM se pueden realizar a través del script ./webodm.sh. Ya te has encontrado con uno de ellos:
$ ./webodm.sh start
que se encarga de iniciar WebODM y configurar un nodo de procesamiento predeterminado (node-odm-1). Si desea detener WebODM, ya puede adivinar cuál es el comando:
$ ./webodm.sh stop
Hay otros varios comandos que puede usar, junto con diferentes banderas. Los indicadores son parámetros que se pasan al comando ./webodm.sh y suelen tener el prefijo «-». El indicador port, por ejemplo, indica a WebODM que utilice un puerto de red diferente:
$ ./webodm.sh start --port 80
A continuación se enumeran otros comandos útiles:
# 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
El foro de la comunidad The community forum <https://community.opendronemap.org> _ es un gran lugar para pedir ayuda si tiene dificultades durante cualquiera de los pasos de instalación y si tiene preguntas generales sobre el uso del script ./webodm.sh.
¡Hola WebODM!
Después de ejecutar ./webodm.sh start y abrir WebODM en el navegador, se le dará la bienvenida con un mensaje de bienvenida y se le pedirá que cree el primer usuario. Tómese un tiempo para familiarizarse con la interfaz web y explorar sus diversos menús.
WebODM Dashboard
Tenga en cuenta que en el menú Processing Nodes hay un nodo «node-odm-1» ya configurado para su uso. Este es un nodo NodeODM y ha sido creado automáticamente por WebODM. Este nodo se ejecuta en la misma máquina que WebODM.
Si has llegado hasta aquí, ¡felicitaciones! Ahora es el momento de comenzar a procesar algunos datos.
Ejecutando en más de una máquina
Opcionalmente: Si tiene otra computadora, puede repetir el proceso de instalación (instalar docker, git, python, etc.) y lanzar un nuevo nodo NodeODM escribiendo desde una ventana Terminal / Git Bash:
docker run --rm -it -p 3000:3000 opendronemap/nodeodm -q 1 --token secret
El comando anterior le pide a Docker que lance un nuevo contenedor usando la imagen opendronemap/nodeodm de Docker Hub (la última versión de NodeODM), usando el puerto 3000, estableciendo un número máximo de tareas concurrentes en 1 y para proteger el nodo del acceso no autorizado usando el contraseña «secret».
Desde WebODM, puede presionar el botón Add new debajo de Processing Nodes. En el campo hostname/IP **, escriba la IP de la segunda computadora. Para el campo **port, escriba «3000». Para el campo token, escriba «secret». También puede agregar una etiqueta label opcional para su nodo, como «segunda computadora». Luego presione Save para guardar.
Si todo salió bien, ¡ahora debería tener dos nodos de procesamiento! Podrá procesar múltiples tareas en paralelo utilizando dos máquinas diferentes.
Aprende a editar y ayuda a mejorar esta página!