HomogenizationConstraintScalarKernel

Overview

This ScalarKernel inputs the residual contributions from the Lagrangian kernel homogenization system. The HomogenizationConstraintIntegral UserObject computes the actual values of the residual volume integrals and the HomogenizedTotalLagrangianStressDivergence Kernel handles all the off-diagonal Jacobian terms. This ScalarKernel only supplies the residual and on-diagonal Jacobian.

The TensorMechanics/MasterAction can add this object automatically, which is the recommended way to set up homogenization constraints.

Example Input File Syntax

The following example manually specifies the parameters required to setup the object for a 3D, large deformation homogenization problem. In this case the name of the HomogenizationConstraintIntegral is integrator, ndim sets the dimensionality of the problem, and large_kinematics controls if large or small deformation kinematics apply.

[ScalarKernels]
  [enforce]
    type = HomogenizationConstraintScalarKernel
    variable = hvar
    integrator = integrator
    ndim = 3
    large_kinematics = true
  []
[]
(modules/tensor_mechanics/test/tests/lagrangian/total/homogenization/large-tests/3d-stress.i)

Input Parameters

  • integratorThe integrator user object doing the element calculations.

    C++ Type:UserObjectName

    Controllable:No

    Description:The integrator user object doing the element calculations.

  • ndimNumber of problem displacements

    C++ Type:unsigned int

    Controllable:No

    Description:Number of problem displacements

  • variableThe name of the variable that this residual object operates on

    C++ Type:NonlinearVariableName

    Controllable:No

    Description:The name of the variable that this residual object operates on

Required Parameters

  • large_kinematicsFalseAre we using large deformations?

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Are we using large deformations?

Optional Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Controllable:Yes

    Description:Set the enabled status of the MooseObject.

  • implicitTrueDetermines whether this object is calculated using an implicit or explicit form

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Determines whether this object is calculated using an implicit or explicit form

  • seed0The seed for the master random number generator

    Default:0

    C++ Type:unsigned int

    Controllable:No

    Description:The seed for the master random number generator

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

  • extra_matrix_tagsThe extra tags for the matrices this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the matrices this Kernel should fill

  • extra_vector_tagsThe extra tags for the vectors this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the vectors this Kernel should fill

  • matrix_tagssystemThe tag for the matrices this Kernel should fill

    Default:system

    C++ Type:MultiMooseEnum

    Options:nontime, system

    Controllable:No

    Description:The tag for the matrices this Kernel should fill

  • vector_tagsnontimeThe tag for the vectors this Kernel should fill

    Default:nontime

    C++ Type:MultiMooseEnum

    Options:nontime, time

    Controllable:No

    Description:The tag for the vectors this Kernel should fill

Tagging Parameters

Input Files