UMAT4COMSOL: An Abaqus user material (UMAT) subroutine wrapper for COMSOL

S. Lucarini,E. Martínez-Pañeda

2024-02-22

Abstract:We present a wrapper that allows Abaqus user material subroutines (UMATs) to be used as an External Material library in the software COMSOL Multiphysics. The wrapper, written in C language, transforms COMSOL's external material subroutine inputs and outputs into Fortran-coded Abaqus UMAT inputs and outputs, by means of a consistent variable transformation. This significantly facilitates conducting coupled, multi-physics studies employing the advanced material models that the solid mechanics community has developed over the past decades. We exemplify the potential of our new framework, UMAT4COMSOL, by conducting numerical experiments in the areas of elastoplasticity, hyperelasticity and crystal plasticity. The source code, detailed documentation and example tutorials are made freely available to download at www.empaneda.com/codes.

Software Engineering,Computational Engineering; Finance; and Science,Mathematical Software

What problem does this paper attempt to address?

This paper introduces a software package called UMAT4COMSOL, which is a subroutine written in C language. Its purpose is to make the Abaqus user material subroutine (UMAT) compatible with COMSOL Multiphysics software. UMAT4COMSOL allows the use of advanced material models developed for Abaqus in COMSOL for multiphysics studies, such as coupled problems in solid mechanics like hydrogen embrittlement, corrosion, and oxidation fatigue. The paper demonstrates how this framework is applied to numerical experiments in elastic-plastic, hyperelastic, and crystal plasticity.

UMAT4COMSOL achieves this by converting the COMSOL external material inputs and outputs into a format compatible with Abaqus UMAT. It handles the differences in variable formats between different software and provides support for both small and large strain cases. The paper provides a detailed description of the conversion process for input and output parameters and how to use this subroutine for nonlinear analysis in COMSOL.

The paper also provides several examples to validate the effectiveness of UMAT4COMSOL, including small strain elastic-plastic models, large strain hyperelastic models, and crystal plasticity models. These examples demonstrate the potential of using UMAT4COMSOL in a multiphysics environment and highlight the versatility of the software to connect the computational platforms of COMSOL and Abaqus for addressing complex material problems, such as the design and simulation of modern devices like lithium-ion batteries, hydrogels, and magneto-rheological elastomers.

In summary, the problem addressed in this paper is how to enable COMSOL to utilize the rich material models already available in Abaqus for studying material behavior in multiphysics simulations. With UMAT4COMSOL, researchers can conveniently apply complex material models in COMSOL for modeling and simulation of various engineering and scientific problems.