Difference between revisions of "AnyWave:BuildSDK"

From WikiMEG
Jump to: navigation, search
(Prepare to build)
(Blanked the page)
 
Line 1: Line 1:
=Prepare to build=
 
AnyWave requires some librairies and tools to be installed on your system before trying to build it.<br />
 
Use the following command to get the required packages:<br />
 
<syntaxhighlight lang="bash">
 
sudo apt-get install cmake qt5-default libqt5-dev libvtk6-dev libopenblas-base libopenblas-dev
 
libmatio-dev tcsh libfftw3-dev qtbase5-dev libqwt-qt5-dev qttools5-dev-tools libqt5svg5-dev libXt-dev libhdf5-dev
 
</syntaxhighlight>
 
  
=MATLAB support=
 
AnyWave can run MATLAB scripts which are bundled in a plug-in. To do so, the MATLAB support must be built.<br />
 
This requires MATLAB to be installed on the computer.<br />
 
If you want to build the MATLAB support, you must define an environment variable called '''MATLAB_ROOT''' before starting to build AnyWave:
 
<syntaxhighlight lang="bash">
 
export MATLAB_ROOT=/usr/local/MATLAB/R2015a
 
</syntaxhighlight>
 
We strongly suggest that you add this bash command to your .bash_profile file so it will be available in your bash environment.<br />
 
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:<br />
 
<syntaxhighlight lang="bash">
 
sudo apt-get install python-dev python-pip
 
</syntaxhighlight>
 
<syntaxhighlight lang="bash">
 
pip install numpy
 
</syntaxhighlight>
 
 
=Building VTK (optional)=
 
The VTK library 6.x is required and the package should be available in Ubuntu 16.04.<br />
 
If you are using another distribution, you may have to build VTK by yourself:<br />
 
Download VTK 6.3.0 [http://www.vtk.org/files/release/6.3/VTK-6.3.0.tar.gz here]<br />
 
Uncompress the archive and make a separate folder to build it.<br />
 
Use cmake with variables to add Qt Support and Qt5 path:<br />
 
<syntaxhighlight lang="bash">
 
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
 
</syntaxhighlight>
 
 
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:<br />
 
Get the sources:
 
<syntaxhighlight lang="bash">
 
svn checkout svn://svn.code.sf.net/p/qwt/code/branches/qwt-6.1 qwt6.1
 
</syntaxhighlight>
 
Build with the default options:
 
<syntaxhighlight lang="bash">
 
cd qwt6.1
 
qmake qwt.pro
 
sudo make install
 
</syntaxhighlight>
 
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:
 
<syntaxhighlight lang="bash">
 
svn checkout svn://svn.code.sf.net/p/anywave/anywave aw-sf
 
</syntaxhighlight>
 
 
=Building AnyWave=
 
Go to the source folder and build:
 
<syntaxhighlight lang="bash">
 
cd aw-sf
 
mkdir build
 
cd build
 
cmake ..
 
make install
 
</syntaxhighlight>
 
 
If cmake failed to find some libraries, like VTK or Qwt you may have to define the default path for them as follow:
 
<syntaxhighlight lang="bash">
 
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
 
</syntaxhighlight>
 
 
If everything goes well, you will find AnyWave in your aw-sf/bin folder.<br />
 
Two folder will be created: Plugins and lib<br />
 
The Plugins folder contains all the the default plugins built along with AnyWave.<br />
 
The lib folder contains the shared libraries AnyWave needs to run.<br />
 
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.<br />
 
You must add an environment variable called '''AWSDK''' to hold the path to the SDK folder:
 
<syntaxhighlight lang="bash">
 
export AWSDK=/path-to/aw-sf
 
</syntaxhighlight>
 
 
We strongly suggest that you add this line to your .bash_profile file so it will become available in your bash environment.<br />
 
You are ready to develop plug-ins.
 

Latest revision as of 09:05, 2 August 2018