Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
The default parameters are optimal for most datasets. Also many parameters are exposed for research & development purposes and are not useful for users. A subset of them can be useful for advanced users to improve the quality on specific datasets.
The first thing is to verify the number of reconstructed cameras from your input images. If a significant number are not reconstructed, you should focus on the options of the sparse reconstruction.
HighIf your dataset is not big (<300 images), you can us
Highpreset. It will take more time for the
StuctureFromMotionnode but it may help to recover more cameras. If you have really few images (like <50 images), you can also try
Ultrawhich may improve or decrease the quality depending on the image content.
Guided MatchingThis option enables a second stage in the matching procedure. After matching descriptor (with a global distance ratio test) and a first geometric filtering, we retrieve a geometric transformation. The guided-matching use this geometric information to perform the descriptors matching a second time but with a new constraint to limit the search. This geometry-aware approach prevents early rejection and improves the number of matches in particular with repetitive structures.
StructureFromMotionnodes It may improve especially on some surfaces (like skin for instance). It is also more affine invariant than SIFT and can help to recover connections when you have not enough images in input.
DepthMapnode If the resolution of your images is not too high, you can change the `Downscale' setting to 1, but be careful, the calculation will be ~4x longer.
DepthMapFilternode If you input images are not dense enough or too blurry and you have too many holes in your output. It may be useful to relax the
Min Consistent Camerasand
Min Consistent Cameras Bad Similarityto 2 and 3 respectively.
Meshingnode If you have less than 16G of RAM, you will need to reduce the
Max Pointsto fit your RAM limits. You may also augment it, to recover a more dense/precise mesh.
Filter Large Triangles Factorcan be adjusted to avoid holes or on the other side to limit the number of large triangles.
Keep Only The Largest Mesh: Disable this option if you want to retrieve unconnected fragments that may be useful.
Texturingnode You can change the
Texture Downscaleto 1 to improve the texture resolution.