Metadata-Version: 2.1
Name: ansys-meshing-prime
Version: 0.5.0.dev2
Summary: PyPrimeMesh is a Python client to Ansys Prime Server, which delivers core Ansys meshing technology.
Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
Requires-Python: >=3.8,<4
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: ansys-api-meshing-prime==0.1.1
Requires-Dist: numpy>=1.14.0
Requires-Dist: appdirs>=1.4.0
Requires-Dist: importlib-metadata>=4.0,<5; python_version<='3.8'
Requires-Dist: pyvista>=0.32.0 ; extra == "all"
Requires-Dist: ansys-sphinx-theme==0.9.9 ; extra == "doc"
Requires-Dist: jupyter-sphinx==0.4.0 ; extra == "doc"
Requires-Dist: numpydoc==1.5.0 ; extra == "doc"
Requires-Dist: Sphinx==7.0.1 ; extra == "doc"
Requires-Dist: pyvista==0.40.1 ; extra == "doc"
Requires-Dist: sphinx-autodoc-typehints==1.23.3 ; extra == "doc"
Requires-Dist: sphinx-copybutton==0.5.2 ; extra == "doc"
Requires-Dist: sphinx-gallery==0.13.0 ; extra == "doc"
Requires-Dist: sphinx-notfound-page==0.8.3 ; extra == "doc"
Requires-Dist: sphinxemoji==0.2.0 ; extra == "doc"
Requires-Dist: pyvista>=0.32.0 ; extra == "graphics"
Requires-Dist: pytest==7.4.0 ; extra == "tests"
Requires-Dist: pytest-cov==4.1.0 ; extra == "tests"
Requires-Dist: pytest-pyvista==0.1.8 ; extra == "tests"
Requires-Dist: pyvista[trame]==0.40.0 ; extra == "tests"
Project-URL: Documentation, https://prime.docs.pyansys.com
Project-URL: Source, https://github.com/ansys/pyprimemesh
Provides-Extra: all
Provides-Extra: doc
Provides-Extra: graphics
Provides-Extra: tests

# PyPrimeMesh

[![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/)
[![GH-CI](https://github.com/ansys/pyprimemesh/actions/workflows/ci_cd.yml/badge.svg)](https://github.com/ansys/pyprimemesh/actions/workflows/ci_cd.yml)
[![MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat)](https://github.com/psf/black)

## Overview

PyPrimeMesh is a Python client to Ansys Prime Server, which
delivers core Ansys meshing technology.

## Documentation and Issues

For information on PyPrimeMesh, refer to the [documentation](
https://prime.docs.pyansys.com) for the latest stable version.

For queries related to PyPrimeMesh, post on the [PyPrimeMesh Discussions](
https://github.com/ansys/pyprimemesh/discussions) page. 

For bugs or enhancement requests, post an issue on the [PyPrimeMesh Issues](
https://github.com/ansys/pyprimemesh/issues) page. 

For assistance, reach out to the support team at
[pyansys.core@ansys.com](mailto:pyansys.core@ansys.com).

## Installation

The `ansys-meshing-prime` package supports Python 3.8 to Python 3.11 on the Windows and Linux
operating systems.


PyPrimeMesh can be installed with all dependencies directly from PyPi by running
this command:

```bash
pip install ansys-meshing-prime[all]
```

Alternatively, you can clone this repository and install the client using
these commands:

```bash
git clone https://github.com/ansys/pyprimemesh
cd pyprimemesh
pip install -e .[all]
```

The preceding commands install all functionality that is important to development.
To install a basic version of the client, use this command instead:

```bash
pip install -e .
```

## Dependencies

You must have Ansys 2023 R1 or later installed for access to Ansys Prime Server.
Optionally, CAD readers can be configured. Ansys Prime Server requires
an Ansys Mechanical PrepPost or Fluids PrepPost (CFD) license to run.

## Get Started

### Launching PyPrimeMesh

To launch PyPrimeMesh, use this code:

```python
import ansys.meshing.prime as prime

with prime.launch_prime() as prime_client:
    model = prime_client.model
```

## License and Acknowledgments

PyPrimeMesh is licensed under the MIT license.

PyPrimeMesh makes no commercial claim over Ansys whatsoever. This library extends the functionality of
Ansys Prime Server by adding a Python interface without changing the core behavior or license
of the original software. The use of Ansys Prime Server requires a legally licensed copy of Ansys
2023 R1 or later.

