PLAXIS is a Finite Element modelling software that geotechnical engineers will definitely come across at certain point of their career. Modelling complex geotechnical problems in a PLAXIS can be challenging and represents time-consuming modelling work often involving repetitive tasks.
As an engineer, we always want to automate the boring and engineer the awesome.
In this context, programming, more specificallyPython, is the best available tool to automate repetitive tasks.
Python has been around for many years but only recently get recognised by the larger community because of its ease of use, large extent of applications and support by huge open-source communities. It is a great programming language for data science, workflow automation and web development.
PLAXIS has a well-developed Application Programming Interface (API) which allows users to operate PLAXIS through programming. More details can be seen on the official Bentley website.
Although the PLAXIS Python API has been developed for a long time, there is still a lack of thorough guidelines to introduce this technique to geotechnical engineers.
This tutorial assumes readers havezero experience in programmingso I will show how to set up the programming environment from scratch.
Disclaimer
There have been a lot of paid courses which teach engineers to use the built-in Python editor in PLAXIS which I agree is quite well-developed. But I personally prefer to use my own programming environment to write scripts because of the following three reasons:
A well-developed Integrated Development Environment (IDE) is more user-friendly for coding as it picks up wrong syntaxes and identifies bugs, which is crucial for beginners.
Built-in Python editor has less flexibility to import user-developed modules. In the future when you have more programming experience, you will find that a lot of time we need to separate out the functions we write as a module which makes our script less busy. This can be well managed in IDE.
We don’t want to keep the scripts to ourselves but to share them among colleagues. IDE provides perfect integration with code-sharing platforms such as GitHub, GitLab etc.
The ultimate goal of this tutorial is to show you how to use Python script to create your first structural element in PLAXIS 2D. This can be done with the following four steps.
Install Integrated Development Environment (IDE)
Activate PLAXIS Environment
Connect to PLAXIS API
Create first plate element
Lastly, this tutorial assumes readers are using Windows OS and have PLAXIS 2D V22 installed. So let’s get started!
Step 1: Install Integrated Development Environment (IDE)
IDE is a software application which provides comprehensive facilities for programming, usually consisting of source code editor, build automation tools and debugger.
There are various options for IDE, such as Visual Studio Code (VS Code), PyCharm, Jupyter Notebook etc, which have no difference in functionality and are completely up to users’ preference for the choice of IDE. This instruction demonstrates the installation of VS Code.
Install Visual Studio Code (VS Code) with the following instruction:
It should show the correct folder name as shown above.
Activate PLAXIS Python Environment
To activate the PLAXIS Python environment, we will need to select PLAXIS built-in python interpreter which contains all the functionalities required to operate PLAXIS. The python interpreter is automatically installed when PLAXIS is installed.
Location of the Python interpreter:
C:\ProgramData\Bentley\Geotechnical\PLAXIS Python Distribution V2\python\python.exe
Edit (24/10/2023): New directory for PLAXIS V2023.1/2
C:\ProgramData\Seequent\PLAXIS Python Distribution V2\python\python.exe
To select a specific environment, use the Python: Select Interpreter command from the Command Palette (Ctrl+Shift+P). Click “Enter interpreter path…” , then browse the python.exe in the location mentioned above.
In the Terminal tab, select Command Prompt in the drop-down list as highlighted below.
You should see (PLAXIS) in front of the working directory if the environment is activated successfully.
Create .py file in the folder
Click the New file icon:
Create .py file as below:
Next section we will start connecting to the PLAXIS API.
Step 3: Connect PLAXIS API
I will first create an empty python script and call it “create_plate.py” as shown below.
After that, we write the code below to the python file. Three things are doing here:
Import modules from PLAXIS Python environment. In order to operate PLAXIS with Python script, we need to use the functions (more commonly known as methods in terms of programming) developed by PLAXIS. The module we import is called “plxscripting.east”
Open PLAXIS 2D desktop application. The path of the Plaxis2DXInput.exe should be the same as listed below if default installation path is adopted. If that’s not the case, simply change the path to the correct directory. Port number and Password can stay as default but you can select any values you want.
Start the PLAXIS scripting server with the pre-defined port number and password.
from plxscripting.easy import *
import subprocess, time
PLAXIS_PATH = r'C:\Program Files\Bentley\Geotechnical\PLAXIS 2D CONNECT Edition V22\\Plaxis2DXInput.exe' # Specify PLAXIS path on server.
PORT_i = 10000 # Define a port number.
PORT_o = 10001
PASSWORD = 'SxDBR
To test that the code above is working properly, we will run “create_plate.py” in the terminal as shown below. Type “python create_plate.py” and click Enter.
The PLAXIS 2D app should be opened automatically. If the server is configured correctly, you should see “SERVER ACTIVE” as shown below.
Now that we connect to the PLAXIS API server, we can then create a plate element in PLAXIS using Python script.
Step 4: Create First Plate Element
In this part of the tutorial, we aim to create a plate element with positive and negative interfaces. Then we assign “Concrete” material to the element.
First, we define the material name and geometry. I plan to create a line from (-10,0) to (10,0). The square bracket [ ] is calledlistin python, which is a very common data type to store values. To access the values stored in a list, it is called in the following syntax:
If I want to access the coordinates of first point, I use
x coordinate = -10 = first_point[0]
y coordinate = 10 = first_point[1]
0 and 1 here called index which always starts from 0.
Then we create the material and assign it to the plate material list. To create plate material, the command “g_i.platemat()” is used. The code underneath is to assign the plate object to a list.
material=['Concrete']
first_point=[-10,0]
second_point=[10,0]
# Create material
for i in range(len(material)):
g_i.platemat('Identification',material[i])
platematerials = [mat for mat in g_i.Materials[:] if mat.TypeName.value == 'PlateMat']
After that, we create plate element with “g_i.plate()” based on the pre-defined coordinates.
If you rerun the script, you will see the following is created in PLAXIS. As you see, the “Concrete” material is created and is assigned to the plate element we created.
Congratulations! You have just created your first plate element in PLAXIS using Python!
Conclusion
That’s the end of the first tutorial on automating PLAXIS with Python. In the future, I will keep posting tutorials on using Python in PLAXIS. More than that, I’m also keen to share knowledge on how to use Python to automate boring workflow in engineering.
If you’re interested in hearing more about Python, PLAXIS and workflow automation, feel free to follow my page. You can also support me by following me onMediumwhere I will provide source code and more general programming techniques in the future.
