Shape Memory Alloy
The Shape Memory Alloy feature is used to model stress–strain relationships that are nonlinear even at infinitesimal strains. This material model requires the Nonlinear Structural Materials Module. Shape Memory Alloy is available for 3D, 2D, and 2D axisymmetry.
By adding the following subnodes to the Shape Memory Alloy node you can incorporate other effects:
Note: Some options are only available with certain COMSOL products (see www.comsol.com/products/specifications/).
When a Shape Memory Alloy node is present, two result templates are added. In Martensite Volume Fraction, the distribution of martensite over the domain is shown. The Shape Memory Alloy Phase Diagram plot contains a graph showing the material properties in terms of a phase diagram.
See also Shape Memory Alloy in the Structural Mechanics Theory chapter.
Model Inputs
From the Temperature T list, select an existing temperature variable from a heat transfer interface (for example, Temperature (ht)), if any temperature variables exist, or select User defined to enter a value or an expression for the temperature.
If any material in the model has a temperature dependent mass density, and From material is selected for the density, the Volume reference temperature list will appear in the Model Input section. You can also select User defined to enter a value or an expression for the reference temperature locally.
Default Model Inputs and Model Input in the COMSOL Multiphysics Reference Manual.
Coordinate System Selection
The Global coordinate system is selected by default. The Coordinate system list contains all applicable coordinate systems in the component. The coordinate system is used for interpreting directions of orthotropic and anisotropic material data and when stresses or strains are presented in a local system. The coordinate system must have orthonormal coordinate axes, and be defined in the material frame. Many of the possible subnodes inherit the coordinate system settings.
Shape Memory Alloy
Select a Shape memory alloy model from the list: Lagoudas or Souza–Auricchio.
Lagoudas
For Lagoudas, the Reference temperature T0, the Poisson’s ratio ν, and the Density ρ are taken From material. For User defined enter other values or expressions.
For Austenite, select a material from the list. The Young’s modulus EA and the Heat capacity at constant pressure Cp,A are taken from the selected material. For Martensite, select a material from the list. The Young’s modulus EM and the Heat capacity at constant pressure Cp,M are taken from the selected material. For User defined enter other values or expressions.
Under Phase transformation, specify the parameters that describe the phase transitions in terms of Temperature or Stress levels.
When Temperature is selected from the Specify list, enter the Martensite start temperature Ms, the Martensite finish temperature Mf, the Slope of martensite limit curve CM, the Austenite start temperature As, the Austenite finish temperature Af, and the Slope of austenite limit curve CA.
When Stress is selected from the Specify list, enter the Martensite start stress σMs, the Martensite finish stress σMf, the Slope of martensite limit curve CM, the Austenite start stress σAs, the Austenite finish stress σAf, the Slope of austenite limit curve CA, and the Measurement temperature Tσ.
Under the Maximum transformation strain list select Constant to directly enter the Maximum transformation strain εtr,max, or Exponential law to specify a stress-dependent maximum transformation strain. Under Exponential law, enter the Initial maximum transformation strain εtr,min, the Ultimate transformation strain εtr,sat, the Critical stress σcrit, and the Saturation exponent k. Enter the Calibration stress level σ*.
Under Phase transformation kinetics, select the Transformation function from the list: Quadratic, Cosine, Smooth, or User defined.
For Smooth, enter the smoothing parameters η1, η2, η3, and η4.
For User defined enter the Yield stress σys, the Forward transformation law, and the Reverse transformation law.
When Lagoudas model is selected, a Phase Transformation Direction subnode is added to the Shape memory alloy node. Select a Transformation direction from the list: Automatic (default) or User defined.
Souza–Auricchio
For Souza–Auricchio the defaults for the Poisson’s ratio ν and Density ρ, are taken From material. For User defined enter other values or expressions.
For Austenite, select a material from the list. The Young’s modulus EA is taken from the selected material. For Martensite, select a material from the list. The Young’s modulus EM is taken from the selected material. For User defined enter other values or expressions.
Under Phase transformation specify how the Equivalent stress is computed. Select von Mises for a symmetric elastic domain radius in tension or compression. Select Prager–Lode to specify the Stress ratio between the elastic domain radius in compression and tension.
The default values for the Slope of limit curve β and the Maximum transformation strain εtr,max are taken From material. For User defined enter other values or expressions.
Specify the parameters that describe the phase transitions in terms of Temperature or Stress levels.
When Standard is selected from the Specify list, enter the Elastic domain radius σ0, the Hardening modulus Hk, and the Reference temperature T*.
When Stress is selected from the Specify list, enter the Martensite start stress σMs, the Martensite finish stress σMf, the Austenite finish stress σAf, and the Measurement temperature Tσ.
When Temperature is selected from the Specify list, enter the Martensite start temperature Ms, the Martensite finish temperature Mf, and the Austenite finish temperature Af.
Initial Transformation State
For Lagoudas model, enter the Initial martensite volume fraction, the Initial transformation strain tensor, the Initial martensite volume fraction at reverse point, and the Initial transformation strain tensor at reverse point.
For the Souza–Auricchio model, enter the Initial transformation strain tensor.
Geometric Nonlinearity
The settings in this section control the overall kinematics, the definition of the strain decomposition, and the behavior of inelastic contributions, for the material.
Select a FormulationFrom study step, Total Lagrangian, or Geometrically linear to set the kinematics of the deformation and the definition of strain. When From study step is selected, the study step controls the kinematics and the strain definition.
When From study step is selected, a total Lagrangian formulation for large strains is used when the Include geometric nonlinearity checkbox is selected in the study step. If the checkbox is not selected, the formulation is geometrically linear, with a small strain formulation.
To have full control of the formulation, select either Total Lagrangian, or Geometrically linear. When Total Lagrangian is selected, the physics will force the Include geometric nonlinearity checkbox in all study steps.
When inelastic deformations are present, such as for plasticity, the elastic strain can be obtained in different ways: using additive decomposition of strains or logarithmic stretches, or using multiplicative decomposition of deformation gradients.
Select a Strain decompositionAutomatic, Additive, Logarithmic, or Multiplicative to decide how the inelastic deformations are treated. This option is not available when the formulation is set to Geometrically linear.
When Automatic is selected, a multiplicative or additive decomposition is used with a total Lagrangian formulation, depending on the Include geometric nonlinearity checkbox status in the study step.
Select Additive to force an additive decomposition of strains.
Select Logarithmic to force an additive decomposition of logarithmic stretches. This option is only visible if Formulation is set to Total Lagrangian.
-
Select a MethodAnalytic or Padé to decide how the logarithm of the right stretch tensor is computed.
Select Multiplicative to force a multiplicative decomposition of deformation gradients. This option is only visible if Formulation is set to Total Lagrangian.

The Logarithmic strain decomposition is available for Linear Elastic materials in the Solid Mechanics and Solid Mechanics, Explicit Dynamics interfaces.
The Strain decomposition input is only visible for material models that support both additive and multiplicative decomposition of the deformation gradient.
Lagrangian Formulation, Deformation Measures, and Inelastic Strain Contributions in the Structural Mechanics Theory chapter.
Modeling Geometric Nonlinearity in the Structural Mechanics Modeling chapter.
Study Settings in the COMSOL Multiphysics Reference Manual.
Only the additive decomposition of strains is available for Lagoudas model.
Energy Dissipation
Select how to compute the energy dissipated by Creep, Plasticity, Viscoplasticity, or other dissipative processes.
Select how to Store dissipationFrom physics interface, Individual contributions, Total, Domain ODEs (legacy), or Off.

The option Domain ODEs (legacy) is not available in the interfaces intended for time-explicit dynamic analysis.
Use From physics interface to treat the dissipative processes as specified in the settings of the physics interface, see for instance Energy Dissipation in the Solid Mechanics interface.
Use Individual contributions to treat each dissipative process independently. Selecting this option gives a more flexible implementation for problems where dissipation occurs at different time scales, and you want to distinguish each phenomenon separately.
Use Total to accumulate all the dissipative processes into one common variable.
Use Domain ODEs to accumulate the dissipative processes into ODE variables instead of internal state variables.
Quadrature Settings
Select the Reduced integration checkbox to reduce the number of integration points used for the weak contribution in the material. Reduced integration give faster computations at the element level and help mitigate locking issues. However, reduced integration may also introduce numerical instabilities, which then require an additional stabilization term.
By default, the Reduced integration checkbox is cleared, except in interfaces designed for explicit dynamic analysis, where it is always selected.
It is possible to define different hourglass stabilization methods per mesh element type, for instance, when combining hexahedral and prisms elements within the same domain.
Select a method for Hourglass stabilizationAutomatic, Energy sampling, Hessian, Flanagan–Belytschko, Manual, or None to be used in combination with the reduced integration scheme.

The Energy sampling and Hessian methods are available in the Solid Mechanics and Solid Mechanics, Explicit Dynamics interfaces.
The Flanagan–Belytschko method is only available in the Solid Mechanics, Explicit Dynamics interface and should only be used with the Explicit Dynamics study step.
The Automatic option selects the stabilization method and its properties based on the physics interface, space dimension, shape function type and order of the displacement field, and the study type.
For the Energy sampling, Hessian, and Flanagan–Belytschko methods, the hourglass stiffness can be scaled by specifying a stiffness multiplier fstb. This multiplier can be an expression of any parameter or variable in the model. This multiplier can be expressed as any parameter or variable in the model. However, to maintain computational efficiency, avoid expensive definitions such as nonlocal coupling operators.
For the hourglass stabilization methods, the stiffness is automatically adjusted during the solution process using an internal multiplier. This accounts for the effect of inelastic deformations, such as damage and plasticity. This correction can be disabled by setting Inelastic deformations to Ignore. Ignoring inelastic deformations may be necessary for scenarios like cyclic loading, where the hourglass stiffness could become too small during unloading. Alternatively, adjust the value for the Minimum stiffness multiplier., which acts as a lower bound for the hourglass stiffness, which is applied in addition to any expression entered for fstb.
For the Energy sampling method, the default stabilization uses an isotropic linear elastic potential. Set the Energy Sampling Potential to Hyperelastic for large deformations. When selected, a neo-Hookean potential is used for nonlinear strains, while linear strains use the linear elastic potential.
The Hessian method evaluates a weak contribution using the reduced integration order. For hexahedral mesh elements, this approach may not suppress all hourglass modes. In most cases, non-stabilized modes are suppressed by constraints adjacent to the domain, but if they are not, select Use full integration to increase the integration order of the stabilization equations to suppress all modes. The higher integration order will increase the computational cost of the stabilization method.
When using the Manual option, select Shear stabilization or Volumetric stabilization. When Shear stabilization is selected, enter a stabilization shear modulus, Gstb. The value should be in the order of magnitude of the equivalent shear modulus.
When Volumetric stabilization is selected, enter a stabilization bulk modulus, Kstb. The value should be in the order of magnitude of the equivalent bulk modulus.
See also Reduced Integration and Hourglass Stabilization in the Structural Mechanics Theory chapter and Using Reduced Integration in the Structural Mechanics Modeling chapter.
Advanced
To display this section, click the Show More Options button () and select Advanced Physics Options in the Show More Options dialog.
Select the Local method to solve the plasticity problem — Automatic or Backward Euler. When Backward Euler is selected, it is possible to specify the maximum number of iterations and the relative tolerance used to solve the local plasticity equations. Enter the following settings:
Maximum number of local iterations. To determine the maximum number of iteration in the Newton loop when solving the local plasticity equations. The default value is 25 iterations.
Relative tolerance. To check the convergence of the local plasticity equations based on the step size in the Newton loop. The final tolerance is computed based on the current solution of the local variable and the entered value. The default value is 1e-6.
See also the Numerical Integration Algorithm section in the Structural Mechanics Theory chapter.
For the Lagoudas model, under Volume fraction constraint enter the Penalty factor γ to constrain the martensite volume fraction by the inequality ξM − 1 < 0.
For the Souza–Auricchio model, under Transformation strain constraint enter the Penalty factor γ to constrain the equivalent transformation strain by the inequality εtre − εtre,max < 0.
Check the Use transition zone checkbox to specify a transition zone size for the inequality.
Location in User Interface
Context Menus
Ribbon
Physics tab with Solid Mechanics selected:
Physics tab with Truss selected: