kopia lustrzana https://github.com/OpenDroneMap/docs
optimization: WebPify all the things
Homogenize image format, filesize savings of over 25MB, faster renderingpull/240/head
Saijin-Naib
rodzic
99ca5ebd75
commit
cfd4424d72
40
README.md
40
README.md
|
|
@ -18,7 +18,7 @@ Once you have an account there are two ways to contribute. One is quick for smal
|
|||
|
||||
Browse to https://github.com/OpenDroneMap/docs/tree/publish/source. Each row in the table corresponds to a page in the documentation. Tap on the file name, in the second (2nd) column from left. Press the "Edit" icon.
|
||||
|
||||
|
||||
|
||||
|
||||
Make your changes, then scroll down and tap the "Propose Changes" button.
|
||||
|
||||
|
|
@ -38,7 +38,7 @@ You may want to read the English Style Guide for github https://github.com/raywe
|
|||
|
||||
Press the "Fork" button at the top of this page.
|
||||
|
||||
|
||||
|
||||
|
||||
## Step 2. Install Git and Python 3
|
||||
As there is an issue with python3.13 [(https://github.com/ethereum/s……olidity/issues/15811) with ](https://github.com/ethereum/solidity/issues/15811) python3.12 at most should be used.
|
||||
|
|
@ -104,7 +104,7 @@ After running `source .venv/bin/activate` there should be some indication that t
|
|||
|
||||
Note: If you've installed `sphinx` on your system, you may run into issues with commands using that version instead of the version inside your virtualenv.
|
||||
|
||||
|
||||
|
||||
|
||||
Then if there are no errors, run:
|
||||
|
||||
|
|
@ -171,9 +171,9 @@ An *italic section of text* may also have a single asterisk on either side.
|
|||
|
||||
Italic text needs to have a space before, then a backtick or grave accent (\`) that touches the first character of the italic text, then the italic text, then a backtick or grave accent (\`) that touches the last character of the italic text, then a space. The backticks may also be asterisks.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Bold
|
||||
|
|
@ -184,9 +184,9 @@ A **bold section of text** will have double asterisks on either side.
|
|||
|
||||
Bold text needs to have a space before, then a double asterisk (`**`) that touches the first character of the bold text, then the bold text, then a double asterisk (`**`) that touches the last character of the bold text, then a space.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Link
|
||||
|
||||
|
|
@ -195,9 +195,9 @@ Check out the `ODM documentation <https://docs.opendronemap.org/>`_!
|
|||
```
|
||||
Links need to have a space before, then a backtick or grave accent (\`), then the text that will become the link on the page (in the above example: "ODM documentation"), then a space, then a less than symbol (`<`), then the complete URL, then a greater than symbol and underscore (`>_`).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Code
|
||||
|
||||
|
|
@ -205,13 +205,13 @@ Code snippets need to have a space before, then a double backtick or grave accen
|
|||
|
||||
**NOTE:** Code snippets may be referring to specific software commands and so often should NOT be translated.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Managing the translation process
|
||||
|
|
@ -248,7 +248,7 @@ You can also run the build for just one specific language, for example:
|
|||
sphinx-build -b dirhtml -D language='sw' source "_build/html/sw/"
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
You should see output in your console such as:
|
||||
|
||||
|
|
@ -261,7 +261,7 @@ Look at the source file and line that is mentioned. In this case the file is `so
|
|||
|
||||
Go to Transifex, go to the resource, and go to the string. The warning/error message should help you understand what went wrong. In this case the link syntax wasn't matched correctly. Fix and save the translation.
|
||||
|
||||
|
||||
|
||||
|
||||
Pull the language down (for example, `tx pull -l sw`) and then try the build again.
|
||||
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ Path to a GeoTIFF DEM or a LAS/LAZ point cloud that the reconstruction outputs s
|
|||
|
||||
See `Multi-temporal datasets for further usage information. <../../map-accuracy/#improving-relative-accuracy>`_
|
||||
|
||||
.. figure:: ../images/align_pc.gif
|
||||
.. figure:: ../images/align_pc.webp
|
||||
:alt: Animated gif comparing two separately processed, but aligned digital surface models.
|
||||
:align: center
|
||||
|
||||
|
|
|
|||
|
|
@ -57,14 +57,14 @@ Example Images
|
|||
|
||||
True: ``--auto-boundary``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864618-2a0c95f2-669e-45dc-b5c5-df82a555e4e5.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864618-2a0c95f2-669e-45dc-b5c5-df82a555e4e5.webp
|
||||
:alt: WebODM displaying the reconstruction extent of a terrestrial orbit survey of a Northern Catalpa tree.
|
||||
|
||||
The WebODM 3D View shows the full extent of the reconstruction, bounded by the ``--auto-boundary`` option.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864753-db3695c5-3ba2-48fb-a644-3e591913de72.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864753-db3695c5-3ba2-48fb-a644-3e591913de72.webp
|
||||
:alt: WebODM displaying the reconstruction extent of a terrestrial orbit survey of a Northern Catalpa tree.
|
||||
|
||||
The WebODM 3D View shows the full extent of the recosntruction. Compared to the ``--auto-boundary`` reconstruction above, one can see that the full reconstruction area is much larger (and therefore more visually sparse).
|
||||
|
|
|
|||
|
|
@ -62,28 +62,28 @@ GeoJSON.io
|
|||
|
||||
New GeoJSON
|
||||
""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102197-b44fea3b-01df-4f2f-9cde-f1c94ba2e8d3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102197-b44fea3b-01df-4f2f-9cde-f1c94ba2e8d3.webp
|
||||
:alt: GeoJSON.io interface with empty GeoJSON map and text.
|
||||
|
||||
After opening the above link to GeoJSON.io, one should pan and zoom the map preview to find their area of interest.
|
||||
|
||||
Creating A Polygon
|
||||
"""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102194-7992ddf8-81ce-4ee9-bb81-b5d93cb05e25.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102194-7992ddf8-81ce-4ee9-bb81-b5d93cb05e25.webp
|
||||
:alt: Choosing the "Draw Polygon" menu option in the Map View.
|
||||
|
||||
Selecting the "Draw Polygon" menu option will allow you to place vertices for your polygon by left-clicking on the map.
|
||||
|
||||
Placing Vertices
|
||||
"""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102186-38a4107f-4c93-46f9-b423-3ce40fddff4b.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102186-38a4107f-4c93-46f9-b423-3ce40fddff4b.webp
|
||||
:alt: Placing vertices in the Map View to create the boundary GeoJSON.
|
||||
|
||||
Choose the appropriate locations of the boundary of your polygon by left-clicking on the map to place a vertex. You can place as many vertices as you require.
|
||||
|
||||
Completing A Polygon
|
||||
"""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102193-4e619f4e-e95d-4c3d-8f89-29a38015bce0.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102193-4e619f4e-e95d-4c3d-8f89-29a38015bce0.webp
|
||||
:alt: Completed polygon in the Map View and GeoJSON text view.
|
||||
|
||||
To close the polygon, you left-click on your first vertex. You will be able to close your polygon once you have placed at least three vertices on the map.
|
||||
|
|
@ -91,7 +91,7 @@ Completing A Polygon
|
|||
|
||||
Saving A Polygon
|
||||
"""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102199-a5d37bbf-d057-46d8-8baf-91817c7e2f30.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102199-a5d37bbf-d057-46d8-8baf-91817c7e2f30.webp
|
||||
:alt: Saving the polygon using the Save menu and choosing GeoJSON.
|
||||
|
||||
Select "Save" and then "GeoJSON" to save the completed GeoJSON boundary to disk. Your browser will prompt or otherwise alert you that the file is ready to download. Alternatively, you can copy and paste the text-only representation of the GeoJSON boundary from the right panel with the "JSON" header.
|
||||
|
|
@ -138,21 +138,21 @@ Saving A Polygon
|
|||
|
||||
Downloading A Polygon
|
||||
""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145103954-17ba7c31-fda6-4883-b7a6-3f0bacc266dd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145103954-17ba7c31-fda6-4883-b7a6-3f0bacc266dd.webp
|
||||
:alt: Browser Download/Save file prompt for the generated GeoJSON file.
|
||||
|
||||
Once the GeoJSON file has been chosen for saving, the browser will prompt you to save it to disk. Choose an appropriate location where you can access it at a later time to load into WebODM.
|
||||
|
||||
Setting Boundary [GeoJSON] In Task Options
|
||||
"""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102200-02bd1c97-e0e8-4932-a77d-91562823b46e.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102200-02bd1c97-e0e8-4932-a77d-91562823b46e.webp
|
||||
:alt: Task Options preview showing Boundary field and "Load" icon.
|
||||
|
||||
When you are editing the Task Options for your Task, you can choose to load the Boundary [GeoJSON] created above by clicking the "Load" icon. Alternatively, you can paste the textual representation of the boundary into the Boundary [GeoJSON] text box.
|
||||
|
||||
Boundary [GeoJSON] Loaded In Task Options
|
||||
""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102196-8f87e4ac-197f-4ce0-ac6f-082772921ea0.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102196-8f87e4ac-197f-4ce0-ac6f-082772921ea0.webp
|
||||
:alt: Task Options preview showing loaded Boundary with GeoJSON text.
|
||||
|
||||
Once the Boundary [GeoJSON] has been loaded from disk or pasted from the system clipboard, you can confirm its presence by seeing the text in the text box. You can now save the Task Options to enable the Boundary [GeoJSON] for the processing Task.
|
||||
|
|
@ -164,28 +164,28 @@ QGIS
|
|||
|
||||
Creating A New Temporary Scratch Layer
|
||||
"""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109912-9176cd94-1140-43ac-a371-96de2b874ec3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109912-9176cd94-1140-43ac-a371-96de2b874ec3.webp
|
||||
:alt: Choosing the "Create A Temporary Scratch Layer" tool to make an empty layer to create our Boundary [GeoJSON] within.
|
||||
|
||||
You will first need a layer to create your Boundary [GeoJSON] within, so creating a New Temporary Scratch layer is a way to do this without needing to setup a file on disk first.
|
||||
|
||||
New Temporary Scratch Layer Geometry Type
|
||||
""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109915-ddbfed43-da5e-466b-a4b6-d6ff3b96a555.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109915-ddbfed43-da5e-466b-a4b6-d6ff3b96a555.webp
|
||||
:alt: Setting "Polygon" as the Geometry Type for the Temporary Scratch Layer.
|
||||
|
||||
There are numerous choices of geometry types that can be represented by a given layer. OpenDroneMap is designed to work with Single Polygon, so you will choose Polygon from the Geometry Type menu.
|
||||
|
||||
New Temporary Scratch Layer Settings
|
||||
"""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109917-58b6c147-bdae-45be-839d-5d56b1a22fe8.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109917-58b6c147-bdae-45be-839d-5d56b1a22fe8.webp
|
||||
:alt: Leaving the remaining settings in their Default state.
|
||||
|
||||
Similar to Geometry Types, there are a large number of settings and options you can adjust for a Temporary Scratch Layer. You should leave these at their pictured defaults for usage with OpenDroneMap.
|
||||
|
||||
Adding an Orthophoto Background
|
||||
""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109918-df591ce8-3df4-485d-a775-81813b7e61ef.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109918-df591ce8-3df4-485d-a775-81813b7e61ef.webp
|
||||
:alt: Browsing to a generated Orthophoto from WebODM that covers the Area Of Interest (AOI).
|
||||
|
||||
If you have run the task already without a Boundary [GeoJSON], you can load the generated Orthophoto from OpenDroneMap into QGIS to use as your basemap for creating your Boundary [GeoJSON]. This should ensure that your boundary polygon exactly matches the data in your Task, as different basemaps can have errors of 1-10m or more.
|
||||
|
|
@ -193,35 +193,35 @@ Adding an Orthophoto Background
|
|||
|
||||
Adding A Polyon Feature
|
||||
""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109907-b61afb3c-fdd2-4eef-872a-91f2ea97d887.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109907-b61afb3c-fdd2-4eef-872a-91f2ea97d887.webp
|
||||
:alt: Selecting the "Add A Polygon Feature" tool to begin creating a boundary polygon.
|
||||
|
||||
After selecting the "Add A Polygon Feature" tool, you can begin placing vertices on the map to create your boundary. To finish your polygon, you will right-click on the canvas. Similar to GeoJSON.io, a finished polygon will have a darker outline and a darker fill to indicate that it is "solid".
|
||||
|
||||
Toggle Editing Off
|
||||
"""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109924-42480f63-2cfa-427c-8414-f45d39f796f7.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109924-42480f63-2cfa-427c-8414-f45d39f796f7.webp
|
||||
:alt: Clicking the "Toggle Editing" tool will prompt you to save your changes to the Temporary Scratch Layer.
|
||||
|
||||
Once you are finished with your boundary polygon, you can click the "Toggle Editing" tool to accept your changes and write them out to the Temporary Scratch Layer and make the layer valid for saving/exporting to disk.
|
||||
|
||||
Save Changes To Temporary Scratch Layer
|
||||
""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109921-73ab273a-7180-40ea-ba3d-75ecb65c97f5.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109921-73ab273a-7180-40ea-ba3d-75ecb65c97f5.webp
|
||||
:alt: QGIS Dialog asking you to Save your changes to the Temporary Scratch Layer.
|
||||
|
||||
Clicking Save on this dialog will write the changes to the Temporary Scratch Layer and enable export/save functionality.
|
||||
|
||||
Export Temporary Scratch Layer Features
|
||||
""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109911-45d7dae3-49ce-40fb-8df0-85a164763810.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109911-45d7dae3-49ce-40fb-8df0-85a164763810.webp
|
||||
:alt: A right-click on the Temporary Scratch Layer in the Layers panel will expose the Export menu item, with the Save Features As sub-menu item.
|
||||
|
||||
Right-click on the Temporary Scratch Layer in the Layers panel to bring up the Export menu and the Save Features As sub-menu item, selecting Save Features As. This will prompt you to choose the export format, location and file name, and settings for your layer.
|
||||
|
||||
Save Vector Layer As
|
||||
"""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109923-b55dfc1a-5c31-4382-8b1f-3bc6322b0f33.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109923-b55dfc1a-5c31-4382-8b1f-3bc6322b0f33.webp
|
||||
:alt: The "Save Vector Layer As" dialog showing Format as GeoJSON, an example of a valid File Name and path, CRS of EPSG:4326 and other default options.
|
||||
|
||||
This dialog will require you to choose GeoJSON as the format, a valid filename and path for the GeoJSON to be written out to disk with, and a valid CRS. The safest CRS choice with GeoJSON is EPSG:4326, so choose that if it is not chosen by default. All other options should be left as default and do not apply for OpenDroneMap usage.
|
||||
|
|
@ -231,35 +231,35 @@ Example Images
|
|||
|
||||
True: ``--boundary [GeoJSON]`` - Point Cloud
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858936-10fda65f-c278-46ae-95bd-7af8f8369554.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858936-10fda65f-c278-46ae-95bd-7af8f8369554.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Point Cloud.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Point Cloud, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - Orthophoto
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859033-c6cab4f0-74b3-4266-b5ec-4a90da931340.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859033-c6cab4f0-74b3-4266-b5ec-4a90da931340.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Orthophoto.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Orthophoto, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - Digital Elevation Model
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859073-28db5174-9a40-42d8-86d6-f345d9dad5a8.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859073-28db5174-9a40-42d8-86d6-f345d9dad5a8.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Digital Elevation Model.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Digital Elevation Model, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - 3D Model/Textured Mesh
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859125-4854e651-9eff-430d-956c-16f4d9a52dfd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859125-4854e651-9eff-430d-956c-16f4d9a52dfd.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset 3D Model/Textured Mesh.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction 3D Model/Textured Mesh, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858712-9bfd8c56-a52a-480e-b68d-d5a97bc516fd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858712-9bfd8c56-a52a-480e-b68d-d5a97bc516fd.webp
|
||||
:alt: WebODM displaying the full reconstruction of the Brighton Beach dataset Point Cloud.
|
||||
|
||||
The WebODM 3D View shows the full extent of the recosntruction. Compared to the ``--boundary`` reconstruction above, one can see that the full reconstruction area is much larger and includes many features outside of the Area Of Interest used to generate the GeoJSON.
|
||||
|
|
|
|||
|
|
@ -60,14 +60,14 @@ Example Images
|
|||
|
||||
True: ``--build-overviews``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127073339-6b2a0a4f-6ede-4dc1-8da4-5bc9646de304.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127073339-6b2a0a4f-6ede-4dc1-8da4-5bc9646de304.webp
|
||||
:alt: QGIS displaying the generated Overviews
|
||||
|
||||
The Layer Properties panel demonstrates that this OpenDroneMap-generated GeoTIFF has internal Overviews.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127074349-a3f84c4c-d05c-4bf1-bd7c-790781ad0fe3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127074349-a3f84c4c-d05c-4bf1-bd7c-790781ad0fe3.webp
|
||||
:alt: QGIS displaying the file is lacking Overviews
|
||||
|
||||
The Layer Properties panel demonstrates that this OpenDroneMap-generated GeoTIFF lacks internal Overviews.
|
||||
|
|
|
|||
|
|
@ -56,21 +56,21 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
|
||||
``auto`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077336-ae79a958-a953-4376-86fd-430d0e5457f2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077336-ae79a958-a953-4376-86fd-430d0e5457f2.webp
|
||||
:alt: Rectilinear data rendered by ``auto`` Camera Lens Model
|
||||
|
||||
This Point Cloud shows a proper reconstruction via the ``auto`` (``brown``) Camera Lens Model, which is appropriate for this sensor.
|
||||
|
||||
``brown`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077753-580a174e-7572-4315-8801-224ce097d9fc.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077753-580a174e-7572-4315-8801-224ce097d9fc.webp
|
||||
:alt: Rectilinear data rendered by ``brown`` Camera Lens Model
|
||||
|
||||
As in the prior example, this Point Cloud is reconstructed via the ``brown`` Camera Lens Model.
|
||||
|
||||
``fisheye`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077826-53d459fe-5e4e-4b10-8e70-fbddf775c4f7.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077826-53d459fe-5e4e-4b10-8e70-fbddf775c4f7.webp
|
||||
:alt: Rectilinear data rendered by ``fisheye`` Camera Lens Model
|
||||
|
||||
In this Point Cloud reconstruction, severe bowling and other artifacts have been introduced via the use of the wrong Camera Lens Model.
|
||||
|
|
@ -78,7 +78,7 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
``perspective`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077485-699f9e61-72a6-45f2-990f-f5748b6ee99f.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077485-699f9e61-72a6-45f2-990f-f5748b6ee99f.webp
|
||||
:alt: Rectilinear data rendered by ``perspective`` Camera Lens Model
|
||||
|
||||
This Point Cloud rendered well, very similar to the ``auto`` and ``brown`` examples. One may see artifacts in the ``perspective`` Camera Lens Model in very large collections, or over very flat/homogenus terrain (agricultural fields). In such cases, forcing ``brown`` may help.
|
||||
|
|
@ -86,7 +86,7 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
``spherical`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127078960-27e35cbb-a378-4d0d-92e2-42dbfd1edd7c.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127078960-27e35cbb-a378-4d0d-92e2-42dbfd1edd7c.webp
|
||||
:alt: Rectilinear data rendered by ``spherical`` Camera Lens Model
|
||||
|
||||
This Point Cloud failed to reconstruct properly due to the manual selection of the ``fisheye`` Camera Lens Model. Similar failures to reconstruct can often indicate the wrong manual selection, or in edge cases, wrong ``auto`` selection of the Camera Lens Model, and you are advised to try another Model that is more appropriate.
|
||||
|
|
|
|||
|
|
@ -55,34 +55,34 @@ Example Images
|
|||
|
||||
True: ``--cog``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127079824-c85fa5a9-842a-4f28-a380-b6404aac7ef2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127079824-c85fa5a9-842a-4f28-a380-b6404aac7ef2.webp
|
||||
:alt: GDAL Info showing LAYOUT=COG
|
||||
|
||||
The Raster Information tool in QGIS can print information from gdalinfo which can be used to confirm the conformance of a GeoTIFF to the COG spec.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138731905-d10483bd-b91b-4f63-bfb4-89c0f50bf74b.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138731905-d10483bd-b91b-4f63-bfb4-89c0f50bf74b.webp
|
||||
:alt: QGIS Layer Properties showing Internal Overviews
|
||||
|
||||
The Layer Properties panel can show that there are in fact internal overviews. Keep in mind that not every GeoTIFF has internal overviews, but every COG must.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733095-fb5f07ef-fbb0-48f4-8401-25cbf5294b9d.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733095-fb5f07ef-fbb0-48f4-8401-25cbf5294b9d.webp
|
||||
:alt: QGIS Layer Properties showing an on-disk file size of 8.78 MB
|
||||
|
||||
Note that the on-disk file size is 8.78 MB for the COG due to the presence of internal overviews when compared to the 6.30 MB of the non-COG GeoTIFF below.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127080115-7e09ba30-140f-402d-b00a-8bb0c7bc72ff.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127080115-7e09ba30-140f-402d-b00a-8bb0c7bc72ff.webp
|
||||
:alt: GDAL Info not showing LAYOUT=COG
|
||||
|
||||
The Raster Information tool in QGIS does not show LAYOUT=COG, which indicates that this GeoTIFF does not meet the COG spec.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138732051-d227c98d-10a5-46de-ac99-8c5ffb0a12b2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138732051-d227c98d-10a5-46de-ac99-8c5ffb0a12b2.webp
|
||||
:alt: QGIS Layer Properties not showing Internal Overviews
|
||||
|
||||
The Layer Properties panel shows that the GeoTIFF lacks all levels of Internal Pyramids.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733132-a9c4f8b4-673a-426b-a665-bde5e89e4de3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733132-a9c4f8b4-673a-426b-a665-bde5e89e4de3.webp
|
||||
:alt: QGIS Layer Properties showing an on-disk file size of 6.30 MB
|
||||
|
||||
Note that the on-disk file size is 6.30 MB for the COG due to the lack of internal overviews when compared to the 8.78 MB of the COG GeoTIFF above.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
|
||||
See `Multi-temporal datasets for further usage information. <../../map-accuracy/#improving-relative-accuracy>`_
|
||||
|
||||
.. figure:: ../images/align_pc.gif
|
||||
.. figure:: ../images/align_pc.webp
|
||||
:alt: Animated gif comparing two separately processed, but aligned digital surface models.
|
||||
:align: center
|
||||
|
||||
|
|
|
|||
|
|
@ -43,14 +43,14 @@ Example Images
|
|||
|
||||
True: ``--auto-boundary``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864618-2a0c95f2-669e-45dc-b5c5-df82a555e4e5.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864618-2a0c95f2-669e-45dc-b5c5-df82a555e4e5.webp
|
||||
:alt: WebODM displaying the reconstruction extent of a terrestrial orbit survey of a Northern Catalpa tree.
|
||||
|
||||
The WebODM 3D View shows the full extent of the reconstruction, bounded by the ``--auto-boundary`` option.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864753-db3695c5-3ba2-48fb-a644-3e591913de72.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140864753-db3695c5-3ba2-48fb-a644-3e591913de72.webp
|
||||
:alt: WebODM displaying the reconstruction extent of a terrestrial orbit survey of a Northern Catalpa tree.
|
||||
|
||||
The WebODM 3D View shows the full extent of the recosntruction. Compared to the ``--auto-boundary`` reconstruction above, one can see that the full reconstruction area is much larger (and therefore more visually sparse).
|
||||
|
|
|
|||
|
|
@ -48,28 +48,28 @@ GeoJSON.io
|
|||
|
||||
New GeoJSON
|
||||
""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102197-b44fea3b-01df-4f2f-9cde-f1c94ba2e8d3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102197-b44fea3b-01df-4f2f-9cde-f1c94ba2e8d3.webp
|
||||
:alt: GeoJSON.io interface with empty GeoJSON map and text.
|
||||
|
||||
After opening the above link to GeoJSON.io, one should pan and zoom the map preview to find their area of interest.
|
||||
|
||||
Creating A Polygon
|
||||
"""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102194-7992ddf8-81ce-4ee9-bb81-b5d93cb05e25.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102194-7992ddf8-81ce-4ee9-bb81-b5d93cb05e25.webp
|
||||
:alt: Choosing the "Draw Polygon" menu option in the Map View.
|
||||
|
||||
Selecting the "Draw Polygon" menu option will allow you to place vertices for your polygon by left-clicking on the map.
|
||||
|
||||
Placing Vertices
|
||||
"""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102186-38a4107f-4c93-46f9-b423-3ce40fddff4b.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102186-38a4107f-4c93-46f9-b423-3ce40fddff4b.webp
|
||||
:alt: Placing vertices in the Map View to create the boundary GeoJSON.
|
||||
|
||||
Choose the appropriate locations of the boundary of your polygon by left-clicking on the map to place a vertex. You can place as many vertices as you require.
|
||||
|
||||
Completing A Polygon
|
||||
"""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102193-4e619f4e-e95d-4c3d-8f89-29a38015bce0.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102193-4e619f4e-e95d-4c3d-8f89-29a38015bce0.webp
|
||||
:alt: Completed polygon in the Map View and GeoJSON text view.
|
||||
|
||||
To close the polygon, you left-click on your first vertex. You will be able to close your polygon once you have placed at least three vertices on the map.
|
||||
|
|
@ -77,7 +77,7 @@ Completing A Polygon
|
|||
|
||||
Saving A Polygon
|
||||
"""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102199-a5d37bbf-d057-46d8-8baf-91817c7e2f30.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102199-a5d37bbf-d057-46d8-8baf-91817c7e2f30.webp
|
||||
:alt: Saving the polygon using the Save menu and choosing GeoJSON.
|
||||
|
||||
Select "Save" and then "GeoJSON" to save the completed GeoJSON boundary to disk. Your browser will prompt or otherwise alert you that the file is ready to download. Alternatively, you can copy and paste the text-only representation of the GeoJSON boundary from the right panel with the "JSON" header.
|
||||
|
|
@ -124,21 +124,21 @@ Saving A Polygon
|
|||
|
||||
Downloading A Polygon
|
||||
""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145103954-17ba7c31-fda6-4883-b7a6-3f0bacc266dd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145103954-17ba7c31-fda6-4883-b7a6-3f0bacc266dd.webp
|
||||
:alt: Browser Download/Save file prompt for the generated GeoJSON file.
|
||||
|
||||
Once the GeoJSON file has been chosen for saving, the browser will prompt you to save it to disk. Choose an appropriate location where you can access it at a later time to load into WebODM.
|
||||
|
||||
Setting Boundary [GeoJSON] In Task Options
|
||||
"""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102200-02bd1c97-e0e8-4932-a77d-91562823b46e.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102200-02bd1c97-e0e8-4932-a77d-91562823b46e.webp
|
||||
:alt: Task Options preview showing Boundary field and "Load" icon.
|
||||
|
||||
When you are editing the Task Options for your Task, you can choose to load the Boundary [GeoJSON] created above by clicking the "Load" icon. Alternatively, you can paste the textual representation of the boundary into the Boundary [GeoJSON] text box.
|
||||
|
||||
Boundary [GeoJSON] Loaded In Task Options
|
||||
""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102196-8f87e4ac-197f-4ce0-ac6f-082772921ea0.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145102196-8f87e4ac-197f-4ce0-ac6f-082772921ea0.webp
|
||||
:alt: Task Options preview showing loaded Boundary with GeoJSON text.
|
||||
|
||||
Once the Boundary [GeoJSON] has been loaded from disk or pasted from the system clipboard, you can confirm its presence by seeing the text in the text box. You can now save the Task Options to enable the Boundary [GeoJSON] for the processing Task.
|
||||
|
|
@ -150,28 +150,28 @@ QGIS
|
|||
|
||||
Creating A New Temporary Scratch Layer
|
||||
"""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109912-9176cd94-1140-43ac-a371-96de2b874ec3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109912-9176cd94-1140-43ac-a371-96de2b874ec3.webp
|
||||
:alt: Choosing the "Create A Temporary Scratch Layer" tool to make an empty layer to create our Boundary [GeoJSON] within.
|
||||
|
||||
You will first need a layer to create your Boundary [GeoJSON] within, so creating a New Temporary Scratch layer is a way to do this without needing to setup a file on disk first.
|
||||
|
||||
New Temporary Scratch Layer Geometry Type
|
||||
""""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109915-ddbfed43-da5e-466b-a4b6-d6ff3b96a555.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109915-ddbfed43-da5e-466b-a4b6-d6ff3b96a555.webp
|
||||
:alt: Setting "Polygon" as the Geometry Type for the Temporary Scratch Layer.
|
||||
|
||||
There are numerous choices of geometry types that can be represented by a given layer. OpenDroneMap is designed to work with Single Polygon, so you will choose Polygon from the Geometry Type menu.
|
||||
|
||||
New Temporary Scratch Layer Settings
|
||||
"""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109917-58b6c147-bdae-45be-839d-5d56b1a22fe8.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109917-58b6c147-bdae-45be-839d-5d56b1a22fe8.webp
|
||||
:alt: Leaving the remaining settings in their Default state.
|
||||
|
||||
Similar to Geometry Types, there are a large number of settings and options you can adjust for a Temporary Scratch Layer. You should leave these at their pictured defaults for usage with OpenDroneMap.
|
||||
|
||||
Adding an Orthophoto Background
|
||||
""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109918-df591ce8-3df4-485d-a775-81813b7e61ef.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109918-df591ce8-3df4-485d-a775-81813b7e61ef.webp
|
||||
:alt: Browsing to a generated Orthophoto from WebODM that covers the Area Of Interest (AOI).
|
||||
|
||||
If you have run the task already without a Boundary [GeoJSON], you can load the generated Orthophoto from OpenDroneMap into QGIS to use as your basemap for creating your Boundary [GeoJSON]. This should ensure that your boundary polygon exactly matches the data in your Task, as different basemaps can have errors of 1-10m or more.
|
||||
|
|
@ -179,35 +179,35 @@ Adding an Orthophoto Background
|
|||
|
||||
Adding A Polyon Feature
|
||||
""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109907-b61afb3c-fdd2-4eef-872a-91f2ea97d887.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109907-b61afb3c-fdd2-4eef-872a-91f2ea97d887.webp
|
||||
:alt: Selecting the "Add A Polygon Feature" tool to begin creating a boundary polygon.
|
||||
|
||||
After selecting the "Add A Polygon Feature" tool, you can begin placing vertices on the map to create your boundary. To finish your polygon, you will right-click on the canvas. Similar to GeoJSON.io, a finished polygon will have a darker outline and a darker fill to indicate that it is "solid".
|
||||
|
||||
Toggle Editing Off
|
||||
"""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109924-42480f63-2cfa-427c-8414-f45d39f796f7.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109924-42480f63-2cfa-427c-8414-f45d39f796f7.webp
|
||||
:alt: Clicking the "Toggle Editing" tool will prompt you to save your changes to the Temporary Scratch Layer.
|
||||
|
||||
Once you are finished with your boundary polygon, you can click the "Toggle Editing" tool to accept your changes and write them out to the Temporary Scratch Layer and make the layer valid for saving/exporting to disk.
|
||||
|
||||
Save Changes To Temporary Scratch Layer
|
||||
""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109921-73ab273a-7180-40ea-ba3d-75ecb65c97f5.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109921-73ab273a-7180-40ea-ba3d-75ecb65c97f5.webp
|
||||
:alt: QGIS Dialog asking you to Save your changes to the Temporary Scratch Layer.
|
||||
|
||||
Clicking Save on this dialog will write the changes to the Temporary Scratch Layer and enable export/save functionality.
|
||||
|
||||
Export Temporary Scratch Layer Features
|
||||
""""""""""""""""""""""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109911-45d7dae3-49ce-40fb-8df0-85a164763810.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109911-45d7dae3-49ce-40fb-8df0-85a164763810.webp
|
||||
:alt: A right-click on the Temporary Scratch Layer in the Layers panel will expose the Export menu item, with the Save Features As sub-menu item.
|
||||
|
||||
Right-click on the Temporary Scratch Layer in the Layers panel to bring up the Export menu and the Save Features As sub-menu item, selecting Save Features As. This will prompt you to choose the export format, location and file name, and settings for your layer.
|
||||
|
||||
Save Vector Layer As
|
||||
"""""""""""""""""""""
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109923-b55dfc1a-5c31-4382-8b1f-3bc6322b0f33.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/145109923-b55dfc1a-5c31-4382-8b1f-3bc6322b0f33.webp
|
||||
:alt: The "Save Vector Layer As" dialog showing Format as GeoJSON, an example of a valid File Name and path, CRS of EPSG:4326 and other default options.
|
||||
|
||||
This dialog will require you to choose GeoJSON as the format, a valid filename and path for the GeoJSON to be written out to disk with, and a valid CRS. The safest CRS choice with GeoJSON is EPSG:4326, so choose that if it is not chosen by default. All other options should be left as default and do not apply for OpenDroneMap usage.
|
||||
|
|
@ -217,35 +217,35 @@ Example Images
|
|||
|
||||
True: ``--boundary [GeoJSON]`` - Point Cloud
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858936-10fda65f-c278-46ae-95bd-7af8f8369554.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858936-10fda65f-c278-46ae-95bd-7af8f8369554.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Point Cloud.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Point Cloud, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - Orthophoto
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859033-c6cab4f0-74b3-4266-b5ec-4a90da931340.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859033-c6cab4f0-74b3-4266-b5ec-4a90da931340.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Orthophoto.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Orthophoto, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - Digital Elevation Model
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859073-28db5174-9a40-42d8-86d6-f345d9dad5a8.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859073-28db5174-9a40-42d8-86d6-f345d9dad5a8.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset Digital Elevation Model.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction Digital Elevation Model, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
True: ``--boundary [GeoJSON]`` - 3D Model/Textured Mesh
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859125-4854e651-9eff-430d-956c-16f4d9a52dfd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140859125-4854e651-9eff-430d-956c-16f4d9a52dfd.webp
|
||||
:alt: WebODM displaying the "clipped" reconstruction of the Brighton Beach dataset 3D Model/Textured Mesh.
|
||||
|
||||
The WebODM 3D View shows the modified extent of the reconstruction 3D Model/Textured Mesh, bounded by the GeoJSON proivded to the ``--boundary`` option.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858712-9bfd8c56-a52a-480e-b68d-d5a97bc516fd.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/140858712-9bfd8c56-a52a-480e-b68d-d5a97bc516fd.webp
|
||||
:alt: WebODM displaying the full reconstruction of the Brighton Beach dataset Point Cloud.
|
||||
|
||||
The WebODM 3D View shows the full extent of the recosntruction. Compared to the ``--boundary`` reconstruction above, one can see that the full reconstruction area is much larger and includes many features outside of the Area Of Interest used to generate the GeoJSON.
|
||||
|
|
|
|||
|
|
@ -46,14 +46,14 @@ Example Images
|
|||
|
||||
True: ``--build-overviews``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127073339-6b2a0a4f-6ede-4dc1-8da4-5bc9646de304.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127073339-6b2a0a4f-6ede-4dc1-8da4-5bc9646de304.webp
|
||||
:alt: QGIS displaying the generated Overviews
|
||||
|
||||
The Layer Properties panel demonstrates that this OpenDroneMap-generated GeoTIFF has internal Overviews.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127074349-a3f84c4c-d05c-4bf1-bd7c-790781ad0fe3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127074349-a3f84c4c-d05c-4bf1-bd7c-790781ad0fe3.webp
|
||||
:alt: QGIS displaying the file is lacking Overviews
|
||||
|
||||
The Layer Properties panel demonstrates that this OpenDroneMap-generated GeoTIFF lacks internal Overviews.
|
||||
|
|
|
|||
|
|
@ -42,21 +42,21 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
|
||||
``auto`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077336-ae79a958-a953-4376-86fd-430d0e5457f2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077336-ae79a958-a953-4376-86fd-430d0e5457f2.webp
|
||||
:alt: Rectilinear data rendered by ``auto`` Camera Lens Model
|
||||
|
||||
This Point Cloud shows a proper reconstruction via the ``auto`` (``brown``) Camera Lens Model, which is appropriate for this sensor.
|
||||
|
||||
``brown`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077753-580a174e-7572-4315-8801-224ce097d9fc.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077753-580a174e-7572-4315-8801-224ce097d9fc.webp
|
||||
:alt: Rectilinear data rendered by ``brown`` Camera Lens Model
|
||||
|
||||
As in the prior example, this Point Cloud is reconstructed via the ``brown`` Camera Lens Model.
|
||||
|
||||
``fisheye`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077826-53d459fe-5e4e-4b10-8e70-fbddf775c4f7.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077826-53d459fe-5e4e-4b10-8e70-fbddf775c4f7.webp
|
||||
:alt: Rectilinear data rendered by ``fisheye`` Camera Lens Model
|
||||
|
||||
In this Point Cloud reconstruction, severe bowling and other artifacts have been introduced via the use of the wrong Camera Lens Model.
|
||||
|
|
@ -64,7 +64,7 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
``perspective`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077485-699f9e61-72a6-45f2-990f-f5748b6ee99f.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127077485-699f9e61-72a6-45f2-990f-f5748b6ee99f.webp
|
||||
:alt: Rectilinear data rendered by ``perspective`` Camera Lens Model
|
||||
|
||||
This Point Cloud rendered well, very similar to the ``auto`` and ``brown`` examples. One may see artifacts in the ``perspective`` Camera Lens Model in very large collections, or over very flat/homogenus terrain (agricultural fields). In such cases, forcing ``brown`` may help.
|
||||
|
|
@ -72,7 +72,7 @@ The following examples are all data taken with a standard Rectilinear Lens. Manu
|
|||
``spherical`` : Rectilinear Data
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127078960-27e35cbb-a378-4d0d-92e2-42dbfd1edd7c.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127078960-27e35cbb-a378-4d0d-92e2-42dbfd1edd7c.webp
|
||||
:alt: Rectilinear data rendered by ``spherical`` Camera Lens Model
|
||||
|
||||
This Point Cloud failed to reconstruct properly due to the manual selection of the ``fisheye`` Camera Lens Model. Similar failures to reconstruct can often indicate the wrong manual selection, or in edge cases, wrong ``auto`` selection of the Camera Lens Model, and you are advised to try another Model that is more appropriate.
|
||||
|
|
|
|||
|
|
@ -41,34 +41,34 @@ Example Images
|
|||
|
||||
True: ``--cog``
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127079824-c85fa5a9-842a-4f28-a380-b6404aac7ef2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127079824-c85fa5a9-842a-4f28-a380-b6404aac7ef2.webp
|
||||
:alt: GDAL Info showing LAYOUT=COG
|
||||
|
||||
The Raster Information tool in QGIS can print information from gdalinfo which can be used to confirm the conformance of a GeoTIFF to the COG spec.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138731905-d10483bd-b91b-4f63-bfb4-89c0f50bf74b.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138731905-d10483bd-b91b-4f63-bfb4-89c0f50bf74b.webp
|
||||
:alt: QGIS Layer Properties showing Internal Overviews
|
||||
|
||||
The Layer Properties panel can show that there are in fact internal overviews. Keep in mind that not every GeoTIFF has internal overviews, but every COG must.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733095-fb5f07ef-fbb0-48f4-8401-25cbf5294b9d.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733095-fb5f07ef-fbb0-48f4-8401-25cbf5294b9d.webp
|
||||
:alt: QGIS Layer Properties showing an on-disk file size of 8.78 MB
|
||||
|
||||
Note that the on-disk file size is 8.78 MB for the COG due to the presence of internal overviews when compared to the 6.30 MB of the non-COG GeoTIFF below.
|
||||
|
||||
False: ``null``
|
||||
^^^^^^^^^^^^^^^
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127080115-7e09ba30-140f-402d-b00a-8bb0c7bc72ff.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/127080115-7e09ba30-140f-402d-b00a-8bb0c7bc72ff.webp
|
||||
:alt: GDAL Info not showing LAYOUT=COG
|
||||
|
||||
The Raster Information tool in QGIS does not show LAYOUT=COG, which indicates that this GeoTIFF does not meet the COG spec.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138732051-d227c98d-10a5-46de-ac99-8c5ffb0a12b2.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138732051-d227c98d-10a5-46de-ac99-8c5ffb0a12b2.webp
|
||||
:alt: QGIS Layer Properties not showing Internal Overviews
|
||||
|
||||
The Layer Properties panel shows that the GeoTIFF lacks all levels of Internal Pyramids.
|
||||
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733132-a9c4f8b4-673a-426b-a665-bde5e89e4de3.png
|
||||
.. figure:: https://user-images.githubusercontent.com/19295950/138733132-a9c4f8b4-673a-426b-a665-bde5e89e4de3.webp
|
||||
:alt: QGIS Layer Properties showing an on-disk file size of 6.30 MB
|
||||
|
||||
Note that the on-disk file size is 6.30 MB for the COG due to the lack of internal overviews when compared to the 8.78 MB of the COG GeoTIFF above.
|
||||
|
|
|
|||
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 208 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 357 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 7.0 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 5.7 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 2.0 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 2.3 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.5 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 1.5 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 6.1 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 5.4 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 5.8 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 5.3 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 12 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 5.9 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 3.4 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 2.6 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 617 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 571 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 131 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 28 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.9 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 1.8 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.8 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 383 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 5.8 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 6.6 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.4 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 2.0 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 30 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 29 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 89 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 63 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 65 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 18 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 18 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 8.1 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 87 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 15 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 2.6 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 379 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 95 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 20 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 99 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 16 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 130 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 27 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.3 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 1.1 MiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 244 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 39 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 122 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 25 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 94 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 22 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 154 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 347 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 1.3 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 268 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 215 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 40 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 406 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 47 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 72 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 12 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 11 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 8.1 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 680 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 78 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 651 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 80 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 620 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 82 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 623 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 79 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 651 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 87 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 316 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 26 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 14 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 9.9 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 44 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 10 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 2.5 MiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 354 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 16 KiB |
Plik binarny nie jest wyświetlany.
|
Po Szerokość: | Wysokość: | Rozmiar: 5.3 KiB |
Plik binarny nie jest wyświetlany.
|
Przed Szerokość: | Wysokość: | Rozmiar: 2.5 MiB |
Some files were not shown because too many files have changed in this diff Show More
Ładowanie…
Reference in New Issue