1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
============
Installation
============
Windows
-------
Persalys requires Windows >=10.
The default language setting can be overidden with the argument :code:`--lang=en|fr` added to the launcher executable command-line.
To do so right-click on the desktop shortcut, select ``Properties``, then edit the ``target`` field::
...\persalys_launcher.exe --lang en
In the same fashion the bundled software OpenGL renderer can be enabled/disabled with the argument :code:`--mesa=1|0`.
Linux
-----
Requirements:
- glibc >=2.28 (Debian 10+, Ubuntu 18.10+, Fedora 29+, CentOS/RHEL 8+)
- X11/Wayland with OpenGL >=3.2
- FUSE userspace filesystem
The AppImage binary requires the libfuse2 package to run which might not be installed by default, for example on Ubuntu::
$ sudo apt install libfuse2t64
No installation is required, set the executable bit if needed and just run the .AppImage as follows::
$ chmod a+rx persalys-x.y-x86_64.AppImage
$ ./persalys-x.y-x86_64.AppImage
The LANGUAGE environment variable can be set to ``en`` or ``fr`` to override the default language::
$ LANGUAGE=fr ./persalys-x.y-x86_64.AppImage
Note that documentation links from the GUI cannot be opened in a snap-sandboxed browser: https://bugs.launchpad.net/snapd/+bug/1972762.
Additional Python packages
--------------------------
The Python environment can be amended with additional packages using the included nopip module
by typing the following in the :ref:`Python console <pythonconsole>`::
from nopip import install
install.modules(["<module_name>", "--user"], verbose=True)
where ``<module_name>`` is the PyPI module name of the desired package.
Modules are then installed in ``~/.persalys_base`` on Linux and in ``<USER_DIR>\AppData\Roaming\Persalys\`` on Windows.
|
