Installation

This section describes the installation procedure for Paraqus, which is dependent on whether you want to use it inside the software Abaqus (which is the typical use case).

Using Paraqus only outside Abaqus

If you do not use Abaqus, you are in luck: the installation is pretty simple. Assuming Python is already available on your machine, Paraqus can be installed from the Python Package Index:

pip install paraqus

This will install Paraqus for the Python version that pip is connected to.

Using Paraqus inside Abaqus

Abaqus is shipped with its own Python interpreter (we will call it Abaqus Python in the following), which unfortunately does not allow installations through pip. To use Paraqus inside Abaqus, first of all, you need to install Paraqus and then let Abaqus Python know where to find it. The steps are described below depending on whether Python is installed on your system.

If you already have Python installed

Follow the instructions above (Using Paraqus only outside Abaqus) and install Paraqus outside Abaqus.
Open a Python interpreter (type python in a terminal).

Enter the following commands:

>>> import paraqus
>>> print(paraqus.__path__)

Take note of the output by removing the ending /paraqus term; the resulting string represents the path to the location where the Paraqus package is installed. For instance, should the output be ['/home/user/lib/python3.11/site-packages/paraqus'], you need to note down the path /home/user/lib/python3.11/site-packages.
In every Python script that is executed by Abaqus Python, before you import Paraqus, add the following lines of code (replace <path> with the path you noted):

import sys
sys.path.append("<path>")

If you do not have Python installed

Clone the repository into a directory of your choice, e.g. /home/user/paraqus-files/. Alternatively download and unpack the directory manually.
Locate the src directory inside the repository folder. In the above example, this would be /home/user/paraqus-files/src/. Note this path down.
In every Python script that is executed by Abaqus Python, before you import Paraqus, add the following lines of code (replace <path> with the path you noted):

import sys
sys.path.append("<path>")

Adding Paraqus to the Python path (advanced, but recommended)

If you would like to avoid adding the code lines above to all your Python scripts when using Paraqus, you can add the directory <path> to the environment variable PYTHONPATH. Since this step is dependent on the operating system, it is not described here in detail, but you have to loom it up for your os. A starting point can be found here.

Compiling the documentation

We suggest that readers use the online documentation for Paraqus, located here. However, the docs can also be built from source. This requires additional dependencies from pip. With these installed, the docs can be built by running

python -m sphinx -T -b html -d _build/doctrees -D language=en . output_dir