{"id":14673131,"url":"https://github.com/ansys/pymapdl","last_synced_at":"2025-05-14T12:12:16.253Z","repository":{"id":36952155,"uuid":"70696039","full_name":"ansys/pymapdl","owner":"ansys","description":"A Python client library for Ansys MAPDL","archived":false,"fork":false,"pushed_at":"2025-04-09T04:53:43.000Z","size":306899,"stargazers_count":447,"open_issues_count":209,"forks_count":131,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-04-09T05:29:22.914Z","etag":null,"topics":["ansys","apdl","engineering","finite-elements","mesh","numerical-simulation","post-treatment","pre-treatment","python","structural-mechanics"],"latest_commit_sha":null,"homepage":"https://mapdl.docs.pyansys.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ansys.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-12T12:06:55.000Z","updated_at":"2025-04-08T20:18:24.000Z","dependencies_parsed_at":"2025-04-02T05:35:17.015Z","dependency_job_id":null,"html_url":"https://github.com/ansys/pymapdl","commit_stats":null,"previous_names":["pyansys/pymapdl"],"tags_count":179,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansys%2Fpymapdl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansys%2Fpymapdl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansys%2Fpymapdl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansys%2Fpymapdl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansys","download_url":"https://codeload.github.com/ansys/pymapdl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248154987,"owners_count":21056542,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansys","apdl","engineering","finite-elements","mesh","numerical-simulation","post-treatment","pre-treatment","python","structural-mechanics"],"created_at":"2024-09-12T06:03:37.560Z","updated_at":"2025-05-14T12:12:16.241Z","avatar_url":"https://github.com/ansys.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n   \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/ansys/pymapdl/blob/main/doc/source/_static/logo_dark.png\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/ansys/pymapdl/blob/main/doc/source/_static/logo_light.png\"\u003e\n      \u003cimg alt=\"PyMAPDL Logo\" src=\"https://raw.githubusercontent.com/ansys/pymapdl/blob/main/doc/source/_static/logo_light.png\" width=\"70%\"\u003e\n   \u003c/picture\u003e\n\u003c/p\u003e\n\n[![pyansys](https://img.shields.io/badge/Py-Ansys-ffc107.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAABDklEQVQ4jWNgoDfg5mD8vE7q/3bpVyskbW0sMRUwofHD7Dh5OBkZGBgW7/3W2tZpa2tLQEOyOzeEsfumlK2tbVpaGj4N6jIs1lpsDAwMJ278sveMY2BgCA0NFRISwqkhyQ1q/Nyd3zg4OBgYGNjZ2ePi4rB5loGBhZnhxTLJ/9ulv26Q4uVk1NXV/f///////69du4Zdg78lx//t0v+3S88rFISInD59GqIH2esIJ8G9O2/XVwhjzpw5EAam1xkkBJn/bJX+v1365hxxuCAfH9+3b9/+////48cPuNehNsS7cDEzMTAwMMzb+Q2u4dOnT2vWrMHu9ZtzxP9vl/69RVpCkBlZ3N7enoDXBwEAAA+YYitOilMVAAAAAElFTkSuQmCC)](https://docs.pyansys.com/)\n[![pypi](https://img.shields.io/pypi/v/ansys-mapdl-core.svg?logo=python\u0026logoColor=white)](https://pypi.org/project/ansys-mapdl-core/)\n[![PyPIact](https://img.shields.io/pypi/dm/ansys-mapdl-core.svg?label=PyPI%20downloads)](https://pypi.org/project/ansys-mapdl-core/)\n[![codecov](https://codecov.io/gh/ansys/pymapdl/branch/main/graph/badge.svg)](https://codecov.io/gh/ansys/pymapdl)\n[![GH-CI](https://github.com/ansys/pymapdl/actions/workflows/ci.yml/badge.svg)](https://github.com/ansys/pymapdl/actions/workflows/ci.yml)\n[![zenodo](https://zenodo.org/badge/70696039.svg)](https://zenodo.org/badge/latestdoi/70696039)\n[![MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat)](https://github.com/psf/black)\n[![pre-commit](https://results.pre-commit.ci/badge/github/ansys/pymapdl/main.svg)](https://results.pre-commit.ci/latest/github/ansys/pymapdl/main)\n\n## Overview\n\nThe PyMAPDL project supports Pythonic access to MAPDL to be able to\ncommunicate with the MAPDL process directly from Python. The latest\n[ansys-mapdl-core](https://pypi.org/project/ansys-mapdl-core/) package\nenables a more comprehensive interface with MAPDL and supports:\n\n-  All the features of the original module (for example, Pythonic commands \n   and interactive sessions).\n\n-  Remote connections to MAPDL from anywhere via gRPC.\n\n-  Direct access to MAPDL arrays, meshes, and geometry as Python\n   objects.\n\n-  Low-level access to the MAPDL solver through APDL math in a SciPy-\n   like interface.\n\nHere's a quick demo of PyMAPDL within Visual Studio Code:\n\n![landing_demo](https://github.com/ansys/pymapdl/raw/main/doc/source/_static/landing_page_demo.gif)\n\nPyMAPDL works within Jupyter Notebooks, the standard Python console,\nor in batch mode on Windows, Linux, and even macOS.\n\n## Documentation and issues\n\nDocumentation for the latest stable release of PyMAPDL is hosted at\n[PyMAPDL Documentation](https://mapdl.docs.pyansys.com).\n\nIn the upper right corner of the documentation's title bar, there is an option for switching from\nviewing the documentation for the latest stable release to viewing the documentation for the\ndevelopment version or previously released versions.\n\nYou can also [download](https://mapdl.docs.pyansys.com/version/stable/_static/cheat_sheet.pdf) the\nPyMAPDL cheat sheet. This one-page reference provides syntax rules and commands\nfor using PyMAPDL. \n\nFor troubleshooting, visit \n[Troubleshooting PyMAPDL](https://mapdl.docs.pyansys.com/version/stable/user_guide/troubleshoot.html#troubleshooting-pymapdl)\n\nOn the [PyMAPDL Issues](https://github.com/ansys/pymapdl/issues) page,\nyou can create issues to report bugs and request new features. On the \n[PyMAPDL Discussions](https://github.com/ansys/pymapdl/discussions) page\nor the  [Discussions](https://discuss.ansys.com/) page on the\n[Ansys Developer portal](https://developer.ansys.com),\nyou can post questions, share ideas, and get community feedback. \n\nTo reach the project support team, email [PyAnsys Core team](pyansys.core@ansys.com).\nUnfortunately, this team cannot answer specific library questions or issues. You must\nuse the [PyMAPDL Issues](https://github.com/ansys/pymapdl/issues)\nand [PyMAPDL Discussions](https://github.com/ansys/pymapdl/discussions) pages\nfor raising issues, request new features, and asking questions.\n\nYou can contribute to PyMAPDL by developing new features, fixing bugs, improving the documentation,\nfixing typos, writing examples, etc.\nTo learn how to contribute to PyMAPDL, visit [Contributing section](https://mapdl.docs.pyansys.com/version/stable/getting_started/contribution.html).\n\n\n## Project transition -  legacy support\n\nThis project was formerly known as ``pyansys``, and we'd like to thank\nall the early adopters, contributors, and users who submitted issues,\ngave feedback, and contributed code through the years.  The\n``pyansys`` project has been taken up at Ansys and is being leveraged in\ncreating new Pythonic, cross-platform, and multi-language service-based\ninterfaces for Ansys's products.  Your contributions to\n``pyansys`` has shaped it into a better solution.\n\nThe ``pyansys`` project is expanding beyond just MAPDL, and while\nthere are many new features and changes to the original Python module,\nmany steps have been taken to ensure compatibility with legacy code\nwhile supporting new features.  The original Python module has been\nsplit up into the following projects and modules:\n\n-  [ansys.mapdl.core](https://github.com/ansys/pymapdl)\n-  [ansys.mapdl.reader](https://github.com/ansys/pymapdl-reader)\n-  [ansys.mapdl.corba](https://github.com/ansys/pymapdl-corba)\n\nFor more information on each project, visit their GitHub pages.\n\n## Citing this module\n\nIf you use [PyMAPDL](https://mapdl.docs.pyansys.com/version/stable/) for\nresearch and would like to cite the module and source, you can visit \n[pyansys Zenodo](https://zenodo.org/badge/latestdoi/70696039) and generate the\ncorrect citation.  For example, the BibTex citation is:\n\n```bibtex\n@software{alexander_kaszynski_2020_4009467,\n  author       = {Alexander Kaszynski},\n  title        = {{pyansys: Pythonic interface to MAPDL}},\n  month        = nov,\n  year         = 2021,\n  publisher    = {Zenodo},\n  version      = {0.60.3},\n  doi          = {10.5281/zenodo.4009466},\n  url          = {https://doi.org/10.5281/zenodo.4009466}\n}\n```\n\nBecause the citation here might not be current, visit the link above to obtain\nthe most recent citation.\n\n## License and acknowledgments\n\n[PyMAPDL](https://mapdl.docs.pyansys.com/) is licensed under\n[the MIT license](https://github.com/ansys/pymapdl/blob/main/LICENSE).\n\n[ansys-mapdl-core](https://pypi.org/project/ansys-mapdl-core/) package\nmakes no commercial claim over Ansys whatsoever.  \nThis tool extends the functionality of ``MAPDL`` by adding a Python\ninterface to the MAPDL service without changing the\ncore behavior or license of the original software.  The use of the\ninteractive APDL control of [PyMAPDL](https://mapdl.docs.pyansys.com/)\nrequires a legally licensed local copy of Ansys.\n\nTo get a copy of Ansys, visit [Ansys](https://www.ansys.com/).\n","funding_links":[],"categories":["PDE Solver"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansys%2Fpymapdl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansys%2Fpymapdl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansys%2Fpymapdl/lists"}