kopia lustrzana https://github.com/OpenDroneMap/docs
commit
068672a5d9
|
@ -6,34 +6,44 @@ 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
|
||||
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
|
||||
|
@ -68,71 +78,87 @@ Arguments::
|
|||
compensates for spectral radiance registered via a
|
||||
downwelling light sensor (DLS) taking in consideration
|
||||
the angle of the sun. Can be set to one of: [none,
|
||||
camera, camera+sun]. Default: none
|
||||
camera, camera+sun].
|
||||
Default: none
|
||||
|
||||
--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
|
||||
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.
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
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
|
||||
|
@ -140,93 +166,117 @@ Arguments::
|
|||
results of the original (unscreened) Poisson
|
||||
Reconstruction can be obtained by setting this value
|
||||
to 0.
|
||||
Default: 4
|
||||
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
|
||||
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
|
||||
Default: 2.5
|
||||
|
||||
--smrf-scalar <positive float>
|
||||
Simple Morphological Filter elevation scalar
|
||||
parameter.
|
||||
Default: 1.25
|
||||
Default: 1.25
|
||||
|
||||
--smrf-slope <positive float>
|
||||
Simple Morphological Filter slope parameter (rise over
|
||||
run).
|
||||
Default: 0.15
|
||||
Default: 0.15
|
||||
|
||||
--smrf-threshold <positive float>
|
||||
Simple Morphological Filter elevation threshold
|
||||
parameter (meters).
|
||||
Default: 0.5
|
||||
Default: 0.5
|
||||
|
||||
--smrf-window <positive float>
|
||||
Simple Morphological Filter window radius parameter
|
||||
(meters).
|
||||
Default: 18.0
|
||||
Default: 18.0
|
||||
|
||||
--texturing-data-term <string>
|
||||
Data term: [area, gmi].
|
||||
Default: 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
|
||||
Default: 16
|
||||
|
||||
--texturing-outlier-removal-type <string>
|
||||
Type of photometric outlier removal method: [none,
|
||||
gauss_damping, gauss_clamping].
|
||||
Default: gauss_clamping
|
||||
Default: gauss_clamping
|
||||
|
||||
--texturing-skip-visibility-test
|
||||
Skip geometric visibility test.
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--texturing-skip-global-seam-leveling
|
||||
Skip global seam leveling. Useful for IR data.
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--texturing-skip-local-seam-leveling
|
||||
Skip local seam blending.
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--texturing-skip-hole-filling
|
||||
Skip filling of holes in the mesh.
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--texturing-keep-unseen-faces
|
||||
Keep faces in the mesh that are not seen in any
|
||||
camera.
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--texturing-tone-mapping <string>
|
||||
Turn on gamma tone mapping or none for no tone
|
||||
mapping. Choices are 'gamma' or 'none'.
|
||||
Default: 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
|
||||
|
@ -235,32 +285,39 @@ Arguments::
|
|||
inverse distance weighted (IDW) algorithm and merged
|
||||
together. Remaining gaps are then merged using nearest
|
||||
neighbor interpolation.
|
||||
Default: 3
|
||||
Default: 3
|
||||
|
||||
--dem-resolution <float>
|
||||
DSM/DTM resolution in cm / pixel.
|
||||
Default: 5
|
||||
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
|
||||
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
|
||||
Default: False
|
||||
|
||||
--orthophoto-resolution <float > 0.0>
|
||||
Orthophoto resolution in cm / pixel.
|
||||
Default: 5
|
||||
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
|
||||
|
@ -268,33 +325,52 @@ Arguments::
|
|||
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
|
||||
Default: False
|
||||
|
||||
--build-overviews Build orthophoto overviews using gdaladdo.
|
||||
|
||||
--verbose, -v Print additional messages to the console
|
||||
Default: False
|
||||
Default: False
|
||||
|
||||
--time Generates a benchmark file with runtime info
|
||||
Default: False
|
||||
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.
|
||||
|
||||
--optimize-disk-space
|
||||
Delete heavy intermediate files (such as original orthos, dtm, dsm)
|
||||
to optimize disk space usage, while keeping the compressed versions.
|
||||
This affects the ability to restart the pipeline from an intermediate
|
||||
stage, but allows datasets to be processed on machines that don't have
|
||||
sufficient disk space available. Also, in this mode, the "reports" does
|
||||
not get written under the output 'opensfm' folder.
|
||||
Default: False
|
||||
|
||||
--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
|
||||
|
||||
--merge <string>
|
||||
Choose what to merge in the merge step in a split
|
||||
dataset. By default all available outputs are merged.
|
||||
Default: all
|
||||
|
||||
|
|
Ładowanie…
Reference in New Issue