ec-jrc / jeolib-jiplib

jiplib

jiplib is a C++ library with a Python wrapper for image processing for geospatial data implemented in JRC Ispra. Python users are encouraged to use pyjeo that is built upon this library.

License

jiplib is released under the GPLv3 license.

Dependencies

libraries:

• gdal: MIT/X style https://gdal.org/license.html
• PROJ: MIT https://proj.org/about.html
• GNU compiler selection (gcc/g++): GPL v.3 https://gcc.gnu.org/onlinedocs/libstdc++/manual/license.html
• cmake: BSD 3 https://cmake.org/licensing/
• GNU Scientific library: GPL https://www.gnu.org/software/gsl/
• FANN: LGPL http://leenissen.dk/fann/wp/
• libsvm: modified BSD license https://www.csie.ntu.edu.tw/~cjlin/libsvm/COPYRIGHT
• libLAS: BSD https://liblas.org/
• jsoncpp: MIT https://github.com/open-source-parsers/jsoncpp/blob/master/LICENSE
• doxygen: GPL v.2 https://github.com/doxygen/doxygen/blob/master/LICENSE
• boost: BSD/MIT like https://www.boost.org/users/license.html
• SWIG: GPL v.3 http://www.swig.org/Release/LICENSE
• Python: Python Software Foundation License https://docs.python.org/3/license.html
• numpy: BSD https://numpy.org/license.html
• scipy: BSD https://www.scipy.org/scipylib/license.html
• Sphinx: BSD http://www.sphinx-doc.org/en/master/

Installation procedure

Install dependency libraries (example for Debian based system using apt)

sudo apt install -yq \
  build-essential \
  cmake \
  libgsl-dev \
  libfann-dev \
  libgdal-dev \
  libjsoncpp-dev \
  libpython3-dev \
  python3-numpy \
  python3-pip \
  libboost-filesystem-dev  \
  libboost-serialization-dev \
  swig

Build and install miallib

Get the source code from miallib, to create the library:

git clone https://github.com/ec-jrc/jeolib-miallib.git
cd jeolib-miallib
mkdir build
cd build
cmake ..

or without sudo rights, replace the last command with:

cmake -DCMAKE_INSTALL_PREFIX=/home/user/install/miallib ..

Build the miallib library:

cmake --build .

Install the miallib library (remove sudo to install without sudo rights):

sudo cmake --install .

Build and install jiplib

Get the source code from jiplib:

git clone https://github.com/ec-jrc/jeolib-jiplib.git
cd jeolib-jiplib
mkdir build
cd build
cmake ..

or without sudo rights, replace the last command with:

cmake -DCMAKE_PREFIX_PATH=/home/user/install/miallib -DCMAKE_INSTALL_PREFIX=/home/user/install/jiplib ..

Build the jiplib library and create a python wheel:

cmake --build .

Install the jiplib library:

cmake --install .

To only install the Python bindings using the wheel that has been built:

cmake --install . --component wheels

Test the installation

From the build directory, run:

ctest .

Build documentation (deprecated, users are encouraged to use pyjeo documentation)

Go to directory doc and run make html.

cd doc
make html