Skip to main content

Data Processing Framework - Python Core

Project description

DPF - Ansys Data Processing Framework

PyAnsys Python pypi freq-PyDPF-Core GH-CI docs MIT pypidl cov codacy

Ansys Data Processing Framework (DPF) provides numerical simulation users and engineers with a toolbox for accessing and transforming simulation data. With DPF, you can perform complex preprocessing or postprocessing of large amounts of simulation data within a simulation workflow.

DPF is an independent, physics-agnostic tool that you can plug into many apps for both data input and data output, including visualization and result plots. It can access data from solver result files and other neutral formats, such as CSV, HDF5, and VTK files.

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

  • Mechanical APDL (.rst, .mode, .rfrq, .rdsp, .rth)
  • LS-DYNA (.d3plot, .binout)
  • Fluent (.cas/dat.h5, .flprj)
  • CFX (.cas/dat.cff, .flprj, .res)

For more information on file support, see the main page in the PyDPF-Core documentation.

Using the many DPF operators that are available, you can manipulate and transform this data. You can also chain operators together to create simple or complex data-processing workflows that you can reuse for repeated or future evaluations.

The data in DPF is defined based on physics-agnostic mathematical quantities described in self-sufficient entities called fields. This allows DPF to be a modular and easy-to-use tool with a large range of capabilities.

DPF flow

The ansys.dpf.core package provides a Python interface to DPF, enabling rapid postprocessing of a variety of Ansys file formats and physics solutions without ever leaving the Python environment.

Documentation and issues

Documentation for the latest stable release of PyDPF-Core is hosted at PyDPF-Core 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 view or download the PyDPF-Core cheat sheet. This one-page reference provides syntax rules and commands for using PyDPF-Core.

On the PyDPF-Core Issues page, you can create issues to report bugs and request new features. On the PyDPF-Core 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@ansys.com.

Installation

PyDPF-Core requires DPF to be available. You can either have a compatible Ansys version installed or install the standalone ansys-dpf-server server package. For more information, see Getting Started with DPF Server in the PyDPF-Core documentation.

For the compatibility between PyDPF-Core and Ansys, see Compatibility in the PyDPF-Core documentation.

To use PyDPF-Core with the ansys-dpf-server server package or with Ansys 2022 R2 or later, install the latest version with this command:

   pip install ansys-dpf-core

PyDPF-Core plotting capabilities require PyVista <https://pyvista.org/>_ to be installed. To install PyDPF-Core with its optional plotting functionalities, use this command:

   pip install ansys-dpf-core[graphics]

For more information on PyDPF-Core plotting capabilities, see Plot in the PyDPF-Core documentation.

To use PyDPF-Core with Ansys 2022 R1, install the latest compatible version with this command:

   pip install ansys-dpf-core<0.10.0

To use PyDPF-Core with Ansys 2021 R2, install the latest compatible version with this command:

   pip install ansys-grpc-dpf<0.4.0; pip install ansys-dpf-core<0.10.0

To use PyDPF-Core with Ansys 2021 R1, install the latest compatible version with this command:

   pip install ansys-grpc-dpf<0.3.0; pip install ansys-dpf-core<0.3.0

Brief demo

Provided you have DPF available, a DPF server automatically starts once you start using PyDPF-Core.

To open a result file and explore what's inside, use this code:

>>> from ansys.dpf import core as dpf
>>> from ansys.dpf.core import examples
>>> model = dpf.Model(examples.find_simple_bar())
>>> print(model)

    DPF Model
    ------------------------------
    Static analysis
    Unit system: Metric (m, kg, N, s, V, A)
    Physics Type: Mechanical
    Available results:
         -  displacement: Nodal Displacement
         -  element_nodal_forces: ElementalNodal Element nodal Forces
         -  elemental_volume: Elemental Volume
         -  stiffness_matrix_energy: Elemental Energy-stiffness matrix
         -  artificial_hourglass_energy: Elemental Hourglass Energy
         -  thermal_dissipation_energy: Elemental thermal dissipation energy
         -  kinetic_energy: Elemental Kinetic Energy
         -  co_energy: Elemental co-energy
         -  incremental_energy: Elemental incremental energy
         -  structural_temperature: ElementalNodal Temperature
    ------------------------------
    DPF  Meshed Region: 
      3751 nodes 
      3000 elements 
      Unit: m 
      With solid (3D) elements
    ------------------------------
    DPF  Time/Freq Support: 
      Number of sets: 1 
    Cumulative     Time (s)       LoadStep       Substep         
    1              1.000000       1              1               

Read a result with this command:

>>> result = model.results.displacement.eval()

Then, start connecting operators with this code:

>>> from ansys.dpf.core import operators as ops
>>> norm = ops.math.norm(model.results.displacement())

Starting the service

The ansys.dpf.core library automatically starts a local instance of the DPF service in the background and connects to it. If you need to connect to an existing remote or local DPF instance, use the connect_to_server method:

>>> from ansys.dpf import core as dpf
>>> dpf.connect_to_server(ip='10.0.0.22', port=50054)

Once connected, this connection remains for the duration of the module. It closes when you exit Python or connect to a different server.

License and acknowledgments

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

PyDPF-Core makes no commercial claim over Ansys whatsoever. This library extends the functionality of Ansys DPF by adding a Python interface to DPF without changing the core behavior or license of the original software.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

ansys_dpf_core-0.13.8-py3-none-win_amd64.whl (7.6 MB view details)

Uploaded Python 3Windows x86-64

ansys_dpf_core-0.13.8-py3-none-manylinux_2_17_x86_64.whl (13.4 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

ansys_dpf_core-0.13.8-py3-none-manylinux1_x86_64.whl (13.4 MB view details)

Uploaded Python 3

ansys_dpf_core-0.13.8-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

Details for the file ansys_dpf_core-0.13.8-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for ansys_dpf_core-0.13.8-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 7fad41a7102abcef02c9a865591b07581f2328ea2cdbb45db05490eac435786c
MD5 3ff64488d29e0ad542dc93fbebd07427
BLAKE2b-256 eb6e5fc6dfa28061bf91678cb3c70eacf3cbdfd658ea17274c5db1484613827d

See more details on using hashes here.

File details

Details for the file ansys_dpf_core-0.13.8-py3-none-manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ansys_dpf_core-0.13.8-py3-none-manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 28134eaaa10a2bdf1a86103682832ebe9781be80ec5b0432f6345d59fd38f874
MD5 5c4aabe3e6dea1523f3f027dc0e922de
BLAKE2b-256 0553dc66c2010de5ea0f22a28bdf8f33e86ca61a8141d926352e9ec48f46ccf8

See more details on using hashes here.

File details

Details for the file ansys_dpf_core-0.13.8-py3-none-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for ansys_dpf_core-0.13.8-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 37eb44e87618c60f128838e115d3db72b27c82e61a434bfb31adf2a5e5921aa6
MD5 143436c27a4be8eb9069b70252e21d68
BLAKE2b-256 8275b63c7ef4ab091c04c86c362f89add7f8c82b59ef7783b225ce3b3b829a3e

See more details on using hashes here.

File details

Details for the file ansys_dpf_core-0.13.8-py3-none-any.whl.

File metadata

File hashes

Hashes for ansys_dpf_core-0.13.8-py3-none-any.whl
Algorithm Hash digest
SHA256 94ffee67a9fe47a09f25de6652106f9dfbe6c43e098ae6cf8190b0948a4fe7e5
MD5 5bbf167ebed1cf8a0a3ac7aa75aefcc0
BLAKE2b-256 a85f61cc0d325836e2a7a421fe163aa8130396ec8c09e101bfe7cd6aced48902

See more details on using hashes here.

Supported by

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