pyjamas-rfglab 2021.8.0

PyJAMAS is Just A More Awesome SIESTA

PyJAMAS

PyJAMAS is Just A More Awesome Siesta.

Documentation

You can find the official PyJAMAS documentation, with detailed installation instructions, here.

Installing PyJAMAS

The easiest way to install PyJAMAS is using PyPi.

A note on the Python interpreter

PyJAMAS requires that you have Python installed.

PyJAMAS has been extensively tested with Python 3.7 and 3.8.

PyJAMAS does NOT work with Python 2.

MacOS and Linux

Open a terminal. If you had previously installed PyJAMAS, we recommend uninstalling the previous version:

To install PyJAMAS, type:

$ python3 -m pip install --no-cache-dir -U pyjamas-rfglab

To run PyJAMAS, type:

$ pyjamas

at the user prompt.

If the executable fails to run, you can also try to execute PyJAMAS by opening a terminal and typing:

$ python3 -m pyjamas.pjscore

Windows

Before installing PyJAMAS, you will need to install Shapely, a package used in PyJAMAS to represent geometric objects such as points or polygons. Under Windows, Shapely fails to install with the PyJAMAS PyPi package. It is recommended to start by manually installing Shapely. To that end, download the appropriate Shapely version from this link. For example, use Shapely‑1.6.4.post2‑cp37‑cp37m‑win_amd64.whl for a 64-bit machine running Python 3.7. Open a command prompt and navigate to the folder that contains the downloaded .whl file using the cd command. Complete the installation of Shapely by typing:

$ python -m pip install Shapely‑1.6.4.post2‑cp37‑cp37m‑win_amd64.whl

substituting the downloaded file name. Note that, depending on your Python installation, the executable for the Python interpreter might be py.

Once Shapely, has been set up, you can proceed with a regular PyPi installation of PyJAMAS. Open a command prompt and type:

$ python -m pip install --no-cache-dir -U pyjamas-rfglab

To run PyJAMAS type:

$ pyjamas

at the user prompt.

If the executable fails to run, you can also try to execute PyJAMAS by opening a command prompt and typing:

$ python -m pyjamas.pjscore

GPU support under Windows

PyJAMAS supports the use of CUDA -based GPUs in Windows. Please, check here for instructions on how to configure your system. Briefly:

1. Download and install the NVIDIA GPU drivers.

2. Download and install the CUDA Toolkit.

3. Download and install the cuDNN SDK (https://developer.nvidia.com/cudnn and https://docs.nvidia.com/deeplearning/cudnn/install-guide/index.html).

Known problems: CUDA and cuDNN are picky with the version of each other that they talk to. If PyJAMAS displays an error that cusolver64_10.dll is not found:

1. Go to the folder C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\V11.2\bin (replacing V11.2 by whichever version you installed).

2. Create a copy of the file cusolver64_11.dll.

3. Rename the copy as cusolver64_10.dll.