# SOME DESCRIPTIVE TITLE. # Copyright (C) 2020, OpenDroneMap # This file is distributed under the same license as the OpenDroneMap # package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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 `_, 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 `_ 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 `_ 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 ”. 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 " "`_ 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 `_ 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 `_ and help improve `this page " "`_!" msgstr ""