Skip to content

Run Time Parameters

Dakota Benjamin edited this page Dec 14, 2016 · 12 revisions

There are the following run time parameters that can be used to adjust the results.

usage: run.py [-h] [--project-path <string>] [--resize-to <integer>]
              [--start-with <string>] [--end-with <string>]
              [--rerun <string> | --rerun-all | --rerun-from <string>]
              [--force-focal <positive float>] [--force-ccd <positive float>]
              [--min-num-features <integer>] [--matcher-threshold <percent>]
              [--matcher-ratio <float>] [--matcher-neighbors <integer>]
              [--matcher-distance <integer>] [--use-opensfm-pointcloud]
              [--cmvs-maxImages <integer>] [--pmvs-level <positive integer>]
              [--pmvs-csize < positive integer>]
              [--pmvs-threshold <float: -1.0 <= x <= 1.0>]
              [--pmvs-wsize <positive integer>]
              [--pmvs-minImageNum <positive integer>]
              [--pmvs-num-cores <positive integer>]
              [--odm_meshing-maxVertexCount <positive integer>]
              [--odm_meshing-octreeDepth <positive integer>]
              [--odm_meshing-samplesPerNode <float >= 1.0>]
              [--odm_meshing-solverDivide <positive integer>]
              [--mvs_texturing-dataTerm <string>]
              [--mvs_texturing-outlierRemovalType <string>]
              [--mvs_texturing-skipGeometricVisibilityTest]
              [--mvs_texturing-skipGlobalSeamLeveling]
              [--mvs_texturing-skipLocalSeamLeveling]
              [--mvs_texturing-skipHoleFilling]
              [--mvs_texturing-keepUnseenFaces]
              [--odm_texturing-textureResolution <positive integer>]
              [--odm_texturing-textureWithSize <positive integer>]
              [--odm_georeferencing-gcpFile <path string>]
              [--odm_georeferencing-useGcp]
              [--odm_orthophoto-resolution <float > 0.0>] [--zip-results]
              [--time]

OpenDroneMap

optional arguments:
  -h, --help            show this help message and exit
  --project-path <string>
                        Path to the project to process
  --resize-to <integer>
                        resizes images by the largest side
  --start-with <string>, -s <string>
                        Can be one of: resize | opensfm | cmvs | pmvs |
                        odm_meshing | mvs_texturing | odm_georeferencing |
                        odm_orthophoto
  --end-with <string>, -e <string>
                        Can be one of:resize | opensfm | cmvs | pmvs |
                        odm_meshing | mvs_texturing | odm_georeferencing |
                        odm_orthophoto
  --rerun <string>, -r <string>
                        Can be one of:resize | opensfm | cmvs | pmvs |
                        odm_meshing | mvs_texturing | odm_georeferencing |
                        odm_orthophoto
  --rerun-all           force rerun of all tasks
  --rerun-from <string>
                        Can be one of:resize | opensfm | cmvs | pmvs |
                        odm_meshing | mvs_texturing | odm_georeferencing |
                        odm_orthophoto
  --force-focal <positive float>
                        Override the focal length information for the images
  --force-ccd <positive float>
                        Override the ccd width information for the images
  --min-num-features <integer>
                        Minimum number of features to extract per image. More
                        features leads to better results but slower execution.
                        Default: 4000
  --matcher-threshold <percent>
                        Ignore matched keypoints if the two images share less
                        than <float> percent of keypoints. Default: 2.0
  --matcher-ratio <float>
                        Ratio of the distance to the next best matched
                        keypoint. Default: 0.6
  --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 to 0 to skip pre-
                        matching. Default: 0
  --use-opensfm-pointcloud
                        Use OpenSfM to compute the point cloud instead of PMVS
  --cmvs-maxImages <integer>
                        The maximum number of images per cluster. Default: 500
  --pmvs-level <positive integer>
                        The level in the image pyramid that is used for the
                        computation. see
                        http://www.di.ens.fr/pmvs/documentation.html for more
                        pmvs documentation. Default: 1
  --pmvs-csize < positive integer>
                        Cell size controls the density of
                        reconstructionsDefault: 2
  --pmvs-threshold <float: -1.0 <= x <= 1.0>
                        A patch reconstruction is accepted as a success and
                        kept if its associated photometric consistency measure
                        is above this threshold. Default: 0.7
  --pmvs-wsize <positive integer>
                        pmvs samples wsize x wsize pixel colors from each
                        image to compute photometric consistency score. For
                        example, when wsize=7, 7x7=49 pixel colors are sampled
                        in each image. Increasing the value leads to more
                        stable reconstructions, but the program becomes
                        slower. Default: 7
  --pmvs-minImageNum <positive integer>
                        Each 3D point must be visible in at least minImageNum
                        images for being reconstructed. 3 is suggested in
                        general. Default: 3
  --pmvs-num-cores <positive integer>
                        The maximum number of cores to use in dense
                        reconstruction. Default: 16
  --odm_meshing-maxVertexCount <positive integer>
                        The maximum vertex count of the output mesh Default:
                        100000
  --odm_meshing-octreeDepth <positive integer>
                        Oct-tree depth used in the mesh reconstruction,
                        increase to get more vertices, recommended values are
                        8-12. Default: 9
  --odm_meshing-samplesPerNode <float >= 1.0>
                        Number of points per octree node, recommended and
                        default value: 1.0
  --odm_meshing-solverDivide <positive integer>
                        Oct-tree depth at which the Laplacian equation is
                        solved in the surface reconstruction step. Increasing
                        this value increases computation times slightly but
                        helps reduce memory usage. Default: 9
  --mvs_texturing-dataTerm <string>
                        Data term: [area, gmi]. Default: gmi
  --mvs_texturing-outlierRemovalType <string>
                        Type of photometric outlier removal method: [none,
                        gauss_damping, gauss_clamping]. Default: none
  --mvs_texturing-skipGeometricVisibilityTest
                        Skip geometric visibility test. Default: False
  --mvs_texturing-skipGlobalSeamLeveling
                        Skip geometric visibility test. Default: False
  --mvs_texturing-skipLocalSeamLeveling
                        Skip local seam blending. Default: False
  --mvs_texturing-skipHoleFilling
                        Skip filling of holes in the mesh. Default: False
  --mvs_texturing-keepUnseenFaces
                        Keep faces in the mesh that are not seen in any
                        camera. Default: False
  --odm_texturing-textureResolution <positive integer>
                        The resolution of the output textures. Must be greater
                        than textureWithSize. Default: 4096
  --odm_texturing-textureWithSize <positive integer>
                        The resolution to rescale the images performing the
                        texturing. Default: 3600
  --odm_georeferencing-gcpFile <path string>
                        path to the file containing the ground control points
                        used for georeferencing. Default: gcp_list.txt. The
                        file needs to be on the following line format: easting
                        northing height pixelrow pixelcol imagename
  --odm_georeferencing-useGcp
                        Enabling GCPs from the file above. The GCP file is not
                        used by default.
  --odm_orthophoto-resolution <float > 0.0>
                        Orthophoto ground resolution in pixels/meterDefault:
                        20.0
  --zip-results         compress the results using gunzip
  --time                Generates a benchmark file with runtime info Default:
                        False

More documentation on cmvs and pmvs available here:
http://www.di.ens.fr/cmvs/documentation.html
http://www.di.ens.fr/pmvs/documentation.html