Introduction

iqr is a simulation software to design and control large-scale neuronal models with a graphical
interface. The modelled systems can be connected to various hardware devices, e.g. to
control the behavior of a robot or read input from a camera.

iqr versions

The sources of iqr 1.x are in the 'src' directory. The directory 'src-qt4' contains iqr
version 2.x which is ported to qt 4

Requirements

to compile iqr, you need the standard compile suite for c++ (gcc-c++, libstdc++, etc),
cmake, and the following devel packages:
- Qt Framework version 5.x (https://www.qt.io/)
- OpenCV (Windows: needs to be compiled with MinGW/MSys)
- Video4Linux library (libv4l-devel)

Windows

You will additionally need
- NSIS (http://nsis.df.net) if you want to create an installer

preparation:

• Compiler: Use the GNU compiler that comes with QT
• Install the MSYS tool chains
• PATH environment variables
• QT mingw tools (e.g. C:\Qt\Tools\mingw530_32\bin)
• cmake\bin (e.g. C:\Program Files\CMake) directory
• CMake generator: MinGW Makefiles

Compiling iqr

• the build system of iqr is based on cmake (http://www.cmake.org/)

• to generate the Makefiles run 'cmake .' in the top-level directory

• compiling on Windows

• compilation on windows works with MinGW/MSys compile that comes with Qt
• first download and compile OpenCV
• adapt the CMAKE_PREFIX_PATH in CMakeLists.txt
• Easiest ways is to use CMake-GUI to generate the MinGW Makefil
  • OpenCV_DIR to e.g F:/src/opencv-3.4.1/build
• compile command: mingw32-make.exe

Installation

WINDOWS

• 'mingw32-make package' will create an NSIS installer on Windows

RPM packages

• 'make package' will create RPM packages on Linux

DEBIAN packages

• following files should be updated/checked before packaging:
• debian/changelog
• man page symlink to correct version in doc/
• to create the package:
  • first create a source tarball (e.g.):
    cd ..
    tar cfvz iqr_2.5.orig.tar.gz iqr-qt5/
  • compile and package:
    debuild -us -uc

Using Make

• alternatively iqr can be installed system wide with 'make install'
• if you do not use 'make install':
  you'll have to set the environment variable 'LD_LIBRARY_PATH' (on Linux) to
  include the '../lib' directory. This can be done by e.g. adding 'export
  LD_LIBRARY_PATH=$LD_LIBRARY_PATH:~/home/iqr/lib' to ~/.bashrc. The executable (iqr) resides in 'bin/'