https://github.com/ansys/pymaterials-manager

Python package to unify material management across the Ansys portfolio
https://github.com/ansys/pymaterials-manager

Last synced: 2 months ago
JSON representation

Python package to unify material management across the Ansys portfolio

• Host: GitHub
• URL: https://github.com/ansys/pymaterials-manager
• Owner: ansys
• License: mit
• Created: 2022-12-06T09:45:26.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-19T14:44:04.000Z (2 months ago)
• Last Synced: 2025-03-20T05:55:56.535Z (2 months ago)
• Language: Python
• Homepage: https://manager.materials.docs.pyansys.com
• Size: 5.47 MB
• Stars: 0
• Watchers: 6
• Forks: 0
• Open Issues: 9
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
PyMaterials Manager

===================

|pyansys| |python| |pypi| |GH-CI| |codecov| |MIT| |black|

.. |pyansys| image:: 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

   :target: https://docs.pyansys.com/

   :alt: PyAnsys

.. |python| image:: https://img.shields.io/pypi/pyversions/ansys-materials-manager

   :target: https://pypi.org/project/ansys-materials-manager/

   :alt: Python

.. |pypi| image:: https://img.shields.io/pypi/v/ansys-materials-manager.svg?logo=python&logoColor=white

   :target: https://pypi.org/project/ansys-materials-manager

   :alt: PyPI

.. |codecov| image:: https://codecov.io/gh/ansys/pymaterials-manager/branch/main/graph/badge.svg

   :target: https://codecov.io/gh/ansys/pymaterials-manager

   :alt: Codecov

.. |GH-CI| image:: https://github.com/ansys/pymaterials-manager/actions/workflows/ci_cd.yml/badge.svg

   :target: https://github.com/ansys/pymaterials-manager/actions/workflows/ci_cd.yml

   :alt: GH-CI

.. |MIT| image:: https://img.shields.io/badge/License-MIT-yellow.svg

   :target: https://opensource.org/licenses/MIT

   :alt: MIT

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=flat

   :target: https://github.com/psf/black

   :alt: Black

PyMaterials Manager is a Python package for unifying material management across the Ansys portfolio.

PyMaterials Manager is currently a proof of concept, expect things to break.

It currently provides the following features:

- It defines a Material Object that can have different material models

- The supported material models can be read from a running PyMAPDL instance

- The supported material models can written to a running PyMAPDL / pyFluent instance

- Some supported material models can be read from a MatML XML file

- Some supported material models can be written to a MatML XML file

The following material models are supported:

- pyMAPDL

    - Simple constant material properties

    - Piecewise linear material properties

    - Polynomial material properties

    - Anisotropic Elasticity

- pyFluent

    - Simple constant material properties

    - Ideal Gas properties

Installation

------------

Install the ``ansys-materials-manager`` package with this code:

.. code::

   pip install ansys-materials-manager

Alternatively, clone and install this package with this code:

.. code::

   git clone https://github.com/ansys/pymaterials-manager

   cd pymaterials-manager

   pip install .

Testing

-------

This project takes advantage of `tox`_. This tool is used to automate common

development tasks (similar to Makefile), but it is oriented towards Python

development. 

Use ``tox``

^^^^^^^^^^^

`tox`_ uses environments, which are similar to ``Makefile`` rules, to make it highly

customizable. In fact, this tool creates its own virtual environment so that anything

being tested is isolated from the project to guarantee the project's integrity.

Descriptions follow of some of the most widely used environments:

- **tox -e style**: Checks the code style of your project.

- **tox -e py**: Runs your test suite.

- **tox -e doc**: Builds the documentation of your project.

Perform raw testing

^^^^^^^^^^^^^^^^^^^

If required, you can call style commands (such as `black`_, `isort`_,

and `flake8`_) or unit testing commands (such as `pytest`_) from the command

line. However, calling these commands does not guarantee that your project

is being tested in an isolated environment, which is the reason why tools

like `tox`_ exist.

Use pre-commit

^^^^^^^^^^^^^^

The style checks take advantage of `pre-commit`_. Developers are not forced but

encouraged to install this tool by running this command:

.. code:: bash

    python -m pip install pre-commit && pre-commit install

Every time you stage some changes and try to commit them,

``pre-commit`` only allows them to be committed if all defined hooks succeed.

Documentation and issues

------------------------

For comprehensive information on PyMaterials Manager, see the latest release `documentation`_.

On the `PyMaterials Manager Issues`_ page, you can create issues to submit questions,

report bugs, and request new features. This is the best place to post questions and code.

Distribution

------------

If you want to create either source or wheel files, start by installing poetry and then 

executing the build module. To install poetry you should use the ``pipx`` installation

method in the `poetry documentation`_.

.. code:: bash

    poetry install

    poetry build

    twine check ./dist

.. LINKS AND REFERENCES

.. _black: https://github.com/psf/black

.. _flake8: https://flake8.pycqa.org/en/latest/

.. _isort: https://github.com/PyCQA/isort

.. _pip: https://pypi.org/project/pip/

.. _pre-commit: https://pre-commit.com/

.. _PyAnsys Developer's Guide: https://dev.docs.pyansys.com/

.. _pytest: https://docs.pytest.org/en/stable/

.. _Sphinx: https://www.sphinx-doc.org/en/master/

.. _tox: https://tox.wiki/

.. _PyMaterials Manager Issues: https://github.com/ansys/pymaterials-manager/issues

.. _documentation: https://manager.materials.docs.pyansys.com/

.. _poetry documentation: https://python-poetry.org/docs/#installing-with-pipx