kopia lustrzana https://github.com/OpenDroneMap/docs
841 wiersze
23 KiB
Plaintext
841 wiersze
23 KiB
Plaintext
|
# SOME DESCRIPTIVE TITLE.
|
|||
|
|
# Copyright (C) 2020, OpenDroneMap
|
|||
|
|
# This file is distributed under the same license as the OpenDroneMap
|
|||
|
|
# package.
|
|||
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 2023.
|
|||
|
|
#
|
|||
|
|
#, fuzzy
|
|||
|
|
msgid ""
|
|||
|
|
msgstr ""
|
|||
|
|
"Project-Id-Version: OpenDroneMap 2.7.0\n"
|
|||
|
|
"Report-Msgid-Bugs-To: \n"
|
|||
|
|
"POT-Creation-Date: 2021-12-28 10:32-0500\n"
|
|||
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|||
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|||
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|||
|
|
"MIME-Version: 1.0\n"
|
|||
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|||
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|||
|
|
"Generated-By: Babel 2.9.1\n"
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:4
|
|||
|
|
msgid "Installation and Getting Started"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:6
|
|||
|
|
msgid ""
|
|||
|
|
"This section is excerpted and modified with permission from "
|
|||
|
|
"`OpenDroneMap: The Missing Guide <https://odmbook.com>`_, by Piero "
|
|||
|
|
"Toffanin."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:8
|
|||
|
|
msgid ""
|
|||
|
|
"Until recently OpenDroneMap was the term used to refer to a single "
|
|||
|
|
"command line application (what is now known as the ODM project). With "
|
|||
|
|
"the recent development of a web interface, an API and other tools, "
|
|||
|
|
"OpenDroneMap has become an ecosystem of various applications to process, "
|
|||
|
|
"analyze and display aerial data. This ecosystem is made of several "
|
|||
|
|
"components:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "ODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:14
|
|||
|
|
msgid ""
|
|||
|
|
"**ODM** is the processing engine, which can be used from the command "
|
|||
|
|
"line. It takes images as input and produces a variety of outputs, "
|
|||
|
|
"including point clouds, 3D models and orthophotos"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "NodeODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:20
|
|||
|
|
msgid ""
|
|||
|
|
"**NodeODM** is a light-weight API built on top of ODM. It allows users "
|
|||
|
|
"and applications to access the functions of ODM over a computer network"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "WebODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:26
|
|||
|
|
msgid ""
|
|||
|
|
"**WebODM** is a friendly user interface that includes a map viewer, a 3D "
|
|||
|
|
"viewer, user logins, a plugin system and many other features that are "
|
|||
|
|
"expected of modern drone mapping platforms"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "CloudODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:32
|
|||
|
|
msgid ""
|
|||
|
|
"**CloudODM** is a small command line client to communicate with ODM via "
|
|||
|
|
"the NodeODM API"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "PyODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:38
|
|||
|
|
msgid ""
|
|||
|
|
"**PyODM** is a Python SDK for creating tasks via the NodeODM API. We "
|
|||
|
|
"cover it in more detail in the “Automated Processing With Python” chapter"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "ClusterODM Logo"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:44
|
|||
|
|
msgid ""
|
|||
|
|
"**ClusterODM** is a load balancer for connecting together multiple "
|
|||
|
|
"NodeODM instances"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:46
|
|||
|
|
msgid ""
|
|||
|
|
"ODM, NodeODM and WebODM are available on all major platforms (Windows, "
|
|||
|
|
"macOS and Linux) via a program called docker, which is required to run "
|
|||
|
|
"the software. Docker offers a way to run “containers”. Containers are "
|
|||
|
|
"packaged copies of an entire system, its software and its dependencies. "
|
|||
|
|
"These containers run within a virtual environment. On Linux this virtual "
|
|||
|
|
"environment is available from the operating system and is very efficient."
|
|||
|
|
" On macOS and Windows the containers run within a VM, so there’s a bit of"
|
|||
|
|
" a overhead. but it’s still very suitable for running the software. Once "
|
|||
|
|
"installed users do not have to worry much about docker, as it operates "
|
|||
|
|
"(almost) transparently."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:48
|
|||
|
|
msgid ""
|
|||
|
|
"Without docker it would not be possible to run ODM on Windows or macOS. "
|
|||
|
|
"On these platforms ODM cannot run natively. Future development efforts "
|
|||
|
|
"are being focused on leveraging the new Windows Subsystem for Linux (WSL)"
|
|||
|
|
" and the possibility to make a native port of all dependencies to macOS, "
|
|||
|
|
"which is going to make the installation much easier."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:50
|
|||
|
|
msgid ""
|
|||
|
|
"On Ubuntu Linux 18.04 it’s feasible to run all OpenDroneMap software "
|
|||
|
|
"natively. However, because there’s very little performance penalty for "
|
|||
|
|
"running docker on Linux and docker is straightforward to setup on this "
|
|||
|
|
"platform, we don’t recommend it. On Linux the advantages of "
|
|||
|
|
"containerization far outweigh a tiny performance penalty. With docker "
|
|||
|
|
"users also get easy one-step updates of the software, so that’s nice."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:54
|
|||
|
|
msgid "Hardware Recommendations"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:56
|
|||
|
|
msgid "The bare minimum requirements for running the software are:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:59
|
|||
|
|
msgid "64bit CPU manufactured on or after 2010"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:60
|
|||
|
|
msgid "20 GB of disk space"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:61
|
|||
|
|
msgid "4 GB RAM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:63
|
|||
|
|
msgid ""
|
|||
|
|
"No more than 100-200 images can be processed with the above "
|
|||
|
|
"specifications (the software will run out of memory). Recommended "
|
|||
|
|
"requirements are:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:65
|
|||
|
|
msgid "Latest Generation CPU"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:66
|
|||
|
|
msgid "100 GB of disk space"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:67
|
|||
|
|
msgid "16 GB RAM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:69
|
|||
|
|
msgid ""
|
|||
|
|
"The above will allow for a few hundred images to be processed without too"
|
|||
|
|
" many issues. A CPU with more cores will allow for faster processing, "
|
|||
|
|
"while a graphics card (GPU) currently has no impact on performance. For "
|
|||
|
|
"processing more images, add more disk space and RAM linearly to the "
|
|||
|
|
"number of images you need to process."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:75
|
|||
|
|
msgid "Installation"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:77
|
|||
|
|
msgid ""
|
|||
|
|
"We recommend people use `docker <https://www.docker.com>`_ for running "
|
|||
|
|
"ODM, whether you are on Windows, macOS or Linux."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:80
|
|||
|
|
msgid "Windows"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:82
|
|||
|
|
msgid ""
|
|||
|
|
"To run OpenDroneMap you need at least Windows 7. Previous versions of "
|
|||
|
|
"Windows are not supported."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:86 ../../installation.rst:238
|
|||
|
|
msgid "Step 1. Check Virtualization Support"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:88
|
|||
|
|
msgid ""
|
|||
|
|
"Docker requires a feature from your CPU called virtualization, which "
|
|||
|
|
"allows it to run virtual machines (VMs). Make sure you have it enabled! "
|
|||
|
|
"Sometimes this is disabled. To check, on Windows 8 or higher you can open"
|
|||
|
|
" the **Task Manager** (press CTRL+SHIFT+ESC) and switch to the "
|
|||
|
|
"**Performance** tab."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Image of checking virtualization in Windows 8 or higher"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:94
|
|||
|
|
msgid "*Virtualization should be enabled*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:96
|
|||
|
|
msgid ""
|
|||
|
|
"On Windows 7 to see if you have virtualization enabled you can use the "
|
|||
|
|
"`Microsoft® Hardware-Assisted Virtualization Detection Tool <http:// "
|
|||
|
|
"www.microsoft.com/en-us/download/details.aspx?id=592>`_ instead."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:99
|
|||
|
|
msgid ""
|
|||
|
|
"If virtualization is disabled, you’ll need to enable it. The procedure "
|
|||
|
|
"unfortunately is a bit different for each computer model, so the best way"
|
|||
|
|
" to do this is to look up on a search engine “how to enable vtx for <type"
|
|||
|
|
" your computer model here>”. Often times it’s a matter of restarting the "
|
|||
|
|
"computer, immediately pressing F2 or F12 during startup, navigating the "
|
|||
|
|
"boot menu and changing the settings to enable virtualization (often "
|
|||
|
|
"called “VT-X”)."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Table of different bios keys"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:105
|
|||
|
|
msgid ""
|
|||
|
|
"*Common keys to press at computer startup to access the boot menu for "
|
|||
|
|
"various PC vendors*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:108 ../../installation.rst:257
|
|||
|
|
msgid "Step 2. Install Requirements"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:110
|
|||
|
|
msgid "First, you’ll need to install:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:112
|
|||
|
|
msgid "Git: https://git-scm.com/downloads"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:113
|
|||
|
|
msgid "Python (latest version 3): https://www.python.org/downloads/windows/"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:115
|
|||
|
|
msgid ""
|
|||
|
|
"For Python 3, make sure you check **Add Python 3.x to PATH** during the "
|
|||
|
|
"installation."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Python3 installation process"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:121
|
|||
|
|
msgid ""
|
|||
|
|
"*Don’t forget to add the Python executable to your PATH (so that you can "
|
|||
|
|
"run commands with it)*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:123
|
|||
|
|
msgid ""
|
|||
|
|
"Then, only if you are on Windows 10 Home, Windows 8 (any version) or "
|
|||
|
|
"Windows 7 (any version), install:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:125
|
|||
|
|
msgid ""
|
|||
|
|
"Docker Toolbox: "
|
|||
|
|
"https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:127
|
|||
|
|
msgid ""
|
|||
|
|
"If you are on Windows 10 Professional or a newer version, you should "
|
|||
|
|
"install instead:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:129
|
|||
|
|
#, python-format
|
|||
|
|
msgid ""
|
|||
|
|
"Docker for Windows: "
|
|||
|
|
"https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:131
|
|||
|
|
msgid ""
|
|||
|
|
"Please do **NOT** install both docker programs. They are different and "
|
|||
|
|
"will create a mess if they are both installed."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:133
|
|||
|
|
msgid ""
|
|||
|
|
"After installing docker, launch it from the Desktop icon that is created "
|
|||
|
|
"from the installation (**Docker Quickstart** in the case of Docker "
|
|||
|
|
"Toolbox, **Docker for Windows** for Docker for Windows). This is "
|
|||
|
|
"important, do not skip this step. If there are errors, follow the prompts"
|
|||
|
|
" on screen to fix them."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:136 ../../installation.rst:299
|
|||
|
|
msgid "Step 3. Check Memory and CPU Allocation"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:138
|
|||
|
|
msgid ""
|
|||
|
|
"Docker on Windows works by running a VM in the background (think of a VM "
|
|||
|
|
"as a “computer emulator”). This VM has a certain amount of memory "
|
|||
|
|
"allocated and WebODM can only use as much memory as it’s allocated."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:140
|
|||
|
|
msgid ""
|
|||
|
|
"If you installed Docker Toolbox (see below if you installed Docker for "
|
|||
|
|
"Windows instead):"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:142
|
|||
|
|
msgid "Open the **VirtualBox Manager** application"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:143
|
|||
|
|
msgid ""
|
|||
|
|
"Right click the **default** VM and press **Close (ACPI Shutdown)** to "
|
|||
|
|
"stop the machine"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:144
|
|||
|
|
msgid "Right click the **default** VM and press **Settings...**"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:145
|
|||
|
|
#, python-format
|
|||
|
|
msgid ""
|
|||
|
|
"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"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of VirtualBox Settings"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:151
|
|||
|
|
msgid "*VirtualBox default VM settings*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:153
|
|||
|
|
msgid "Then press **OK**, right click the **default** VM and press **Start**."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:155
|
|||
|
|
msgid "If you installed Docker for Windows instead:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:157
|
|||
|
|
msgid "Look in the system tray and right click the “white whale” icon."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:158
|
|||
|
|
msgid "From the menu, press **Settings...**"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:159
|
|||
|
|
#, python-format
|
|||
|
|
msgid ""
|
|||
|
|
"From the panel, click **Advanced** and use the sliders to allocate 60-70%"
|
|||
|
|
" of available memory and use half of all available CPUs."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:160
|
|||
|
|
msgid "Press **Apply**."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Docker Icon"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:166
|
|||
|
|
msgid "*Step 1 Docker icon*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Docker Settings"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:172
|
|||
|
|
msgid "*Step 3 & 4 Docker settings*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:175
|
|||
|
|
msgid "Step 4. Download WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:177
|
|||
|
|
msgid "Open the **Git Gui** program that comes installed with Git. From there:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:179
|
|||
|
|
msgid "When Git Gui opens, click 'Clone Existing Repository' option"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:180
|
|||
|
|
msgid "In **Source Location** type: https://github.com/OpenDroneMap/WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:181
|
|||
|
|
msgid ""
|
|||
|
|
"In **Target Directory** click browse and navigate to a folder of your "
|
|||
|
|
"choosing (create one if necessary)"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:182
|
|||
|
|
msgid "Press **Clone**"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Git Gui"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:188
|
|||
|
|
msgid "*Git Gui*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:190
|
|||
|
|
msgid "If the download succeeded, you should now see this window:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Git Gui after successful download"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:196
|
|||
|
|
msgid "*Git Gui after successful download (clone)*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:198
|
|||
|
|
msgid ""
|
|||
|
|
"Go to the **Repository** menu, then click **Create Desktop Icon**. This "
|
|||
|
|
"will allow you to come back to this application easily in the future."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:201
|
|||
|
|
msgid "Step 4. Launch WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:203
|
|||
|
|
msgid ""
|
|||
|
|
"From Git Gui, go to the **Repository** menu, then click **Git Bash**. "
|
|||
|
|
"From the command line terminal type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:209
|
|||
|
|
msgid ""
|
|||
|
|
"Several components will download to your machine at this point, including"
|
|||
|
|
" WebODM, NodeODM and ODM. After the download you should be greeted by the"
|
|||
|
|
" following screen:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of after successfully downloading WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:215
|
|||
|
|
msgid "*Console output after starting WebODM for the first time*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:217
|
|||
|
|
msgid ""
|
|||
|
|
"If you are using Docker for Windows, open a web browser to "
|
|||
|
|
"http://localhost:8000"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:218
|
|||
|
|
msgid ""
|
|||
|
|
"If you are using Docker Toolbox, find the IP address to connect to by "
|
|||
|
|
"typing:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:224
|
|||
|
|
msgid "You should get a result like the following:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:230
|
|||
|
|
msgid ""
|
|||
|
|
"Then connect to http://192.168.1.100:8000 (replacing the IP address with "
|
|||
|
|
"the proper one)."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:233
|
|||
|
|
msgid "macOS"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:235
|
|||
|
|
msgid ""
|
|||
|
|
"Most modern (post 2010) Mac computers running macOS Sierra 10.12 or "
|
|||
|
|
"higher can run OpenDroneMap using docker, as long as hardware "
|
|||
|
|
"virtualization is supported (see below)."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:240
|
|||
|
|
msgid "Open a Terminal window and type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:246
|
|||
|
|
msgid "You will get a response similar to the following:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:252
|
|||
|
|
msgid ""
|
|||
|
|
"If the result is *kern.hv_support: 1*, then your Mac is supported! "
|
|||
|
|
"Continue with Step 2."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:254
|
|||
|
|
msgid ""
|
|||
|
|
"If the result is *kern.hv_support: 0*, unfortunately it means your Mac is"
|
|||
|
|
" too old to run OpenDroneMap. :("
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:259
|
|||
|
|
msgid "There are only two programs to install:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:261
|
|||
|
|
msgid "Docker: https://download.docker.com/mac/stable/Docker.dmg"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:262
|
|||
|
|
msgid "Git: https://sourceforge.net/projects/git-osx-installer/files/"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:264
|
|||
|
|
msgid ""
|
|||
|
|
"After installing docker you should find an icon that looks like a whale "
|
|||
|
|
"in the task bar."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Docker whale"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:270
|
|||
|
|
msgid "*Docker app running*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:272
|
|||
|
|
msgid ""
|
|||
|
|
"You can verify that docker is running properly by opening the "
|
|||
|
|
"**Terminal** app and typing:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:278
|
|||
|
|
msgid "Which should return"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:284
|
|||
|
|
msgid "To verify that git is installed, simply type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:290
|
|||
|
|
msgid "Which should return something similar to the following:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:296
|
|||
|
|
msgid ""
|
|||
|
|
"If you get a “bash: git: command not found”, try to restart your "
|
|||
|
|
"**Terminal** app and double-check for any errors during the install "
|
|||
|
|
"process."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:301
|
|||
|
|
msgid ""
|
|||
|
|
"Docker on macOS works by running a VM in the background (think of it as a"
|
|||
|
|
" “computer emulator”). This VM has a certain amount of memory allocated "
|
|||
|
|
"and WebODM can only use as much memory as it’s allocated."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:303
|
|||
|
|
msgid "Right click the whale icon from the task bar and click **Preferences**..."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:304
|
|||
|
|
msgid "Select the **Advanced** tab"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:305
|
|||
|
|
#, python-format
|
|||
|
|
msgid ""
|
|||
|
|
"Adjust the CPUs slider to use half of all available CPUs and the memory "
|
|||
|
|
"to use 60-70% of all available memory"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:306
|
|||
|
|
msgid "Press **Apply & Restart**"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of Docker advanced settings"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:312
|
|||
|
|
msgid "*Docker advanced settings*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:315
|
|||
|
|
msgid "Step 4. Download and Launch WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:317
|
|||
|
|
msgid "From a **Terminal** type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:325 ../../installation.rst:426
|
|||
|
|
msgid "Then open a web browser to http://localhost:8000."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:328
|
|||
|
|
msgid "Linux"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:330
|
|||
|
|
msgid ""
|
|||
|
|
"OpenDroneMap can run on any Linux distribution that supports docker. "
|
|||
|
|
"According to `docker’s documentation website "
|
|||
|
|
"<https://docs.docker.com/install/>`_ the officially supported "
|
|||
|
|
"distributions are CentOS, Debian, Ubuntu and Fedora, with static binaries"
|
|||
|
|
" available for others. If you have to pick a distribution solely for "
|
|||
|
|
"running OpenDroneMap, Ubuntu is the recommended way to go."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:333
|
|||
|
|
msgid "Step 1. Install Requirements"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:335
|
|||
|
|
msgid "There are four programs that need to be installed:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:337
|
|||
|
|
msgid "Docker"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:338
|
|||
|
|
msgid "Git"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:339
|
|||
|
|
msgid "Python (2 or 3)"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:340
|
|||
|
|
msgid "Pip"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:342
|
|||
|
|
msgid ""
|
|||
|
|
"We cannot possibly cover the installation process for every Linux "
|
|||
|
|
"distribution out there, so we’ll limit the instructions to those that are"
|
|||
|
|
" distributions officially supported by docker. In all cases it’s just a "
|
|||
|
|
"matter of opening a terminal prompt and typing a few commands."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:345
|
|||
|
|
msgid "Install on Ubuntu / Debian"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:347 ../../installation.rst:359
|
|||
|
|
#: ../../installation.rst:370 ../../installation.rst:381
|
|||
|
|
msgid "Commands to type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:357
|
|||
|
|
msgid "Install on CentOS / RHEL"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:368
|
|||
|
|
msgid "Install on Fedora"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:379
|
|||
|
|
msgid "Install on Arch"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:388
|
|||
|
|
msgid "Step 2. Check Additional Requirements"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:390
|
|||
|
|
msgid ""
|
|||
|
|
"In addition to the three programs above, the dockercompose script is also"
|
|||
|
|
" needed. Sometimes it’s already installed with docker, but sometimes it "
|
|||
|
|
"isn’t. To verify if it’s installed try to type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:396
|
|||
|
|
msgid "You should see somethings similar to the following:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:402
|
|||
|
|
msgid "If instead you get something similar to the following:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:408
|
|||
|
|
msgid "you can install it by using pip:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:416
|
|||
|
|
msgid "Step 3. Download and Launch WebODM"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:418
|
|||
|
|
msgid "From a terminal type:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:429
|
|||
|
|
msgid "Basic Commands and Troubleshooting"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:431
|
|||
|
|
#, python-format
|
|||
|
|
msgid ""
|
|||
|
|
"The cool thing about using docker is that 99% of the tasks you’ll ever "
|
|||
|
|
"need to perform while using WebODM can be done via the ./webodm.sh "
|
|||
|
|
"script. You have already encountered one of them:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:437
|
|||
|
|
msgid ""
|
|||
|
|
"which takes care of starting WebODM and setting up a default processing "
|
|||
|
|
"node (node-odm-1). If you want to stop WebODM, you can already guess what"
|
|||
|
|
" the command is:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:443
|
|||
|
|
msgid ""
|
|||
|
|
"There are several other commands you can use, along with different flags."
|
|||
|
|
" Flags are parameters passed to the ./webodm.sh command and are typically"
|
|||
|
|
" prefixed with “–”. The **port** flag for example instructs WebODM to use"
|
|||
|
|
" a different network port:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:449
|
|||
|
|
msgid "Other useful commands are listed below:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:468
|
|||
|
|
msgid ""
|
|||
|
|
"`The community forum <https://community.opendronemap.org>`_ 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."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:471
|
|||
|
|
msgid "Hello, WebODM!"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:473
|
|||
|
|
msgid ""
|
|||
|
|
"After running ./webodm.sh start and opening WebODM in the browser, you "
|
|||
|
|
"will be greeted with a welcome message and will be asked to create the "
|
|||
|
|
"first user. Take some time to familiarize yourself with the web interface"
|
|||
|
|
" and explore its various menus."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Screenshot of WebODM Dashboard"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:479
|
|||
|
|
msgid "*WebODM Dashboard*"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:481
|
|||
|
|
msgid ""
|
|||
|
|
"Notice that under the **Processing Nodes** menu there’s a \"node-odm-1\" "
|
|||
|
|
"node already configured for you to use. This is a NodeODM node and has "
|
|||
|
|
"been created automatically by WebODM. This node is running on the same "
|
|||
|
|
"machine as WebODM."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:483
|
|||
|
|
msgid ""
|
|||
|
|
"If you’ve made it this far, congratulations! Now it’s time to start "
|
|||
|
|
"processing some data."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
msgid "Image of celebratory dance"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:490
|
|||
|
|
msgid "Running on more than one machine"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:492
|
|||
|
|
msgid ""
|
|||
|
|
"**Optionally:** If you have another computer, you can repeat the "
|
|||
|
|
"installation process (install docker, git, python, etc.) and launch a new"
|
|||
|
|
" NodeODM node by typing from a Terminal/Git Bash window:"
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:498
|
|||
|
|
msgid ""
|
|||
|
|
"The above command asks docker to launch a new container using the "
|
|||
|
|
"opendronemap/nodeodm image from Docker Hub (the latest version of "
|
|||
|
|
"NodeODM), using port 3000, setting a maximum number of concurrent tasks "
|
|||
|
|
"to 1 and to protect the node from unauthorized access using the password "
|
|||
|
|
"\"secret\"."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:500
|
|||
|
|
msgid ""
|
|||
|
|
"From WebODM you can then press the **Add New** button under **Processing "
|
|||
|
|
"Nodes**. For the **hostname/IP** field type the IP of the second "
|
|||
|
|
"computer. For the **port** field type “3000”. For the **token** field "
|
|||
|
|
"type “secret”. You can also add an optional **label** for your node, such"
|
|||
|
|
" as “second computer”. Then press **Save**."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:502
|
|||
|
|
msgid ""
|
|||
|
|
"If everything went well, you should now have two processing nodes! You "
|
|||
|
|
"will be able to process multiple tasks in parallel using two different "
|
|||
|
|
"machines."
|
|||
|
|
msgstr ""
|
|||
|
|
|
|||
|
|
#: ../../installation.rst:505
|
|||
|
|
msgid ""
|
|||
|
|
"`Learn to edit <https://github.com/opendronemap/docs#how-to-make-your-"
|
|||
|
|
"first-contribution>`_ and help improve `this page "
|
|||
|
|
"<https://github.com/OpenDroneMap/docs/blob/publish/source/installation.rst>`_!"
|
|||
|
|
msgstr ""
|
|||
|
|
|