Python files required to interact with PLAXIS API. These files are created by Seequent/Bentley (owner of PLAXIS) and distributed as part of the PLAXIS installation. The goal of this repository is simply to store this files to ease the CEMS development pipeline.
To install simply run:
$ pip install plxscripting
Or for a particular version (e.g. 1.0.2):
$ pip install plxscripting==1.0.2
Each version of this repository is compatible with one (or more) versions of the PLAXIS 2D and 3D programs. Below you find two tables containing the known compatibilities, so you can install the version you need depending on the PLAXIS program you need to use.
PLAXIS 2D Versions | Repository Version |
---|---|
PLAXIS 2D CONNECT Edition V22 Update 2 | 1.0.2 |
PLAXIS 3D Versions | Repository Version |
---|---|
PLAXIS 3D 2023.2 | 1.0.4 |
Every time a new PLAXIS version is released, a new version of the
plxscripting
directory and the encryption.py
file is released/included in
the PLAXIS installation. Theses files are typically located under a directory similar to:
C:\ProgramData\Seequent\PLAXIS Python Distribution V2\python\Lib\site-packages
where Seequent
used to be named Bentley
in the previous versions and V2
will have a different index.
The contribution of this repository restricts itself to:
- Copy the copy these files to
plxscripting
directory and theencryption.py
under thesrc
of this repository. - Make a new release using the same version as in the file
plxscripting\__version__.py
. - Updating the compatibilty tables writter in the previous section.
We recommend developing in Python3.9 with a clean virtual environment (using virtualenv
or conda
),
installing the requirements from the requirements.txt file:
Example using virtualenv
and pip
to install the dependencies in a new environment .env on Linux:
python -m venv .env
source .env/bin/activate
python -m pip install --upgrade pip setuptools
pip install -r requirements.txt
pip install -e .
Requirements are autogenerated by the pip-compile
command with python 3.9
Install pip-tools with:
pip install pip-tools
Generate requirements.txt file with:
pip-compile --extra=test --output-file=requirements.txt pyproject.toml
Update the requirements within the defined ranges with:
pip-compile --upgrade --extra=test --output-file=requirements.txt pyproject.toml