/* * Software License Agreement (BSD License) * * Point Cloud Library (PCL) - www.pointclouds.org * Copyright (c) 2009, Willow Garage, Inc. * Copyright (c) 2012-, Open Perception, Inc. * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following * disclaimer in the documentation and/or other materials provided * with the distribution. * * Neither the name of the copyright holder(s) nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * * */ #pragma once #include #include #include namespace pcl { /** \brief SHOTEstimationOMP estimates the Signature of Histograms of OrienTations (SHOT) descriptor for a given point cloud dataset * containing points and normals, in parallel, using the OpenMP standard. * * The suggested PointOutT is pcl::SHOT352. * * \note If you use this code in any academic work, please cite: * * - F. Tombari, S. Salti, L. Di Stefano * Unique Signatures of Histograms for Local Surface Description. * In Proceedings of the 11th European Conference on Computer Vision (ECCV), * Heraklion, Greece, September 5-11 2010. * - F. Tombari, S. Salti, L. Di Stefano * A Combined Texture-Shape Descriptor For Enhanced 3D Feature Matching. * In Proceedings of the 18th International Conference on Image Processing (ICIP), * Brussels, Belgium, September 11-14 2011. * * \author Samuele Salti * \ingroup features */ template class SHOTEstimationOMP : public SHOTEstimation { public: using Ptr = shared_ptr >; using ConstPtr = shared_ptr >; using Feature::feature_name_; using Feature::getClassName; using Feature::input_; using Feature::indices_; using Feature::k_; using Feature::search_parameter_; using Feature::search_radius_; using Feature::surface_; using Feature::fake_surface_; using FeatureFromNormals::normals_; using FeatureWithLocalReferenceFrames::frames_; using SHOTEstimationBase::lrf_radius_; using SHOTEstimation::descLength_; using SHOTEstimation::nr_grid_sector_; using SHOTEstimation::nr_shape_bins_; using SHOTEstimation::sqradius_; using SHOTEstimation::radius3_4_; using SHOTEstimation::radius1_4_; using SHOTEstimation::radius1_2_; using PointCloudOut = typename Feature::PointCloudOut; using PointCloudIn = typename Feature::PointCloudIn; /** \brief Empty constructor. */ SHOTEstimationOMP (unsigned int nr_threads = 0) : SHOTEstimation () { setNumberOfThreads(nr_threads); }; /** \brief Initialize the scheduler and set the number of threads to use. * \param nr_threads the number of hardware threads to use (0 sets the value back to automatic) */ void setNumberOfThreads (unsigned int nr_threads = 0); protected: /** \brief Estimate the Signatures of Histograms of OrienTations (SHOT) descriptors at a set of points given by * using the surface in setSearchSurface () and the spatial locator in * setSearchMethod () * \param output the resultant point cloud model dataset that contains the SHOT feature estimates */ void computeFeature (PointCloudOut &output) override; /** \brief This method should get called before starting the actual computation. */ bool initCompute () override; /** \brief The number of threads the scheduler should use. */ unsigned int threads_; }; /** \brief SHOTColorEstimationOMP estimates the Signature of Histograms of OrienTations (SHOT) descriptor for a given point cloud dataset * containing points, normals and colors, in parallel, using the OpenMP standard. * * The suggested PointOutT is pcl::SHOT1344. * * \note If you use this code in any academic work, please cite: * * - F. Tombari, S. Salti, L. Di Stefano * Unique Signatures of Histograms for Local Surface Description. * In Proceedings of the 11th European Conference on Computer Vision (ECCV), * Heraklion, Greece, September 5-11 2010. * - F. Tombari, S. Salti, L. Di Stefano * A Combined Texture-Shape Descriptor For Enhanced 3D Feature Matching. * In Proceedings of the 18th International Conference on Image Processing (ICIP), * Brussels, Belgium, September 11-14 2011. * * \author Samuele Salti * \ingroup features */ template class SHOTColorEstimationOMP : public SHOTColorEstimation { public: using Ptr = shared_ptr >; using ConstPtr = shared_ptr >; using Feature::feature_name_; using Feature::getClassName; using Feature::input_; using Feature::indices_; using Feature::k_; using Feature::search_parameter_; using Feature::search_radius_; using Feature::surface_; using Feature::fake_surface_; using FeatureFromNormals::normals_; using FeatureWithLocalReferenceFrames::frames_; using SHOTEstimationBase::lrf_radius_; using SHOTColorEstimation::descLength_; using SHOTColorEstimation::nr_grid_sector_; using SHOTColorEstimation::nr_shape_bins_; using SHOTColorEstimation::sqradius_; using SHOTColorEstimation::radius3_4_; using SHOTColorEstimation::radius1_4_; using SHOTColorEstimation::radius1_2_; using SHOTColorEstimation::b_describe_shape_; using SHOTColorEstimation::b_describe_color_; using SHOTColorEstimation::nr_color_bins_; using PointCloudOut = typename Feature::PointCloudOut; using PointCloudIn = typename Feature::PointCloudIn; /** \brief Empty constructor. */ SHOTColorEstimationOMP (bool describe_shape = true, bool describe_color = true, unsigned int nr_threads = 0) : SHOTColorEstimation (describe_shape, describe_color) { setNumberOfThreads(nr_threads); } /** \brief Initialize the scheduler and set the number of threads to use. * \param nr_threads the number of hardware threads to use (0 sets the value back to automatic) */ void setNumberOfThreads (unsigned int nr_threads = 0); protected: /** \brief Estimate the Signatures of Histograms of OrienTations (SHOT) descriptors at a set of points given by * using the surface in setSearchSurface () and the spatial locator in * setSearchMethod () * \param output the resultant point cloud model dataset that contains the SHOT feature estimates */ void computeFeature (PointCloudOut &output) override; /** \brief This method should get called before starting the actual computation. */ bool initCompute () override; /** \brief The number of threads the scheduler should use. */ unsigned int threads_; }; } #ifdef PCL_NO_PRECOMPILE #include #endif