Package: pyansys
Welcome to the PyAnsys metapackage repository. Thepyansysmetapackage
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.Thepyansysmetapackage ensures compatibility between these PyAnsys packages:PyAdditive: Pythonic interface to the Ansys Additive service.PyAEDT: Pythonic interface to AEDT (Ansys Electronics Desktop).PyAnsys Geometry: Pythonic interface to the Ansys Geometry service.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.PyDyna: Pythonic interface to build the Ansys DYNA input deck, submit it to the Ansys LS-DYNA solver and postprocess its results.PyDynamicReporting: Pythonic interface to Ansys Dynamic Reporting for service and control of its database and reports.PyEDB - Core: Pythonic interface to the Electronics Database (EDB).PyEnSight: Pythonic interface to EnSight, the Ansys simulation postprocessor.PyFluent: Pythonic interface to Ansys Fluent.PyFluent - Parametric: Pythonic interface to Ansys Fluent parametric workflows.PyFluent - Visualization: Pythonic interface to visualize Ansys Fluent simulations.PyGranta: Pythonic interface to Ansys Granta MI services.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.PyTurboGrid: Pythonic interface to Ansys TurboGrid, a high-quality turbomachinery meshing software app.PyTwin: Pythonic interface to communicate with consumption workflows for Ansys digital twins.Shared Components: Shared Ansys software components to enable package interoperability and minimize maintenance.Other tools delivered as part of the metapackage are:Ansys Tools Path: Library to locate Ansys products in a local machine.Ansys Tools Protobuf Compilation Helper: Utility library to compile.protofiles to Python source when building the package wheel.PyAnsys Tools Report:  Tool for reporting your Python environment’s package versions and hardware resources in a standardized way.PyAnsys Tools Versioning: Tool for backwards and forwards server support.PyAnsys Units: Pythonic interface for units, unit systems, and unit conversions.Much effort is underway to continue expanding and developing packages in thePyAnsys GitHubaccount. On theIssuespage
for each package, you can post issues and request new features. You can also feel
free to post a question on theAnsys Developer Forums.By default, the PyAnsys metapackage installs these core modules:PyAdditivePyAEDTPyAnsys GeometryPyAnsys MathPyDPF - CorePyDPF - PostPyDPF - CompositesPyDynaPyDynamicReportingPyEDB - CorePyEnSightPyFluentPyGrantaPyMAPDLPyMechanicalPyMotorCADPyOptislangPyPIMPyPrimeMeshPySeascapePySherlockPySystemCouplingPyTurboGridPyTwinShared ComponentsAdditionally, thepyansysmetapackage contains certain extra targets that
can be installed upon request:mapdl-all: This target installs the core packages andPyMAPDL Reader.fluent-all: This target installs the core packages,PyFluent - Parametric, andPyFluent - Visualization.tools: This target installs the core packages,Ansys Tools Path,Ansys Tools Protobuf Compilation Helper,PyAnsys Tools Versioning,PyAnsys Tools Report, andPyAnsys Units.all: This target installs all extrapyansyspackages.Package installationTwo installation modes are provided: user and offline.User mode installationBefore installing thepyansysmetapackage in user mode, ensure that you have
the latest version ofpipwith this command:python-mpipinstall-UpipThen, install thepyansysmetapackage with this command:python-mpipinstallpyansysIf you are interested ininstalling an extra targetsuch asfluent-all,
you use a command like this:python-mpipinstallpyansys[fluent-all]If you are interested ininstalling a specific versionsuch as2023.1.0,
you use a command like this:python-mpipinstallpyansys==2023.1.0Offline mode installationIf you lack an internet connection on your installation machine, the recommended way of installing
thepyansysmetapackage is downloading the wheelhouse archive from theReleases Pagefor your corresponding machine architecture.Each wheelhouse archive contains all the Python wheels necessary to install thepyansysmetapackage from
scratch on Windows, Linux, and MacOS from Python 3.9 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.9, unzip the wheelhouse archive and install it with the following
commands:unzippyansys-v2024.1.5-wheelhouse-Linux-3.9-core.zipwheelhousepipinstallpyansys-fwheelhouse--no-index--upgrade--ignore-installedIf you’re on Windows with Python 3.9, unzip to a wheelhouse directory and then install using
the samepipcommand as in the previous example.Consider installing using avirtual environment.Versioning systemThepyansysmetapackage 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.ZZWhere:XXXXis the Ansys product release year (for example, 2022).Yis the Ansys product release within the same year (for example, 1, which relates to R1).ZZis a patched version to thepyansysmetapackage, if any.Consequently, the firstpyansysmetapackage compatible with the 2024 R2 release would be:2024.2.0Any subsequent patched version of this package would be:2024.2.12024.2.22024.2.3...You can request a specific version install when usingpipto install
your package:python-mpipinstallpyansys==2024.2.0License and acknowledgmentsAll 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 theAnsys web site.