Read nodes and elements from LS-DYNA decks.

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

These details have not been verified by PyPI

Project description

LS-DYNA Mesh Reader

This library can be used to read in LS-DYNA meshes stored within keyword (*.k, *.key, *.dyn) files, also known as keyword format "input decks". Full documentation for this repository can be found at lsdyna-mesh-reader Documentation.

Many of these example files were obtained from the excellent documentation at LS-DYNA Examples.

Motivation

Despite its popularity, there doesn't appear to be a reader for LS-DYNA keyword files. I need a reader for a closed source project and hope that this helps someone else who also wishes to read in these files. It borrows from mapdl-archive as MAPDL also follows many of the same FORTRAN conventions when writing out FEMs.

Installation

Install the fully featured reader with visualization with:

pip install lsdyna-mesh-reader[pyvista]

If you only need the node and element arrays and not any VTK features (e.g. plotting or UnstructuredGrid representation), install the basic library with:

pip install lsdyna-mesh-reader

Examples

Before going through a basic example, let's talk about how these "decks" are organized. Each keyword file contains "keywords" that describe the start of sections of "cards". This terminology dates back to when DYNA3D was developed in 1976 where programs were written on punch cards.

To read in nodes and elements, we have to read in one or more node and element sections, each starting with *NODE or *ELEMENT_SOLID. This library loads in those raw sections as well as parsed sections as a higher level abstraction.

Let's start by loading the Contact Eroding I example deck.

Load the birdball deck.

>>> import lsdyna_mesh_reader
>>> from lsdyna_mesh_reader import examples
>>> deck = lsdyna_mesh_reader.Deck(examples.birdball)
LSDYNA Deck with:
  Node sections:              1
  Element Solid sections:     1
  Element Shell sections:     1

We can now inspect one of the node sections:

>>> node_section = deck.node_sections[0]
>>> node_section
NodeSection containing 1281 nodes

|  NID  |       X       |       Y       |       Z       |   tc   |   rc   |
|-------|---------------|---------------|---------------|--------|--------|
       1 -2.30940104e+00 -2.30940104e+00 -2.30940104e+00        0        0
       2 -2.03960061e+00 -2.03960061e+00 -2.03960061e+00        0        0
       3 -1.76980031e+00 -1.76980031e+00 -1.76980031e+00        0        0
       4 -1.50000000e+00 -1.50000000e+00 -1.50000000e+00        0        0
       5 -2.59364843e+00 -1.59561157e+00 -2.59364843e+00        0        0
       6 -2.22909880e+00 -1.39707434e+00 -2.22909880e+00        0        0
       7 -1.86454940e+00 -1.19853711e+00 -1.86454940e+00        0        0
       8 -1.50000000e+00 -1.00000000e+00 -1.50000000e+00        0        0
       9 -2.76911068e+00 -8.14893484e-01 -2.76911068e+00        0        0
      10 -2.34607387e+00 -7.09928930e-01 -2.34607387e+00        0        0
...

We can directly access the node IDs and arrays of the node section:

Node IDs

>>> node_section.nid
array([   1,    2,    3, ..., 1342, 1343, 1344], dtype=int32)

Node coordinates

>>> node_section.coordinates
array([[ -2.30940104,  -2.30940104,  -2.30940104],
       [ -2.03960061,  -2.03960061,  -2.03960061],
       [ -1.76980031,  -1.76980031,  -1.76980031],
       ...,
       [ -4.        , -10.        ,   0.        ],
       [ -2.        , -10.        ,   0.        ],
       [  0.        , -10.        ,   0.        ]])

The same can be done for both the solid and shell element sections.

>>> deck.element_solid_sections  # or deck.element_shell_sections
[ElementSolidSection containing 816 elements

 |  EID  |  PID  |  N1   |  N2   |  N3   |  N4   |  N5   |  N6   |  N7   |  N8   |
 |-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|
        1       1       1       2       6       5      17      18      22      21
        2       1       2       3       7       6      18      19      23      22
        3       1       3       4       8       7      19      20      24      23
        4       1       5       6      10       9      21      22      26      25
        5       1       6       7      11      10      22      23      27      26
        6       1       7       8      12      11      23      24      28      27
        7       1       9      10      14      13      25      26      30      29
        8       1      10      11      15      14      26      27      31      30
        9       1      11      12      16      15      27      28      32      31
       10       1      17      18      22      21      33      34      38      37
 ...]

Element IDs

>>> section = deck.element_solid_sections[0]
>>> section.eid
array([  1,   2,   3, ..., 814, 815, 816], dtype=int32)

Node IDs of the elements

>>>
array([   1,    2,    6, ..., 1256, 1267, 1266], dtype=int32)

The elements are stored as a single contiguous array for efficiency and can be split up via:

>>> import numpy as np
>>> elements = np.split(section.node_ids, section.node_id_offsets[1:-1])
[array([ 1,  2,  6,  5, 17, 18, 22, 21], dtype=int32),
 array([ 2,  3,  7,  6, 18, 19, 23, 22], dtype=int32),
...
]

If you have pyvista installed or installed the library with pip install lsdyna-mesh-reader[pyvista], you can convert the mesh to a single unstructured grid:

>>> grid = deck.to_grid()
>>> grid
UnstructuredGrid (0x70d5d723bc40)
  N Cells:    916
  N Points:   1281
  X Bounds:   -2.000e+01, 2.220e-15
  Y Bounds:   -1.000e+01, 4.000e+00
  Z Bounds:   -2.000e+01, 4.441e-15
  N Arrays:   2

This lets you plot, save, or perform other operations on the mesh via PyVista. For example, you could plot the resulting mesh. Here's a full example using the Yaris Static Suspension System Loading Examplew.

>>> filename = "YarisD_V2g_shock_abs_load_01.k"
>>> deck = Deck(filename)
>>> grid = deck.to_grid()
>>> grid.plot(color="w", smooth_shading=True, show_edges=True)

Yaris Static Suspension Mesh

Caveats and Limitations

As of now, limited testing has been performed on this library and you may find that it fails to load complex or simple keyword decks.

Additionally, this reader only supports the following keywords:

*NODE
*ELEMENT_SHELL
*ELEMENT_SOLID
*ELEMENT_TSHELL (note: sections encoded as solid sections)

The VTK UnstructuredGrid contains only the linear element conversion of the underlying LS-DYNA elements, and only supports VTK_QUAD, VTK_TRIANGLE, VTK_TETRA, VTK_WEDGE, and VTK_HEXAHEDRAL.

Issues and Contributing

Feel free to open an Issue in this repository with any features you'd like me to add or bugs you need fixed.

If you'd like to contribute, please see CONTRIBUTING.md.

License

Source and content is under the MIT License, except for the LS-DYNA artifacts, which retain their original license from LS-DYNA and Ansys.

Note that the example files used here were downloaded from LS-DYNA Examples and have the following usage license as noted on the website:

The input files and several class notes are available for download. The
download is free of charge, a login is not required. All examples are
presented with a brief description. You may find an example by checking a
specific class or by using the search functionality of the site.

The content is prepared for educational purposes. Hence, material
properties and other parameters might be non-physic for simplification.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

akaszynski

These details have not been verified by PyPI

Release history Release notifications | RSS feed

This version

0.1.4

May 22, 2025

0.1.3

Sep 26, 2024

0.1.2

Sep 25, 2024

0.1.1

Sep 9, 2024

0.1.0

Sep 9, 2024

Download files

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

Source Distribution

lsdyna-mesh-reader-0.1.4.tar.gz (648.0 kB view details)

Uploaded May 22, 2025 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lsdyna_mesh_reader-0.1.4-cp313-cp313-win_amd64.whl (717.4 kB view details)

Uploaded May 22, 2025 CPython 3.13Windows x86-64

lsdyna_mesh_reader-0.1.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (747.8 kB view details)

Uploaded May 22, 2025 CPython 3.13manylinux: glibc 2.17+ x86-64

lsdyna_mesh_reader-0.1.4-cp313-cp313-macosx_11_0_arm64.whl (713.1 kB view details)

Uploaded May 22, 2025 CPython 3.13macOS 11.0+ ARM64

lsdyna_mesh_reader-0.1.4-cp313-cp313-macosx_10_14_x86_64.whl (719.4 kB view details)

Uploaded May 22, 2025 CPython 3.13macOS 10.14+ x86-64

lsdyna_mesh_reader-0.1.4-cp312-cp312-win_amd64.whl (717.4 kB view details)

Uploaded May 22, 2025 CPython 3.12Windows x86-64

lsdyna_mesh_reader-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (747.8 kB view details)

Uploaded May 22, 2025 CPython 3.12manylinux: glibc 2.17+ x86-64

lsdyna_mesh_reader-0.1.4-cp312-cp312-macosx_11_0_arm64.whl (713.1 kB view details)

Uploaded May 22, 2025 CPython 3.12macOS 11.0+ ARM64

lsdyna_mesh_reader-0.1.4-cp312-cp312-macosx_10_14_x86_64.whl (719.4 kB view details)

Uploaded May 22, 2025 CPython 3.12macOS 10.14+ x86-64

lsdyna_mesh_reader-0.1.4-cp311-cp311-win_amd64.whl (719.0 kB view details)

Uploaded May 22, 2025 CPython 3.11Windows x86-64

lsdyna_mesh_reader-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (752.2 kB view details)

Uploaded May 22, 2025 CPython 3.11manylinux: glibc 2.17+ x86-64

lsdyna_mesh_reader-0.1.4-cp311-cp311-macosx_11_0_arm64.whl (715.2 kB view details)

Uploaded May 22, 2025 CPython 3.11macOS 11.0+ ARM64

lsdyna_mesh_reader-0.1.4-cp311-cp311-macosx_10_14_x86_64.whl (720.9 kB view details)

Uploaded May 22, 2025 CPython 3.11macOS 10.14+ x86-64

lsdyna_mesh_reader-0.1.4-cp310-cp310-win_amd64.whl (719.2 kB view details)

Uploaded May 22, 2025 CPython 3.10Windows x86-64

lsdyna_mesh_reader-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (752.5 kB view details)

Uploaded May 22, 2025 CPython 3.10manylinux: glibc 2.17+ x86-64

lsdyna_mesh_reader-0.1.4-cp310-cp310-macosx_11_0_arm64.whl (715.4 kB view details)

Uploaded May 22, 2025 CPython 3.10macOS 11.0+ ARM64

lsdyna_mesh_reader-0.1.4-cp310-cp310-macosx_10_14_x86_64.whl (721.1 kB view details)

Uploaded May 22, 2025 CPython 3.10macOS 10.14+ x86-64

lsdyna_mesh_reader-0.1.4-cp39-cp39-win_amd64.whl (719.7 kB view details)

Uploaded May 22, 2025 CPython 3.9Windows x86-64

lsdyna_mesh_reader-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (752.6 kB view details)

Uploaded May 22, 2025 CPython 3.9manylinux: glibc 2.17+ x86-64

lsdyna_mesh_reader-0.1.4-cp39-cp39-macosx_11_0_arm64.whl (715.6 kB view details)

Uploaded May 22, 2025 CPython 3.9macOS 11.0+ ARM64

lsdyna_mesh_reader-0.1.4-cp39-cp39-macosx_10_14_x86_64.whl (721.3 kB view details)

Uploaded May 22, 2025 CPython 3.9macOS 10.14+ x86-64

File details

Details for the file lsdyna-mesh-reader-0.1.4.tar.gz.

File metadata

Download URL: lsdyna-mesh-reader-0.1.4.tar.gz
Upload date: May 22, 2025
Size: 648.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for lsdyna-mesh-reader-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`6959e73b817206e8ae5b74870688452e6b741aef4a129a84d2608c984b931a01`
MD5	`fb4331dc57a1fc447861dda710a7a695`
BLAKE2b-256	`be9bb7b7f6f0967ab82f0befb4a9681e1ce15cbdc932a7aecaedf723192cd356`

Algorithm	Hash digest
SHA256	`b2338082c192d099703568f807935045f7bbaf9dc5224aa4942cf5a2156afca2`
MD5	`a91cdb81861e67a11da6719bc00da433`
BLAKE2b-256	`12ebe26de4daf42764c9c98b517689b06009e7af6ea1e373202800a40667ce61`

Algorithm	Hash digest
SHA256	`8152e03afa7a56dcca4f8589763da55d1a4c8b03b8cf0bbc9dd3116503c3e9bf`
MD5	`d83dd7aea52cea15e330e735c689c89e`
BLAKE2b-256	`0e928a5f49189ae6500fdee9db2708f54e612726d02cceee2876af2ea96f6ee8`

Algorithm	Hash digest
SHA256	`335c26c571823a1b7969e2bada385a442fff6398a53a36aace254ad841b00a0a`
MD5	`8ed71469027e67a347fcae086c1dfe83`
BLAKE2b-256	`db802a7b55731e4ccb3a2914d292bd090fad9c5497d6ef8703749df322a54f7a`

Algorithm	Hash digest
SHA256	`4b2fb47563d564fa9afb2b8f895712e3aff43b14df1db7c96a6ff4621b9612b9`
MD5	`9800b03b0ec81513996544819ac465e4`
BLAKE2b-256	`b90479999ec81e813c658135c42e3f874e175305f70a6707f3f00c1b6f817d8b`

Algorithm	Hash digest
SHA256	`fa136a31d62cbff09487309df29143a51a8bccce18255d67c0a46c37aa3a744f`
MD5	`0bfa28f9f3bc20fad4744402886ff18a`
BLAKE2b-256	`69d74d353db765aa77a72c345a3fd7ee17232310548b987cd71357071cd4505e`

Algorithm	Hash digest
SHA256	`90ea14ff069443f7573d6941c6afe1f66d4412d71f85449d393a9e65650c4c99`
MD5	`6b6f9de6a31b14234fef4613c4c39b7f`
BLAKE2b-256	`32f6bbc69fd8bac336c14b4ca0dc5c0b4a69c99cac18d77f0ddb808a1d4b9bb9`

Algorithm	Hash digest
SHA256	`a7ab4bf290e0642f1a671bc333a20ab000aef972fe068204eddf1fd116095daa`
MD5	`725a848bbaf1658d0d2aaccee3744bda`
BLAKE2b-256	`9b3d55dceee56b4ea522a8433036c9ded8a45273227b96dc72c9f66a654a9de3`

Algorithm	Hash digest
SHA256	`280a50d9454f2034ac4b869cfe9aef9cb8f7f8250aa910cf14342e49ae79cb5c`
MD5	`dc8a165e17356504d235c8e4e37821c9`
BLAKE2b-256	`b4fc93cb012424fa30efd52e7837921ba4e31e0ad4df0c86b7ef5dead55f6754`

Algorithm	Hash digest
SHA256	`08c73f9f58c09e5f0083fd4d9c1b10f413b878dbadecc1d7e7097982f29254e3`
MD5	`bd75ef6cd7c54c14111cca6f04e2a34c`
BLAKE2b-256	`c984488ffd14ce591f8045361ebfcacd21a99cc883b2c08d303164f4c5a02b45`

Algorithm	Hash digest
SHA256	`a7ebf5339d0bbc871ab871a78efcde2c18bba7ee18e392edd0345100698f4594`
MD5	`cdc0e8a581f7a78ae431d5e283be075c`
BLAKE2b-256	`9641e5615ef764f14dd60fe7795b183199c4fce50baee32b758e20e7651e0c0a`

Algorithm	Hash digest
SHA256	`cd2d674161848619df4c6e524eb5339777141b49d8c322e4b2230d59aa1534f4`
MD5	`a30017e8c49b6a154a63afc3aa5c8124`
BLAKE2b-256	`2adfa73d5629aae1f7ec7bbb39c674f307d5b0fb0f26f10480a93541dc816fdb`

Algorithm	Hash digest
SHA256	`0eaeb8e8a6141fdc45435e7046b98aa844fe94aaa2a53bda73bbe5a7b26f20db`
MD5	`4b17825b439205608eb7a9910ae5180e`
BLAKE2b-256	`2f55710032c1a700f14bd65680a8ce821cd1ecdc2a206bbef63333317e561652`

Algorithm	Hash digest
SHA256	`ebe169d8ee2f7ab97273cf2c03e6435079e37201c898727ec31c393b0b51c872`
MD5	`76ed2201b751a8fa01caa5eb25ad1edb`
BLAKE2b-256	`a290a7bf0b54250ee76ac69e4f85d110791642647d2d30acf85672ec6daaaeb9`

Algorithm	Hash digest
SHA256	`fb56253d7ea5beece2892646bc4da149445ebccab6ebe96647b97595809e8240`
MD5	`81e87ae7ab003545ab161e38726ab10d`
BLAKE2b-256	`b550011813d69b178fb8709f0917dd07c8ffb0d26647cd14659c376dac50cf91`

Algorithm	Hash digest
SHA256	`5d54fbbe0087acdfdc10eb015d2f8e0b0b47f53aa159b814a15ec48c019ea56a`
MD5	`f9b96e07a648d298ad8fbd94aae5c986`
BLAKE2b-256	`43180dcb773f42cbef2af7029b2d82cbd2bef0583351f32c0f5305ad0433502e`

Algorithm	Hash digest
SHA256	`ac7bbebacb58141e49d913b77e007ecde03a9d9717b906b096389aea403180b9`
MD5	`9c8bac203d28b08887c4ec3254912c9e`
BLAKE2b-256	`950c5d6a72b5d86f3a65717eb0a5b218b077031a1c2046e6ae5764398938f907`

Algorithm	Hash digest
SHA256	`500c7b8732c9a5d1671383b159d94dd21d5be2f8a880f509c01ba59fc396f503`
MD5	`db8b9c4658b4003d4e277453b74222f7`
BLAKE2b-256	`8685b00934ff29214705d5c6215901cb5cd9562e365ce9234342632483000b7c`

Algorithm	Hash digest
SHA256	`c537854903cc1646b51edece06e74fa0c1b052a6b187eb5449321e9d5b06930a`
MD5	`0f38a9546463a9f6a99a43edf7407522`
BLAKE2b-256	`b2b8b937c55c423c25511b041be3c049fbc7609f0c725fb938c0b677bfd2b07b`

Algorithm	Hash digest
SHA256	`4236aba8bd11cdf0b241381d6e5c06439f55a1294acc98162c5ccc85b44944cb`
MD5	`5de838a715133a9320bed983abaaf8a1`
BLAKE2b-256	`a37d6c19452183c91072cf36000dc77aed26708296c2a5ccb8eee1baafd2a007`

Algorithm	Hash digest
SHA256	`2b4b803c7c4803a4007884cd8695d8c571794627c760f3cb2c887368ffb38610`
MD5	`311b157f5038e16059793410b1f813a2`
BLAKE2b-256	`5713836e44afd78aa89cd70d3eacbc03f56b6aa6ebc30922ba3bba0876664249`

lsdyna-mesh-reader 0.1.4

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

LS-DYNA Mesh Reader

Motivation

Installation

Examples

Caveats and Limitations

Issues and Contributing

License

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes