Xentica is planned to run with several GPU backends in future, like CUDA, OpenCL and GLSL. However, right now, only CUDA is supported.
If your GPU is not CUDA-enabled, this guide is not for you. Framework will just not run, no matter how hard you try. You may check the list of CUDA-enabled cards, if you have any doubts.
This page currently containing instructions only for Debian-like systems. If you are on other system, you still can use links to pre-requisites in order to install them. If so, please contact us by opening an issue on GitHub. We could help you if you’ll meet some troubles during installation, and also your experience could be used to improve this document.
In order to run CA models without any visualization, you have to correctly install following software.
Generally, you can install it just from your distrubution’s repository:
$ sudo apt-get install nvidia-cuda-toolkit
Although, default packages are often out of date, so in case you have one of those latest cool GPU, you may want to upgrade to the latest CUDA version from official NVIDIA source. We’ll hint you with a good article explaining how to do it. But you are really on your own with this stuff.
Your distribution should already have all you need:
$ sudo apt-get install python3 python3-dev python3-pip wheel
Once Python3 is correctly installed, you can install NumPy by:
$ pip3 install numpy
If CUDA is correctly installed, you again can simply install PyCUDA with
$ pip3 install pycuda
Other pre-requisites should be transparently installed with the main Xentica package.
Its pre-requisites could be installed by:
$ sudo apt-get install \ build-essential \ git \ ffmpeg \ libsdl2-dev \ libsdl2-image-dev \ libsdl2-mixer-dev \ libsdl2-ttf-dev \ libportmidi-dev \ libswscale-dev \ libavformat-dev \ libavcodec-dev \ zlib1g-dev
Then, to install stable Kivy:
$ pip3 install Cython==0.25 Kivy==1.10.0
On latest Debian distributions you can meet conflicts with
libsdl-mixer. Then, try to install latest developer version,
$ pip3 install Cython==0.27.3 git\+https://github.com/kivy/kivy.git
If you have any other troubles with that, please refer to the official Kivy installation instructions.
Xentica package could be installed with:
$ pip3 install xentica
Note, it does not depends on pre-requisites described above, but you still need to install them properly, or Xentica will not run.
Run Xentica examples¶
In order to run Game of Life model built with Xentica:
$ pip3 install moire $ wget https://raw.githubusercontent.com/a5kin/xentica/master/examples/game_of_life.py $ python3 game_of_life.py
Or, if you are using
$ optirun python3 game_of_life.py
In order to run Xentica tests:
$ git clone https://github.com/a5kin/xentica.git $ cd xentica/tests $ ./run_tests.sh
Or, if you are using
$ optirun python3 run_tests.py
Tests will also give you performance metrics. Please update us with them, along with the info about you GPU and Xentica version.