The Mangrove TDS Library (The Quick User's Guide)
A C++ Tool for the Fast Prototyping of the Topological Data Structures
|Both the stable versions of the Mangrove TDS Library (SourceForge.net) and the experimental Mangrove TDS Library (GitHub) are rooted in the same theoretical basis. In any case, the experimental versions are currently unstable, and we do not provide their official documentation. It can be generated by using the Doxygen.|
Here, there are some quick instructions regarding how exploiting the Mangrove TDS Library (SourceForge.net) in the applications. The use of the experimental version is (basically) very similar. An interested user finds more details in the Official Documentation (SourceForge.net) and/or in the Literature Section.
[ Back ]
Getting the Mangrove TDS LibraryAll versions of the Mangrove TDS Library (SourceForge.net) are hosted on the SourceForce.net website, and are also available via a public read-only svn repository:
You can download a compressed version of the last (stable) version for this library from here (Sourceforge.net), i.e., from:
svn checkout svn://svn.code.sf.net/p/mangrovetds/code/trunk mangrovetds-code
The experimental versions of ths library are hosted on the GitHub website, in particular on this Git repository, i.e.,:
git clone http://github.com/davidcanino/mangrovetdslib.git
We provide the complete source code of the library, plus the unit tests programs for retrieving the statistics, and for manipulating the non-manifold shapes of any dimension.
You can find more information in the Getting Started (SourceForge.net) Section of the Official Documentation (SourceForge.net).
[ Back ]
Getting the Documentation
The Official Documentation (SourceForge.net) of the stable Mangrove TDS Library 2.0 can be:
[ Back ]
Exporting the Official DocumentationThe Official Documentation (SourceForge.net) of the stable Mangrove TDS Library 2.0 (but not only, even the documentation of the experimental version) can be also generated and exported by exploiting the Doxygen program:
from the 'doc/' folder.
The Doxygen program has the built-in support to generate the inheritance diagrams for the C++ classes. In particular, it can use the "dot" tool from the Graphviz suite in order to generate more advanced diagrams and graphs. This latter is an open-source and cross-platform graph drawing toolkit, and can be found at http://www.graphviz.org/. If you have the "dot" tool in the path, you can set the HAVE_DOT macro to YES in the 'mangrove_doc.conf' configuration file to let doxygen use it. Otherwise, you set the HAVE_DOT macro to NO.
[ Back ]
The Requirements and the Supported PlatformsAll versions of this library are written in the C++ language, and are based on the metaprogramming template-based techniques. More precisely:Generally speaking, this library is mostly an header-only library, except small parts of code, that must be built properly. Its building system is based (for all versions) on the well-known QT Library, a famous and platform-independent library for devoloping the GUIs and the servers.
All versions of this library have been successfully compiled and tested using the following operating configurations:
- several GNU/Linux distribution (up to the recent Ubuntu 16.0.4 LTS, with several versions of the GCC, up to 6.0 svn-experimental version);
- the MacOSX 10.11.* with the Clang 7.0 (tags/Apple/clang-700.1.6 and based on the LLVM 7.0.76);
- the MacOSX 10.7.2 with the Clang 3.1 (tags/Apple/clang-318.0.61 and based on the LLVM 3.1svn);
- the MacOSX 10.7.2 with the GCC 4.8.3 (the MacPorts gcc48 4.8.3_4);
- the MacOSX 10.7.2 with the GCC 4.2.1 (Based on the Apple Inc. build 5658 and the LLVM build 2336.9.00);
- the Microsoft Windows 10 (only with the MinGW compiler, up to version 4.9);
- the Microsoft Windows Vista (only with the MinGW compiler, up to version 4.9);
- the QT Library (up to the version 5.7 Community Edition);
The experimental versions have been also tested with:
[ Back ]
Building the Mangrove TDS LibraryAs mentioned above, this library is written in the C++ language, and deeply exploits the generic programming. Specifically, there are a few source files to be compiled and built. You can build the code either in the debug or the release mode. In the debug mode, several checks are performed through the assertions, that are enabled (by construction). In the release mode, no check is performed, and the assertions are disabled.
Basically, we exploit the building infrastructure, which is provided by the QT Library. An interested user finds more details in the Official Documentation of the QT Library.
The main QT project file of interest is given by the 'mangrove.pro' file, while the header and the source files of the library are stored in the 'include/' and the 'src/' folders, respectively. Once built, you will obtain a dynamic library file MangroveTDS.(so, dll, or dylib) in the 'bin/' folder, plus the executables of all unit tests.
We encourage the use of the QT Creator program, which is a cross-platform integrated development environment (IDE), tailored to the needs of the QT Library. In any case, also the command-line procedure is supported.
In particular, if you prefer to build the library with the QT Creator:
If you prefer the command-line procedure, then you must run at your terminal:
open the 'mangrove.pro' file
choose Debug or Release mode (according to your need)
press Build All
In any case, the qmake program must be configured properly in order to generate the makefile properly through the correct 'qmake_spec' (to be replaced with the correct value, see also the QMAKESPEC variable). For more details (depending on your platform and your compiler), please refer to the Official Documentation of the QT Library.
qmake [-spec qmake_spec] mangrove.pro
make clean (only on some GNU/Linux platforms)
make debug or make release (according to your need)
These instructions are valid for the Mangrove TDS Library (SourceForge.net). Instead, the experimental Mangrove TDS Library (GitHub) requires the further customization of the paths, containing the header and the libraries files for the Boost Library and the SparseHash Library. These operations must be performed on the QT projects files of interest.
[ Back ]
||Official Documentation (SourceForge.net)
|Credits & Contacts
|Copyright (c) 2012 by David Canino
||Last Update: November 4, 2016