Published November 18, 2025 | Version v0.1.2
Software Open

Deep Eshelby Network for Superspherical Inclusions

Description

DEshN is a machine learning framework for solving the Eshelby problem of inclusions with arbitrary geometries. It implements its physics-informed architecture in PyTorch to provide fast and accurate predictions of dilute strain concentration tensors beyond ellipsoidal shapes.

This package contains:

  • PyTorch implementation of DEshN.
  • A pretrained DEshN for superspherical inclusions.
  • The training data for Eshelby problems with superspherical inclusions.

Version and Dependencies can be found in pyproject.toml

The pretrained DEshN can be used to homogenize representative volume elements with superspherical inclusions using classical continuum micromechanics methods.

If you use this code or dataset, please cite the following paper: 

M. Schwaighofer, M. Königsberger, S. Pech, M. Lukacevic, J. Füssl, Deep Eshelby Network: an AI framework for multiscale continuum micromechanics homogenization schemes with complex inclusion shapes, Computer Methods in Applied Mechanics and Engineering (2026)

Licenses

Training DataCreative Commons Attribution 4.0 International (CC BY 4.0)
CodeMIT License

Abstract

Continuum micromechanics homogenization provides an efficient framework to relate the microstructural features of heterogeneous materials to their macroscopic mechanical response. The microstructure is idealized as an assembly of interacting matrix–inclusion problems, each governed by Eshelby’s analytical solution for ellipsoidal inclusion shapes. This assumption severely simplifies the often complex morphology of real materials---and, owing to the uniformity of strains inside Eshelby's inclusion, provides access to average strains rather than the underlying field fluctuations in the heterogeneities of the material.

To address these limitations, we propose the Deep Eshelby Network (DEshN), a machine-learning framework that generalizes the Eshelby problem to non-ellipsoidal inclusion geometries. The network consists of a Deep Material Network (DMN) that incorporates physical constraints through laminate building blocks into a tree-like architecture and a single linear layer that modulates the weights and orientations of the DMN. Trained on finite element solutions of inclusion problems with diverse shapes and stiffness ratios, the DEshN provides rapid and accurate predictions that can be seamlessly integrated into classical homogenization schemes. In this way, DEshN-based homogenization retains the efficiency of continuum micromechanical approaches while extending their applicability to materials with heterogeneities of arbitrary shape, volume fraction, orientation distribution, and even hierarchical multiscale organization.

To unveil its potential, a DEshN is trained on superspherical inclusions to predict the homogenized stiffness for orthotropic matrix-inclusion-type materials and polycrystalline materials with aligned or randomly oriented superspheres, as a function of the supersphere shape parameter. This task could not have been solved with the approaches developed so far.

Files

deepeshelbynetwork-v0.1.2.zip

Files (475.1 KiB)

NameSize
md5:df5809be4ff3c74f5a849d6fec0eb283
475.1 KiBPreview Download

Additional details

Funding

FWF Austrian Science Fund
Virtual Wood Labs Y1093
FWF Austrian Science Fund
Advanced Computational Design SFB F77
Christian Doppler Research Association
Christian Doppler Laboratory for Next-Generation Wood-Based Biocomposite
European Union
AI-TranspWood HORIZON-CL4–2023-RESILIENCE- 01–23