<liclass="toctree-l4"><aclass="reference internal"href="../installation/#step-3-check-memory-and-cpu-allocation">Step 3. I-check ang Memory at CPU Allocation</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="../installation/#id3">Step 3. I-check ang Memory at CPU Allocation</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="../installation/#step-4-download-and-launch-webodm">Step 4. I-download at i-launch ang WebODM</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="../installation/#step-1-install-requirements">Step 1. Mga kailangan bago maginstall.</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="../installation/#step-2-check-additional-requirements">Step 2. I-check ang mga karagdagan na requirements</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="../installation/#step-3-download-and-launch-webodm">Step 3. Download and Launch WebODM</a></li>
<liclass="toctree-l2"><aclass="reference internal"href="../installation/#basic-commands-and-troubleshooting">Basic na mga cCommands at Troubleshooting</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="../installation/#running-on-more-than-one-machine">Pagpapatakbo sa dalawa o mas marami pang machine</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="#accessing-logs-on-the-instance">Accessing logs on the instance</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="#command-line-access-to-instances">Command line access to instances</a></li>
<liclass="toctree-l3"><aclass="reference internal"href="#cleaning-up-after-docker">Cleaning up after Docker</a></li>
</ul>
</li>
<liclass="toctree-l2"><aclass="reference internal"href="#using-odm-from-low-bandwidth-location">Paggamit ng ODM para sa low-bandwidth na lokasyon.</a><ul>
<liclass="toctree-l3"><aclass="reference internal"href="#what-is-this-and-who-is-it-for">Ano ito at para kanino ito?</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="#prep-data-and-project">Prep data and project</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="#resize-droplet-pull-pin-run-away">I-resize ang droplet, hatakin ang pin at i-proseso ito.</a></li>
<liclass="toctree-l4"><aclass="reference internal"href="#after-it-finishes-assuming-you-survive-that-long">Matapos ang lahat (assuming na ikaw ay nagsurvive ng ganoon katagal)</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="../gcp/">Ground Control Points</a><ul>
<liclass="toctree-l2"><aclass="reference internal"href="../gcp/#recommended-practices-for-gcp-setting">Mga nirerekumendang gawi para sa paglagay ng GCP</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="../map-accuracy/">Kawastuan ng Mapa</a><ul>
<liclass="toctree-l2"><aclass="reference internal"href="../map-accuracy/#what-to-expect">Mga Dapat I-expect</a><ul>
<liclass="toctree-l3"><aclass="reference internal"href="../map-accuracy/#aspects-impacting-map-accuracy">Mga aspeto na may impact sa map accuracy</a></li>
<liclass="toctree-l2"><aclass="reference internal"href="../contributing/#community-forum">Pagtitipon ng Komunidad</a></li>
<liclass="toctree-l2"><aclass="reference internal"href="../contributing/#reporting-bugs">Pagsumite ng mga Sira</a><ul>
<liclass="toctree-l3"><aclass="reference internal"href="../contributing/#template-for-submitting-bug-reports">Template para sa pagpapasa ng Bug Reports</a></li>
<h2>Paglikha ng Mataas na Kalidad ng Orthophotos<aclass="headerlink"href="#creating-high-quality-orthophotos"title="Permalink to this headline">¶</a></h2>
<p>Nang walang anumang mga pagpapalit ng parameter, ang ODM ay pumipili ng isang mahusay na kompromiso sa pagitan ng kalidad, bilis at paggamit ng memorya. Kung nais mong makakuha ng mas mataas na kalidad ng mga resulta, kailangan mong magpalit ng ilang mga parameter:</p>
<blockquote>
<div><ulclass="simple">
<li><p>"orthophoto resolution" ay ang resolusyon ng orthophoto sa cm / pixel. Bawasan ang halagang ito para sa isang mas mataas na resulta ng resolusyon.</p></li>
<li><p>"--ignore-gsd" ay isang hudyat o babala na nagtuturo sa ODM na laktawan ang ilang mga memorya at bilis ng pag-optimize na direktang nakakaapekto sa orthophoto. Ang paggamit ng hudyat na ito ay magpapataas ng runtime at paggamit ng memorya, ngunit maaaring makagawa ng mga sharper results.</p></li>
<li><p>"--texturing-nadir-weight" ay dapat na itaas sa "29-32" sa mga lunsod o bayan upang mabuo ang mas mahusay na mga gilid ng mga bubong. Dapat itong ibaba sa 0-6 sa mga lugar na patag at damuhan.</p></li>
<li><p>"--texturing-data-term" ay dapat itakda sa 'area' sa mga lugar na kagubatan.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">--mesh-size</span></code> ay dapat itaas sa <codeclass="docutils literal notranslate"><spanclass="pre">300000-6000</span></code> at <codeclass="docutils literal notranslate"><spanclass="pre">--mesh-octree-depth</span></code> ay dapat itaas ng <codeclass="docutils literal notranslate"><spanclass="pre">10-11</span></code> sa urban areas para maka-create ng magandang building / bubong.</p></li>
<h2>Pag-kalibrate ng Camera<aclass="headerlink"href="#calibrating-the-camera"title="Permalink to this headline">¶</a></h2>
<p>Ang pag-calibrate ng camera ay isang malaking hamon sa mga pangkaraniwang camera. Ang mga pagbabago sa temperatura, mga vibrations, pokus, at iba pang mga kadahilanan ay maaaring makaapekto sa mga hango na mga parameter na may malaking epekto sa resultang data. Ang awtomatikong o pag-calibrate sa sarili ay posible at mas mainam sa mga drone flights, ngunit depende sa pattern ng flight, ang awtomatikong pagkakalibrate ay maaaring hindi mag-alis ng lahat ng pagbaluktot sa mga nagresultang produkto. Sa papel nina James at Robson (2014) na "Ang pagpapalit ng sistematikong error sa mga topographic models na nagmula sa UAV at ground ‐ based image networks <<aclass="reference external"href="https://onlinelibrary.wiley.com/doi/full/10.1002/esp.3609">https://onlinelibrary.wiley.com/doi/full/10.1002/esp.3609</a>> ay nagpapakita kung paano mabawasan ang pagkabaluktot.</p>
<p>Ang epekto ng "Bowling" sa point cloud ng mahigit "13,000+ imahe na nakalap ng World Bank Tanzania sa bahaing lugar ng Msimbasi, Basin, Dar es Salaam, Tanzania.</p>
<p>Upang pagaanin ang epekto na ito, may ilang mga pagpipilian ngunit ang pinakasimple ay ang mga sumusunod: lumipad ng dalawang pattern na pinaghihiwalay ng 20°, at sa halip na magkaroon ng isang nadir (tuwid at pababang pagturo) camera, gumamit ng isa na nakakiling sa harap ng 5°.</p>
<p>Dahil ang pamamaraang ito sa paglipad ay maaaring mas matagal kaysa sa mga karaniwang lipad, ang isa o ilang mga piloto ay maaaring lumipad ng isang maliit na lugar gamit ang pamamaraan sa itaas. Ang OpenDroneMap ay bubuo ng isang pangkalibrate file na tinatawag na mga cameras.json na pagkatapos ay mai-import upang magamit na pang calibrate ang isa pang flight na mas mahusay na napaliparan.</p>
<p>Bilang kahalili, ang sumusunod na pamamaraan ng eksperimento ay maaaring gawin: lumipad na may mas mababang overlap, ngunit dalawang flight ng crossgrid (kung minsan ay tinatawag na crosshatch) na pinaghiwalay ng 20° na may 5° pasulong na nakaharap na camera.</p>
<ulclass="simple">
<li><p>Ang mga porsyento na overlap ng crossgrid ay maaaring mas mababa kaysa sa mga kahilera na flight. Upang makakuha ng mahusay na mga resulta ng 3D, kakailanganin ang 68% na magkakapatong at sidelap para sa katumbas na 83% na magkakapatong at sidelap.</p></li>
<li><p>Upang makakuha ng magandang resulta ng 2D at 2.5D (digital elevation model), kakailanganin ang 42% na magkakapatong at sidelap para sa isang katumbas na 70% na magkakapatong at sidelap.</p></li>
<p>Ang mga magkakahiwalay na linya ng flight ay nagpapabuti din sa kawastuhan, ngunit mas kaunti kaysa sa isang kamera na pasulong na hinaharap ng 5°.</p>
<p>Mula kay James at Robson (2014), 'CC BY 4.0 <<aclass="reference external"href="https://creativecommons.org/licenses/by/4.0">https://creativecommons.org/licenses/by/4.0</a>>_</p>
<h2>Paglikha ng Digital Elevation Models<aclass="headerlink"href="#creating-digital-elevation-models"title="Permalink to this headline">¶</a></h2>
<p>Bilang default, ang ODM ay hindi lumilikha ng DEM. Upang lumikha ng isang digital na modelo ng terrain, siguraduhing ipasa ang watawat --dtm. Upang lumikha ng isang digital na modelo ng ibabaw, siguraduhing ipasa ang watawat --dsm.</p>
<p>Para sa pag gawa ng DTM, ginagamit ang isang Simple Morphological Filter (smrf) upang mauri ang mga puntos sa nasa lupa kumpara sa wala sa lupa, kung saan ang mga nasa lupa na puntos lamang ang ginagamit. Ang filter na "smrf" ay maaaring kontrolin sa pamamagitan ng maraming mga parameter:</p>
<blockquote>
<div><ulclass="simple">
<li><p>"--smrf-scalar" halaga ng pag-iskala. Taasan ang parameter na ito para sa mga lupain na may maraming pag-iba ng taas.</p></li>
<li><p>"--smrf-slope" parametro ng libis, na sukat ng "tolerance ng slope". Taasan ang parametrong ito para sa mga lupain na may maraming pagiiba-iba ng taas. Dapat ang halaga nito ay mas mataas sa 0.1 ngunit hindi tataas sa 1.2.</p></li>
<li><p>"--smrf-threshold" bingit ng pagtaas. Itakda ang parametrong ito sa minimong taas (sa yunit na metro) ng mga bagay na wala sa lupa.</p></li>
<li><p>"--smrf-window" parametro ng pinakalamaking paikot na sukat (sa yunit na metro) na sukat ng pinakamalaking bagay (gusali, mga puno, atbp.) na aalisin. Dapat itakda sa halagang mas mataas sa 10.</p></li>
</ul>
</div></blockquote>
<p>Ang pagpapalit ng mga opsiyon na ito ay nagreresulta ng malaking epekto sa DTMs. Ang pinakamahusay na basahin para mapagkunan ng pinakamahusay na impormasyon ukol sa parametro ng epekto ng output ay ang <aclass="reference external"href="https://www.researchgate.net/publication/258333806_An_Improved_Simple_Morphological_Filter_for_the_Terrain_Classification_of_Airborne_LIDAR_Data">An improved simple morphological filter for the terrain classification of airborne LIDAR data</a> (Ang PDF ay libre lamang)</p>
<p>Ang <codeclass="docutils literal notranslate"><spanclass="pre">--smrf-threshold</span></code> ang may pinakamalaking impact sa resulta.</p>
<p>Ang SMRF ay mahusay sa pagiwas ng Type I na pagkakamali (maliliit na numero ng ground poins na napagkakamalan bilang non-ground) pero "acceptable" sa pagiwas sa Type II na pagkakamali (malaking numero na non-ground points na napagkakamalan na ground). Ito ay dapat na bigyan importansiya kapag bumubuo ng DTMs na hangarin na gamitin ng biswal, bilang ang mga baga na napagkakamalan na ground ay mukhang artifacts sa resulta ng DTM.</p>
<p>May dalawa pang importanteng parameters na nakakaapekto sa DEM generation:</p>
<blockquote>
<div><ulclass="simple">
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">--dem-resolution</span></code> na nagse-set ng output resolution ng DEM raster (cm/pixel)</p></li>
<li><p>Ang <codeclass="docutils literal notranslate"><spanclass="pre">--dem-gapfill-steps</span></code> ang tumutukoy sa bilang ng progresibong DEM layer na gagamitin. Para sa urban na eksena na may taas na value na <cite>4-5</cite> ay makakatulong na magresulta ng mas maayos na interpolation sa mga lugar na iniwan na walang laman ng SMRF filter.</p></li>
<h3>Fieldwork planning<aclass="headerlink"href="#fieldwork-planning"title="Permalink to this headline">¶</a></h3>
<p>Weather conditions modify illumination and thus impact the photography results. Best results are obtained with evenly overcast or clear skies. Also look for low wind speeds that allow the camera to remain stable during the data collection process.
In order to avoid shadows which on one side of the stockpile can obstruct feature detection and lessen the number of resulting points, always prefer the flights during the midday, when the sun is at the nadir so everything is consistently illuminated.
Also ensure that your naked eye horizontal visibility distance is congruent with the planned flight distances for the specific project, so image quality is not adversely impacted by dust, fog, smoke, volcanic ash or pollution.</p>
<h3>Flight pattern<aclass="headerlink"href="#flight-pattern"title="Permalink to this headline">¶</a></h3>
<p>Most stockpile measurement jobs does not require a crosshatch pattern or angled gimbal as the resting angle of stockpile materials allows the camera to capture the entire stockpile sides. Only some special cases where erosion or machinery operations causes steep angles on the faces of the stockpile would benefit of the crosshatch flight pattern and angled camera gimbal but consider that these additional recognized features come at a cost, (in field labor and processing time) and the resulting improvements are sometimes negligible.</p>
<p>In most of the cases a lawn mower flight pattern is capable of producing highly accurate stockpile models.</p>
<p>Recommended overlap would be between 75% and 80% with a sidelap in the order of 65% to 70%. It is also recommended to slightly increase overlap and sidelap as the flight height is increased.</p>
<h3>Flight height<aclass="headerlink"href="#flight-height"title="Permalink to this headline">¶</a></h3>
<p>Flight height can be influenced by different camera models, but in a general way and in order to ensure a balance between image quality and flight optimization, it is recommended to be executed at heights 3 to 4 times the tallest stockpile height. So for a 10 meter stockpile, images can be captured at a height of 40 meters.
As the flight height is increased, it is also recommended to increase overlap, so for a 40 meter height flight you can set a 65% sidelap and 75% overlap, but for a planned height of 80 meters a 70% sidelap and 80% overlap allowing features to be recognized and properly processed.</p>
<h3>GCPs<aclass="headerlink"href="#gcps"title="Permalink to this headline">¶</a></h3>
<p>To achieve accuracy levels better than 3%, the use of GCP’s is advised. Typically 5 distributed GCP are sufficient to ensure accurate results.
When placing or measuring GCP, equipment accuracy should be greater than the GSD. Survey grade GNSS and total stations are intended to provide the required millimetric accuracy.</p>
<p>For further information on the use of GCPs, please refer to the <aclass="reference external"href="https://docs.opendronemap.org/gcp.html">Ground Control Points section</a>.</p>
<h3>Processing parameters<aclass="headerlink"href="#processing-parameters"title="Permalink to this headline">¶</a></h3>
<p>A highly accurate model can be achieved using WebODM high resolution predefined settings. Then you can further adjust some parameters as necessary.</p>
<p>If using ODM, these this reference values can help you configure the process settings.</p>
<h3>Measuring<aclass="headerlink"href="#measuring"title="Permalink to this headline">¶</a></h3>
<p>As almost 50% of the material will be found in the first 20% of the stockpile height, special care should be taken in adequately defining the base plane.</p>
<p>Dialog box will show the message "Computing ..." for a few seconds, and after the computing is finished the volume measurement value will be displayed.</p>
<p>If you are using the command line OpenDroneMap you can use the dsm files to measure the stockpile volumes using other programs.</p>
<p>Also consider that once the limits of the stockpile are set in software like <aclass="reference external"href="https://www.qgis.org">QGis</a>, you will find there are some ways to determine the base plane. So for isolated stockpiles which boundaries are mostly visible, a linear approach can be used. While for stockpiles set in slopes or in bins, the base plane is better defined by the lowest point.
Creation of a triangulated 3D surface to define the base plane is advised for large stockpiles. This is also valid for stockpiles paced on irregular surfaces.</p>
<h2>Using Docker<aclass="headerlink"href="#using-docker"title="Permalink to this headline">¶</a></h2>
<p>Bilang maraming gumagamit ang nageemply ng docker para madeply ang OpenDroneMap, makakatulong kapag naiintindihan ang mga basic commands para matanong ang mga pangayayari na ang docker ay nagkakamali. Ang Docker ay isang contained na aplikasyon na ang intensiyon ay mapadali ang pagdeploy ng software independent sa lokal na kapaligiran. Sa lagay na ito, ito ay masasabing pareho sa virtual machines</p>
<p>Ang ilan na simpleng commands ay makakatulong na mapaayos ang experience.</p>
<p>Ito ay di hamak na malaki ngunit maaaring gamitin ang <cite>|</cite> na karakter at iba pang mga tools para kunin ang mga kailangan sa logs. Halimbawa, pwedeng tignan ang log ng mabagal sa pamamagitan ng <cite>more</cite> command:</p>
<p>ANg paggamit ng <cite>Enter</cite> o <cite>Space</cite>, arrow keys o <cite>Page Up</cite> o <cite>Page Down</cite> keys ay makakatulong sa pag-navigate ng logs. Ang maliit na titik <cite>Q</cite> naman ay ang escape back pabalik ng command line.</p>
<p>Maaaring i-extract ang dulo ng logs gamit ang <cite>tail</cite> commmand na sumusunod:</p>
<h3>Command line access to instances<aclass="headerlink"href="#command-line-access-to-instances"title="Permalink to this headline">¶</a></h3>
<p>Minsan, kailangan natin na laliman ang pagsusuri sa proseso ng OpenDroneMap. Makakakuha dito ng diretsong command line na daan sa machine. dahil dito, pwede gamitin ang <cite>docker exec</cite> ng mapasagawa ang bash` command line shell sa machine of interest na sumusunod:</p>
<h3>Cleaning up after Docker<aclass="headerlink"href="#cleaning-up-after-docker"title="Permalink to this headline">¶</a></h3>
<p>Ang docker ay may kahina-hinayang na gamit ng space at by default ay hindi naglilinis ng sobrang laman na data at machine kapag ang proseso ay kumpleto na. Ito ay may benepisyo kapag kailangan na puntahan ang proseso na matagal ng terminated pero kinakarga pa rin ang bigat ng nagamit na storage space overtime. Si Maciej Łebkowski ay may 'napakahusay na pangkahalatang-ideya kung papaano aayusin ang sobrang disk usage sa docker <<aclass="reference external"href="https://lebkowski.name/docker-volumes/">https://lebkowski.name/docker-volumes/</a>>`_.</p>
<h2>Paggamit ng ODM para sa low-bandwidth na lokasyon.<aclass="headerlink"href="#using-odm-from-low-bandwidth-location"title="Permalink to this headline">¶</a></h2>
<p>Ang <aclass="reference external"href="https://www.opendronemap.org/">OpenDroneMap</a> ay hindi naman laging epektibo sa pagset-up locally-ito ay makapagyarihan na machine sa pagproseso ng malalaking datasets ng sa gayon ang cloud machine ay maaaring masagot ang mga tao sa field. Ngunit, bandwidth ang problema sa maraming low-income na setting. Ang kakulangan na ito ay hindi mareresolusyonan agag-agad pero ang mga sumusunod na hakbang ay makatutulong sa pagpapababa ng kailangan na bandwidth para maproseso ang drone imagery datasets sa cloud mula sa African na lokasyon.</p>
<p>Dito ay nagsasaad kami ng nakakalito ngunit maisasagawa na proseso para makagawa ng OPenDronMap cloud machine (<em>hindi</em> CloudODM ito, isa lamang cloud-based instance ng ODM na pwedeng patakbuhin mula sa command line) at gamitin ito para maproseso ang malalaking photo sets. Ito ay nangangailangan nga kaalaman sa Unix command line use, ssh, Digital Ocean account (ang Amazon AWS ay gagana ngunit mga kaunting kaibahan sa set-up), at katamtaman na kaalaman sa general computer literacy. Kung ikaw ay hindi masyadong eksperto at handang pagdaanan ang nakakalito na pagset-up, ang 'CloudODM <<aclass="reference external"href="https://www.opendronemap.org/cloudodm/">https://www.opendronemap.org/cloudodm/</a>>`__ ang dapat pagbasehan.</p>
<p>Ang kabuoan na proseso ay nakatarget sa pagpapalipad ng mga importanteng misyon sa African o kapareho na lokasyon na maghahanap ng ipoproseso na data habang naghihintay ng field setting. Sa madalit sabi, ito ay naglalayon ng trabaho na makababawas sa bandwidth/data transfer, kesa sa simlpeng pagpapatakbo lamang ng ODM.</p>
<h4>Install<aclass="headerlink"href="#install"title="Permalink to this headline">¶</a></h4>
<ulclass="simple">
<li><p>Gumawa ng Digital Ocean droplet na may 4GB na RAM. Ito ay magkakapresyo ng $20/month. Hindi sapat ang 4GB na RAM at ang installation ay siguradong hindi matutuloy. Kapag ang ODM na proseso ay pinapatakbo, ito ay nire-resize sa mas malaki-at mas mahal-na cloud machine pero habang ito ay pinapatakbo, maaari na pababain sa pangalawang pinakamura na drooplet na nagkakahalaga ng $10/month (pinakamura na droplet na nasa $5/month, may kasama na maliit na drive na hindi na pwedeng magdownsize pabalik dito).</p>
<ul>
<li><p>Dapat ay Ubintu 18.04 na instansiya para makasiguro sa dependency compatibility.</p></li>
<li><p>Gumawa ng user na may pribelehiyong sudo. <aclass="reference external"href="https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04">Digital Ocean’s insanely good documentation</a> ay makakatulong na alamin ito. Sa aming kaso, nagset-up kami ng user na may pangalan na <codeclass="docutils literal notranslate"><spanclass="pre">odm</span></code>, para kumonekta via sa command na <codeclass="docutils literal notranslate"><spanclass="pre">ssh</span><spanclass="pre">odm@xxx.xxx.xxx.xxx</span></code> (kung saan ang x's ay IPv4 na address ng iyong server). Kung nais na sundan ito, <em>gamitin</em> ang username na <codeclass="docutils literal notranslate"><spanclass="pre">odm</span></code>; tapos ang install path dapat ay <codeclass="docutils literal notranslate"><spanclass="pre">/home/odm/ODM/</span></code> at makakapareho ang mga halimbawa sa dokumento na ito.</p></li>
<li><p>Magpatuloy sa pagpapasagawa ng <codeclass="docutils literal notranslate"><spanclass="pre">sudo</span><spanclass="pre">apt</span><spanclass="pre">update</span></code> at <codeclass="docutils literal notranslate"><spanclass="pre">sudo</span><spanclass="pre">apt</span><spanclass="pre">upgrade</span></code> para masigurado na ang server ay may updates. Siguraduhin na nasa Ubuntu 18.04.</p></li>
</ul>
</li>
<li><p>I-download at i-install ang ODM sa <aclass="reference external"href="https://github.com/OpenDroneMap/ODM">ODM Github</a> (regular, hindi WebODM) na may mga sumusunod na commands:</p></li>
<li><p>Kapag ito ay nagawa mo na sa default home faulder ng user (i.e.``odm``) ang daan papunta sa paginstall ay <codeclass="docutils literal notranslate"><spanclass="pre">/home/odm/ODM</span></code> (abbreviated as <codeclass="docutils literal notranslate"><spanclass="pre">~/ODM/</span></code>).</p></li>
<li><p>May mga elemento na pangkalikasan na kelangan isaayos. Buksan ang ~/.bashrc file sa iyong machine at idagdag ang 3 linya sa huli (From <aclass="reference external"href="https://github.com/OpenDroneMap/ODM">the ODM github</a>). Ang file ay pwedeng buksan sa <codeclass="docutils literal notranslate"><spanclass="pre">nano</span><spanclass="pre">~/.bashrc</span></code> (o sakahit anong text editor na ginagamit sa halip ng nano). Siguraduhin na napalitan ang <codeclass="docutils literal notranslate"><spanclass="pre">/home/odm/</span></code> ng tama na path papunta sa lokasyon kung saan inextract ang OpenDroneMap kung hindi nagawa ang mga hakbang ng eksaktong katulad ng mga nasa halimbawa (halimbawa ay ang paggamit ng ibang username sa server setup):</p></li>
<li><p>Alalahanin na ang ODM github readme ay naglalaman ng kaunting kamalian, ang pangalan ng direktoryong pang-install ay ODM, hindi OpenDroneMap (Makikita ito kapag kinumpara ag mga iinstruksiyon sa taas sa mga instruksiyon sa ODM GitHub).</p></li>
<li><p>Para maiwasan ang pag-crash kung saan ang split-merge na proseso ay hindi na ma-locate ang sarili nitong executable, dinaragdag natin ang mga sumusunod na linya <codeclass="docutils literal notranslate"><spanclass="pre">~/.bashrc</span></code> (i-adjust ang paths kung may makita na kakaiba sa aming halimbawa):</p></li>
<li><p>Ngayon, kakailanganin mo ng pangalawang cloud hard drive (“Volume” in Digital Ocean jargon) na may sapat na laki para sa iyong proyekto. Ang pamantayan ay 10 beses ng laki iyong raw image set; ay mayroon 100GB na image set at set-up na 1000GB volume (kapag ito ay napaandar na, dapat ay makapagbawas na ng mga mamahalin na drive capacity, ito ay kailangan para matapos ang proseso). Iset-up ang volume at i-attach ito sa droplet at 'ayusin ang mount point <<aclass="reference external"href="https://www.digitalocean.com/docs/volumes/how-to/mount/">https://www.digitalocean.com/docs/volumes/how-to/mount/</a>>`__ (sa halimbawa na ito, ise-set natin sa <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/</span></code>).</p></li>
<h4>Prep data and project<aclass="headerlink"href="#prep-data-and-project"title="Permalink to this headline">¶</a></h4>
<ulclass="simple">
<li><p>Ngayon, i-push ang mga imahe sa server. Maaaring gamitin ang Now push your images onto the server. You can use <aclass="reference external"href="https://en.wikipedia.org/wiki/Secure_copy">Secure Copy (scp)</a> like so: <codeclass="docutils literal notranslate"><spanclass="pre">scp</span><spanclass="pre">-r</span><spanclass="pre">/path/to/my/imagefolder</span><spanclass="pre">odm@xxx.xxx.xxx.xxx:/mnt/odmdata/</span></code>.</p>
<ul>
<li><p>Matutulak nito ang buong folder na puno ng imahe (ito ang nagagawa ng <codeclass="docutils literal notranslate"><spanclass="pre">-r</span></code> option, “recursive”) sa remote na lokasyon (sa ating halimbawa, inattach sa volume ang cloud machine <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/</span></code>.</p></li>
<li><p>Kukunsumo ito ng bandwidth. No way around the size of the files.<aclass="reference external"href="#footnote1">1</a>, <aclass="reference external"href="#footnote2">2</a></p></li>
<h5>Istraktura ng direktoryo<aclass="headerlink"href="#directory-structure"title="Permalink to this headline">¶</a></h5>
<p>Nirerequire ng ODM na iset-up ang direktoryo sa machine. ANg kritikal ay ang install folder (kung ininstall mo katulad ng nasa taas, <codeclass="docutils literal notranslate"><spanclass="pre">/home/odm/ODM/</span></code>) at ang project folder (i.e. <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/</span></code>)</p>
<ulclass="simple">
<li><p>Ang ODM settings.yaml file ay nag-specify ng isang parent directory na naglalaman ng lahat ng proyekto. Ito ang nangyayari sa path line ng proyekto ng settings.yaml file (medyo nakakalito ito ngunit ito ang <em>parent</em> diirectory ng mga indibidwal na direktoryo ng proyekto na tinutukoy sa project name parameter kapag tinatawagan ang ODM). Ang edit settings.yaml at ang set ng project_path parameter sa (ayon sa halimbawa na set-up) <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/</span></code>, na sa kaso na ito ay pinupunto ang volume na nilikha. Ang Indibidwal na direktoryo ng proyekto ay nilikha sa loob nito.</p></li>
<li><p>Ang mga indibidwal na direktoryo ng proyekto, halimbawa <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/</span></code> ay naglalaman ng gcp_list.txt file, ang imahe na image_groups.txt file, at ang imahe ng folder kada proyekto```</p></li>
<li><p>Ang folder ng imahe, i.e. <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/images/</span></code> ay naglalaman ng lahat ng imahe. Kapag sinet-up ito ng ganon, hindi marere-copy ang mga imahe dahil ito ay nasa direktoryo na kung saan gusto sila ilagay ng ODM.</p></li>
<li><p>I-modify ang settings.yaml para matukoy ang parent directory ng project folder (sa kaso na ito ang Volume na nilikha, <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/</span></code>). Siguraduhin na ang mga imahe ay nasa tamang lugaw, i.e. <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/images</span></code> at ang ibang ancillary files <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/images</span></code> ay nasa root folder <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/</span></code></p></li>
<li><p>Kung ang mga imahe mo ay nasa hiwalay na folder para sa indibidwal na AOI blocks or flights (na kadalasan ay nangyayari kapag ang iyong pamamahala ay organisado), pwedeng gumawa ng image_groups.txt file na may incantation na <codeclass="docutils literal notranslate"><spanclass="pre">for</span><spanclass="pre">i</span><spanclass="pre">in</span><spanclass="pre">*;</span><spanclass="pre">do</span><spanclass="pre">cd</span><spanclass="pre">$i;</span><spanclass="pre">for</span><spanclass="pre">j</span><spanclass="pre">in</span><spanclass="pre">*;</span><spanclass="pre">do</span><spanclass="pre">echo</span><spanclass="pre">"$j</span><spanclass="pre">$i"</span><spanclass="pre">>></span><spanclass="pre">../$i.txt;</span><spanclass="pre">done;</span><spanclass="pre">cd</span><spanclass="pre">../;</span><spanclass="pre">done;</span></code> at <codeclass="docutils literal notranslate"><spanclass="pre">cd</span><spanclass="pre">../</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">for</span><spanclass="pre">i</span><spanclass="pre">in</span><spanclass="pre">myproject/*.txt;</span><spanclass="pre">do</span><spanclass="pre">cat</span><spanclass="pre">$i</span><spanclass="pre">>></span><spanclass="pre">image_groups.txt;</span><spanclass="pre">done;</span></code>. Ito ay makakabuo ng file na may tamang istraktura: listahan ng mga imahe at "group name" pagkatapos ng bawat isa (na sa kaso na ito madalas ay pangalan ng folder na pinanggalingan nito). Ilagay ang lahat ng image files sa isang direktoryo na tatawagin na images sa project root dir (so <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/images/</span></code>). Ang image_groups.txt file ay papayagan ng ODM na bantayan ang mga imahe na na kasapi ng kaparehong batch, kahit na sila ay nasa iisang direktoryo lamang.</p></li>
<h4>I-resize ang droplet, hatakin ang pin at i-proseso ito.<aclass="headerlink"href="#resize-droplet-pull-pin-run-away"title="Permalink to this headline">¶</a></h4>
<ulclass="simple">
<li><p>Patayin at ire-size ang machine sa tamang bilang ng CPUs at laki ng memory. Ginagamit namin ang memory-optimized machine na may 24 na dedicated vCPUs at 192GB na RAM (na nagkakahalaga ng $1.60/hr-na dumaragdag ng mabilis, ito ay nasa $1000/month). I-restart at magsimula agad para hindi masayang nag mahal na big-droplet time.</p></li>
<li><p>i-launce ang ODM na proseso gamit ang ssh at nohup (para kahit ikaw ay maputol, magtutuloy-tuloy ang proseso)</p>
<ul>
<li><p>Pwedeng gamitin ang GNU screen para masimulan ang proseso mula sa screen session na hindi hihinto kung ang konesyon mo ay hindi masisira; I-launch ang <codeclass="docutils literal notranslate"><spanclass="pre">screen</span></code>, at gamitin ang <codeclass="docutils literal notranslate"><spanclass="pre"><ctrl></span><spanclass="pre">a</span><spanclass="pre"><ctrl></span><spanclass="pre">d</span></code> para humiwalay at <codeclass="docutils literal notranslate"><spanclass="pre">screen</span><spanclass="pre">-r</span></code> para kumabit ulit. Ngunit ang paggamit ng screen ay hindi makakapagbigay ng log file ng lahat ng console output maliban kung may gagawin na partikular para ito ay makuhanan. Ang nohup ay nagbibigay ng file na kasama ang lahat n g console output kasama na ang error messages ng libre.</p></li>
<li><p>Tandaan: as of 2020-03 ang normal na incantation na <codeclass="docutils literal notranslate"><spanclass="pre">python</span><spanclass="pre">run.py</span><spanclass="pre">-i</span><spanclass="pre">/path/to/image/folder</span><spanclass="pre">project_name</span></code> ay mukhang <em>hindi</em> gumagana; ang <codeclass="docutils literal notranslate"><spanclass="pre">-i</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">--image</span></code> parameter ay nagdudulot ng kakaibang error. So hindi na ginagamit ang -i parameter, ayt umaasa na lamang sa project directory line sa settings.yaml file para iderekta ang ODM sa tamang lugar. Ngayon ay gumagamit (kasama ang split-merge):</p></li>
<li><p>Tinuturo ang ODM sa folder (sa halimbawa na ito) <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/</span></code>. Sa kondisyon na image_groups.txt at ang image_groups.txt ay nasa folder na ito, ang mga imahe ay nasa <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/myproject/images/</span></code>, at ang project path sa settings.yaml ay <codeclass="docutils literal notranslate"><spanclass="pre">/mnt/odmdata/</span></code> hindi masasayang ang oras at ang ispasyo sa pagkopya ng imahe.</p></li>
<li><p>Tandaan na ina-assume dito na ikaw ay meroong image_groups.txt file. Kung wala, itong <codeclass="docutils literal notranslate"><spanclass="pre">-split-overlap</span><spanclass="pre">0</span></code> ay paniguradong masisira ang lahat at ang <codeclass="docutils literal notranslate"><spanclass="pre">--split</span><spanclass="pre">1</span></code> naman ay literal na sapalarang numero lamang na hindi papansinin matapos ang image_groups.txt file ay ma-load (normal na kinokontrol nito ang dami ng grupo ng imahe na hinihiwalay nito, pero sa kaso na ito ay ating inaasahan na ang mga imahe ay nakagrupo na). Kung ikaw ay walang malaki na dataset (>1000 na imahe), tanggalin ang <codeclass="docutils literal notranslate"><spanclass="pre">--split</span></code> at <codeclass="docutils literal notranslate"><spanclass="pre">--split-overlap</span></code> na opsiyon.</p></li>
<li><p>Sundan ang progreso gamit ang tail (para malaman kapag tapos na)</p></li>
<h4>Matapos ang lahat (assuming na ikaw ay nagsurvive ng ganoon katagal)<aclass="headerlink"href="#after-it-finishes-assuming-you-survive-that-long"title="Permalink to this headline">¶</a></h4>
<ulclass="simple">
<li><p>Kapag tapos na ang proseso, patayin ang machine at ire-size ito pabalik sa inexpensive minimum capacity.</p></li>
<li><p>Simulan ang machine back up at log in via ssh.</p></li>
<li><p>Kung gusto makatipid sa download bandwidth, pwedeng icompress ang orthophoto gamit ang GDAL. Wag magdagdag ng overviews, gawin ito sa iyong lokal na machine para maiwasan ang pagpapalaki ng file bago ito i-download.</p></li>
<li><p>Magdownload gamit ang: <codeclass="docutils literal notranslate"><spanclass="pre">scp</span><spanclass="pre">odm@xxx.xxx.xxx.xxx:/mnt/odmdata/myproject/odm_orthophoto/odm_orthophoto.tif</span></code> (o i-grab ang compressed na bersiyon na ginawa mo sa huling hakbang)</p></li>
<li><p>Kapag nakuha na ang file sa iyong lokal na computer, gamitin ang QGIS para magdagdag ng overviews (“pyramids”) o gamitin ang GDAL command <cite>gdaladdo -r average /path/to/image.tif 2 4 8 16 32 64 128 256 512 1024`</cite>.</p></li>
<li><p>Maaaring i-archive ang odm_texturing, odm_georeferencing, at odm-dem folders gamit ang tar ng mas mapadali ang pagdownload ng isang piraso (at maaaring mas maliit).</p></li>
<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/tutorials.rst">this page</a>!</p>
