Frequently Asked Question
What is the license of this software ?
This software is distributed under the Free Software CECILL License
On which OS does it work ?
Currently it works on UNIX OS (Linux, Solaris, MacOSX, etc). Concerning Windows, a pre-compiled version is available for a specific version of Anaconda Python Distribution. Check the prerequisites section of the wiki.
What is needed to install ?
Check the prerequisites section of the wiki.
I get the message "ImportError: No module named pylmgc90" when running an example, what is wrong ?
Python did not find the module with lmgc90. If the path to your build directory is my_build_path,
then make sure your
PYTHONPATH environment variable is correctly set with:
or that you add the path inside your command script with the two lines:
import sys sys.path.append("my_build_path")
How to use multi-threaded version ?
First the code must be re-compiled (unavailable on Windows).
Go to your build directory (if you followed the instruction of the wiki it should be lmgc90_user/build), then type the following command in your terminal:
cmake . -DWITH_OPENMP=True
Finally before running a computation, you must set two environment variables which are:
export OMP_SCHEDULE=STATIC export OMP_NUM_THREADS=n export OPENBLAS_NUM_THREADS=1
where n is the number of threads you want to use (usually no more than the number of core available).
Additional informations in: examples/Ateliers/Performance/directions/index.html
An error arise at the very beginning when running
- if the error message is something like:
CMake generation for this library is not allowed within the source directory! Remove the CMakeCache.txt file and try again from another folder, e.g.: rm -r CMakeCache.txt CMakeFiles cd <somewhere (preferably a local place on your computer and not a network folder)> cmake <source directory of LMGC90> If you really need an in source build, then run : cmake -DIN_SOURCE_BUILD=ON Call Stack (most recent call first): CMakeLists.txt:21 (include) -- Configuring incomplete, errors occurred!
Then it means you issued the
cmake command within the base of your source
directory. In this case, following the recommendation of the error message
you have to remove, in the source directory the
CMakeCache.txt file and
CMakeFiles directory. Then you can go back to step where you change of
cd build) before continuing the installation process.
An error arise when building the
matlib on Mac OS Yosemite
- if the error is something like:
/usr/include/dispatch/object.h:143:15: error: expected ')' before '^' token /usr/include/dispatch/object.h:362:3: error: 'dispatch_block_t' has not been declared dispatch_block_t notification_block); ^ make: *** [CMakeFiles/matlib.dir/src/math/eigmat.cpp.o] Error 1 make: *** [CMakeFiles/matlib.dir/all] Error 2 make: *** [all] Error 2 make: *** [src/contribs/matlib-prefix/src/matlib-stamp/matlib-build] Error 2 make: *** [src/contribs/CMakeFiles/matlib.dir/all] Error 2 make: *** [all] Error 2
Then you can:
- shut down the MatLib if you do not need it:
cmake . -DMATLIB_VERSION=none make
- or modifiy the file src/contribs/MatLib4-LMGC-2015-1/src/math/lapack.h so that it looks like this:
#ifndef ZORGLIB_MATH_LAPACK_H #define ZORGLIB_MATH_LAPACK_H #ifndef __has_extension #define __has_extension(x) 0 #endif #define vImage_Utilities_h #define vImage_CVUtilities_h // config #include <matlib_macros.h>