Welcome to the PyAnsys metapackage repository. The pyansys
metapackage
provides a single package of collected PyAnsys packages that ensures compatibility
of these packages amongst themselves and the Ansys product release that they are linked to.
The pyansys
metapackage ensures compatibility between these PyAnsys packages:
- PyAEDT: Pythonic interface to AEDT (Ansys Electronics Desktop).
- PyAnsys Math: Pythonic interface to PyAnsys Math libraries.
- PyDPF - Core: Pythonic interface to Ansys DPF (Data Processing Framework) for building more advanced and customized workflows.
- PyDPF - Post: Pythonic interface to access and post process Ansys solver result files.
- PyDPF - Composites: Pythonic interface for DPF's postprocessing of layered and short-fiber composite models.
- PyDynamicReporting: Pythonic interface to Ansys Dynamic Reporting for service and control of its database and reports.
- PyFluent: Pythonic interface to Ansys Fluent.
- PyFluent - Parametric: Pythonic interface to Ansys Fluent parametric workflows.
- PyFluent - Visualization: Pythonic interface to visualize Ansys Fluent simulations.
- PyMAPDL: Pythonic interface to Ansys MAPDL (Mechanical APDL).
- PyMAPDL Reader: Pythonic interface to read legacy MAPDL result files (MAPDL 14.5 and later).
- PyMechanical: Pythonic interface to Ansys Mechanical.
- PyMotorCAD: Pythonic interface to Ansys Motor-CAD.
- PyOptislang: Pythonic interface to Ansys Optislang.
- PyPIM: Pythonic interface to communicate with the Ansys PIM (Product Instance Management) API.
- PyPrimeMesh: Pythonic interface to Ansys Prime Server, which delivers core Ansys meshing technology.
- PySeascape: Pythonic interface to communicate with Ansys RedHawkSC and TotemSC.
- PySherlock: Pythonic interface to communicate with Ansys Sherlock.
- PySystemCoupling: Pythonic interface to communicate with Ansys System Coupling.
- PyTwin: Pythonic interface to communicate with consumption workflows for Ansys digital twins.
- Granta MI BoM Analytics: Pythonic interface to Ansys Granta MI BoM Analytics services.
- Granta MI RecordLists: Pythonic interface to Ansys Granta MI Lists API.
- Shared Components: Shared Ansys software components to enable package interoperability and minimize maintenance.
Much effort is underway to continue expanding and developing packages in the
PyAnsys GitHub account. On the Issues
page
for each package, you can post issues and request new features. You can also feel
free to post a question on the Ansys Developer Forums.
By default, the PyAnsys metapackage installs these core modules:
- PyAEDT
- PyAnsys Math
- PyDPF - Core
- PyDPF - Post
- PyDPF - Composites
- PyDynamicReporting
- PyFluent
- PyMAPDL
- PyMechanical
- PyMotorCAD
- PyOptislang
- PyPIM
- PyPrimeMesh
- PySeascape
- PySherlock
- PySystemCoupling
- PyTwin
- Granta MI BoM Analytics
- Granta MI RecordLists
- Shared Components
Additionally, the pyansys
metapackage contains certain extra targets that
can be installed upon request:
- mapdl-all: This target installs the core packages and PyMAPDL Reader.
- fluent-all: This target installs the core packages and PyFluent - Parametric and PyFluent - Visualization.
- all: This target installs all extra
pyansys
packages.
Two installation modes are provided: user and offline.
Before installing the pyansys
metapackage in user mode, ensure that you have
the latest version of pip with this command:
python -m pip install -U pip
Then, install the pyansys
metapackage with this command:
python -m pip install pyansys
If you are interested in installing an extra target such as fluent-all
,
you use a command like this:
python -m pip install pyansys[fluent-all]
If you are interested in installing a specific version such as 2023.1.0
,
you use a command like this:
python -m pip install pyansys==2023.1.0
If you lack an internet connection on your installation machine, the recommended way of installing
the pyansys
metapackage is downloading the wheelhouse archive from the
Releases Page for your corresponding machine architecture.
Each wheelhouse archive contains all the Python wheels necessary to install the pyansys
metapackage from
scratch on Windows, Linux, and MacOS from Python 3.8 to 3.11. You can install this on an isolated system with
a fresh Python installation or on a virtual environment.
For example, on Linux with Python 3.8, unzip the wheelhouse archive and install it with the following commands:
unzip pyansys-v2023.1.dev0-wheelhouse-Linux-3.8-core.zip wheelhouse
pip install pyansys -f wheelhouse --no-index --upgrade --ignore-installed
If you're on Windows with Python 3.9, unzip to a wheelhouse directory and then install using
the same pip
command as in the previous example.
Consider installing using a virtual environment.
The pyansys
metapackage follows a semantic-like versioning system, though it has been adapted to the
Ansys product release mechanism. Thus, this kind of versioning system is followed:
XXXX.Y.ZZ
Where:
XXXX
is the Ansys product release year (for example, 2022).Y
is the Ansys product release within the same year (for example, 1, which relates to R1).ZZ
is a patched version to thepyansys
metapackage, if any.
Consequently, the first pyansys
metapackage compatible with the 2024 R2 release would be:
2024.2.0
Any subsequent patched version of this package would be:
2024.2.1
2024.2.2
2024.2.3
...
You can request a specific version install when using pip
to install
your package:
python -m pip install pyansys==2024.2.0
All PyAnsys libraries are licensed under the MIT license.
PyAnsys libraries make no commercial claim over Ansys whatsoever. These libraries extend the functionality of Ansys products by adding Python interfaces to legally obtained software products without changing the core behaviors or licenses of the original software.
For more information on Ansys products, visit the Ansys web site.