GranOO's install guide
The current stable version of GranOO is the 3.0. Note that this guide is related to this version.
GranOO is coded in C++. It depends on the following C++ libraries : boost, zlib, qt5, eigen3, vtk and suitespare. The sources of GranOO are managed by svn and the compilation process is assisted bycmake. After installation, you can go to the tutorial section to learn the basic usage of the workbench. Is is recommended to install GranOO on the last GNU/Linux Ubuntu LTS system.
A user install corresponds to an installation in the user environment whereas an admin install corresponds to an install
in the root system /usr/local
. A user install does not require admin privilege excepted for installing dependencies.
Install the required dependencies for Ubuntu based distributions.
Install the required dependencies for CentOS based distributions.
Install the required dependencies for Fedora based distributions.
Install the required dependencies for macOS. Note that you probably need to install Xcode and Homebrew.
Download the GranOO sources. Note that sources are managed by svn. If you are asked for a password just type anonsvn
.
Following the standard cmake install procedure, create a build
directory.
For a user install, you must create also an install
directory
Compiling GranOO with cmake and make…
Now, do not forget to install GranOO in the $DIR/granoo/tags/3.0/install/
directory
Compiling GranOO with cmake and make…
Now, do not forget to install GranOO in the /usr/local
system directory
Adding the GranOO installation directory to your logging environment.
Checking your installation
If you see a 3D graphical interface that shows a granular rain simulation, it means that the install is right !
Uninstalling
Remove the python version of GranOO with pip
Ppurge GranOO from the /usr/local
system directory with
Uninstalling
Remove the python version of GranOO with pip
Remove the GranOO installation directory
Fixing the “path not found” cmake error
If you experienced the following error during the cmake
process
It means that cmake
is not able to locate your GranOO installation path. It probably means
that you do not follow all the installation step. Indeed, if you want to fix this error,
you must help cmake
to locate GranOO. You can invoke cmake with the CMAKE_PREFIX_PATH
option as
Installing GranOO natively on Windows is so long and complicated that your best choice is to use WSL, which stands for “Windows Subsystem for Linux”. It consists in installing a virtual, but nevertheless quite powerful, machine (depending on the physical host).
Install WSL (Windows Subsystem for Linux)
Follow the step by step guide provided by Microsoft here. We recommand to install a Ubuntu distribution so that the following step is straightforward.
Build and install GranOO
Follow the step by step guide provided by the GranOO team for Ubuntu/Debian distributions.
X server
The last step, if you plan to use GUI in the Linux system, is to install an X server. Again, we recommand to install VcXsrv
, which is quite easy to use. VcXsrv
can be downloaded from here.
Finally, in the Linux virtual machine, edit your .bashrc
file:
nano /home/<username>/.bashrc
and add the display address at the end of the file:
export DISPLAY=:0.0
GranOO is now ready to use !