forked from symao/libicp
-
Notifications
You must be signed in to change notification settings - Fork 1
OpenTopography fork of the C++ Library for Iterative Closest Point fitting. Updated by Chelsea Scott [email protected] - LASlib integration
OpenTopography/libicp
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
#################################################################################### # Copyright 2011. All rights reserved. # # Institute of Measurement and Control Systems # # Karlsruhe Institute of Technology, Germany # # # # This file is part of libicp. # # Authors: Andreas Geiger # # Please send any bugreports to [email protected] # LASReaders Update: Chelsea Scott - [email protected] # # # libicp is free software; you can redistribute it and/or modify it under the # # terms of the GNU General Public License as published by the Free Software # # Foundation; either version 3 of the License, or any later version. # # # # libicp is distributed in the hope that it will be useful, but WITHOUT ANY # # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A # # PARTICULAR PURPOSE. See the GNU General Public License for more details. # # # # You should have received a copy of the GNU General Public License along with # # libicp; if not, write to the Free Software Foundation, Inc., 51 Franklin # # Street, Fifth Floor, Boston, MA 02110-1301, USA # #################################################################################### +++++++++++++++++++++++++++++++++++ + INTRODUCTION + +++++++++++++++++++++++++++++++++++ Libicp (LIBrary for Iterative Closest Point fitting) is a cross-platfrom C++ library with MATLAB wrappers for fitting 2d or 3d point clouds with respect to each other. Currently it implements the SVD-based point-to-point algorithm as well as the linearized point-to-plane algorithm. It also supports outlier rejection and is accelerated by the use of kd trees as well as a coarse matching stage using only a subset of all points. If you distribute a software that uses libicp, you have to distribute it under GPL with the source code. +++++++++++++++++++++++++++++++++++ + COMPILING MATLAB WRAPPERS + +++++++++++++++++++++++++++++++++++ If you want to use libicp directly from MATLAB you can easily do this by using the MATLAB wrappers provided. They also include some demo files for testing your configuration. First, configure your MATLAB MEX C++ compiler, if it is not yet configured (mex -setup). Under Linux you might use g++, under Windows I compiled it successfully with the Microsoft Visual Studio Express 2008 compilers. 1) Change to the libicp/matlab directory 2) After running 'make.m' you should have a MEX file called 'icpMex' 3) Now try to run 'demo_2d.m' or 'demo_3d.m' +++++++++++++++++++++++++++++++++++ + BUILDING A C++ LIBRARY + +++++++++++++++++++++++++++++++++++ Prerequisites needed for compiling libicp using c++: - CMake (available at: http:https://www.cmake.org/) - Boost (available at: http:https://www.boost.org/) Note: Please make sure that the boost headers can be found! (Add /usr/local/include to your include path if you have installed them locally) Linux: 1) Move to libicp root directory 2) Type 'cmake .' 3) Type 'make' 4) Run './icp' (demo program) Windows: 1) Start CMake GUI 2) Set directories to libicp root directory 3) Run configure, configure and generate 4) Open the resulting Visual Studio solution with Visual Studio 5) Switch to 'Release' mode, build all and run the demo program For more information on CMake, have a look at the CMake documentation. For more information on the usage of the library, have a look into the MATLAB wrappers and into the documentation of the header file icp.h. Please send any feedback and bugreports to [email protected] Andreas Geiger The demo.cpp script was edited to conduct windowed ICP 3D differencing for this manuscript to Geosphere: Scott, C., Phan, M., Nandigam, V., Crosby, C., and Arrowsmith, J R., 2021, Measuring change at Earth’s surface: On-demand vertical and threedimensional topographic differencing implemented in OpenTopography: Geosphere, v. 17, no. 4, p. 1318–1332, https://doi.org/10.1130/GES02259.1 Chelsea Scott: [email protected](corresponding author) Minh Phan, Viswanath Nandigam, Christopher Crosby, Ramon Arrowsmith To set up to run this script: The following directory and txt file must be created. Create tiled point cloud files of the pre- and post- event data: For the compare (pre-event): las_diff/compare_x1_y1.las las_diff/compare_x2_y2.las ... For the reference (post-event): las_diff/ref_x1_y1.las las_diff/ref_x2_y2.las ... tiles.txt in the libicp-master directory tiles.txt x1 y1 x2 y2 ... This will output a disp.txt which has the results of the 3D differencing.
About
OpenTopography fork of the C++ Library for Iterative Closest Point fitting. Updated by Chelsea Scott [email protected] - LASlib integration
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published
Languages
- C++ 98.8%
- CMake 1.2%