kopia lustrzana https://github.com/OpenDroneMap/docs
830 wiersze
53 KiB
HTML
830 wiersze
53 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<html class="writer-html5" lang="sw" >
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
|
|
<title>Kuingiza na kuanza kutumia — OpenDroneMap 2.5.8 documentation</title>
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
|
|
|
|
|
|
|
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!--[if lt IE 9]>
|
|
<script src="../_static/js/html5shiv.min.js"></script>
|
|
<![endif]-->
|
|
|
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
|
|
<script src="../_static/jquery.js"></script>
|
|
<script src="../_static/underscore.js"></script>
|
|
<script src="../_static/doctools.js"></script>
|
|
|
|
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
|
|
|
|
|
<link rel="index" title="Index" href="../genindex/" />
|
|
<link rel="search" title="Search" href="../search/" />
|
|
<link rel="next" title="Somo" href="../tutorials/" />
|
|
<link rel="prev" title="Karibu OpenDroneMap Kitabu" href="../" />
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav">
|
|
|
|
|
|
<div class="wy-grid-for-nav">
|
|
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|
<div class="wy-side-scroll">
|
|
<div class="wy-side-nav-search" >
|
|
|
|
|
|
|
|
<a href="../" class="icon icon-home"> OpenDroneMap
|
|
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<div class="version">
|
|
2.5.8
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div role="search">
|
|
<form id="rtd-search-form" class="wy-form" action="../search/" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="current">
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="#">Kuingiza na kuanza kutumia</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="#hardware-recommendations">Sifa za Hardware</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#installation">Uingizaji</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="#windows">Windows</a><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-1-check-virtualization-support">Jia ya 1. Angalia msaada wa uvumbuzi</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-2-install-requirements">Njia ya 2. Ingiza Vinavyohitajika</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-3-check-memory-and-cpu-allocation">Njia ya 3. Angalia nafasi na mgao wa CPU</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-4-download-webodm">Njia ya 4. Pakua WebODM</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-4-launch-webodm">Njia ya 4. Zindua WebODM</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#macos">macOS</a><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="#id1">Jia ya 1. Angalia msaada wa uvumbuzi</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#id2">Njia ya 2. Ingiza Vinavyohitajika</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#id3">Njia ya 3. Angalia nafasi na mgao wa CPU</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-4-download-and-launch-webodm">Njia ya 4. Pakua na fungua WebODM</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l3"><a class="reference internal" href="#linux">Linux</a><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-1-install-requirements">Hatua 1. Mahitaji ya kuingiza</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-2-check-additional-requirements">Njia ya 2. Angalia Mahitaji ya Ziada</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="#step-3-download-and-launch-webodm">Njia ya 3. Pakua na zindua WebODM</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#basic-commands-and-troubleshooting">Camand za msingi na utatuzi shida</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="#hello-webodm">Habari, WebODM!</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="#running-on-more-than-one-machine">Kuendesha mashine zaidi ya moja</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="../tutorials/">Somo</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#creating-high-quality-orthophotos">Tengeneza Orthophotos ya kitaalamu</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#calibrating-the-camera">Kurekebisha Camera</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#creating-digital-elevation-models">Kutengeneza Digital Elevation Model</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#measuring-stockpile-volume">Measuring stockpile volume</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#fieldwork-planning">Fieldwork planning</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#flight-pattern">Flight pattern</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#flight-height">Flight height</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#gcps">GCPs</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#processing-parameters">Processing parameters</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#measuring">Measuring</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#expected-accuracy">Expected accuracy</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#using-docker">Kutumia Docker</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#listing-docker-machines">Kutumia Docker mashine</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#accessing-logs-on-the-instance">Tumia logs kwenye instance</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#command-line-access-to-instances">Matumizy ya camand line kwa mifano</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#cleaning-up-after-docker">Safisha juu baada ya Docker</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../tutorials/#using-odm-from-low-bandwidth-location">Tumia ODM kutoka eneo lenye low-bandwidth</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#what-is-this-and-who-is-it-for">Nini hiki na kwa nani</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../tutorials/#steps">Njia</a><ul>
|
|
<li class="toctree-l4"><a class="reference internal" href="../tutorials/#install">Kuingiza</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../tutorials/#prep-data-and-project">Kuandaa data na project</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../tutorials/#resize-droplet-pull-pin-run-away">Kubadilisha droplet, kuvuta pini, pekua</a></li>
|
|
<li class="toctree-l4"><a class="reference internal" href="../tutorials/#after-it-finishes-assuming-you-survive-that-long">Baada kumaliza (kisia utachukua mda mkubwa)</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../arguments/">Chagizi na Bendera</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/build-overviews/">build-overviews</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/camera-lens/">camera-lens</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/cameras/">cameras</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/cog/">cog</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/copy-to/">copy-to</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/crop/">crop</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/debug/">debug</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dem-decimation/">dem-decimation</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dem-euclidean-map/">dem-euclidean-map</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dem-gapfill-steps/">dem-gapfill-steps</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dem-resolution/">dem-resolution</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/depthmap-resolution/">depthmap-resolution</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dsm/">dsm</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/dtm/">dtm</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/end-with/">end-with</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/fast-orthophoto/">fast-orthophoto</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/feature-quality/">feature-quality</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/feature-type/">feature-type</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/force-gps/">force-gps</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/gcp/">gcp</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/geo/">geo</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/gps-accuracy/">gps-accuracy</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/help/">help</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/ignore-gsd/">ignore-gsd</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/matcher-distance/">matcher-distance</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/matcher-neighbors/">matcher-neighbors</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/matcher-type/">matcher-type</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/max-concurrency/">max-concurrency</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/merge/">merge</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/mesh-octree-depth/">mesh-octree-depth</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/mesh-size/">mesh-size</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/min-num-features/">min-num-features</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/name/">name</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/optimize-disk-space/">optimize-disk-space</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-compression/">orthophoto-compression</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-cutline/">orthophoto-cutline</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-kmz/">orthophoto-kmz</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-no-tiled/">orthophoto-no-tiled</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-png/">orthophoto-png</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/orthophoto-resolution/">orthophoto-resolution</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-classify/">pc-classify</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-csv/">pc-csv</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-ept/">pc-ept</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-filter/">pc-filter</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-geometric/">pc-geometric</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-las/">pc-las</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-quality/">pc-quality</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-rectify/">pc-rectify</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-sample/">pc-sample</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/pc-tile/">pc-tile</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/primary-band/">primary-band</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/project-path/">project-path</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/radiometric-calibration/">radiometric-calibration</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/rerun/">rerun</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/rerun-all/">rerun-all</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/rerun-from/">rerun-from</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/resize-to/">resize-to</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/skip-3dmodel/">skip-3dmodel</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/skip-band-alignment/">skip-band-alignment</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/skip-report/">skip-report</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/sm-cluster/">sm-cluster</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/smrf-scalar/">smrf-scalar</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/smrf-slope/">smrf-slope</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/smrf-threshold/">smrf-threshold</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/smrf-window/">smrf-window</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/split/">split</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/split-image-groups/">split-image-groups</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/split-overlap/">split-overlap</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-data-term/">texturing-data-term</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-keep-unseen-faces/">texturing-keep-unseen-faces</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-outlier-removal-type/">texturing-outlier-removal-type</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-skip-global-seam-leveling/">texturing-skip-global-seam-leveling</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-skip-local-seam-leveling/">texturing-skip-local-seam-leveling</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/texturing-tone-mapping/">texturing-tone-mapping</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/tiles/">tiles</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/time/">time</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/use-3dmesh/">use-3dmesh</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/use-exif/">use-exif</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/use-fixed-camera-params/">use-fixed-camera-params</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/use-hybrid-bundle-adjustment/">use-hybrid-bundle-adjustment</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/verbose/">verbose</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../arguments/version/">version</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../outputs/">OpenDroneMap Matokeo</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../outputs/#point-cloud">Point Cloud</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../outputs/#d-textured-model">3D Textured Model</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../outputs/#orthophoto">Orthophoto</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../outputs/#dtm-dsm">DTM/DSM</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../outputs/#list-of-all-outputs">Mpangilo wa matokeo yote</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../gcp/">Pointi za Udhibiti wa chini</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../gcp/#recommended-practices-for-gcp-setting">Recommended practices for GCP setting</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../gcp/#gcp-file-format">GCP file format</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../gcp/#user-interfaces">interface ya mtumiaji</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../gcp/#id1">POSM GCPi</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../gcp/#id2">GCP Editor Pro</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../gcp/#references">References</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../map-accuracy/">Map accuracy</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../map-accuracy/#what-to-expect">What to expect</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../map-accuracy/#aspects-impacting-map-accuracy">Aspects impacting map accuracy</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../map-accuracy/#references">References</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../geo/">Image Geolocation Files</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../masks/">Using Image Masks</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../large/">Kugawa Database Kubwa</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../large/#calibrate-images">Kurekebisha Picha</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../large/#local-split-merge">Split-Merge ya Ndani</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../large/#distributed-split-merge">Kugawanya Split-Merge</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../large/#getting-started-with-distributed-split-merge">Kupata kuanza pamoja na kugawanya Split-Merge</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../large/#understanding-the-cluster">Kufahamu Cluster</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../large/#accessing-the-logs">Kutumia Logs</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../large/#autoscaling-clusterodm">Kuongeza kiotomatiki ClusterODM</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../large/#limitations">Mipaka</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../large/#acknowledgments">Tunakiri</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../resources/">Kumbukumbu za ziada</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../resources/#for-users">Kwa watumiaji</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../resources/#for-developers">Kwa msanidi programu</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../flying/">Kidokeza cha kurusha ndege nyuki</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../multispectral/">Msaada wa Multispectral</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../multispectral/#hardware">Hardware</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../multispectral/#usage">Matumizi</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../requesting-features/">Vipi Utaomba Vipengele</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../contributing/">Jinsi ya kushiriki</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../contributing/#community-forum">Jukwaa la kijamii</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../contributing/#reporting-bugs">Kuwasilisha Bugs</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../contributing/#template-for-submitting-bug-reports">Kigezo kwa kuwasilisha maelezo ya bug</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../contributing/#pull-requests">Tatua maombi</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../faq/">Frequently Asked Questions</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="../faq/#data-processing">Data Processing</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../faq/#can-i-process-two-or-more-orthophoto-geotiffs-to-stitch-them-together">Can I process two or more orthophoto GeoTIFFs to stitch them together?</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l2"><a class="reference internal" href="../faq/#licensing">Licensing</a><ul>
|
|
<li class="toctree-l3"><a class="reference internal" href="../faq/#i-want-to-build-a-commercial-application-that-includes-odm-do-i-need-a-commercial-license">I want to build a commercial application that includes ODM. Do I need a commercial license?</a></li>
|
|
<li class="toctree-l3"><a class="reference internal" href="../faq/#are-there-other-licensing-options-aside-from-the-agplv3">Are there other licensing options aside from the AGPLv3?</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
|
|
|
|
<nav class="wy-nav-top" aria-label="top navigation">
|
|
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="../">OpenDroneMap</a>
|
|
|
|
</nav>
|
|
|
|
|
|
<div class="wy-nav-content">
|
|
|
|
<div class="rst-content">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
|
|
<ul class="wy-breadcrumbs">
|
|
|
|
<li><a href="../" class="icon icon-home"></a> »</li>
|
|
|
|
<li>Kuingiza na kuanza kutumia</li>
|
|
|
|
|
|
<li class="wy-breadcrumbs-aside">
|
|
|
|
|
|
<a href="../_sources/installation.rst.txt" rel="nofollow"> View page source</a>
|
|
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
<hr/>
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div itemprop="articleBody">
|
|
|
|
<div class="section" id="installation-and-getting-started">
|
|
<h1>Kuingiza na kuanza kutumia<a class="headerlink" href="#installation-and-getting-started" title="Permalink to this headline">¶</a></h1>
|
|
<p>Kipengele hiki kimekubalika na kurahisishwa pamoja na ruhusa kutoka <a class="reference external" href="https://odmbook.com">OpenDroneMap: Maelekezo yaliokosekana</a>, by Piero Toffanin.</p>
|
|
<p>Hadi sasa OpenDroneMap imekua ni term inayotumika kuwakilisha mstari mmoja wa camand application (ambayo sasa inajuulika kama ODM project). Pamoja na maendeleo ya sasa ya web interface ya API na tools nyengine, OpenDroneMap imekua tegemezi kwa application tofauti kwa kuchakata, kuchambua na kuonesha data za ardhini. Utegemeo huu umetengeneza baadhi ya vipengele:</p>
|
|
<div class="figure align-center">
|
|
<img alt="ODM Logo" src="https://www.opendronemap.org/wp-content/uploads/2018/07/odm-logo-64x64.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>ODM</strong> ni mashine ya kuchakata, ambayo inaweza kutumika kutoka camand line. itachukua picha kama kiingizio na kutoa matokeo tofauti, ikiwemo point clouds, 3D model na orthophotos.</p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="NodeODM Logo" src="../_images/NodeODMLogo.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>NodeODM</strong> ni light-weight API iliojengwa juu ya ODM. Inaruhusu watumiaji na application kutumia function za ODM kwenye computer mtandao</p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="WebODM Logo" src="https://www.opendronemap.org/wp-content/uploads/2018/07/webodm-icon-64x64.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>WebODM</strong> ni muonekano rahisi wa mtumiaji inayokusanya muonekano wa ramani, muonesho wa 3D, user login, mfumo wa plagin na vipengele vyengine ambavyo vinategemewa na drone mapping platform za kisasa</p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="CloudODM Logo" src="https://www.opendronemap.org/wp-content/uploads/2019/01/cloudodm-64x64.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>CloudODM</strong> ni mtari mdogo wa camand ya mteja kwa kuwasiliana na ODM kupitia NodeODM API</p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="PyODM Logo" src="../_images/PyODMLogo.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>PyODM</strong> ni Python SDK kwa kutengeza kazi kupitia NodeODM API. Tunavalisha maelezo zaidi ndani ya sura ya “Automated Processing With Python”</p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="ClusterODM Logo" src="../_images/ClusterODMLogo.png" />
|
|
</div>
|
|
<ul class="simple">
|
|
<li><p><strong>ClusterODM</strong> ni usawa wa kubeba kwa kuunganisha pamoja NodeODM instance nyingi</p></li>
|
|
</ul>
|
|
<p>ODM, NodeODM na WebODM zinapatika katika platform kuu (Windows,macOS na Linux) kupitia programu inayoitwa docker, ambayo unatakiwa ifanye kazi software. Docker inatoa njia ya kutumia “containers”. Container zimekusanywa kukopiwa kwa system yote, ni software na inajitegemea. Container hii inarun ndani ya mazingira ya virtual. Katika Linux mazingira ya virtual hii yanapatika ndani ya operating system na ni rahisi kwa macOS na Windows, container hio inatumika ndani ya VM, kwa hiyo kuna nafasi mbele. lakini bado ni sawa kutumia software. Mara ikiingizwa mtumiaji hana haja ya kujali kuhusu docker, kama inafanya kazi sawa (kiujumla).</p>
|
|
<p>Bila ya docker itakuwa sio rahisi ODM na Windows au macOS kufanya kazi. Katika platform hizi ODM haziwezi kukufanya kazi inavyotakiwa. Maendeleo ya nguvu za baadae yatazingatia juu ya nguvu mpya za Windows subsystem kwa Linux (WSL) na rahisi kuanzisha port kwa tegemezi zote za macOS, ambazo zitafanyak uingizwa software kwa rahisi zaidi.</p>
|
|
<p>Katika Ubuntu Linux 18.04 inawezekana kurun OpenDroneMap software zote wenyewe. Hata hivyo, kwa sababu kuna kuongezeka ufanisi kwa kufanya kazi docker kwenye Linux na docker ina njia nyepesi ya kupangilia katika platform hii, hatushauri hio. Katika Linux ya faida ya chombo kisichozidi uwezowe uliopewa. Kwa watumiaji wa docker pia wanapata urahisi katika kupangilia kuapdate software, kwa hio ni vizuri.</p>
|
|
<div class="section" id="hardware-recommendations">
|
|
<h2>Sifa za Hardware<a class="headerlink" href="#hardware-recommendations" title="Permalink to this headline">¶</a></h2>
|
|
<p>Nafasi ndogo inayotakiwa kwa kutumia software ni:</p>
|
|
<ul class="simple">
|
|
<li><p>64bit CPU iliotengenezwa sasa au baada ya 2010</p></li>
|
|
<li><p>20 GB ya kiendshi disk</p></li>
|
|
<li><p>4 GB RAM</p></li>
|
|
</ul>
|
|
<p>Si zaidi ya picha 100-200 zinaweza kuchakatwa kwa sifa hizo hapo juu (software itafanya kazi kinyume na nafasi). Mahitaji yafuatayo yanapendekezwa:</p>
|
|
<ul class="simple">
|
|
<li><p>Toleo la sasa la CPU</p></li>
|
|
<li><p>100 GB za kiendeshi disk</p></li>
|
|
<li><p>16 GB RAM</p></li>
|
|
</ul>
|
|
<p>Sifa hizo zitaruhusu kwa picha kidogo mia moja kuchakatwa bila uzito mwingi. CPU iliyo na core nyingi itaruhu kuchakata haraka, wakati kadi ya picha (CPU) kwa wakati huo haina faida juu ya utendaji kazi. Kwa kuchakata picha zaidi, engeza kiendshi diski na RAM kulingana na picha unazotaka kuchakata.</p>
|
|
</div>
|
|
<div class="section" id="installation">
|
|
<span id="docker-installation"></span><h2>Uingizaji<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h2>
|
|
<p>Tunapendekeza watu kutumia <a class="reference external" href="https://www.docker.com">docker</a> kwa kurun ODM, kama unatumia Windows, macOS au Linux.</p>
|
|
<div class="section" id="windows">
|
|
<h3>Windows<a class="headerlink" href="#windows" title="Permalink to this headline">¶</a></h3>
|
|
<p>Kutumia OpenDroneMap unahitaji angalau Windows 7. Toleo la nyuma la windows halihimili.</p>
|
|
<div class="section" id="step-1-check-virtualization-support">
|
|
<h4>Jia ya 1. Angalia msaada wa uvumbuzi<a class="headerlink" href="#step-1-check-virtualization-support" title="Permalink to this headline">¶</a></h4>
|
|
<p>Docker inahitaji vipengele kutoka kwenye CPU yako inayoitwa virtualization, ambayo inaruhusu kufanya kazi virtual mashine (VMs). Hakikisha unaweka enabled! baadhi ya muda huwa disabled. Kuangalia, katika windows 8 au ya juu zaidi unaweza kufungua <strong>Task Manager</strong> (Bonyeza CTRL+SHIFT+ESC) na washa <strong>Performance</strong> tab.</p>
|
|
<div class="figure align-center">
|
|
<img alt="Image of checking virtualization in Windows 8 or higher" src="../_images/virtualizationcheck.png" />
|
|
</div>
|
|
<p><em>Virtualization lazima iruhusiwe</em></p>
|
|
<p>Katika Window 7 kuangalia kama una virtualization ilioruhusiwa, unaweza kutumia <a class="reference external" href="http://www.microsoft.com/en-us/download/details.aspx?id=592">Microsoft® Hardware-Assisted Virtualization Detection Tool</a> badala yake.</p>
|
|
<p>Ikiwa virtualization haijaruhusiwa, unahitajika uiruhusu. Kwa sasa watoaji ni tofauti kidogo kwa kila aina ya computer, Njia nzuri kufanya hivi ni kuangalia katika search engine “how to enable vtx for <type your computer model here>”. Kawaida muda hutegemea na kurestart computer, haraka bonyeza F2 au F12 wakati inawaka,angalia boot menu na badilisha mpangilo kwa kuruhusu virtualization (kawaida inaitwa "VT-X").</p>
|
|
<div class="figure align-center">
|
|
<img alt="Table of different bios keys" src="../_images/bioskeys.png" />
|
|
</div>
|
|
<p><em>Key iliyozoeleka kubonyeza kwa kuwasha computer kutumia boot menu kwa watengezaji wengi wa PC</em></p>
|
|
</div>
|
|
<div class="section" id="step-2-install-requirements">
|
|
<h4>Njia ya 2. Ingiza Vinavyohitajika<a class="headerlink" href="#step-2-install-requirements" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kwanza, Unahitaji kuingiza:</p>
|
|
<ul class="simple">
|
|
<li><p>Git: <a class="reference external" href="https://git-scm.com/downloads">https://git-scm.com/downloads</a></p></li>
|
|
<li><p>Python (toleo la sasa la 3): <a class="reference external" href="https://www.python.org/downloads/windows/">https://www.python.org/downloads/windows/</a></p></li>
|
|
</ul>
|
|
<p>Kwa Python 3, hakikisha unaangalia <strong>Add Python 3.x to PATH</strong> wakati wa uingizaji.</p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Python3 installation process" src="../_images/installpython3.png" />
|
|
</div>
|
|
<p><em>Usisahau kuingiza Python executable katika PATH (kwa maana hio unaweza kurun camand pamoja).</em></p>
|
|
<p>Kisha, ikiwa upo katika Windows 10 home pekee, Windows 8 (toleo lolote) au Windows 7 (toleo lolote), ingiza:</p>
|
|
<ul class="simple">
|
|
<li><p>Docker Toolbox: <a class="reference external" href="https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe">https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe</a></p></li>
|
|
</ul>
|
|
<p>Ikiwa upo katika Windows 10 Professional au toleo jipya, unaweza kuingiza badala yake:</p>
|
|
<ul class="simple">
|
|
<li><p>Docker for Windows: <a class="reference external" href="https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe">https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe</a></p></li>
|
|
</ul>
|
|
<p>Tafadhali <strong>usingize</strong> programu zote za docker. Ni tofauti na utatengeneza tatizo ikiwa zote zimeingizwa.</p>
|
|
<p>Baada ya kuingiza docker, fungua kutoka Desktop icon ambayo imetengenezwa ilipoingizwa (<strong>Docker Quickstart</strong> kwa Docker Toolbox, <strong>Docker for Windows</strong> kwa docker kwa ajili ya Windows). Hii ni muhimu, usikatishe hatua hii. ikiwa kuna makosa fuata haraka katika koo na uyatatue.</p>
|
|
</div>
|
|
<div class="section" id="step-3-check-memory-and-cpu-allocation">
|
|
<h4>Njia ya 3. Angalia nafasi na mgao wa CPU<a class="headerlink" href="#step-3-check-memory-and-cpu-allocation" title="Permalink to this headline">¶</a></h4>
|
|
<p>Docker katika Windows inafanya kazi kwa kufungua VM katika msingi (Fikiria VM kama “computer emulator”). VM hii ina kiwango fulani cha nafasi kilichogaiwa na WebODM, kinaweza kutumika tu kwa kiasi ambacho kimetengwa.</p>
|
|
<p>Ikiwa utaingiza Docker Toolbox (angalia chini ikiwa utaingiza Docker badala ya windows):</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Fungua <strong>VirtualBox Manager</strong> application</p></li>
|
|
<li><p>Right click <strong>default</strong> VM na bonyeza <strong>Close (ACPI Shutdown)</strong> kusimamisha mashine</p></li>
|
|
<li><p>Right click <strong>default</strong> VM na bonyeza <strong>Settings...</strong></p></li>
|
|
<li><p>Move the <strong>Base Memory</strong> slider from the <strong>System</strong> panel and allocate 60-70% of all available memory, optionally adding 50% of the available processors from the <strong>Processor</strong> tab also</p></li>
|
|
</ol>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of VirtualBox Settings" src="../_images/virtualboxsettings.png" />
|
|
</div>
|
|
<p><em>Chaguo msingi la VirtualBox kwa Mpangilio wa VM</em></p>
|
|
<p>Kisha bonyeza <strong>OK</strong>", right click <strong>default</strong> VM na bonyeza <strong>Start</strong>.</p>
|
|
<p>Ikiwa umeingiza Docker kwa Windows badala yake:</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Angalia mpangilo uteo na bonyeza kulia “white whale” icon.</p></li>
|
|
<li><p>Kutoka menu, bonyeza <strong>Settings...</strong></p></li>
|
|
<li><p>kutoka kwenye ubao, bonyeza <strong>Advanced</strong> na tumia sliders kuonesha 60-70% ya nafasi inayotumika na tumia nusu ya CPU ilobakia.</p></li>
|
|
<li><p>Bonyeza <strong>Apply</strong>.</p></li>
|
|
</ol>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Docker Icon" src="../_images/dockericon.png" />
|
|
</div>
|
|
<p><em>Njia ya 1. Docker icon</em></p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Docker Settings" src="../_images/dockersettings.png" />
|
|
</div>
|
|
<p><em>Njia ya 3 & 4 Mpangilo wa Docker</em></p>
|
|
</div>
|
|
<div class="section" id="step-4-download-webodm">
|
|
<h4>Njia ya 4. Pakua WebODM<a class="headerlink" href="#step-4-download-webodm" title="Permalink to this headline">¶</a></h4>
|
|
<p>Fungua <strong>Git Gui</strong> programu iliyoingizwa pamoja na Git. Kutoka hapo:</p>
|
|
<ul class="simple">
|
|
<li><p>Ikifunguka Git Gui, bonyeza 'Clone Existing Repository' option</p></li>
|
|
<li><p>Nani ya <strong>Source Location</strong> andika: <a class="reference external" href="https://github.com/OpenDroneMap/WebODM">https://github.com/OpenDroneMap/WebODM</a></p></li>
|
|
<li><p>Ndani ya <strong>Target Directory</strong> bonyeza browse na tembea hadi folder ulilochagua (tengeneza moja kama lazima)</p></li>
|
|
<li><p>Bonyeza <strong>Clone</strong></p></li>
|
|
</ul>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Git Gui" src="../_images/gitgui.png" />
|
|
</div>
|
|
<p><em>Git Gui</em></p>
|
|
<p>Ikiwa kupakua kumefanikiwa, utaona window ifuatayo:</p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Git Gui after successful download" src="../_images/gitguisuccess.png" />
|
|
</div>
|
|
<p><em>Git Gui baada ya kufanikiwa kupakua (clone)</em></p>
|
|
<p>Nenda hadi <strong>Repository</strong> menu, kisha bonyeza <strong>Create Desktop Icon</strong>. Hii itakuruhusu kurudi nyuma kwenda katika application hii kiurahisi zaidi baadae.</p>
|
|
</div>
|
|
<div class="section" id="step-4-launch-webodm">
|
|
<h4>Njia ya 4. Zindua WebODM<a class="headerlink" href="#step-4-launch-webodm" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kutoka Git Gui, nenda kwenye <strong>Repository</strong> menu, kisha bonyeza <strong>Git Bash</strong>. Kutoka kwenye mstari wa camand aina ya terminal:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./webodm.sh start<span class="p">&</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Vipengele tofauti vitapakuliwa katika mashine yako katika hatua hii, ikiwemo WebODM, NodeODM na ODM. Baada ya kupakua utapeleka kwa screen zifuatazo:</p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of after successfully downloading WebODM" src="../_images/webodmsuccess.png" />
|
|
</div>
|
|
<p><em>Console output baada ya kuanzisha WebODM kwa mara ya mwanzo</em></p>
|
|
<ul class="simple">
|
|
<li><p>Ikiwa unatumia docker kwa Windows, fungua browser kwenda <a class="reference external" href="http://localhost:8000">http://localhost:8000</a></p></li>
|
|
<li><p>Ikiwa unatumia docker Toolbox, tafuta anuani IP kuunganisha kwa kuandika:</p></li>
|
|
</ul>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ docker-machine ip
|
|
</pre></div>
|
|
</div>
|
|
<p>Utapata jawabu kama ifuatavyo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="m">192</span>.168.1.100
|
|
</pre></div>
|
|
</div>
|
|
<p>Kisha utaunganisha kwa <a class="reference external" href="http://192.168.1.100:8000">http://192.168.1.100:8000</a> (badilisha anuani IP kuweka iliyo sahihi zaidi).</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="macos">
|
|
<h3>macOS<a class="headerlink" href="#macos" title="Permalink to this headline">¶</a></h3>
|
|
<p>Modem nyingi (post 2010) za Mac computer zinafanya kazi MacOS Sierra 10.12 au kubwa inafanyakazi OpenDroneMap kutumia docker, ikiwa hardware virtualization inakubali (angalia chini).</p>
|
|
<div class="section" id="id1">
|
|
<h4>Jia ya 1. Angalia msaada wa uvumbuzi<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h4>
|
|
<p>Fungua terminal window na andika:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ sysctl kern.hv_support
|
|
</pre></div>
|
|
</div>
|
|
<p>Utapata jawabu inayofanana na ifuatavyo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>kern.hv_support: <span class="m">1</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Ikiwa jawabu ni <em>kern.hv_support: 1</em>, Mac yako inakuali! Endelea na step ya 2.</p>
|
|
<p>Ikiwa majibu ni <em>kern.hv_support: 0</em>, inamaanisha Mac yako ni ya zamani sana kwa kutumia OpenDroneMap. :(</p>
|
|
</div>
|
|
<div class="section" id="id2">
|
|
<h4>Njia ya 2. Ingiza Vinavyohitajika<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kuna programu mbili tu za kuingiza:</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Docker: <a class="reference external" href="https://download.docker.com/mac/stable/Docker.dmg">https://download.docker.com/mac/stable/Docker.dmg</a></p></li>
|
|
<li><p>Git: <a class="reference external" href="https://sourceforge.net/projects/git-osx-installer/files/">https://sourceforge.net/projects/git-osx-installer/files/</a></p></li>
|
|
</ol>
|
|
<p>Baada ya kuingiza docker itaona icon ambyo muonekano wake kama nyumbani katika task bar.</p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Docker whale" src="../_images/macwhale.png" />
|
|
</div>
|
|
<p><em>Docker app running</em></p>
|
|
<p>Unaweza kuhakikisha kwamba docker inafanya kazi sawa kwa kufungua <strong>Terminal</strong> app na kuanza kuandika:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ docker run hello-world
|
|
</pre></div>
|
|
</div>
|
|
<p>Ambayo itarejesha</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>Hello from Docker!
|
|
</pre></div>
|
|
</div>
|
|
<p>Kuhakikisha git imeingizwa, njia fupi:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git --version
|
|
</pre></div>
|
|
</div>
|
|
<p>Ambayo itarejesha kitu sawa kwa ifuatavyo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git version <span class="m">2</span>.20.1 <span class="o">(</span>Apple Git-117<span class="o">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Ikiwa umepata “bash: git: command not found”, jaribu kuwasha tena <strong>Terminal</strong> app yako na angalia kwa mara nyengine ikiwa kuna makosa wakati wa mchakato wa kuingiza.</p>
|
|
</div>
|
|
<div class="section" id="id3">
|
|
<h4>Njia ya 3. Angalia nafasi na mgao wa CPU<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h4>
|
|
<p>Docker katika macOS inafanya kazi kwa kuwasha VM katika background (fikiria hilo kama computer emulator”). VM hii ina kiwango cha nafasi kilichowekwa na WebODM inaweza kutumia nafasi ya kutosha iliotengwa.</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Right click ikoni ya nyumbani kutoka kwenye task bar na bonyeza <strong>Preferences</strong>...</p></li>
|
|
<li><p>Chagua <strong>Advanced</strong> tab</p></li>
|
|
<li><p>Rekebisha CPU slider kwa kutumia nusu ya CPU inayopatikana na nafasi ya kutumia 60-70% ya nafasi yote ilyobakia</p></li>
|
|
<li><p>Bonyeza <strong>Apply & Restart</strong></p></li>
|
|
</ol>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of Docker advanced settings" src="../_images/dockeradvanced.png" />
|
|
</div>
|
|
<p><em>Docker advanced settings</em></p>
|
|
</div>
|
|
<div class="section" id="step-4-download-and-launch-webodm">
|
|
<h4>Njia ya 4. Pakua na fungua WebODM<a class="headerlink" href="#step-4-download-and-launch-webodm" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kutoka <strong>Terminal</strong> andika:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/OpenDroneMap/WebODM
|
|
$ <span class="nb">cd</span> WebODM
|
|
$ ./webodm.sh start
|
|
</pre></div>
|
|
</div>
|
|
<p>Kisha fungua web browser kwenda <a class="reference external" href="http://localhost:8000">http://localhost:8000</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="linux">
|
|
<h3>Linux<a class="headerlink" href="#linux" title="Permalink to this headline">¶</a></h3>
|
|
<p>OpenDroneMap inaweza kufanya kazi kwenye Linux yoyote ambayo inaruhusu docker. Kwa mujibu wa <a class="reference external" href="https://docs.docker.com/install/">nyaraka za website ya docker</a> kwa mujibu wa msaada rasmi uliothibitishwa ni CentOS, Debian, Ubuntu na fedora, pamoja na bainari tuli zinazotumika kwa wengine. Ikiwa unataka kuchakua distribution peke yake kwa kumia OpenDroneMap, Ubuntu ni chaguo la kutumia.</p>
|
|
<div class="section" id="step-1-install-requirements">
|
|
<h4>Hatua 1. Mahitaji ya kuingiza<a class="headerlink" href="#step-1-install-requirements" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kuna program nne ambazo zinahitaji kuingizwa:</p>
|
|
<ol class="arabic simple">
|
|
<li><p>Docker</p></li>
|
|
<li><p>Git</p></li>
|
|
<li><p>Python (2 or 3)</p></li>
|
|
<li><p>Pip</p></li>
|
|
</ol>
|
|
<p>Hatuweza kuweza kumaliza mchakato wa uwingizaji kwa kila usambazaji wa Linux nje ya hapo, kwa hio tutazuiya maelekezo kwa wote kusambaza wanasaidiwa na docker. Katika kesi zote ni jambo la kufungua terminal prompt na kuandika comand.</p>
|
|
<div class="section" id="install-on-ubuntu-debian">
|
|
<h5>Ingiza ndani ya Ubuntu / Debian<a class="headerlink" href="#install-on-ubuntu-debian" title="Permalink to this headline">¶</a></h5>
|
|
<p>Camand za kuandika</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ 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
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="install-on-centos-rhel">
|
|
<h5>Ingiza ndani ya CentOS / RHEL<a class="headerlink" href="#install-on-centos-rhel" title="Permalink to this headline">¶</a></h5>
|
|
<p>Camand za kuandika</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ curl -fsSL https://get.docker.com -o get-docker.sh
|
|
$ sh get-docker.sh
|
|
$ sudo yum -y install git python python-pip
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="install-on-fedora">
|
|
<h5>Ingiza ndani ya Fedora<a class="headerlink" href="#install-on-fedora" title="Permalink to this headline">¶</a></h5>
|
|
<p>Camand za kuandika</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ curl -fsSL https://get.docker.com -o get-docker.sh
|
|
$ sh get-docker.sh
|
|
$ sudo dnf install git python python-pip
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="install-on-arch">
|
|
<h5>Ingiza ndani ya Arch<a class="headerlink" href="#install-on-arch" title="Permalink to this headline">¶</a></h5>
|
|
<p>Camand za kuandika</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ sudo pacman -Sy docker git python python-pip
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="step-2-check-additional-requirements">
|
|
<h4>Njia ya 2. Angalia Mahitaji ya Ziada<a class="headerlink" href="#step-2-check-additional-requirements" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kwa kuongezea kwa programu tatu juu, dockercompose script pia inahitajika. Baadhi ya muda inakuwa ishahifadhiwa ndani ya docker, lakini kuna muda haijaingizwa. Kuthibitisha kama imeingizwa jaribu kuandika:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ docker-compose --version
|
|
</pre></div>
|
|
</div>
|
|
<p>Unaweza kuona kitu kinachofanana kama ifuatavyo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>docker-compose version <span class="m">1</span>.22.0, build f46880f
|
|
</pre></div>
|
|
</div>
|
|
<p>Ikiwa badala yake utapata kitu sawa na ifuatavyo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>docker-compose: <span class="nb">command</span> not found
|
|
</pre></div>
|
|
</div>
|
|
<p>Unaweza kuingiza kwa kutumia pip:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ sudo pip install docker-compose
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="step-3-download-and-launch-webodm">
|
|
<h4>Njia ya 3. Pakua na zindua WebODM<a class="headerlink" href="#step-3-download-and-launch-webodm" title="Permalink to this headline">¶</a></h4>
|
|
<p>Kutoka aina ya terminal:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/OpenDroneMap/WebODM
|
|
$ <span class="nb">cd</span> WebODM
|
|
$ ./webodm.sh start
|
|
</pre></div>
|
|
</div>
|
|
<p>Kisha fungua web browser kwenda <a class="reference external" href="http://localhost:8000">http://localhost:8000</a>.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="basic-commands-and-troubleshooting">
|
|
<h2>Camand za msingi na utatuzi shida<a class="headerlink" href="#basic-commands-and-troubleshooting" title="Permalink to this headline">¶</a></h2>
|
|
<p>Kitu kizuri kuhusu kutumia docker ni 99% ya kazi unayohitaji kufanya ikiwa unatumia WebODM, inaweza kufanywa kwa kutumia ./webodm.sh script. Unaweza kutimiza moja kati ya hizo:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./webodm.sh start
|
|
</pre></div>
|
|
</div>
|
|
<p>Kuwa makini kuanzisha WebODM na kupanga mpangilio wa msingi wa kuchakata node (node-odm-1). Ikiwa unahitaji kusimamisha WebODM, unaweza kukisia comand gani ya kutumika:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./webodm.sh stop
|
|
</pre></div>
|
|
</div>
|
|
<p>Kuna camand tofauti unaweza kutumia, kutumia flag tofauti. Flag ni parameter ilipitia kwa ./webodm.sh command na kawaida prefixed with “–”. <strong>port</strong> flag kwa mfano kufundisha kutumia WebODM katika port za mitandao tofauti:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ ./webodm.sh start --port <span class="m">80</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Camand nyengine muhimu zimeorodheshwa chini:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Restart WebODM (useful if things get stuck)</span>
|
|
$ ./webodm.sh restart
|
|
|
|
<span class="c1"># Reset the admin user's password if you forget it</span>
|
|
$ ./webodm.sh resetadminpassword newpass
|
|
|
|
<span class="c1"># Update everything to the latest version</span>
|
|
$ ./webodm.sh update
|
|
|
|
<span class="c1"># Store processing results in the specified folder instead of the default location (inside docker)</span>
|
|
$ ./webodm.sh restart --media-dir /path/to/webodm_results
|
|
|
|
<span class="c1"># See all options</span>
|
|
$ ./webodm.sh --help
|
|
</pre></div>
|
|
</div>
|
|
<p><a class="reference external" href="https://community.opendronemap.org">Jukwaa la kijamii</a> ni sehemu nzuri kuomba msaada ikiwa umekwama wakati unapingiza kwa mpangilio na kwa maswali ya ujumla kutumia ./webodm.sh script.</p>
|
|
</div>
|
|
<div class="section" id="hello-webodm">
|
|
<h2>Habari, WebODM!<a class="headerlink" href="#hello-webodm" title="Permalink to this headline">¶</a></h2>
|
|
<p>Baada kuwa inatumika ./webodm.sh ikianza na kufungua WebODM ndani ya browser, utasalimia pamoja na ujumbe wa karibu na utaulizwa kutengeneza mtumiaji wa kwanza. Chukua muda kumalizia mwenyewe pamoja na web interface na kuchunguza menu tofauti.</p>
|
|
<div class="figure align-center">
|
|
<img alt="Screenshot of WebODM Dashboard" src="../_images/webodmdashboard.png" />
|
|
</div>
|
|
<p><em>WebODM Dashboard</em></p>
|
|
<p>Tazama kwa <strong>Processing Nodes</strong> menu kuna "node-odm-1" node tayari zishapangwa kwa ajili yako kutumia. NodeODM node hii na imetengenezwa wenyewe kwa WebODM. Node hii inatumika katika mashine moja kama WebODM.</p>
|
|
<p>Ikiwa umefikia hapo, Hongera! Sasa ni mda wa kuanza kuchakata baadhi ya data.</p>
|
|
<div class="figure align-center">
|
|
<img alt="Image of celebratory dance" src="../_images/congratulations.png" />
|
|
</div>
|
|
<div class="section" id="running-on-more-than-one-machine">
|
|
<h3>Kuendesha mashine zaidi ya moja<a class="headerlink" href="#running-on-more-than-one-machine" title="Permalink to this headline">¶</a></h3>
|
|
<p><strong>Optionally:</strong> Ikiwa una computer nyengine, unaweza kurejea mchakato wa uwingizaji (install docker, git, python, etc.) na anzisha NodeODM mpya kwa kuandika kutoka dirisha la Terminal/Git Bash:</p>
|
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>docker run --rm -it -p <span class="m">3000</span>:3000 opendronemap/nodeodm -q <span class="m">1</span> --token secret
|
|
</pre></div>
|
|
</div>
|
|
<p>Camand hio hapo juu inaiambia docker kuanzisha container mpya kutumia opendronemap/nodeodm picha kutoka docker Hub (toleo la sasa la NodeODM), kutumia port 3000, Panga namba ya juu ya kazi nyingi kwa wakati mmoja hadi 1 na kulinda node kutoka kwenye matumizi yaliozuiwa kutumia password "secret".</p>
|
|
<p>Kutoka WebODM kisha unawesha kuwasha <strong>Add New</strong> button juu ya <strong>Processin Nodes</strong> Kwa <strong>hostname/IP</strong> aina ya anuani ya field katika computer nyengine. Kwa <strong>port</strong> field type "3000". Kwa <strong>token</strong> field type "secret". Pia unaweza kuengeza <strong>label</strong> kwa node yako, kama vile computer ya pili. Kisha bonyeza <strong>Save</strong>.</p>
|
|
<p>Ikiwa kila kitu kimeenda sawa, lazima uwe na processing node mbili! Utaweza kuchakata kazi nyingi kwa wakati mmoja kwa kutumia mashine tofauti.</p>
|
|
<p><a class="reference external" href="https://github.com/opendronemap/docs#how-to-make-your-first-contribution">Learn to edit</a> and help improve <a class="reference external" href="https://github.com/OpenDroneMap/docs/blob/publish/source/installation.rst">this page</a>!</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<footer>
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
<a href="../tutorials/" class="btn btn-neutral float-right" title="Somo" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
|
<a href="../" class="btn btn-neutral float-left" title="Karibu OpenDroneMap Kitabu" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
|
</div>
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>
|
|
© Copyright 2020, OpenDroneMap.
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
|
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
|
|
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
|
|
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
|
|
</footer>
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
|
|
<script type="text/javascript">
|
|
jQuery(function () {
|
|
SphinxRtdTheme.Navigation.enable(true);
|
|
});
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
</html> |