mirror
/
OpenDroneMap-docs
kopia lustrzana https://github.com/OpenDroneMap/docs
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
OpenDroneMap-docs/arguments/camera-lens/index.html

593 wiersze
38 KiB
HTML
Czysty Zwykły widok Historia

Update documentation
2021-07-22 13:03:23 +00:00
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
Update documentation
2021-10-06 15:11:59 +00:00
<title>camera-lens &mdash; OpenDroneMap 2.6.4 documentation</title>
Update documentation
2021-07-22 13:03:23 +00:00
<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="cameras" href="../cameras/" />
<link rel="prev" title="build-overviews" href="../build-overviews/" />
</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">
Update documentation
2021-10-06 15:11:59 +00:00
2.6.4
Update documentation
2021-07-22 13:03:23 +00:00
</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>
<li class="toctree-l1"><a class="reference internal" href="../../installation/">Installation and Getting Started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../installation/#hardware-recommendations">Hardware Recommendations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../installation/#installation">Installation</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../installation/#windows">Windows</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-1-check-virtualization-support">Step 1. Check Virtualization Support</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-2-install-requirements">Step 2. Install Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-3-check-memory-and-cpu-allocation">Step 3. Check Memory and CPU Allocation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-4-download-webodm">Step 4. Download WebODM</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-4-launch-webodm">Step 4. Launch WebODM</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../installation/#macos">macOS</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#id1">Step 1. Check Virtualization Support</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#id2">Step 2. Install Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#id3">Step 3. Check Memory and CPU Allocation</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-4-download-and-launch-webodm">Step 4. Download and Launch WebODM</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../installation/#linux">Linux</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-1-install-requirements">Step 1. Install Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-2-check-additional-requirements">Step 2. Check Additional Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../installation/#step-3-download-and-launch-webodm">Step 3. Download and Launch WebODM</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../installation/#basic-commands-and-troubleshooting">Basic Commands and Troubleshooting</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../installation/#hello-webodm">Hello, WebODM!</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../installation/#running-on-more-than-one-machine">Running on more than one machine</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../tutorials/">Tutorials</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../tutorials/#creating-high-quality-orthophotos">Creating High Quality Orthophotos</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../tutorials/#calibrating-the-camera">Calibrating the Camera</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../tutorials/#creating-digital-elevation-models">Creating Digital Elevation Models</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">Using Docker</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#listing-docker-machines">Listing Docker Machines</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#accessing-logs-on-the-instance">Accessing logs on the instance</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#command-line-access-to-instances">Command line access to instances</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#cleaning-up-after-docker">Cleaning up after Docker</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../tutorials/#using-odm-from-low-bandwidth-location">Using ODM from low-bandwidth location</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#what-is-this-and-who-is-it-for">What is this and who is it for?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#steps">Steps</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#install">Install</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#prep-data-and-project">Prep data and project</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#resize-droplet-pull-pin-run-away">Resize droplet, pull pin, run away</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#after-it-finishes-assuming-you-survive-that-long">After it finishes (assuming you survive that long)</a></li>
</ul>
</li>
</ul>
</li>
Update documentation
2021-08-21 15:57:09 +00:00
<li class="toctree-l2"><a class="reference internal" href="../../tutorials/#using-potree-3d-viewer-module-on-webodm">Using Potree 3D viewer module on WebODM</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#cameras">Cameras</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#textured-model">Textured model</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#appearance">Appearance</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#point-budget">Point budget</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#field-of-view">Field of view</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#eye-dome-lighting">Eye Dome-lighting</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#background">Background</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#other">Other</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#tools">Tools</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#measurement">Measurement</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#clipping">Clipping</a></li>
<li class="toctree-l4"><a class="reference internal" href="../../tutorials/#navigation">Navigation</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../../tutorials/#scene">Scene</a></li>
</ul>
</li>
Update documentation
2021-07-22 13:03:23 +00:00
</ul>
</li>
<li class="toctree-l1 current"><a class="reference internal" href="../">Options and Flags</a><ul class="current">
Update documentation
2021-08-03 17:28:11 +00:00
<li class="toctree-l2"><a class="reference internal" href="../build-overviews/">build-overviews</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../build-overviews/#what-are-overviews">What Are Overviews?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../build-overviews/#when-are-overviews-appropriate">When are Overviews appropriate?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../build-overviews/#why-would-one-use-overviews">Why would one use Overviews?</a></li>
<li class="toctree-l3"><a class="reference internal" href="../build-overviews/#example-images">Example Images</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../build-overviews/#true-build-overviews">True: <code class="docutils literal notranslate"><span class="pre">--build-overviews</span></code></a></li>
<li class="toctree-l4"><a class="reference internal" href="../build-overviews/#false-null">False: <code class="docutils literal notranslate"><span class="pre">null</span></code></a></li>
</ul>
</li>
</ul>
</li>
Update documentation
2021-08-04 16:17:37 +00:00
<li class="toctree-l2 current"><a class="current reference internal" href="#">camera-lens</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#what-are-camera-lens-models">What Are Camera Lens Models?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#when-are-manual-selections-appropriate">When are manual selections appropriate?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#why-would-one-use-a-particular-camera-lens-model">Why would one use a particular Camera Lens Model?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#example-images">Example Images</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#auto-rectilinear-data"><code class="docutils literal notranslate"><span class="pre">auto</span></code> : Rectilinear Data</a></li>
<li class="toctree-l4"><a class="reference internal" href="#brown-rectilinear-data"><code class="docutils literal notranslate"><span class="pre">brown</span></code> : Rectilinear Data</a></li>
<li class="toctree-l4"><a class="reference internal" href="#fisheye-rectilinear-data"><code class="docutils literal notranslate"><span class="pre">fisheye</span></code> : Rectilinear Data</a></li>
<li class="toctree-l4"><a class="reference internal" href="#perspective-rectilinear-data"><code class="docutils literal notranslate"><span class="pre">perspective</span></code> : Rectilinear Data</a></li>
<li class="toctree-l4"><a class="reference internal" href="#spherical-rectilinear-data"><code class="docutils literal notranslate"><span class="pre">spherical</span></code> : Rectilinear Data</a></li>
</ul>
</li>
</ul>
</li>
Update documentation
2021-07-22 13:03:23 +00:00
<li class="toctree-l2"><a class="reference internal" href="../cameras/">cameras</a></li>
<li class="toctree-l2"><a class="reference internal" href="../cog/">cog</a></li>
<li class="toctree-l2"><a class="reference internal" href="../copy-to/">copy-to</a></li>
<li class="toctree-l2"><a class="reference internal" href="../crop/">crop</a></li>
<li class="toctree-l2"><a class="reference internal" href="../debug/">debug</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dem-decimation/">dem-decimation</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dem-euclidean-map/">dem-euclidean-map</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dem-gapfill-steps/">dem-gapfill-steps</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dem-resolution/">dem-resolution</a></li>
<li class="toctree-l2"><a class="reference internal" href="../depthmap-resolution/">depthmap-resolution</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dsm/">dsm</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dtm/">dtm</a></li>
<li class="toctree-l2"><a class="reference internal" href="../end-with/">end-with</a></li>
<li class="toctree-l2"><a class="reference internal" href="../fast-orthophoto/">fast-orthophoto</a></li>
<li class="toctree-l2"><a class="reference internal" href="../feature-quality/">feature-quality</a></li>
<li class="toctree-l2"><a class="reference internal" href="../feature-type/">feature-type</a></li>
<li class="toctree-l2"><a class="reference internal" href="../force-gps/">force-gps</a></li>
<li class="toctree-l2"><a class="reference internal" href="../gcp/">gcp</a></li>
<li class="toctree-l2"><a class="reference internal" href="../geo/">geo</a></li>
<li class="toctree-l2"><a class="reference internal" href="../gps-accuracy/">gps-accuracy</a></li>
<li class="toctree-l2"><a class="reference internal" href="../help/">help</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ignore-gsd/">ignore-gsd</a></li>
<li class="toctree-l2"><a class="reference internal" href="../matcher-distance/">matcher-distance</a></li>
<li class="toctree-l2"><a class="reference internal" href="../matcher-neighbors/">matcher-neighbors</a></li>
<li class="toctree-l2"><a class="reference internal" href="../matcher-type/">matcher-type</a></li>
<li class="toctree-l2"><a class="reference internal" href="../max-concurrency/">max-concurrency</a></li>
<li class="toctree-l2"><a class="reference internal" href="../merge/">merge</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mesh-octree-depth/">mesh-octree-depth</a></li>
<li class="toctree-l2"><a class="reference internal" href="../mesh-size/">mesh-size</a></li>
<li class="toctree-l2"><a class="reference internal" href="../min-num-features/">min-num-features</a></li>
<li class="toctree-l2"><a class="reference internal" href="../name/">name</a></li>
<li class="toctree-l2"><a class="reference internal" href="../optimize-disk-space/">optimize-disk-space</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-compression/">orthophoto-compression</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-cutline/">orthophoto-cutline</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-kmz/">orthophoto-kmz</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-no-tiled/">orthophoto-no-tiled</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-png/">orthophoto-png</a></li>
<li class="toctree-l2"><a class="reference internal" href="../orthophoto-resolution/">orthophoto-resolution</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-classify/">pc-classify</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-csv/">pc-csv</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-ept/">pc-ept</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-filter/">pc-filter</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-geometric/">pc-geometric</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-las/">pc-las</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-quality/">pc-quality</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-rectify/">pc-rectify</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-sample/">pc-sample</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pc-tile/">pc-tile</a></li>
<li class="toctree-l2"><a class="reference internal" href="../primary-band/">primary-band</a></li>
<li class="toctree-l2"><a class="reference internal" href="../project-path/">project-path</a></li>
<li class="toctree-l2"><a class="reference internal" href="../radiometric-calibration/">radiometric-calibration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../rerun/">rerun</a></li>
<li class="toctree-l2"><a class="reference internal" href="../rerun-all/">rerun-all</a></li>
<li class="toctree-l2"><a class="reference internal" href="../rerun-from/">rerun-from</a></li>
<li class="toctree-l2"><a class="reference internal" href="../resize-to/">resize-to</a></li>
<li class="toctree-l2"><a class="reference internal" href="../skip-3dmodel/">skip-3dmodel</a></li>
<li class="toctree-l2"><a class="reference internal" href="../skip-band-alignment/">skip-band-alignment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../skip-report/">skip-report</a></li>
<li class="toctree-l2"><a class="reference internal" href="../sm-cluster/">sm-cluster</a></li>
<li class="toctree-l2"><a class="reference internal" href="../smrf-scalar/">smrf-scalar</a></li>
<li class="toctree-l2"><a class="reference internal" href="../smrf-slope/">smrf-slope</a></li>
<li class="toctree-l2"><a class="reference internal" href="../smrf-threshold/">smrf-threshold</a></li>
<li class="toctree-l2"><a class="reference internal" href="../smrf-window/">smrf-window</a></li>
<li class="toctree-l2"><a class="reference internal" href="../split/">split</a></li>
<li class="toctree-l2"><a class="reference internal" href="../split-image-groups/">split-image-groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="../split-overlap/">split-overlap</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-data-term/">texturing-data-term</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-keep-unseen-faces/">texturing-keep-unseen-faces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-outlier-removal-type/">texturing-outlier-removal-type</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-skip-global-seam-leveling/">texturing-skip-global-seam-leveling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-skip-local-seam-leveling/">texturing-skip-local-seam-leveling</a></li>
<li class="toctree-l2"><a class="reference internal" href="../texturing-tone-mapping/">texturing-tone-mapping</a></li>
<li class="toctree-l2"><a class="reference internal" href="../tiles/">tiles</a></li>
<li class="toctree-l2"><a class="reference internal" href="../time/">time</a></li>
<li class="toctree-l2"><a class="reference internal" href="../use-3dmesh/">use-3dmesh</a></li>
<li class="toctree-l2"><a class="reference internal" href="../use-exif/">use-exif</a></li>
<li class="toctree-l2"><a class="reference internal" href="../use-fixed-camera-params/">use-fixed-camera-params</a></li>
<li class="toctree-l2"><a class="reference internal" href="../use-hybrid-bundle-adjustment/">use-hybrid-bundle-adjustment</a></li>
<li class="toctree-l2"><a class="reference internal" href="../verbose/">verbose</a></li>
<li class="toctree-l2"><a class="reference internal" href="../version/">version</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../outputs/">OpenDroneMap Outputs</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">List of all outputs</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../gcp/">Ground Control Points</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">User Interfaces</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/">Splitting Large Datasets</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../large/#calibrate-images">Calibrate images</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../large/#local-split-merge">Local Split-Merge</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../large/#distributed-split-merge">Distributed Split-Merge</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../large/#getting-started-with-distributed-split-merge">Getting Started with Distributed Split-Merge</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../large/#understanding-the-cluster">Understanding the Cluster</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../large/#accessing-the-logs">Accessing the Logs</a></li>
<li class="toctree-l3"><a class="reference internal" href="../../large/#autoscaling-clusterodm">Autoscaling ClusterODM</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../large/#limitations">Limitations</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../large/#acknowledgments">Acknowledgments</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../resources/">Additional References</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../resources/#for-users">For Users</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../resources/#for-developers">For Developers</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../flying/">Flying Tips</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../multispectral/">Multispectral Support</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">Usage</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../requesting-features/">How To Request Features</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../contributing/">How To Contribute</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../../contributing/#community-forum">Community Forum</a></li>
<li class="toctree-l2"><a class="reference internal" href="../../contributing/#reporting-bugs">Reporting Bugs</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../../contributing/#template-for-submitting-bug-reports">Template For Submitting Bug Reports</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../contributing/#pull-requests">Pull Requests</a></li>
</ul>
</li>
Update documentation
2021-07-30 22:42:15 +00:00
<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>
Update documentation
2021-07-22 13:03:23 +00:00
</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> &raquo;</li>
<li><a href="../">Options and Flags</a> &raquo;</li>
<li>camera-lens</li>
<li class="wy-breadcrumbs-aside">
<a href="../../_sources/arguments/camera-lens.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="camera-lens">
<span id="id1"></span><h1>camera-lens<a class="headerlink" href="#camera-lens" title="Permalink to this headline"></a></h1>
<p><strong>Options:</strong> <em>auto | perspective | brown | fisheye | spherical</em></p>
<p>Set a camera projection type. Manually setting a value can help improve geometric undistortion. By default the application tries to determine a lens type from the images metadata. . Default: <code class="docutils literal notranslate"><span class="pre">auto</span></code></p>
Update documentation
2021-08-04 16:17:37 +00:00
<div class="line-block">
<div class="line">Parameter Type:</div>
<div class="line-block">
<div class="line"><strong>String</strong></div>
</div>
<div class="line">Parameter Domain:</div>
<div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">auto</span></code> : Automatic selection of best camera projection model.</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">brown</span></code> : Robust rectilinear projection model. Preferred by <code class="docutils literal notranslate"><span class="pre">auto</span></code>.</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">fisheye</span></code> : Wide-angle / non-rectilinear projection model.</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">perspective</span></code> : Legacy rectilinear projection model.</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">spherical</span></code> : 360° camera projection model.</div>
</div>
<div class="line">Parameter Default:</div>
<div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">auto</span></code></div>
</div>
</div>
<hr class="docutils" />
<table class="docutils align-default">
<colgroup>
<col style="width: 44%" />
<col style="width: 56%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Resource</p></th>
<th class="head"><p>Impact</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>CPU</p></td>
<td><p>●○○ | Low</p></td>
</tr>
<tr class="row-odd"><td><p>GPU</p></td>
<td><p>○○○ | None</p></td>
</tr>
<tr class="row-even"><td><p>HDD</p></td>
<td><p>●○○ | Low</p></td>
</tr>
<tr class="row-odd"><td><p>RAM</p></td>
<td><p>●○○ | Low</p></td>
</tr>
<tr class="row-even"><td><p>Time</p></td>
<td><p>●○○ | Low</p></td>
</tr>
</tbody>
</table>
<hr class="docutils" />
<div class="section" id="what-are-camera-lens-models">
<h2>What Are Camera Lens Models?<a class="headerlink" href="#what-are-camera-lens-models" title="Permalink to this headline"></a></h2>
<p>Camera Lens Models are projection/distortion models that OpenSFM uses to correct for the optics of the camera platforms that record our images. These corrections are essential for proper camera/scene modeling, and therefore, proper reconstruction of the data.</p>
</div>
<div class="section" id="when-are-manual-selections-appropriate">
<h2>When are manual selections appropriate?<a class="headerlink" href="#when-are-manual-selections-appropriate" title="Permalink to this headline"></a></h2>
<p>Manually choosing a Camera Lens Model is currently only recommended in the case of Spherical Cameras (GoPro Fusion, GoPro Max, Insta360, Kodak PixPro, etc.) as these are currently not detected automatically by OpenSFM.</p>
</div>
<div class="section" id="why-would-one-use-a-particular-camera-lens-model">
<h2>Why would one use a particular Camera Lens Model?<a class="headerlink" href="#why-would-one-use-a-particular-camera-lens-model" title="Permalink to this headline"></a></h2>
<p>In rare cases, OpenSFM may not be able to detect (or retrieve from its Camera database) the correct Camera Lens Model for your particular sensor, in which case you should select the closest appropriate model. When in doubt, try specifying <code class="docutils literal notranslate"><span class="pre">brown</span></code> first.</p>
</div>
<div class="section" id="example-images">
<h2>Example Images<a class="headerlink" href="#example-images" title="Permalink to this headline"></a></h2>
<p>The following examples are all data taken with a standard Rectilinear Lens. Manual selection of the various Camera Lens Models is demonstrated to show some differences in how this will affect reconstruction.</p>
<div class="section" id="auto-rectilinear-data">
<h3><code class="docutils literal notranslate"><span class="pre">auto</span></code> : Rectilinear Data<a class="headerlink" href="#auto-rectilinear-data" title="Permalink to this headline"></a></h3>
<div class="figure align-default" id="id2">
<img alt="Rectilinear data rendered by ``auto`` Camera Lens Model" src="https://user-images.githubusercontent.com/19295950/127077336-ae79a958-a953-4376-86fd-430d0e5457f2.png" />
<p class="caption"><span class="caption-text">This Point Cloud shows a proper reconstruction via the <code class="docutils literal notranslate"><span class="pre">auto</span></code> (<code class="docutils literal notranslate"><span class="pre">brown</span></code>) Camera Lens Model, which is appropriate for this sensor.</span><a class="headerlink" href="#id2" title="Permalink to this image"></a></p>
</div>
</div>
<div class="section" id="brown-rectilinear-data">
<h3><code class="docutils literal notranslate"><span class="pre">brown</span></code> : Rectilinear Data<a class="headerlink" href="#brown-rectilinear-data" title="Permalink to this headline"></a></h3>
<div class="figure align-default" id="id3">
<img alt="Rectilinear data rendered by ``brown`` Camera Lens Model" src="https://user-images.githubusercontent.com/19295950/127077753-580a174e-7572-4315-8801-224ce097d9fc.png" />
<p class="caption"><span class="caption-text">As in the prior example, this Point Cloud is reconstructed via the <code class="docutils literal notranslate"><span class="pre">brown</span></code> Camera Lens Model.</span><a class="headerlink" href="#id3" title="Permalink to this image"></a></p>
</div>
</div>
<div class="section" id="fisheye-rectilinear-data">
<h3><code class="docutils literal notranslate"><span class="pre">fisheye</span></code> : Rectilinear Data<a class="headerlink" href="#fisheye-rectilinear-data" title="Permalink to this headline"></a></h3>
<div class="figure align-default" id="id4">
<img alt="Rectilinear data rendered by ``fisheye`` Camera Lens Model" src="https://user-images.githubusercontent.com/19295950/127077826-53d459fe-5e4e-4b10-8e70-fbddf775c4f7.png" />
<p class="caption"><span class="caption-text">In this Point Cloud reconstruction, severe bowling and other artifacts have been introduced via the use of the wrong Camera Lens Model.</span><a class="headerlink" href="#id4" title="Permalink to this image"></a></p>
</div>
</div>
<div class="section" id="perspective-rectilinear-data">
<h3><code class="docutils literal notranslate"><span class="pre">perspective</span></code> : Rectilinear Data<a class="headerlink" href="#perspective-rectilinear-data" title="Permalink to this headline"></a></h3>
<div class="figure align-default" id="id5">
<img alt="Rectilinear data rendered by ``perspective`` Camera Lens Model" src="https://user-images.githubusercontent.com/19295950/127077485-699f9e61-72a6-45f2-990f-f5748b6ee99f.png" />
<p class="caption"><span class="caption-text">This Point Cloud rendered well, very similar to the <code class="docutils literal notranslate"><span class="pre">auto</span></code> and <code class="docutils literal notranslate"><span class="pre">brown</span></code> examples. One may see artifacts in the <code class="docutils literal notranslate"><span class="pre">perspective</span></code> Camera Lens Model in very large collections, or over very flat/homogenus terrain (agricultural fields). In such cases, forcing <code class="docutils literal notranslate"><span class="pre">brown</span></code> may help.</span><a class="headerlink" href="#id5" title="Permalink to this image"></a></p>
</div>
</div>
<div class="section" id="spherical-rectilinear-data">
<h3><code class="docutils literal notranslate"><span class="pre">spherical</span></code> : Rectilinear Data<a class="headerlink" href="#spherical-rectilinear-data" title="Permalink to this headline"></a></h3>
<div class="figure align-default" id="id6">
<img alt="Rectilinear data rendered by ``spherical`` Camera Lens Model" src="https://user-images.githubusercontent.com/19295950/127078960-27e35cbb-a378-4d0d-92e2-42dbfd1edd7c.png" />
<p class="caption"><span class="caption-text">This Point Cloud failed to reconstruct properly due to the manual selection of the <code class="docutils literal notranslate"><span class="pre">fisheye</span></code> Camera Lens Model. Similar failures to reconstruct can often indicate the wrong manual selection, or in edge cases, wrong <code class="docutils literal notranslate"><span class="pre">auto</span></code> selection of the Camera Lens Model, and you are advised to try another Model that is more appropriate.</span><a class="headerlink" href="#id6" title="Permalink to this image"></a></p>
</div>
Update documentation
2021-07-22 13:03:23 +00:00
<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/arguments_edit/camera-lens.rst">this page</a>!</p>
Update documentation
2021-08-04 16:17:37 +00:00
</div>
</div>
Update documentation
2021-07-22 13:03:23 +00:00
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../cameras/" class="btn btn-neutral float-right" title="cameras" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
<a href="../build-overviews/" class="btn btn-neutral float-left" title="build-overviews" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&#169; 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>