For instructions on how to setup Abaqus with subroutines, see here
This repository contains user material models for Abaqus (UMAT) written by Knut Andreas Meyer.
It has different model categories, located in the models
folder. Each category contains (at least) three items:
src
: A folder containing the source code necessary to build the modeldoc
: A folder containing documentation for the modelsref.bib
: Latex bibliography file with reference(s) to the appropriate paper(s)
If you publish results based on any of these models, please cite the relevant paper. If you are presenting results obtained with any of these models, please also mention this repository.
Additionally, the models
folder contains a umat_utils
folder, with general-purpose codes used by several models.
(Please see AbaqusSetup.md
for some hints on how to setup your environment for Abaqus using user subroutines)
The scripts folder contains two scripts, one for building models for Abaqus (UMAT) and one for building a general shared library with the umat interface. These scripts take the following input:
- Input 1: Which model category to build (see folder names in the
models
folder) - Input 2-: Which model number(s) to build within the given category (see
cmake_compile_models.txt
orabaqus_compile_files.txt
) in the correspondingsrc
folder
The built models for Abaqus and the general case are put in folders compiled_abaqus
and compiled
respectively.
Note: To use the compiled routines (.so
/.dll
) for Abaqus, they must be renamed into standardU.dll
or libstandardU.so
. In the abaqus_v6.env
file the variable usub_lib_dir
must be set to the folder containing the shared library. Alternatively, the .o
or .obj
files can be used. Additionally, a folder containing all sources required for the particular model is created in the compiled_abaqus
folder, where the file umat.for
/umat.f
file is the main file. This setup can be used if more user subroutines should be linked with abaqus, and the line include umat.for
/include umat.f
can be used to also compile the user material model.
First, the models related to specific publications are listed. Further descriptions are given later for the specific model.
- Meyer et al. (2018): GenFiniteStrain
- Meyer (2020): Shi2014, Qin2018, CrystalPlasticity
- Meyer and Menzel (2021): MM2021 (distortional hardening model)
This category includes the Chaboche plasticity model for small strains. It includes different multiaxial extensions of the Armstrong-Frederick kinematic hardening rule: The Ohno-Wang model and the multiaxial modification based on Burlet and Cailletaud (1986) The models are available in rate-independent as well as rate-dependent forms, the latter with three different overstress functions.
This category includes extensions of the rate-independent small strain models to finite strains, using a hyperelasto-plastic framework. The implementation is from Meyer et al. (2018)
Rate independent distortional hardening model, inspired by Shi et al. (2014), published in Meyer (2020)
Rate independent distortional hardening model, inspired by Qin et al. (2018), published in Meyer (2020)
Taylor homogenized crystal plasticity model. Several different hardening laws, overstress functions etc. can be obtained by modifying the AceGen code. Published in Meyer (2020)
An improved distortional hardening model that guarantees a convex yield surface and avoids the issues with excessive softening reported in Meyer (2020). The two versions of the model presented in Meyer and Menzel (2021) are available as disthard_ISO2_BC2
(H_r=0
) and rmodel_ISO2_BC2
(H_r \neq 0
).
Some of the included code is generated using AceGen, and this should be referenced according to the instructions on their homepage (http://symech.fgg.uni-lj.si/). See also Korelc (2002)
- H. Burlet and G. Cailletaud (1986) "Numerical techniques for cyclic plasticity at variable temperature," Eng. Comput., vol. 3, no. 2, pp. 143–153
- K. A. Meyer, M. Ekh, and J. Ahlström (2018) "Modeling of kinematic hardening at large biaxial deformations in pearlitic rail steel," Int. J. Solids Struct., vol. 130–131, pp. 122–132. https://doi.org/10.1016/j.ijsolstr.2017.10.007
- K. A. Meyer (2020) "Evaluation of Material Models Describing the Evolution of Plastic Anisotropy in Pearlitic Steel." Int. J. Solids Struct. https://doi.org/10.1016/j.ijsolstr.2020.04.037.
- K. A. Meyer and A. Menzel (2021) "A distortional hardening model for finite plasticity" Int. J. Solids Struct.
- Korelc J. (2002) "Multi-language and Multi-environment Generation of Nonlinear Finite Element Codes", Engineering with Computers, vol. 18, n. 4, str. 312-327