meshroom.nodes.aliceVision.FeatureMatching.FeatureMatching

Inheritance diagram of meshroom.nodes.aliceVision.FeatureMatching.FeatureMatching

Category: Sparse Reconstruction

This node performs the matching of all features between the candidate image pairs.

It is performed in 2 steps:

1/ Photometric Matches

It performs the photometric matches between the set of features descriptors from the 2 input images. For each feature descriptor on the first image, it looks for the 2 closest descriptors in the second image and uses a relative threshold between them. This assumption kill features on repetitive structure but has proved to be a robust criterion.

2/ Geometric Filtering

It performs a geometric filtering of the photometric match candidates. It uses the features positions in the images to make a geometric filtering by using epipolar geometry in an outlier detection framework called RANSAC (RANdom SAmple Consensus). It randomly selects a small set of feature correspondences and compute the fundamental (or essential) matrix, then it checks the number of features that validates this model and iterate through the RANSAC framework.

Online

https://alicevision.org/#photogrammetry/feature_matching

Inputs:

  • input (File)

  • featuresFolders (ListAttribute)

  • imagePairsList (File)

  • describerTypes (ChoiceParam)

  • photometricMatchingMethod (ChoiceParam)

  • geometricEstimator (ChoiceParam)

  • geometricFilterType (ChoiceParam)

  • distanceRatio (FloatParam)

  • maxIteration (IntParam)

  • geometricError (FloatParam)

  • knownPosesGeometricErrorMax (FloatParam)

  • minRequired2DMotion (FloatParam)

  • maxMatches (IntParam)

  • savePutativeMatches (BoolParam)

  • crossMatching (BoolParam)

  • guidedMatching (BoolParam)

  • matchFromKnownCameraPoses (BoolParam)

  • exportDebugFiles (BoolParam)

  • verboseLevel (ChoiceParam)

Outputs:

  • output (File)

class meshroom.nodes.aliceVision.FeatureMatching.FeatureMatching
__init__()

Methods

__init__()

buildCommandLine(chunk)

postUpdate(node)

Method call after node's internal update on invalidation.

processChunk(chunk)

stopProcess(chunk)

update(node)

Method call before node's internal update on invalidation.

upgradeAttributeValues(attrValues, fromVersion)

Attributes

category

cgroupParsed

cmdCore

cmdMem

commandLine

commandLineRange

cpu

documentation

gpu

inputs

internalFolder

internalInputs

outputs

packageName

packageVersion

parallelization

ram

size