summaryrefslogtreecommitdiffstats
path: root/Readme.md
diff options
context:
space:
mode:
authorEdoardo Pasca <edo.paskino@gmail.com>2018-08-14 17:17:53 +0100
committerGitHub <noreply@github.com>2018-08-14 17:17:53 +0100
commit9d66affa454976ea6cc4a476ef7a6c2186963c0b (patch)
tree6df5eba901d73238230508ab577cd12b85b56b23 /Readme.md
parent9c0df7185bc9ba0dee53fdb4d6a3ecc12e2f1294 (diff)
downloadregularization-9d66affa454976ea6cc4a476ef7a6c2186963c0b.tar.gz
regularization-9d66affa454976ea6cc4a476ef7a6c2186963c0b.tar.bz2
regularization-9d66affa454976ea6cc4a476ef7a6c2186963c0b.tar.xz
regularization-9d66affa454976ea6cc4a476ef7a6c2186963c0b.zip
updated build info
Diffstat (limited to 'Readme.md')
-rw-r--r--Readme.md49
1 files changed, 42 insertions, 7 deletions
diff --git a/Readme.md b/Readme.md
index f88f3e1..fb3fdc8 100644
--- a/Readme.md
+++ b/Readme.md
@@ -35,27 +35,62 @@
## Installation:
-### Python binaries
+The package comes as a CMake project so you will need CMake to install it. After checking out the repository to a directory, i.e. `CCPi-Regularisation-Toolkit`, create a build directory. Additional flags to CMake will allow you to create the Matlab wrapper and/or the Python wrapper and the CUDA regularisers. In the following example I will write a line to build both wrappers and CUDA.
+
+```bash
+git clone https://github.com/vais-ral/CCPi-Regularisation-Toolkit.git
+mkdir build
+cd build
+cmake ../CCPi-Regularisation-Toolkit -DCONDA_BUILD=OFF -DBUILD_MATLAB_WRAPPER=ON -DBUILD_PYTHON_WRAPPER=ON -DBUILD_CUDA=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<your favourite install directory>
+make install
+```
+
+The library may be used directly from C/C++ as it is compiled as a shared library. Check-out the include files in `Core`. We provide wrappers in Python and Matlab.
+
+### Python
+#### Python binaries
Python binaries are distributed via the [ccpi](https://anaconda.org/ccpi/ccpi-regulariser) conda channel. Currently we produce packages for Linux64, Python 2.7, 3.5 and 3.6, NumPy 1.12 and 1.13.
```
conda install ccpi-regulariser -c ccpi -c conda-forge
```
-### Python (conda-build)
+#### Python (conda-build)
```
- export CIL_VERSION=0.10.0
- conda build recipes/regularisers --numpy 1.12 --python 3.5
- conda install cil_regulariser=${CIL_VERSION} --use-local --force
- cd Wrappers/Python
- conda build conda-recipe --numpy 1.12 --python 3.5 --no-test
+ export CIL_VERSION=0.10.1
+ conda build Wrappers/Python/conda-recipe --numpy 1.12 --python 3.5
conda install ccpi-regulariser=${CIL_VERSION} --use-local --force
cd demos/
python demo_cpu_regularisers.py # to run CPU demo
python demo_gpu_regularisers.py # to run GPU demo
```
+
+#### Python build
+
+If Python is not picked by CMake you can provide the additional flag to CMake `-DPYTHON_EXECUTABLE=/path/to/python/executable`.
+
### Matlab
+
+If Matlab is not picked by CMake, you could add `-DMatlab_ROOT_DIR=<Matlab directory>`.
+
+#### Linux
+Because you've installed the modules in `<your favourite install directory>` you need to instruct Matlab to look in those directories:
+
+```bash
+
+PATH="/path/to/mex/:$PATH" LD_LIBRARY_PATH="/path/to/library:$LD_LIBRARY_PATH" matlab
+```
+By default `/path/to/mex` is `${CMAKE_INSTALL_PREFIX}/bin` and `/path/to/library/` is `${CMAKE_INSTALL_PREFIX}/lib`
+
+#### Windows
+On Windows the `dll` and the mex modules must reside in the same directory. It is sufficient to add the directory at the beginning of the m-file.
+```matlab
+addpath(/path/to/library);
+```
+
+#### Legacy Matlab installation
```
+
cd /Wrappers/Matlab/mex_compile
compileCPU_mex.m % to compile CPU modules
compileGPU_mex.m % to compile GPU modules (see instructions in the file)