<liclass="toctree-l2"><aclass="reference internal"href="../tutorials/#using-odm-from-low-bandwidth-location">Tumia ODM kutoka eneo lenye low-bandwidth</a><ul>
<liclass="toctree-l3"><aclass="reference internal"href="../tutorials/#what-is-this-and-who-is-it-for">Nini hiki na kwa nani</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="../large/#getting-started-with-distributed-split-merge">Kupata kuanza pamoja na kugawanya Split-Merge</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="../contributing/#template-for-submitting-bug-reports">Kigezo kwa kuwasilisha maelezo ya bug</a></li>
<liclass="toctree-l3"><aclass="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>
<liclass="toctree-l3"><aclass="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>
<liclass="toctree-l3"><aclass="reference internal"href="../faq/#are-there-other-licensing-options-aside-from-the-agplv3">Are there other licensing options aside from the AGPLv3?</a></li>
<h1>Kuingiza na kuanza kutumia<aclass="headerlink"href="#installation-and-getting-started"title="Permalink to this headline">¶</a></h1>
<p>Kipengele hiki kimekubalika na kurahisishwa pamoja na ruhusa kutoka <aclass="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>
<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>
<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>
<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>
<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>
<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>
<h2>Sifa za Hardware<aclass="headerlink"href="#hardware-recommendations"title="Permalink to this headline">¶</a></h2>
<p>Nafasi ndogo inayotakiwa kwa kutumia software ni:</p>
<ulclass="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>
<ulclass="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>
<spanid="docker-installation"></span><h2>Uingizaji<aclass="headerlink"href="#installation"title="Permalink to this headline">¶</a></h2>
<p>Tunapendekeza watu kutumia <aclass="reference external"href="https://www.docker.com">docker</a> kwa kurun ODM, kama unatumia Windows, macOS au Linux.</p>
<h4>Jia ya 1. Angalia msaada wa uvumbuzi<aclass="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>
<p>Katika Window 7 kuangalia kama una virtualization ilioruhusiwa, unaweza kutumia <aclass="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>
<li><p>Python (toleo la sasa la 3): <aclass="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>
<p>Ikiwa upo katika Windows 10 Professional au toleo jipya, unaweza kuingiza badala yake:</p>
<ulclass="simple">
<li><p>Docker for Windows: <aclass="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>
<h4>Njia ya 3. Angalia nafasi na mgao wa CPU<aclass="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>
<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>
<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>
<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>
<h4>Njia ya 4. Zindua WebODM<aclass="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>
<p>Vipengele tofauti vitapakuliwa katika mashine yako katika hatua hii, ikiwemo WebODM, NodeODM na ODM. Baada ya kupakua utapeleka kwa screen zifuatazo:</p>
<p><em>Console output baada ya kuanzisha WebODM kwa mara ya mwanzo</em></p>
<ulclass="simple">
<li><p>Ikiwa unatumia docker kwa Windows, fungua browser kwenda <aclass="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>
<divclass="highlight-bash notranslate"><divclass="highlight"><pre><span></span>$ docker-machine ip
<h3>macOS<aclass="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>
<divclass="highlight-bash notranslate"><divclass="highlight"><pre><span></span>git version <spanclass="m">2</span>.20.1 <spanclass="o">(</span>Apple Git-117<spanclass="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>
<h4>Njia ya 3. Angalia nafasi na mgao wa CPU<aclass="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>
<olclass="arabic simple">
<li><p>Right click ikoni ya nyumbani kutoka kwenye task bar na bonyeza <strong>Preferences</strong>...</p></li>
<h3>Linux<aclass="headerlink"href="#linux"title="Permalink to this headline">¶</a></h3>
<p>OpenDroneMap inaweza kufanya kazi kwenye Linux yoyote ambayo inaruhusu docker. Kwa mujibu wa <aclass="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>
<h4>Hatua 1. Mahitaji ya kuingiza<aclass="headerlink"href="#step-1-install-requirements"title="Permalink to this headline">¶</a></h4>
<p>Kuna program nne ambazo zinahitaji kuingizwa:</p>
<olclass="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>
<h4>Njia ya 2. Angalia Mahitaji ya Ziada<aclass="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>
<h2>Camand za msingi na utatuzi shida<aclass="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>
<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>
<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>
<p><aclass="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>
<h2>Habari, WebODM!<aclass="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>
<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>
<h3>Kuendesha mashine zaidi ya moja<aclass="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>
<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><aclass="reference external"href="https://github.com/opendronemap/docs#how-to-make-your-first-contribution">Learn to edit</a> and help improve <aclass="reference external"href="https://github.com/OpenDroneMap/docs/blob/publish/source/installation.rst">this page</a>!</p>
