An open-source toolbox for post-processing and analysis of 3D meshes obtained from SLAM or Structure-from-Motion solutions of underwater structures such as: shipwrecks, seabed, coral colonies and reefs, etc. Yet, it can be applied to any generic surface. It's aimed to process OBJ or PLY meshes exported from Agisoft Photoscan PSX or other 3D mesh processing tool such as Meshlab.
meshToolbox is a free and open source software licensed under the GNU GPLv3.0 License, unless otherwise specified in particular modules or libraries (see LICENSE and README.md).
- objLoader Basic OBJ import module for debugging purposes. Relies on OBJ-Loader library (see #requirements)
Each module contains information describing its usage, with (usually) some useful README file. Code documentation is expected to be provided in Doxygen-compatible format. The current release contains C/C++, Python and/or Matlab implementations.
The current release has been developed and tested in Ubuntu 16.04 LTS 64 bits.
- cmake 2.8 - cmake making it happen again
- OBJ-Loader - OBJ Loading header file, released under MIT license.
This repository provides an incremental collection of compatible, yet independent, modules for 3D mesh analysis. For more extensive and user-friendly solution please see other alternatives as Meshlab. To start using this toolbox, proceed to the standard clone steps:
cd <some_directory>
git clone https://github.com/cappelletto/meshToolbox.git
Then enter the desired module and compile it:
cd <module_directory>
mkdir build
cd build
cmake ..
make
- Implementation done in C++, Python and/or Matlab/Octave.
Summary of contributing guidelines (based on those of other projects such as OpenCV):
- One pull request per issue;
- Choose the right base branch;
- Include tests and documentation;
- Use small datasets for testing purposes;
- Follow always the same coding style guide. If possible, apply code formating with any IDE.
Feel free to fork, clone or join the dev team. For further information please contact J. Cappelletto ([email protected]) with the subject: meshToolbox.
Copyright (c) 2017-2018 José Cappelletto ([email protected]). Released under the GNU GPLv3.0 License.