Extending the Python environment
Last update: 20.02.2025Because ACP is delivered with a frozen Python, the Python environment cannot be modified with standard modules such as pip. Nevertheless, it is possible to import and use Python modules within ACP which are not delivered with the installation (matplotlib, for example). You can do this by creating a virtual Python environment (VENV) and adding this environment to the ACP Python path.
How to create a virtual environment
First, make sure you are using the same version of Python that ACP is using. To call
up the version number, type sys.version in ACP’s Python shell.
There are several options for generating your own VENV.
-
Using the installed Ansys Python, navigate to the delivered Ansys Python that is in the subfolder of
<WB root dir>\commonfiles\CPythonand call the venv module.python.exe -m venv C:\my_ansys_python_envThis command creates a new environment in the folder
C:\my_ansys_python_env. -
After installing Python, call the venv module to create a new VENV, using standard Python:
python.exe -m venv C:\my_new_python_env`This command creates a new VENV in the folder
C:\my_new_python_env. -
There are other Python distributions as well (Anaconda, for example) which enable you to create virtual environments.
How to install a module in your virtual environment and use it within ACP
You must activate the virtual Python environment before additional modules can be installed. The example below shows how to install matplotlib into your virtual Python environment using the Windows Command Prompt:
C:\my_new_python_env\scripts\activate
pip install matplotlib
You are now ready to add the virtual Python environment to ACP’s Python. Use the VENV Python packages in ACP’s Python by appending the directories of the VENV to the Python system path of ACP. The Python path of the VENV is available through
import sys
sys.path
Copy this list of paths and add them in the ACP Python shell.
sys.path.extend([….])
Appending the VENV paths to the Python path of ACP is important because it ensures the lookup goes through the ACP Python first before going into the VENV.
Note: ACP uses Ansys’ Python which comes with the installation of Ansys Workbench. You can find
it in <installation dir>\commonfiles\CPython. It is possible that the Ansys version was built
with a different compiler than the one used for the official version of Python or the version
you are running. Its delivered modules and libraries may also differ. This can cause runtime
issues if your Python environment and its installed packages are not compatible with Ansys Python,
even if they were built with the same or compatible compilers.
Alternatives to extending ACP’s Python
With regard to dictionaries, DataFrames, or other data types, you can write to the disk using Python’s native pickle module in order to use the data in another program or share it with others. To do so, use the following commands:
import pickle
import numpy as np
example_array = np.zeros((1000,2))
with open('test.pkl','wb') as f:
pickle.dump(example_array, f)
You can then load the stored data in a different environment using pickle again and then process the data:
import pickle
with open('test.pkl','rb') as f:
loaded_array = pickle.load(f)
Numpy offers similar functionality. See numpy.save, numpy.savez, and numpy.load for more details.