Modeling Soft Matter Using Constitutive Artificial Neural Networks (CANNs)

A special-purpose built-in material is available for modeling soft matter using constitutive artificial neural networks (CANNs). You can use this material model to simulate the response of biological tissue and other soft material systems that can be described with an anisotropic hyperelastic strain energy potential.

This page discusses:

See Also
In Other Guides
About Table Collections, Parameter Tables, and Property Tables
Constitutive Artificial Neural Networks (CANNs) models

Products Abaqus/Standard Abaqus/Explicit

Abaqus provides a general framework to integrate trained constitutive artificial neural networks (CANNs) models into an Abaqus simulation with minimal user effort. CANNs are a general class of anisotropic hyperelastic constitutive models that are described by a neural network architecture. The architecture used in the Abaqus CANNs framework is based on the work of Linka et al. (2023) and Peirlinck et al. (2025).

To activate the framework, the material definition must include the CANNs material user type. It must also include parameter tables with a declared type that starts with "ABQ_CANN." In addition, you must specify a user-defined anisotropic hyperelastic material definition, with the number of fiber families, N f , based on the specific model at hand.

A dedicated collection of parameter tables is available to include all the definitions required to model CANNs models. You can use the abaqus fetch utility to obtain the file containing the type definitions of the parameter tables used by the CANNs framework as follows:

abaqus fetch job=ABQ_CANN_types.inp

Input File Usage

Use the following options to activate the compressible CANNs framework in Abaqus/Standard:

INCLUDE, INPUT=ABQ_CANN_types.inp
MATERIAL, NAME=materialName, USER TYPE=CANN
ANISOTROPIC HYPERELASTIC, DEFINITION=USER,  FORMULATION=INVARIANT, 
LOCAL DIRECTIONS=Nf, TYPE=COMPRESSIBLE
PARAMETER TABLE, TYPE="ABQ_CANN_Coeff"
…
PARAMETER TABLE, TYPE="ABQ_CANN_DerivedInvariant"
…

Use the following options to activate the incompressible CANNs framework in Abaqus/Standard:

INCLUDE, INPUT=ABQ_CANN_types.inp
MATERIAL, NAME=materialName, USER TYPE=CANN
ANISOTROPIC HYPERELASTIC, DEFINITION=USER,  FORMULATION=INVARIANT, 
LOCAL DIRECTIONS=Nf, TYPE=INCOMPRESSIBLE
PARAMETER TABLE, TYPE="ABQ_CANN_Coeff"
…
PARAMETER TABLE, TYPE="ABQ_CANN_DerivedInvariant"
…

Use the following options to activate the CANNs framework in Abaqus/Explicit:

INCLUDE, INPUT=ABQ_CANN_types.inp
MATERIAL, NAME=materialName, 
 USER TYPE=CANN
ANISOTROPIC HYPERELASTIC, DEFINITION=USER,  FORMULATION=INVARIANT, 
LOCAL DIRECTIONS=Nf
PARAMETER TABLE, TYPE="ABQ_CANN_Coeff"
…
PARAMETER TABLE, TYPE="ABQ_CANN_DerivedInvariant"
…