Skip to main content

A Python client library for Ansys MAPDL.

Project description

PyMAPDL Logo

pyansys pypi PyPIact codecov GH-CI zenodo MIT black pre-commit

Overview

The PyMAPDL project supports Pythonic access to MAPDL to be able to communicate with the MAPDL process directly from Python. The latest ansys-mapdl-core package enables a more comprehensive interface with MAPDL and supports:

  • All the features of the original module (for example, Pythonic commands and interactive sessions).

  • Remote connections to MAPDL from anywhere via gRPC.

  • Direct access to MAPDL arrays, meshes, and geometry as Python objects.

  • Low-level access to the MAPDL solver through APDL math in a SciPy- like interface.

Here's a quick demo of PyMAPDL within Visual Studio Code:

landing_demo

PyMAPDL works within Jupyter Notebooks, the standard Python console, or in batch mode on Windows, Linux, and even macOS.

Documentation and issues

Documentation for the latest stable release of PyMAPDL is hosted at PyMAPDL Documentation.

In the upper right corner of the documentation's title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.

You can also download the PyMAPDL cheat sheet. This one-page reference provides syntax rules and commands for using PyMAPDL.

For troubleshooting, visit Troubleshooting PyMAPDL

On the PyMAPDL Issues page, you can create issues to report bugs and request new features. On the PyMAPDL Discussions page or the Discussions page on the Ansys Developer portal, you can post questions, share ideas, and get community feedback.

To reach the project support team, email PyAnsys Core team. Unfortunately, this team cannot answer specific library questions or issues. You must use the PyMAPDL Issues and PyMAPDL Discussions pages for raising issues, request new features, and asking questions.

You can contribute to PyMAPDL by developing new features, fixing bugs, improving the documentation, fixing typos, writing examples, etc. To learn how to contribute to PyMAPDL, visit Contributing section.

Project transition - legacy support

This project was formerly known as pyansys, and we'd like to thank all the early adopters, contributors, and users who submitted issues, gave feedback, and contributed code through the years. The pyansys project has been taken up at Ansys and is being leveraged in creating new Pythonic, cross-platform, and multi-language service-based interfaces for Ansys's products. Your contributions to pyansys has shaped it into a better solution.

The pyansys project is expanding beyond just MAPDL, and while there are many new features and changes to the original Python module, many steps have been taken to ensure compatibility with legacy code while supporting new features. The original Python module has been split up into the following projects and modules:

For more information on each project, visit their GitHub pages.

Citing this module

If you use PyMAPDL for research and would like to cite the module and source, you can visit pyansys Zenodo and generate the correct citation. For example, the BibTex citation is:

@software{alexander_kaszynski_2020_4009467,
  author       = {Alexander Kaszynski},
  title        = {{pyansys: Pythonic interface to MAPDL}},
  month        = nov,
  year         = 2021,
  publisher    = {Zenodo},
  version      = {0.60.3},
  doi          = {10.5281/zenodo.4009466},
  url          = {https://doi.org/10.5281/zenodo.4009466}
}

Because the citation here might not be current, visit the link above to obtain the most recent citation.

License and acknowledgments

PyMAPDL is licensed under the MIT license.

ansys-mapdl-core package makes no commercial claim over Ansys whatsoever.
This tool extends the functionality of MAPDL by adding a Python interface to the MAPDL service without changing the core behavior or license of the original software. The use of the interactive APDL control of PyMAPDL requires a legally licensed local copy of Ansys.

To get a copy of Ansys, visit Ansys.

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

ansys_mapdl_core-0.70.2.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

ansys_mapdl_core-0.70.2-py3-none-any.whl (2.6 MB view details)

Uploaded Python 3

File details

Details for the file ansys_mapdl_core-0.70.2.tar.gz.

File metadata

  • Download URL: ansys_mapdl_core-0.70.2.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ansys_mapdl_core-0.70.2.tar.gz
Algorithm Hash digest
SHA256 403ebe47bd33da211e52170d388b37af3e8795891e857a5cbdc6a78a6afbf22f
MD5 ea67eaf2114b5b52ee8c8038d621286f
BLAKE2b-256 fcd11cae01986024aee6cbfb4bb4f2ecb88a21059c081b6fefd5a6f25df15420

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansys_mapdl_core-0.70.2.tar.gz:

Publisher: ci.yml on ansys/pymapdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ansys_mapdl_core-0.70.2-py3-none-any.whl.

File metadata

File hashes

Hashes for ansys_mapdl_core-0.70.2-py3-none-any.whl
Algorithm Hash digest
SHA256 688d41b7e3a004a8bcf0bc2f94173ef36f906ce4d37a0d582ad9bd9edb202566
MD5 09ae64fa839f0b41a54beb7e6f841cd9
BLAKE2b-256 cedcfa3324631ba58cf10b71360dcd3a25b4d6056893ba7409bcb9bd8d7989cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansys_mapdl_core-0.70.2-py3-none-any.whl:

Publisher: ci.yml on ansys/pymapdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page