Read blocked Ansys MAPDL archive files written from MAPDL using CDWRITE.
This is effectively pymapdl-reader without the binary reader. It’s been isolated to allow greater flexibility in development.
Installation
Installation through pip:
pip install mapdl-archiveExamples
Load and Plot an MAPDL Archive File
ANSYS archive files containing solid elements (both legacy and modern), can be loaded using Archive and then converted to a VTK object.
from mapdl_archive import Archive, examples
# Sample *.cdb
filename = examples.hexarchivefile
# Read ansys archive file
archive = Archive(filename)
# Print raw data from cdb
for key in archive.raw:
print("%s : %s" % (key, archive.raw[key]))
# Create an unstructured grid from the raw data and plot it
grid = archive.parse_vtk(force_linear=True)
grid.plot(color='w', show_edges=True)
# write this as a vtk xml file
grid.save('hex.vtu')
# or as a vtk binary
grid.save('hex.vtk')
You can then load this vtk file using PyVista or VTK.
import pyvista as pv
grid = pv.UnstructuredGrid('hex.vtu')
grid.plot()Reading ANSYS Archives
MAPDL archive *.cdb and *.dat files containing elements (both legacy and modern) can be loaded using Archive and then converted to a vtk object:
import mapdl_archive
from mapdl_archive import examples
# Read a sample archive file
archive = mapdl_archive.Archive(examples.hexarchivefile)
# Print various raw data from cdb
print(archive.nnum, archive.nodes)
# access a vtk unstructured grid from the raw data and plot it
grid = archive.grid
archive.plot(color='w', show_edges=True)You can also optionally read in any stored parameters within the archive file by enabling the read_parameters parameter.
import mapdl_archive
archive = mapdl_archive.Archive('mesh.cdb', read_parameters=True)
# parameters are stored as a dictionary
archive.parametersWriting MAPDL Archives
Unstructured grids generated using VTK can be converted to ANSYS APDL archive files and loaded into any version of ANSYS using mapdl_archive.save_as_archive in Python followed by CDREAD in MAPDL. The following example using the built-in archive file demonstrates this capability.
import pyvista as pv
from pyvista import examples
import mapdl_archive
# load in a vtk unstructured grid
grid = pv.UnstructuredGrid(examples.hexbeamfile)
script_filename = '/tmp/grid.cdb'
mapdl_archive.save_as_archive(script_filename, grid)
# Optionally read in archive in PyMAPDL and generate cell shape
# quality report
from ansys.mapdl.core import launch_mapdl
mapdl = launch_mapdl()
mapdl.cdread('db', script_filename)
mapdl.prep7()
mapdl.shpp('SUMM')Resulting ANSYS quality report:
------------------------------------------------------------------------------
<<<<<< SHAPE TESTING SUMMARY >>>>>>
<<<<<< FOR ALL SELECTED ELEMENTS >>>>>>
------------------------------------------------------------------------------
--------------------------------------
| Element count 40 SOLID185 |
--------------------------------------
Test Number tested Warning count Error count Warn+Err %
---- ------------- ------------- ----------- ----------
Aspect Ratio 40 0 0 0.00 %
Parallel Deviation 40 0 0 0.00 %
Maximum Angle 40 0 0 0.00 %
Jacobian Ratio 40 0 0 0.00 %
Warping Factor 40 0 0 0.00 %
Any 40 0 0 0.00 %
------------------------------------------------------------------------------Supported Elements
At the moment, only solid elements are supported by the save_as_archive function, to include:
vtk.VTK_TETRA
vtk.VTK_QUADRATIC_TETRA
vtk.VTK_PYRAMID
vtk.VTK_QUADRATIC_PYRAMID
vtk.VTK_WEDGE
vtk.VTK_QUADRATIC_WEDGE
vtk.VTK_HEXAHEDRON
vtk.VTK_QUADRATIC_HEXAHEDRON
Linear element types will be written as SOLID185, quadratic elements will be written as SOLID186, except for quadratic tetrahedrals, which will be written as SOLID187.
License and Acknowledgments
The mapdl-archive library is licensed under the MIT license.
1 maintainer
Release files for mapdl-archive 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mapdl_archive-0.4.1.tar.gz | 162.2 kB | Details |
Built distributions (wheels)
Total release size: 5.6 MB
Release files / mapdl_archive-0.4.1.tar.gz
| Download URL | mapdl_archive-0.4.1.tar.gz |
|---|---|
| Size | 162.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b8d8f8f9b4e947dcaa952a91f6ead2c360a572d8fb4264c08e23a6745745385b
|
|
BLAKE2b-256 checksum How to use checksums |
919435c7805cc96fb74ef6416f4e9ae4e853b322c58ee8281c8288e4d5176fd6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp312-abi3-win_amd64.whl
| Download URL | mapdl_archive-0.4.1-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 537.6 kB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
82446acc6723fca5c8d3e48927e86f4abe1dd31434e4ceaf8b06edc4983f6764
|
|
BLAKE2b-256 checksum How to use checksums |
0e05fe6594da53b6ac7f603445a9a7e562acab0aae911730d4d79bddbabdbccc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | mapdl_archive-0.4.1-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 314.9 kB |
| Tags | CPython 3.12 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
0a5d4a6a83fadb41a5b7f9398bac219ae260cbba10afc9b1ec8ac2ed506870d9
|
|
BLAKE2b-256 checksum How to use checksums |
9a7e0e1dbcc23829031367d019656e5b1d5599ff31b38380499c9055b3d29a62
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 355.8 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1a9ee6f2cc6267c99f3e0852ab5c88602b94f081e1ab06e1189187a1aa22b8db
|
|
BLAKE2b-256 checksum How to use checksums |
74fa8864f6d3cc86ce9cc67ade4ca91c575551d45767167a92ab3afdaf648a41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | mapdl_archive-0.4.1-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 292.6 kB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1301c2b371279cffdd2831b57dc23319f05a2afd7e7830c3a1686314be811857
|
|
BLAKE2b-256 checksum How to use checksums |
44c111abb6883a80bd839206bcaec28eb67ffd071916db1f8774cb122eae7748
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp312-abi3-macosx_10_14_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp312-abi3-macosx_10_14_x86_64.whl |
|---|---|
| Size | 299.3 kB |
| Tags | CPython 3.12 abi3 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
c36fbc6d13261a101688643c9f80c5fb437245a8ab3a4d665d7bc3079847287d
|
|
BLAKE2b-256 checksum How to use checksums |
fd6c26eedcc450f9eb6b2ae1058fd14d7930bed4796d671b9b3a0525e19a3bdd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp311-cp311-win_amd64.whl
| Download URL | mapdl_archive-0.4.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 538.5 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
32f7d978f20e0773c7fcf2474905419acfc54e5bf7847d04e18fa0995ddbfbae
|
|
BLAKE2b-256 checksum How to use checksums |
9382e67283de534a6e5fe19f46eafd38a6098086f1ec5a945f1afb121166bb56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | mapdl_archive-0.4.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 322.6 kB |
| Tags | CPython 3.11 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
fdac3cd0a95366ad84a80761f7a05956bb38ee82a48e9f8ddd2b0d5e2f5fa7a0
|
|
BLAKE2b-256 checksum How to use checksums |
38df6680dde33d42f0827e14999638dc882cfc6f514ae9c687c03178ec452810
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 362.4 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
5da57711c41cc31a206c472500f9b6866aec0d989492356cb4e6a4a8e04ae86f
|
|
BLAKE2b-256 checksum How to use checksums |
a8bd769716a39c43291eff41257e49429f82a7c1abbc23b672e2708e4ba59b37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | mapdl_archive-0.4.1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 296.8 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4af97738b4fac5b3c9d19dfab8aa9f2a426505951b55ba2c8080d2890ecdccbc
|
|
BLAKE2b-256 checksum How to use checksums |
f90c03bd9988a3899e3c3d73b20fe54b6a75ba782c9b77c075d03091d368d8dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp311-cp311-macosx_10_14_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp311-cp311-macosx_10_14_x86_64.whl |
|---|---|
| Size | 303.1 kB |
| Tags | CPython 3.11 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
fbdba1446f393740f038e76590cb98d0c1b264536ae4bac758a4d7548e7d03a8
|
|
BLAKE2b-256 checksum How to use checksums |
678ba04fa46b1a4888df9dc90034b7473e9bbc2d06a4be6dd2e8423810eb8126
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp310-cp310-win_amd64.whl
| Download URL | mapdl_archive-0.4.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 537.8 kB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ab7bc60c5fa791c5d8ed2d2fbed88458be3681202ddde206ce74db5bd510de22
|
|
BLAKE2b-256 checksum How to use checksums |
fba316d664318fb3f5cd3e89af7ae1bf5c5413ff235e0506eb99a2f97c97ae67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | mapdl_archive-0.4.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 323.3 kB |
| Tags | CPython 3.10 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
37db6d7d17fe47e9c3d87e0e8f2d2837448e15e3e5a5c3b1f3e5f34f52cf2c9a
|
|
BLAKE2b-256 checksum How to use checksums |
f0fde7d75ac65fdc163608017c3b6101cf06f80beb6a831e80be44c24490aa65
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 363.1 kB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
44c76a63e9da622cd63a0b5ee46f0bc567b7ec4e66b75a9a17e42bf570eb237f
|
|
BLAKE2b-256 checksum How to use checksums |
f17e91b4e000f6b0b0c46b080e8dcf4eaaecdfe6df7d634871d685e6d91c7f98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | mapdl_archive-0.4.1-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 297.5 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2728d5a05f1d33d736929b565ba936cd34da28a8537f8223ea735f863c9d3ef9
|
|
BLAKE2b-256 checksum How to use checksums |
90a755b131976e03551cbc8126c2c2b012fa04d9f4cfa56e53fd98335f969137
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / mapdl_archive-0.4.1-cp310-cp310-macosx_10_14_x86_64.whl
| Download URL | mapdl_archive-0.4.1-cp310-cp310-macosx_10_14_x86_64.whl |
|---|---|
| Size | 303.9 kB |
| Tags | CPython 3.10 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
3e6e387cde1bc9bbe987934e5bc455075986cd4548f2d91c20c43c917b111f49
|
|
BLAKE2b-256 checksum How to use checksums |
263385b69a56269c35a0887045dfdfdc0f45350cb1eb7cb007a01f392236cab6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency log
