// ---------------------------------------------------------------------------- // - Open3D: www.open3d.org - // ---------------------------------------------------------------------------- // Copyright (c) 2018-2023 www.open3d.org // SPDX-License-Identifier: MIT // ---------------------------------------------------------------------------- #pragma once #include #include #include #include #include "open3d/pipelines/registration/TransformationEstimation.h" #include "open3d/utility/Optional.h" namespace open3d { namespace geometry { class PointCloud; } namespace pipelines { namespace registration { class Feature; class RegistrationResult; /// \class FastGlobalRegistrationOption /// /// \brief Options for FastGlobalRegistration. class FastGlobalRegistrationOption { public: /// \brief Parameterized Constructor. /// /// \param division_factor Division factor used for graduated non-convexity. /// \param use_absolute_scale Measure distance in absolute scale (1) or in /// scale relative to the diameter of the model (0). /// \param decrease_mu Set /// to `true` to decrease scale mu by division_factor for graduated /// non-convexity. /// \param maximum_correspondence_distance Maximum /// correspondence distance (also see comment of USE_ABSOLUTE_SCALE). /// \param iteration_number Maximum number of iterations. /// \param tuple_scale Similarity measure used for tuples of feature points. /// \param maximum_tuple_count Maximum numer of tuples. /// \param tuple_test Set to `true` to perform geometric compatibility tests /// on initial set of correspondences. FastGlobalRegistrationOption(double division_factor = 1.4, bool use_absolute_scale = false, bool decrease_mu = true, double maximum_correspondence_distance = 0.025, int iteration_number = 64, double tuple_scale = 0.95, int maximum_tuple_count = 1000, bool tuple_test = true) : division_factor_(division_factor), use_absolute_scale_(use_absolute_scale), decrease_mu_(decrease_mu), maximum_correspondence_distance_(maximum_correspondence_distance), iteration_number_(iteration_number), tuple_scale_(tuple_scale), maximum_tuple_count_(maximum_tuple_count), tuple_test_(tuple_test) {} ~FastGlobalRegistrationOption() {} public: /// Division factor used for graduated non-convexity. double division_factor_; /// Measure distance in absolute scale (1) or in scale relative to the /// diameter of the model (0). bool use_absolute_scale_; /// Set to `true` to decrease scale mu by division_factor for graduated /// non-convexity. bool decrease_mu_; /// Maximum correspondence distance (also see comment of /// USE_ABSOLUTE_SCALE). double maximum_correspondence_distance_; /// Maximum number of iterations. int iteration_number_; /// Similarity measure used for tuples of feature points. double tuple_scale_; /// Maximum number of tuples.. int maximum_tuple_count_; /// Set to `true` to perform geometric compatibility tests on initial set of /// correspondences. bool tuple_test_; }; /// \brief Fast Global Registration based on a given set of correspondences. /// /// \param source The source point cloud. /// \param target The target point cloud. /// \param corres Correspondence indices between source and target point clouds. /// \param option FGR options RegistrationResult FastGlobalRegistrationBasedOnCorrespondence( const geometry::PointCloud &source, const geometry::PointCloud &target, const CorrespondenceSet &corres, const FastGlobalRegistrationOption &option = FastGlobalRegistrationOption()); /// \brief Fast Global Registration based on a given set of FPFH features. /// /// \param source The source point cloud. /// \param target The target point cloud. /// \param corres Correspondence indices between source and target point clouds. /// \param option FGR options RegistrationResult FastGlobalRegistrationBasedOnFeatureMatching( const geometry::PointCloud &source, const geometry::PointCloud &target, const Feature &source_feature, const Feature &target_feature, const FastGlobalRegistrationOption &option = FastGlobalRegistrationOption()); } // namespace registration } // namespace pipelines } // namespace open3d