Compatibility#

Operating system#

DPF supports Windows 10 and Rocky Linux 8 and later. To run DPF on CentOS 7, use DPF for 2024 R2 (8.2) or later. For more information, see Ansys Platform Support.

Compatibility with DPF and ANSYS releases#

The DPF server version depends on your installed Ansys version or your installed standalone DPF Server pre-release version.

The compatibility table below shows the client-server (ansys-dpf-core to DPF) compatibility for supported DPF versions.

Here is a summary of the compatibility rules:

  • With DPF for Ansys 2024 R1 and later, you can use PyDPF-Core 0.10.1 and later.

  • With DPF for Ansys 2023 R1 or R2, you can use PyDPF-Core version 0.10 up to 0.15.

  • With DPF for Ansys 2022 R2, you can use PyDPF-Core version 0.10 up to 0.15.

  • With DPF for Ansys 2021 R2 and 2022 R1, you can use PyDPF-Core version 0.3 up to 0.9.

  • With DPF for Ansys 2021 R1, you must use PyDPF-Core version 0.2.

As new features are developed, every attempt is made to ensure backward compatibility from the client to the server.

Backward compatibility policy#

PyDPF-Core follows the official Ansys support policy for retro-compatibility:

When ansys-dpf-core is released, compatibility is officially ensured with all revisions of:

  • DPF for Ansys releases that same year

  • DPF for Ansys releases at year -1

  • DPF for Ansys releases at year -2

For example, ansys-dpf-core 0.16 supports:

  • DPF for Ansys 2026 R1 (Ansys 2026 R1 being the latest released version at that time)

  • DPF for Ansys 2025 R2 and R1

  • DPF for Ansys 2024 R2 and R1

Breaking changes#

Starting with version 0.10 of ansys-dpf-core, the packages ansys-dpf-gate, ansys-dpf-gatebin and ansys-grpc-dpf are no longer dependencies and are directly integrated within ansys-dpf-core as modules. This introduced a breaking change to simplify installation and prevent synchronization issues between the PyDPF libraries, requiring to drop support for Ansys previous to 2022 R2.

Ansys strongly encourages you to use the latest packages available, as far they are compatible with the server version you want to run.

For ansys-dpf-core<0.10, the ansys.grpc.dpf package should also be synchronized with the server version.

Compatibility tables#

The following tables list the client-server compatibility for recent and legacy DPF versions.

PyDPF-Core strives to follow SPEC-0 for Python version support, as stated in the PyAnsys ecosystem Python version support policy. The “Supported Python versions” column lists the Python versions supported by the minimum compatible ansys-dpf-core version for each server release.

Supported DPF versions#

Client-server and Python version compatibility for supported DPF versions#

Server version

ansys.dpf.core Python module version

Supported Python versions

12.0 (2026 R1)

0.15.0 and later

3.10, 3.11, 3.12, 3.13

11.0 (2026 R1 pre0)

0.14.0 and later

3.10, 3.11, 3.12, 3.13

10.0 (2025 R2)

0.13.8 and later

3.10, 3.11, 3.12

9.1 (2025 R1)

0.13.4 and later

3.9, 3.10, 3.11

9.0 (2025 R1 pre0)

0.13.0 and later

3.9, 3.10, 3.11

8.2 (2024 R2)

0.12.1 and later

3.9, 3.10, 3.11

8.1 (2024 R2 pre1)

0.12.0 and later

3.9, 3.10, 3.11

8.0 (2024 R2 pre0)

0.11.0 and later

3.9, 3.10, 3.11

7.1 (2024 R1)

0.10.1 and later

3.9, 3.10, 3.11

Note

ansys-dpf-core versions 0.13.7 - 0.15.0 can be installed on Python 3.9 but compatibility is not tested.

Legacy DPF versions#

Client-server compatibility for legacy DPF versions#

Server version

ansys.dpf.core Python module version

ansys.grpc.dpf Python module version

ansys.dpf.gatebin binaries Python module version

ansys.dpf.gate Python module version

7.0 (2024 R1 pre0)
0.10.0 to 0.15.0
0.9.0
None
0.8.1
None
0.4.1
None
0.4.1

6.2 (2023 R2)
0.10.0 to 0.15.0
0.8.0 to 0.9.0
None
0.7.1 and later
None
0.3.1 and later
None
0.3.1 and later

6.1 (2023 R2 pre1)
0.10.0 to 0.15.0
0.8.0 to 0.9.0
None
0.7.1 and later
None
0.3.1 and later
None
0.3.1 and later

6.0 (2023 R2 pre0)
0.10.0 to 0.15.0
0.7.0 to 0.9.0
None
0.7.0 and later
None
0.3.0 and later
None
0.3.0 and later

5.0 (2023 R1)
0.10.0 to 0.15.0
0.6.0 to 0.9.0
None
0.6.0 and later
None
0.2.0 and later
None
0.2.0 and later

4.0 (2022 R2)
0.10.0 to 0.15.0
0.5.0 to 0.9.0
None
0.5.0 and later
None
0.1.0 and later
None
0.1.0 and later

3.0 (2022 R1)

0.4.0 to 0.9.0

0.4.0

None

None

2.0 (2021 R2)

0.3.0 to 0.9.0**

0.3.0

None

None

1.0 (2021 R1)

0.2.*

0.2.2

None

None

(** Compatibility of DPF 2.0 with ansys-dpf-core 0.5.0 to 0.9.0 is assumed but not certified.)

Update Python environment#

When moving from one Ansys release to another, you must update the ansys-dpf-core package. To get the latest version of the ansys-dpf-core package, use this command:

pip install --upgrade --force-reinstall ansys-dpf-core

To get a specific version of the ansys-dpf-core package, such as 0.7.0, use this command:

pip install --force-reinstall ansys-dpf-core==0.7.0