Revision as of 11:26, 15 June 2017

Prepare to build

AnyWave requires some librairies and tools to be installed on your system before trying to build it.
Use the following command to get the required packages:

sudo apt-get install svn cmake qt5-default libqt5-dev libvtk6-dev libopenblas-base libopenblas-dev
 libmatio-dev tcsh libfftw3-dev qtbase5-dev libqwt-qt5-dev qttools5-dev-tools  libqt5script5 libqt5scripttools5
 qtscript5-dev libqt5svg5-dev libXt-dev libhdf5-dev

MATLAB support

AnyWave can run MATLAB scripts which are bundled in a plug-in. To do so, the MATLAB support must be built.
This requires MATLAB to be installed on the computer.
If you want to build the MATLAB support, you must define an environment variable called MATLAB_ROOT before starting to build AnyWave:

export MATLAB_ROOT=/usr/local/MATLAB/R2015a

We strongly suggest that you add this bash command to your .bash_profile file so it will be available in your bash environment.
The path in this example is the location where MATLAB 2015a is installed by default on Debian. AnyWave will get the necessary headers and libraries from there.

Python Support

In order to be able to run Python plug-ins, you must have Python and the numpy package ready on your system:

sudo apt-get install python-dev python-pip

pip install numpy

Building VTK (optional)

The VTK library 6.x is required and the package should be available in Ubuntu 16.04.
If you are using another distribution, you may have to build VTK by yourself:
Download VTK 6.3.0 here
Uncompress the archive and make a separate folder to build it.
Use cmake with variables to add Qt Support and Qt5 path:

cd /path/to/VTK-Source
cmake -DVTK_QT_VERSION:STRING=5 \
     -DQT_QMAKE_EXECUTABLE:PATH=/path/to/qt5.2.1-install/5.2.1/gcc_64/bin/qmake \
     -DVTK_Group_Qt:BOOL=ON \
     -DCMAKE_PREFIX_PATH:PATH=/path/to/qt.5.2.1-install/5.2.1/gcc_64/lib/cmake  \
     -DBUILD_SHARED_LIBS:BOOL=ON
     /path/to/VTK

This will build VTK with Qt 5.2.1 and install it in the /path/to/VTK folder. The VTK libraries will be built as shared libraries.

Building Qwt (optional)

The Qwt library is also required to build AnyWave. If the package is not available for your distribution, then you will have to build it yourself:
Get the sources:

svn checkout svn://svn.code.sf.net/p/qwt/code/branches/qwt-6.1 qwt6.1

Build with the default options:

cd qwt6.1
qmake qwt.pro
sudo make install

This should build qwt as a shared library and install it to /usr/local/qwt-6.1.2

Get the AnyWave source files

Either download the archive from SourceForge or get the SVN repository:

svn checkout svn://svn.code.sf.net/p/anywave/anywave aw-sf

Building AnyWave

Go to the source folder and build:

cd aw-sf
mkdir build
cd build
cmake ..
make install

If cmake failed to find some libraries, like VTK or Qwt you may have to define the default path for them as follow:

cd aw-sdk
cmake -DVTK_DIR=/path-to-VTK6.3/lib/cmake/vtk-6.3 -DQWT_DIR=/usr/local/qwt-6.1.2 ../aw-sf
make install

If everything goes well, you will find AnyWave in your aw-sf/bin folder.
Two folder will be created: Plugins and lib
The Plugins folder contains all the the default plugins built along with AnyWave.
The lib folder contains the shared libraries AnyWave needs to run.
So to launch AnyWave you will have to execute the shell script Anywave.sh

Manually installing AnyWave

You may copy this bin folder to a suitable location in the current path and make a symbolic link on the Anywave.sh script file to launch it.

Preparing the SDK to develop plugins

After you successfully built AnyWave, you will use it as the sdk for plugins.
You must add an environment variable called AWSDK to hold the path to the SDK folder:

export AWSDK=/path-to/aw-sf

We strongly suggest that you add this line to your .bash_profile file so it will become available in your bash environment.
You are ready to develop plug-ins.