Instalace a spuštění

Tato část je převzata a upravena se svolením z OpenDroneMap: The Missing Guide, autor 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:

Doporučení k hardwaru

Minimální požadavky pro spuštění softwaru jsou:

  • 64bitový procesor vyrobený v roce 2010 nebo později

  • 20 GB místa na disku

  • 4 GB RAM

S výše uvedenými specifikacemi lze zpracovat maximálně 100-200 snímků (software vyčerpá paměť). Doporučené požadavky jsou:

  • Nejnovější generace CPU

  • 100 GB místa na disku

  • 16 GB RAM

Výše uvedený postup umožní zpracovat několik stovek snímků bez větších problémů. Procesor s více jádry umožní rychlejší zpracování, zatímco grafická karta (GPU) nemá v současné době na výkon žádný vliv. Pro zpracování většího počtu snímků přidejte více místa na disku a paměti RAM lineárně podle počtu snímků, které potřebujete zpracovat.

Minimum RAM needed for N images

Number of images

RAM or RAM + Swap

40

4

250

16

500

32

1500

64

2500

128

3500

192

5000

256

Instalace

Pro spuštění ODM doporučujeme používat docker, ať už používáte Windows, MacOS nebo Linux.

Windows

Pro spuštění OpenDroneMap potřebujete alespoň Windows 7. Předchozí verze systému Windows nejsou podporovány.

Krok 1. Zkontrolujte podporu virtualizace

Docker vyžaduje od procesoru funkci zvanou virtualizace, která mu umožňuje spouštět virtuální počítače (VM). Ujistěte se, že ji máte povolenou! Někdy je tato funkce vypnutá. Chcete-li to zkontrolovat, můžete v systému Windows 8 nebo vyšším otevřít Správce úloh (stiskněte klávesy CTRL+SHIFT+ESC) a přepnout na kartu Výkon.

Obrázek kontroly virtualizace v systému Windows 8 nebo vyšším

Virtualizace by měla být povolena

V systému Windows 7 můžete pro zjištění, zda máte povolenou virtualizaci, použít místo toho nástroj Microsoft® Hardware-Assisted Virtualization Detection Tool.

Pokud je virtualizace zakázána, je třeba ji povolit. Postup se bohužel u každého modelu počítače trochu liší, takže nejlépe uděláte, když si ve vyhledávači vyhledáte „jak povolit vtx pro <type your computer model here>“. Často se jedná o restartování počítače, okamžité stisknutí klávesy F2 nebo F12 během spouštění, procházení spouštěcí nabídky a změnu nastavení pro povolení virtualizace (často nazývané „VT-X“).

Tabulka různých klíčů biosu

Obvyklé klávesy, které je třeba stisknout při spuštění počítače pro přístup ke spouštěcí nabídce různých výrobců počítačů

Krok 2. Požadavky na instalaci

Nejprve je třeba nainstalovat:

V případě Pythonu 3 se ujistěte, že jste během instalace zaškrtli políčko Přidat Python 3.x do PATH.

Snímek obrazovky procesu instalace Pythonu3

Nezapomeňte přidat spustitelný soubor Pythonu do cesty PATH (abyste s ním mohli spouštět příkazy).

Pouze pokud používáte systém Windows 10 Home, Windows 8 (jakoukoli verzi) nebo Windows 7 (jakoukoli verzi), nainstalujte jej:

Pokud používáte systém Windows 10 Professional nebo novější verzi, měli byste místo toho nainstalovat:

Prosím, NE instalujte oba programy docker. Jsou odlišné a pokud budou nainstalovány oba, vznikne nepořádek.

Po instalaci nástroje Docker jej spusťte z ikony na ploše, která byla vytvořena při instalaci (Docker Quickstart v případě Docker Toolbox, Docker for Windows pro Docker for Windows). Je to důležité, tento krok nevynechávejte. Pokud se objeví chyby, postupujte podle pokynů na obrazovce a opravte je.

Krok 3. Zkontrolujte přidělení paměti a procesoru

Docker v systému Windows funguje tak, že na pozadí běží virtuální počítač (virtuální počítač si představte jako „emulátor počítače“). Tento virtuální počítač má přiděleno určité množství paměti a WebODM může využívat pouze tolik paměti, kolik mu bylo přiděleno.

Pokud jste nainstalovali Docker Toolbox (pokud jste místo toho nainstalovali Docker pro Windows, viz níže):

  1. Otevřete aplikaci VirtualBox Manager.

  2. Klikněte pravým tlačítkem myši na defaultní virtuální počítač a stiskněte Close (ACPI Shutdown) pro zastavení počítače.

  3. Klikněte pravým tlačítkem myši na výchozí virtuální počítač a stiskněte Nastavení…

  4. Přesuňte posuvník Základní paměť z panelu Systém a přidělte 60-70 % veškeré dostupné paměti, případně přidejte také 50 % dostupných procesorů z karty Procesor.

Snímek obrazovky nastavení VirtualBoxu

Výchozí nastavení virtuálního počítače VirtualBox

Poté stiskněte tlačítko OK, klikněte pravým tlačítkem myši na výchozí virtuální počítač a stiskněte tlačítko Spustit.

Pokud jste místo toho nainstalovali Docker pro Windows:

  1. Podívejte se do systémové lišty a klikněte pravým tlačítkem myši na ikonu „bílé velryby“.

  2. V nabídce stiskněte Nastavení….

  3. Na panelu klikněte na tlačítko Pokročilé a pomocí posuvníků přidělte 60-70 % dostupné paměti a využijte polovinu všech dostupných procesorů.

  4. Stiskněte Použít.

Snímek obrazovky ikony Dockeru

Krok 1 Ikona Docker

Snímek obrazovky nastavení aplikace Docker

Krok 3 a 4 nastavení Dockeru

Krok 4. Stáhněte si WebODM

Otevřete program Git Gui, který je nainstalován se systémem Git. Odtud:

  • Po otevření nástroje Git Gui klikněte na možnost „Klonovat existující úložiště“.

  • Do pole Zdrojové umístění zadejte: https://github.com/OpenDroneMap/WebODM

  • V okně Cílový adresář klikněte na tlačítko procházet a přejděte do vybrané složky (v případě potřeby ji vytvořte).

  • Stiskněte tlačítko Klonovat

Snímek obrazovky Git Gui

Git Gui

Pokud se stahování podařilo, mělo by se zobrazit toto okno:

Snímek obrazovky Git Gui po úspěšném stažení

Git Gui po úspěšném stažení (klonování)

Přejděte do nabídky Úložiště a klikněte na tlačítko Vytvořit ikonu na ploše. To vám umožní se v budoucnu k této aplikaci snadno vracet.

Krok 4. Spusťte WebODM

V prostředí Git Gui přejděte do nabídky Úložiště a klikněte na položku Git Bash. V terminálu příkazového řádku zadejte:

$ ./webodm.sh start &

V tomto okamžiku se do počítače stáhne několik komponent, včetně WebODM, NodeODM a ODM. Po stažení by vás měla přivítat následující obrazovka:

Snímek obrazovky po úspěšném stažení WebODM

Výstup konzoly po prvním spuštění WebODM

  • Pokud používáte Docker pro Windows, otevřete webový prohlížeč na adrese http://localhost:8000.

  • Pokud používáte Docker Toolbox, vyhledejte IP adresu, ke které se chcete připojit, zadáním:

$ docker-machine ip

Měli byste získat následující výsledek:

192.168.1.100

Poté se připojte k webu http://192.168.1.100:8000 (IP adresu nahraďte správnou).

macOS

Na většině moderních počítačů Mac (po roce 2010) se systémem macOS Sierra 10.12 nebo vyšším lze OpenDroneMap spustit pomocí dockeru, pokud je podporována hardwarová virtualizace (viz níže).

Krok 1. Zkontrolujte podporu virtualizace

Otevřete okno Terminálu a napište:

$ sysctl kern.hv_support

Dostanete podobnou odpověď, jako je tato:

kern.hv_support: 1

Pokud je výsledkem kern.hv_support: 1, pak je váš Mac podporován! Pokračujte krokem 2.

Pokud je výsledkem kern.hv_support: 0, To bohužel znamená, že váš Mac je příliš starý na spuštění OpenDroneMap :(.

Krok 2. Požadavky na instalaci

Je třeba nainstalovat pouze dva programy:

  1. Docker: https://download.docker.com/mac/stable/Docker.dmg

  2. Git: https://sourceforge.net/projects/git-osx-installer/files/

Po instalaci dockeru byste měli na hlavním panelu najít ikonu, která vypadá jako velryba.

Snímek obrazovky Docker whale

Spuštěná aplikace Docker

Správné spuštění dockeru můžete ověřit tak, že otevřete aplikaci Terminál a zadáte:

$ docker run hello-world

Který by měl vrátit

Hello from Docker!

Chcete-li ověřit, zda je git nainstalován, jednoduše zadejte:

$ git --version

Který by měl vrátit něco podobného:

git version 2.20.1 (Apple Git-117)

Pokud se zobrazí hlášení „bash: git: command not found“, zkuste restartovat aplikaci Terminal a překontrolujte, zda během instalace nedošlo k chybě.

Krok 3. Zkontrolujte přidělení paměti a procesoru

Docker v systému macOS funguje tak, že na pozadí běží virtuální počítač (představte si ho jako „emulátor počítače“). Tento virtuální počítač má přiděleno určité množství paměti a WebODM může využívat pouze tolik paměti, kolik mu bylo přiděleno.

  1. Klikněte pravým tlačítkem myši na ikonu velryby na hlavním panelu a klikněte na položku Předvolby…

  2. Vyberte kartu Pokročilé

  3. Nastavte posuvník CPU tak, aby využíval polovinu všech dostupných CPU, a paměť tak, aby využívala 60-70 % veškeré dostupné paměti.

  4. Stiskněte tlačítko Použít a restartovat

Snímek obrazovky pokročilého nastavení Docker

Pokročilé nastavení Dockeru

Krok 4. Stažení a spuštění WebODM

V Terminálu napište:

$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start

Poté otevřete webový prohlížeč na adrese http://localhost:8000.

Linux

OpenDroneMap lze spustit na libovolné distribuci Linuxu, která podporuje docker. Podle webových stránek s dokumentací dockeru jsou oficiálně podporovanými distribucemi CentOS, Debian, Ubuntu a Fedora, pro ostatní jsou k dispozici statické binární soubory. Pokud si musíte vybrat distribuci výhradně pro spuštění OpenDroneMap, doporučuje se Ubuntu.

Krok 1. Instalace požadavků

Je třeba nainstalovat čtyři programy:

  1. Docker

  2. Git

  3. Python (2 nebo 3)

  4. Pip

Nemůžeme popsat instalační proces pro všechny distribuce Linuxu, takže se omezíme na ty, které jsou oficiálně podporovány dockerem. Ve všech případech jde jen o otevření terminálového příkazu a zadání několika příkazů.

Instalace na Ubuntu / Debian

Příkazy k zadání:

$ 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
Instalace na CentOS / RHEL

Příkazy k zadání:

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo yum -y install git python python-pip
Instalace v systému Fedora

Příkazy k zadání:

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo dnf install git python python-pip
Instalace na Arch

Příkazy k zadání:

$ sudo pacman -Sy docker git python python-pip

Krok 2. Zkontrolujte další požadavky

Kromě tří výše uvedených programů je zapotřebí také skript dockercompose. Někdy je již nainstalován spolu s dockerem, ale někdy ne. Chcete-li ověřit, zda je nainstalován, zkuste zadat následující příkaz:

$ docker compose --version

Měli byste vidět něco podobného:

docker compose version 24.0.5, build ced0996600

Krok 3. Stažení a spuštění WebODM

Z terminálu typu:

$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start

Poté otevřete webový prohlížeč na adrese http://localhost:8000.

Základní příkazy a řešení potíží

Skvělé na používání dockeru je, že 99 % úloh, které kdy budete potřebovat provést při používání WebODM, lze provést pomocí skriptu ./webodm.sh. S jednou z nich jste se již setkali:

$ ./webodm.sh start

který se postará o spuštění WebODM a nastavení výchozího uzlu pro zpracování (node-odm-1). Pokud chcete službu WebODM zastavit, můžete již tušit, jaký je její příkaz:

$ ./webodm.sh stop

Existuje několik dalších příkazů, které můžete použít spolu s různými příznaky. Příznaky jsou parametry předávané příkazu ./webodm.sh a obvykle mají předponu „-“. Například příznak port dává WebODM pokyn k použití jiného síťového portu:

$ ./webodm.sh start --port 80

Další užitečné příkazy jsou uvedeny níže:

# 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

Komunitní fórum je skvělým místem, kde můžete požádat o pomoc, pokud se zaseknete při některém z kroků instalace, a pro obecné otázky týkající se používání skriptu ./webodm.sh.

Dobrý den, WebODM!

Po spuštění souboru ./webodm.sh start a otevření WebODM v prohlížeči se zobrazí uvítací zpráva a budete vyzváni k vytvoření prvního uživatele. Věnujte nějaký čas seznámení s webovým rozhraním a prozkoumejte jeho různé nabídky.

Snímek obrazovky ovládacího panelu WebODM

WebODM Dashboard

Všimněte si, že v nabídce Processing Nodes je již nakonfigurován uzel „node-odm-1“, který můžete použít. Jedná se o uzel NodeODM a byl vytvořen automaticky pomocí WebODM. Tento uzel běží na stejném počítači jako WebODM.

Pokud jste se dostali až sem, gratulujeme vám! Nyní je čas začít zpracovávat data.

Obrázek oslavného tance

Spuštění na více než jednom počítači

Případně: Pokud máte jiný počítač, můžete proces instalace zopakovat (nainstalovat docker, git, python atd.) a spustit nový uzel NodeODM zadáním v okně Terminal/Git Bash:

docker run --rm -it -p 3000:3000 opendronemap/nodeodm -q 1 --token secret

Výše uvedený příkaz požádá docker o spuštění nového kontejneru pomocí obrazu opendronemap/nodeodm z Docker Hub (nejnovější verze NodeODM), použití portu 3000, nastavení maximálního počtu souběžných úloh na 1 a ochranu uzlu před neoprávněným přístupem pomocí hesla „secret“.

Ve WebODM pak můžete stisknout tlačítko Přidat nový v části Zpracovatelské uzly. Do pole název hostitele/IP zadejte IP adresu druhého počítače. Do pole port zadejte „3000“. Do pole token zadejte „secret“. Můžete také přidat nepovinný název uzlu, například „druhý počítač“. Poté stiskněte tlačítko Uložit.

Pokud vše proběhlo v pořádku, měli byste nyní mít dva zpracovatelské uzly! Budete moci paralelně zpracovávat více úloh na dvou různých strojích.

Naučte se upravovat a pomozte zlepšit tuto stránku!