Difference between revisions of "Install"

From AQUAgpusph
Jump to: navigation, search
(Created page with "== Introduction == Even though [http://canal.etsin.upm.es/aquagpusph:AQUAgpusph] can be compiled in a wide variety of Operating Systems, we are just officially supporting [ht...")
 
(Updated to AQUAgpusph 2.2)
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
  
−
Even though [http://canal.etsin.upm.es/aquagpusph:AQUAgpusph] can be compiled in a wide variety of Operating Systems, we are just officially supporting [https://www.gnu.org:GNU]/[http://www.linux.com:Linux] based ones.
+
Even though [http://canal.etsin.upm.es/aquagpusph AQUAgpusph] can be compiled in a wide variety of Operating Systems, we are just officially supporting [https://www.gnu.org GNU]/[http://www.linux.com Linux] based ones.
  
 
== Precompiled packages ==
 
== Precompiled packages ==
Line 9: Line 9:
 
== Installing from the source code ==
 
== Installing from the source code ==
  
−
=== AQUAgpusph-2.0 ===
+
=== AQUAgpusph-2 ===
 +
 
 +
==== General ====
 +
 
 +
AQUAgpusph-2 is the last stable version of AQUAgpusph, and therefore is the recommended version for most users.
  
 
==== Downloading ====
 
==== Downloading ====
  
−
To download AQUAgpusph-2.0 you must install [http://git-scm.com/:Git] in your system. In [https://www.gnu.org:GNU]/[http://www.linux.com:Linux]/[https://www.debian.org/:Debian] based Operating Systems you can type the following command (as superuser):
+
To download AQUAgpusph-2 you must install [http://git-scm.com/:Git] in your system. In [https://www.gnu.org GNU]/[http://www.linux.com Linux]/[https://www.debian.org/ Debian] based Operating Systems you can type the following command (as superuser):
  
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 19: Line 23:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
After installing [http://git-scm.com/:Git] in your system, you can download AQUAgpusph-2.0 typing (this time superuser is not required):
+
After installing [http://git-scm.com/:Git] in your system, you can download AQUAgpusph-2 typing (this time superuser is not required):
  
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
git clone -b 2.0 "https://github.com/sanguinariojoe/aquagpusph.git"
+
git clone "https://github.com/sanguinariojoe/aquagpusph.git"
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
==== Installing dependencies ====
 
==== Installing dependencies ====
  
−
AQUAgpusph-2.0 has a number of dependencies that should be satisfied before compiling it:
+
AQUAgpusph-2 has a number of dependencies that should be satisfied before compiling it:
  
−
* [http://www.python.org:Python]
+
* [http://www.cmake.org CMake]
−
* [http://www.numpy.org:NumPy]
+
* [http://www.python.org Python]
−
* [http://xerces.apache.org/xerces-c:Xerces-C]
+
* [http://www.numpy.org NumPy]
−
* [http://www.khronos.org/opencl:OpenCL]
+
* [http://xerces.apache.org/xerces-c Xerces-C]
−
* [http://eigen.tuxfamily.org:Eigen3]
+
* [http://www.khronos.org/opencl OpenCL]
−
* [http://www.gnu.org/software/libmatheval:libmatheval]
+
* [http://muparser.beltoforion.de muparser]
−
* [http://llvm.org:LLVM]
+
* [http://eigen.tuxfamily.org Eigen3]
−
* [http://clang.llvm.org:CLang]
+
* [http://www.gnu.org/software/libmatheval libmatheval]
 +
* [http://llvm.org LLVM] (>= 3.5)
 +
* [http://clang.llvm.org CLang] (>= 3.5)
  
−
And some other that are nor mandatory, but highly recommended:
+
In [https://www.gnu.org GNU]/[http://www.linux.com Linux]/[https://www.debian.org/ Debian] based Operating Systems they can be installed typing (as superuser):
  
−
* [http://www.gnu.org/software/ncurses/ncurses.html:Ncurses]
+
<syntaxhighlight lang="bash">
−
* [http://www.vtk.org:VTK]
+
apt-get install cmake python-dev python-numpy libxerces-c-dev ocl-icd-opencl-dev \
 +
libeigen3-dev libmuparser-dev llvm-dev libclang-dev
 +
</syntaxhighlight>
 +
 
 +
There are also some other non-mandatory (but highly recommended) dependencies:
 +
 
 +
* [http://www.gnu.org/software/ncurses/ncurses.html Ncurses]
 +
* [http://www.vtk.org VTK]
 +
 
 +
Such optional dependencies can be installed with the following command (take care, the versions may change):
 +
 
 +
<syntaxhighlight lang="bash">
 +
apt-get install libncurses5-dev libvtk5-dev
 +
</syntaxhighlight>
 +
 
 +
==== Compiling ====
 +
 
 +
AQUAgpusph can be compiled either in the 3D version (which will generate an executable called AQUAgpusph) or in the 2D one (which will generate an executable called AQUAgpusph2D). Both versions can be compiled/installed in the same system, but during this document we are assuming that 3D version is selected (you can toggle to 2D version with -DAQUAGPUSPH_3D=OFF cmake flag).
 +
 
 +
Hence, to compile AQUAgpusph-2 (3D version) you can type (without superuser privileges):
 +
 
 +
<syntaxhighlight lang="bash">
 +
cd aquagpusph &&
 +
cmake -DAQUAGPUSPH_3D=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr . &&
 +
make
 +
</syntaxhighlight>
 +
 
 +
==== Testing ====
 +
 
 +
AQUAgpusph can be tested without installing it, take a look on how to execute the [[examples/3D/spheric_testcase2_dambreak|dam-break example]]. Such example is using some additional software, see [[#Suggested packages|Suggested packages]].
 +
 
 +
==== Installing ====
 +
 
 +
You can install AQUAgpusph executing as superuser the following command (execute it only if [[#Compiling|compilation process]] has finished without errors):
 +
 
 +
<syntaxhighlight lang="bash">
 +
make install
 +
</syntaxhighlight>
 +
 
 +
It is installing the software package at /usr/share/aquagpusph folder, the executable at /usr/bin, and the client and server libraries at /usr/lib.
 +
 
 +
==== Suggested packages ====
 +
 
 +
In addition to the dependencies discussed in [[#Installing dependencies|Installing dependencies]], there are some additional related software that you may want to install (some of these packages are used in the examples, for instance to plot results)
 +
 
 +
* [http://www.paraview.org ParaView]
 +
* [http://matplotlib.org matplotlib]
 +
* [http://www.riverbankcomputing.co.uk/software/pyqt/intro PyQt]
 +
 
 +
In [https://www.gnu.org GNU]/[http://www.linux.com Linux]/[https://www.debian.org/ Debian] based Operating Systems they can be installed by executing (as superuser):
 +
 
 +
<syntaxhighlight lang="bash">
 +
apt-get install paraview python-matplotlib python-qt4
 +
</syntaxhighlight>
 +
 
 +
=== Developing version ===
 +
 
 +
The currently developing branch of AQUAgpusph is the 3 one.
 +
 
 +
To download, compile, and install the branch AQUAgpusph-3 the same process described above should be applied, considering the following differences:
 +
 
 +
* To download the source code the following command will be typed:
 +
 
 +
<syntaxhighlight lang="bash">
 +
git clone -b 3 "https://github.com/sanguinariojoe/aquagpusph.git"
 +
</syntaxhighlight>

Latest revision as of 12:54, 29 December 2015

Introduction

Even though AQUAgpusph can be compiled in a wide variety of Operating Systems, we are just officially supporting GNU/Linux based ones.

Precompiled packages

Currently AQUAgpusph is not providing precompiled packages.

Installing from the source code

AQUAgpusph-2

General

AQUAgpusph-2 is the last stable version of AQUAgpusph, and therefore is the recommended version for most users.

Downloading

To download AQUAgpusph-2 you must install [1] in your system. In GNU/Linux/Debian based Operating Systems you can type the following command (as superuser): 

apt-get install git

After installing [2] in your system, you can download AQUAgpusph-2 typing (this time superuser is not required): 

git clone "https://github.com/sanguinariojoe/aquagpusph.git"

Installing dependencies

AQUAgpusph-2 has a number of dependencies that should be satisfied before compiling it:

In GNU/Linux/Debian based Operating Systems they can be installed typing (as superuser): 

apt-get install cmake python-dev python-numpy libxerces-c-dev ocl-icd-opencl-dev \
libeigen3-dev libmuparser-dev llvm-dev libclang-dev

There are also some other non-mandatory (but highly recommended) dependencies:

Such optional dependencies can be installed with the following command (take care, the versions may change): 

apt-get install libncurses5-dev libvtk5-dev

Compiling

AQUAgpusph can be compiled either in the 3D version (which will generate an executable called AQUAgpusph) or in the 2D one (which will generate an executable called AQUAgpusph2D). Both versions can be compiled/installed in the same system, but during this document we are assuming that 3D version is selected (you can toggle to 2D version with -DAQUAGPUSPH_3D=OFF cmake flag).

Hence, to compile AQUAgpusph-2 (3D version) you can type (without superuser privileges): 

cd aquagpusph && 
cmake -DAQUAGPUSPH_3D=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr . && 
make

Testing

AQUAgpusph can be tested without installing it, take a look on how to execute the dam-break example. Such example is using some additional software, see Suggested packages.

Installing

You can install AQUAgpusph executing as superuser the following command (execute it only if compilation process has finished without errors): 

make install

It is installing the software package at /usr/share/aquagpusph folder, the executable at /usr/bin, and the client and server libraries at /usr/lib.

Suggested packages

In addition to the dependencies discussed in Installing dependencies, there are some additional related software that you may want to install (some of these packages are used in the examples, for instance to plot results)

In GNU/Linux/Debian based Operating Systems they can be installed by executing (as superuser): 

apt-get install paraview python-matplotlib python-qt4

Developing version

The currently developing branch of AQUAgpusph is the 3 one.

To download, compile, and install the branch AQUAgpusph-3 the same process described above should be applied, considering the following differences:

  • To download the source code the following command will be typed:
git clone -b 3 "https://github.com/sanguinariojoe/aquagpusph.git"
Retrieved from "http://canal.etsin.upm.es/aquagpusph/wiki/index.php?title=Install&oldid=190"