ansys-dpf-post 0.5.0

PyDPF-Post Python library.

PyDPF-Post - Ansys Data PostProcessing Framework

The Ansys Data Processing Framework (DPF) is designed to provide numerical simulation users and engineers with a toolbox for accessing and transforming simulation data.

The Python ansys-dpf-post package provides a high-level, physics-oriented API for postprocessing. Loading a simulation (defined by its result files) allows you to extract simulation metadata as well as results and then apply postprocessing operations on it.

The latest version of DPF supports Ansys solver result files for:

• MAPDL (.rst, .mode, .rfrq, .rdsp)
• LS-DYNA (.d3plot, .binout)
• Fluent (.cas/dat.h5, .flprj)
• CFX (.cad/dat.cff, .flprj)

See the PyDPF-Core main page <https://dpf.docs.pyansys.com/version/stable/index.html>_ for more information on compatibility.

This module leverages the PyDPF-Core project's ansys-dpf-core package, which is available at PyDPF-Core GitHub. Use the ansys-dpf-core package for building more advanced and customized workflows using Ansys DPF.

Documentation

For comprehensive information on this package, see the PyDPF-Post Documentation, For detailed how-to information, see the Examples in the PyDPF-Post documentation.

Installation

To install this package, use this command:

pip install ansys-dpf-post

You can also clone and install this package with this code:

git clone https://github.com/ansys/pydpf-post
cd pydpf-post
pip install . --user

Brief demo

Provided you have Ansys 2023 R1 or later installed, a DPF server starts automatically once you start using PyDPF-Post.

To load a simulation to extract and post-process results, use this code:

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> simulation = post.load_simulation(examples.download_crankshaft())
>>> displacement = simulation.displacement()
>>> print(displacement)

             results       U (m)
             set_ids           3
 node_ids components            
     4872          X -3.4137e-05
                   Y  1.5417e-03
                   Z -2.6398e-06
     9005          X -5.5625e-05
                   Y  1.4448e-03
                   Z  5.3134e-06
      ...        ...         ...

>>> displacement.plot()

>>> stress_eqv = simulation.stress_eqv_von_mises_nodal()
>>> stress_eqv.plot()

To run PyDPF-Post with Ansys versions 2021 R1 and 2022 R2, use this code to start the legacy PyDPF-Post tools::

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.download_crankshaft())
>>> stress = solution.stress()
>>> stress.eqv.plot_contour(show_edges=False)

License

PyDPF-Post is licensed under the MIT license. For more information, see the LICENSE.