|
|
(3 intermediate revisions by one user not shown) |
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 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
| |
− | </syntaxhighlight>
| |
| | | |
− | =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>
| |
− |
| |
− | =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.
| |
− |
| |
− | =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-git
| |
− | 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.
| |