abqpy 2022.2.5

Type hints for Abaqus/Python scripting

abqpy 2022

Read this in other languages: English, 简体中文.

Type hints for Abaqus/Python scripting

abqpy is a Python package providing type hints for Python scripting of Abaqus, you can use it to write your Python script of Abaqus fluently, even without doing anything in Abaqus. It also provides some simple APIs to execute the Abaqus commands so that you can run your Python script to build the model, submit the job and extract the output data in just one Python script, even without opening the Abaqus/CAE.

Other links for this project

• GitHub repository: github.com/haiiliin/abqpy
• GitHub repository for translations: github.com/haiiliin/abqpy-translations
• PyPI: pypi.org/project/abqpy
• Anaconda: anaconda.org/haiiliin/abqpy
• Read the Docs: readthedocs.org/projects/abqpy
• Documentation: abqpy.haiiliin.com
• Join Crowdin for documentation translation: crowdin.com/project/abqpy

Pull Requests are Welcome

Since abqpy is reconstructed from the official Abaqus documentation, many of the docstrings are not well formatted, for example, the Raises section, the math equations, the attributes of the objects, due to the limitation of my time, those things are left behind, if anyone is willing to make any contributions, please feel free to create your pull requests.

Installation

abqpy supports Python 3.7 or a later version. If you are using Python 3.6 or an earlier version, please upgrade to Python 3.7 or a later version.

abqpy is uploaded to PyPI, you can simply install it using pip:

pip install abqpy

abqpy is also uploaded to anaconda, you can use conda to install it:

conda install -c haiiliin abqpy

Install A Specific Version

You can specify the version number when installing abqpy, for example:

pip install abqpy==2022.1.1
conda install -c haiiliin abqpy=2022.1.1

A better way is to use * to match specific version:

pip install abqpy==2022.*

Optional Requirements

You can put your Abaqus/Python script into a Jupyter Notebook. When you run the notebook, the package will convert the notebook into a plain Python file with the same name but with .py suffix instead of .ipynb, and then it will be submitted to Abaqus kernel.

Go examples for tests using Jupyter Notebooks to build the Abaqus model.

In order to use the Jupyter Notebook feature, you have to install the following packages:

pip install ipynbname  # to read the file name of the notebook
pip install notebook
pip install jupyterlab

Or use conda to install (the ipynbname package is only distributed in PyPI, so you have to install it using pip):

conda install jupyterlab
conda install jupyter notebook

Try the following command to make sure the jupyter command is available.

jupyter --version

You may install the latest development version by cloning the GitHub repository and use python to install from the local directory:

git clone https://github.com/haiiliin/abqpy.git
cd abqpy
python setup.py install

Setup Abaqus Environment

In order to use Abaqus command to execute the Python script and submit the job, you need to tell abqpy where the Abaqus command is located. Usually, Abaqus command locates in a directory like this:

C:/SIMULIA/Commands/abaqus.bat

You can add the directory C:/SIMULIA/Commands to the system environment variable Path, or you can create a new system variable named ABAQUS_BAT_PATH, and set the value to the file path of the Abaqus command, i.e., C:/SIMULIA/Commands/abaqus.bat.

Screenshots

• Create an Abaqus Model

  

• Extract Output Data

  

Explore more

For detailed usage of this package, please refer to the documentation.