A python wrapper for Ansys Mechanical
Project description
Overview
PyMechanical brings Ansys Mechanical to Python. It enables your Python programs to use Mechanical within Python’s ecosystem. It includes the ability to:
Connect to a remote Mechanical session
Embed an instance of Mechanical directly as a Python object
Install the package
Install PyMechanical using pip with:
pip install ansys-mechanical-core
For more details, see PyMechanical - Install the package
Dependencies
You must have a licensed copy of Ansys Mechanical installed. When using an embedded instance, that installation must be runnable from the same computer as your Python program. When using a remote session, a connection to that session must be reachable from your Python program.
Getting started
PyMechanical uses the built-in scripting capabilities of Mechanical. For information on the scripting APIs available, see the Scripting in Mechanical Guide in the Ansys Help.
Configuring the Mechanical installation
On a Windows system, the environment variable AWP_ROOT<ver> is configured when Mechanical is installed, where <ver> is the Mechanical release number, such as 231 for release 2023 R1. PyMechanical automatically uses this environment variable (or variables if there are multiple installations of different versions) to locate the latest Mechanical installation. On a Linux system, you must configure the AWP_ROOT<ver> environment variable to point to the absolute path of a Mechanical installation.
Starting a remote session
To start a remote session of Mechanical on your computer from Python, use the launch_mechanical() method. This methods returns an object representing the connection to the session:
import ansys.mechanical.core as pymechanical
mechanical = pymechanical.launch_mechanical()
Running commands on the remote session
Given a connection to a remote session, you can send an IronPython script. This uses the built-in scripting capabilities of Mechanical. Here is an example:
result = mechanical.run_python_script("2+3")
result = mechanical.run_python_script("ExtAPI.DataModel.Project.ProjectDirectory")
Using an embedded instance of Mechanical as a Python object
PyMechanical also supports directly embedding an instance of Mechanical as a Python object. In this mode, there is no externally running instance of Mechanical. This feature is supported on Windows for version 2023 R1 and later, and it will be supported on Linux for version 2023 R2 and later. Here is an example:
import ansys.mechanical.core as pymechanical
app = pymechanical.App()
result = app.ExtAPI.DataModel.Project.ProjectDirectory
Testing and Development
If you would like to test or contribute to the development of PyMechanical, please visit PyMechanical - Contributing.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ansys-mechanical-core-0.8.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3470934779f2bda259a751146406a88f0d40c60ab3a290443023c2bf5d902564 |
|
MD5 | 6c2df6837f5ef51badadb6fcf21bb530 |
|
BLAKE2b-256 | 18c0310c9c3371b6ef5121977ade9bf075fa76a1e9c63537c40ab9490446fc62 |
Hashes for ansys_mechanical_core-0.8.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 819ae4627ddfb07e89eb8f2f210da92ad710837f82f2fc232a022138f1102106 |
|
MD5 | 9f2c9a1aa63ab973dfde99472043d620 |
|
BLAKE2b-256 | 2a3cceec25ed812473e8649a2544ee384f040dc8f8ca311b173518a78c1b4bbc |