kopia lustrzana https://github.com/OpenDroneMap/docs
290 wiersze
15 KiB
ReStructuredText
290 wiersze
15 KiB
ReStructuredText
.. _arguments:
|
|
|
|
Options and Flags
|
|
-----------------
|
|
|
|
Arguments::
|
|
|
|
-h, --help show this help message and exit
|
|
--images <path>, -i <path>
|
|
Path to input images
|
|
--project-path <path>
|
|
Path to the project folder
|
|
--resize-to <integer>
|
|
resizes images by the largest side for opensfm. Set to
|
|
-1 to disable.
|
|
Default: 2048
|
|
--end-with <string>, -e <string>
|
|
Can be one of:dataset | split | merge | opensfm | mve
|
|
| odm_filterpoints | odm_meshing | mvs_texturing |
|
|
odm_georeferencing | odm_dem | odm_orthophoto
|
|
--rerun <string>, -r <string>
|
|
Can be one of:dataset | split | merge | opensfm | mve
|
|
| odm_filterpoints | odm_meshing | mvs_texturing |
|
|
odm_georeferencing | odm_dem | odm_orthophoto
|
|
--rerun-all force rerun of all tasks
|
|
--rerun-from <string>
|
|
Can be one of:dataset | split | merge | opensfm | mve
|
|
| odm_filterpoints | odm_meshing | mvs_texturing |
|
|
odm_georeferencing | odm_dem | odm_orthophoto
|
|
--proj <PROJ4 string>
|
|
Projection used to transform the model into geographic
|
|
coordinates
|
|
--min-num-features <integer>
|
|
Minimum number of features to extract per image. More
|
|
features leads to better results but slower execution.
|
|
Default: 8000
|
|
--matcher-neighbors <integer>
|
|
Number of nearest images to pre-match based on GPS
|
|
exif data. Set to 0 to skip pre-matching. Neighbors
|
|
works together with Distance parameter, set both to 0
|
|
to not use pre-matching. OpenSFM uses both parameters
|
|
at the same time, Bundler uses only one which has
|
|
value, prefering the Neighbors parameter.
|
|
Default: 8
|
|
--matcher-distance <integer>
|
|
Distance threshold in meters to find pre-matching
|
|
images based on GPS exif data. Set both matcher-
|
|
neighbors and this to 0 to skip pre-matching.
|
|
Default: 0
|
|
--use-fixed-camera-params
|
|
Turn off camera parameter optimization during bundler
|
|
Off by default unless --camera parameter used
|
|
--camera-lens <string>
|
|
Can be one of auto | perspective | brown | fisheye | spherical
|
|
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: auto
|
|
--max-concurrency <positive integer>
|
|
The maximum number of processes to use in various
|
|
processes. Peak memory requirement is ~1GB per thread
|
|
and 2 megapixel image resolution.
|
|
Default: number of cores
|
|
--depthmap-resolution <positive float>
|
|
Controls the density of the point cloud by setting the
|
|
resolution of the depthmap images. Higher values take
|
|
longer to compute and more memory but produce denser
|
|
point clouds.
|
|
Default: 640
|
|
--opensfm-depthmap-min-consistent-views <integer: 2 <= x <= 9>
|
|
Minimum number of views that should reconstruct a
|
|
point for it to be valid. Use lower values if your
|
|
images have less overlap. Lower values result in
|
|
denser point clouds but with more noise. Only applies
|
|
if using OpenSfM for dense matching.
|
|
Default: 3
|
|
--opensfm-depthmap-method <string>
|
|
Raw depthmap computation algorithm. PATCH_MATCH and
|
|
PATCH_MATCH_SAMPLE are faster, but might miss some
|
|
valid points. BRUTE_FORCE takes longer but produces
|
|
denser reconstructions.
|
|
Default: PATCH_MATCH
|
|
--opensfm-depthmap-min-patch-sd <positive float>
|
|
When using PATCH_MATCH or PATCH_MATCH_SAMPLE, controls
|
|
the standard deviation threshold to include patches.
|
|
Patches with lower standard deviation are ignored.
|
|
Default: 1
|
|
--use-hybrid-bundle-adjustment
|
|
Run local bundle adjustment for every image added to
|
|
the reconstruction and a global adjustment every 100
|
|
images. Speeds up reconstruction for very large
|
|
datasets.
|
|
--mve-confidence <float: 0 <= x <= 1>
|
|
Discard points that have less than a certain
|
|
confidence threshold. This only affects dense
|
|
reconstructions performed with MVE. Higher values
|
|
discard more points.
|
|
Default: 0.6
|
|
--use-3dmesh Use a full 3D mesh to compute the orthophoto instead
|
|
of a 2.5D mesh. This option is a bit faster and
|
|
provides similar results in planar areas.
|
|
--skip-3dmodel Skip generation of a full 3D model. This can save time
|
|
if you only need 2D results such as orthophotos and
|
|
DEMs.
|
|
--use-opensfm-dense Use opensfm to compute dense point cloud alternatively
|
|
--ignore-gsd Ignore Ground Sampling Distance (GSD). GSD caps the
|
|
maximum resolution of image outputs and resizes images
|
|
when necessary, resulting in faster processing and
|
|
lower memory usage. Since GSD is an estimate,
|
|
sometimes ignoring it can result in slightly better
|
|
image output quality.
|
|
--mesh-size <positive integer>
|
|
The maximum vertex count of the output mesh.
|
|
Default: 100000
|
|
--mesh-octree-depth <positive integer>
|
|
Oct-tree depth used in the mesh reconstruction,
|
|
increase to get more vertices, recommended values are
|
|
8-12.
|
|
Default: 9
|
|
--mesh-samples <float >= 1.0>
|
|
Number of points per octree node, recommended and
|
|
Default: 1.0
|
|
--mesh-point-weight <positive float>
|
|
This floating point value specifies the importance
|
|
that interpolation of the point samples is given in
|
|
the formulation of the screened Poisson equation. The
|
|
results of the original (unscreened) Poisson
|
|
Reconstruction can be obtained by setting this value
|
|
to 0.
|
|
Default: 4
|
|
--fast-orthophoto Skips dense reconstruction and 3D model generation. It
|
|
generates an orthophoto directly from the sparse
|
|
reconstruction. If you just need an orthophoto and do
|
|
not need a full 3D model, turn on this option.
|
|
Experimental.
|
|
--crop <positive float>
|
|
Automatically crop image outputs by creating a smooth
|
|
buffer around the dataset boundaries, shrinked by N
|
|
meters. Use 0 to disable cropping.
|
|
Default: 3
|
|
--pc-classify Classify the point cloud outputs using a Simple
|
|
Morphological Filter. You can control the behavior of
|
|
this option by tweaking the --dem-* parameters.
|
|
Default: False
|
|
--pc-csv Export the georeferenced point cloud in CSV format.
|
|
Default: False
|
|
--pc-las Export the georeferenced point cloud in LAS format.
|
|
Default: False
|
|
--pc-filter <positive float>
|
|
Filters the point cloud by removing points that
|
|
deviate more than N standard deviations from the local
|
|
mean. Set to 0 to disable filtering.
|
|
Default: 2.5
|
|
--smrf-scalar <positive float>
|
|
Simple Morphological Filter elevation scalar
|
|
parameter.
|
|
Default: 1.25
|
|
--smrf-slope <positive float>
|
|
Simple Morphological Filter slope parameter (rise over
|
|
run).
|
|
Default: 0.15
|
|
--smrf-threshold <positive float>
|
|
Simple Morphological Filter elevation threshold
|
|
parameter (meters).
|
|
Default: 0.5
|
|
--smrf-window <positive float>
|
|
Simple Morphological Filter window radius parameter
|
|
(meters).
|
|
Default: 18.0
|
|
--texturing-data-term <string>
|
|
Data term: [area, gmi].
|
|
Default: gmi
|
|
--texturing-nadir-weight <integer: 0 <= x <= 32>
|
|
Affects orthophotos only. Higher values result in
|
|
sharper corners, but can affect color distribution and
|
|
blurriness. Use lower values for planar areas and
|
|
higher values for urban areas. The default value works
|
|
well for most scenarios.
|
|
Default: 16
|
|
--texturing-outlier-removal-type <string>
|
|
Type of photometric outlier removal method: [none,
|
|
gauss_damping, gauss_clamping].
|
|
Default: gauss_clamping
|
|
--texturing-skip-visibility-test
|
|
Skip geometric visibility test.
|
|
Default: False
|
|
--texturing-skip-global-seam-leveling
|
|
Skip global seam leveling. Useful for IR data.
|
|
Default: False
|
|
--texturing-skip-local-seam-leveling
|
|
Skip local seam blending.
|
|
Default: False
|
|
--texturing-skip-hole-filling
|
|
Skip filling of holes in the mesh.
|
|
Default: False
|
|
--texturing-keep-unseen-faces
|
|
Keep faces in the mesh that are not seen in any
|
|
camera.
|
|
Default: False
|
|
--texturing-tone-mapping <string>
|
|
Turn on gamma tone mapping or none for no tone
|
|
mapping. Choices are 'gamma' or 'none'.
|
|
Default: none
|
|
--gcp <path string> path to the file containing the ground control points
|
|
used for georeferencing. Default: None. The file needs
|
|
to be on the following line format: easting northing
|
|
height pixelrow pixelcol imagename
|
|
--use-exif Use this tag if you have a gcp_list.txt but want to
|
|
use the exif geotags instead
|
|
--dtm Use this tag to build a DTM (Digital Terrain Model,
|
|
ground only) using a simple morphological filter.
|
|
Check the --dem* and --smrf* parameters for finer
|
|
tuning.
|
|
--dsm Use this tag to build a DSM (Digital Surface Model,
|
|
ground + objects) using a progressive morphological
|
|
filter. Check the --dem* parameters for finer tuning.
|
|
--dem-gapfill-steps <positive integer>
|
|
Number of steps used to fill areas with gaps. Set to 0
|
|
to disable gap filling. Starting with a radius equal
|
|
to the output resolution, N different DEMs are
|
|
generated with progressively bigger radius using the
|
|
inverse distance weighted (IDW) algorithm and merged
|
|
together. Remaining gaps are then merged using nearest
|
|
neighbor interpolation.
|
|
Default: 3
|
|
--dem-resolution <float>
|
|
DSM/DTM resolution in cm / pixel.
|
|
Default: 5
|
|
--dem-decimation <positive integer>
|
|
Decimate the points before generating the DEM. 1 is no
|
|
decimation (full quality). 100 decimates ~99% of the
|
|
points. Useful for speeding up generation.
|
|
Default: 1
|
|
--dem-euclidean-map Computes an euclidean raster map for each DEM. The map
|
|
reports the distance from each cell to the nearest
|
|
NODATA value (before any hole filling takes place).
|
|
This can be useful to isolate the areas that have been
|
|
filled.
|
|
Default: False
|
|
--orthophoto-resolution <float > 0.0>
|
|
Orthophoto resolution in cm / pixel.
|
|
Default: 5
|
|
--orthophoto-no-tiled
|
|
Set this parameter if you want a stripped geoTIFF.
|
|
Default: False
|
|
--orthophoto-compression <string>
|
|
Set the compression to use. Note that this could break
|
|
gdal_translate if you don't know what you are doing.
|
|
Options: JPEG, LZW, PACKBITS, DEFLATE, LZMA, NONE.
|
|
Default: DEFLATE
|
|
--orthophoto-bigtiff {YES,NO,IF_NEEDED,IF_SAFER}
|
|
Control whether the created orthophoto is a BigTIFF or
|
|
classic TIFF. BigTIFF is a variant for files larger
|
|
than 4GiB of data. Options are YES, NO, IF_NEEDED,
|
|
IF_SAFER. See GDAL specs:
|
|
https://www.gdal.org/frmt_gtiff.html for more info.
|
|
Default: IF_SAFER
|
|
--orthophoto-cutline Generates a polygon around the cropping area that cuts
|
|
the orthophoto around the edges of features. This
|
|
polygon can be useful for stitching seamless mosaics
|
|
with multiple overlapping orthophotos.
|
|
Default: False
|
|
--build-overviews Build orthophoto overviews using gdaladdo.
|
|
--verbose, -v Print additional messages to the console
|
|
Default: False
|
|
--time Generates a benchmark file with runtime info
|
|
Default: False
|
|
--version Displays version number and exits.
|
|
--split <positive integer>
|
|
Average number of images per submodel. When splitting
|
|
a large dataset into smaller submodels, images are
|
|
grouped into clusters. This value regulates the number
|
|
of images that each cluster should have on average.
|
|
--split-overlap <positive integer>
|
|
Radius of the overlap between submodels. After
|
|
grouping images into clusters, images that are closer
|
|
than this radius to a cluster are added to the
|
|
cluster. This is done to ensure that neighboring
|
|
submodels overlap.
|
|
--sm-cluster <string>
|
|
URL to a ClusterODM instance for distributing a
|
|
split-merge workflow on multiple nodes in parallel.
|
|
Default: None
|
|
--merge <string> Choose what to merge in the merge step in a split
|
|
dataset. By default all available outputs are merged.
|
|
Default: all
|
|
|
|
|
|
`Help edit these docs! <https://github.com/OpenDroneMap/docs/blob/publish/source/using.rst>`_
|