AsymptoticExpansionHomogenizationElasticConstants

Postprocessor for asymptotic expansion homogenization for elasticity

Description

This PostProcessor computes $var element = document.getElementById("moose-equation-3472c066-c4d7-4457-a71c-283e910a1d3a");katex.render("D_{ijkl}^\\text{H} = \\frac{1}{\\left|\\text{Y}\\right|}\\int_\\text{Y}D_{ijkl} \\left(\\bm{I}+\\frac{\\partial\\chi^{mn}_\\kappa}{\\partial y_l}\\right)\\;d\\bm{y}.", element, {displayMode:true,throwOnError:false});$ where $var element = document.getElementById("moose-equation-b664f5bf-8afb-4905-a867-dd543ee982df");katex.render("D_{ijkl}^\\text{H}", element, {displayMode:false,throwOnError:false});$ is the homogenized elasticity tensor. It is used in conjunction with the Stress Divergence Kernel and the Asymptotic Expansion Homogenization Elastic Constants Kernel to compute homogenized elasticity tensor values according to $var element = document.getElementById("moose-equation-311033ea-e968-42da-8b89-38599f50624f");katex.render("\\int_\\text{Y}\\frac{\\partial v_i}{\\partial y_j} D_{ijkl} \\frac{\\partial\\chi_\\kappa^{mn}}{\\partial y_l}\\text{d}\\bm{y} = \\int_\\text{Y} \\frac{\\partial v_i}{\\partial y_j}D_{ijkl}\\;\\text{d}\\bm{y}", element, {displayMode:true,throwOnError:false});$ where $var element = document.getElementById("moose-equation-269d58f7-d09a-4158-a46c-6a1d77bf8c8c");katex.render("D_{ijkl}", element, {displayMode:false,throwOnError:false});$ is the elasticity tensor. See Hales et al. (2015).

Example Input File Syntax

[./E1111]
  type = AsymptoticExpansionHomogenizationElasticConstants
  base_name = xx
  row = xx
  column = xx
  dx_xx = dx_xx
  dy_xx = dy_xx
  dx_yy = dx_yy
  dy_yy = dy_yy
  dx_xy = dx_xy
  dy_xy = dy_xy
  execute_on = 'initial timestep_end'
[../]

Input Parameters

columnThe column of the material matrix this kernel acts in. (xx, yy, zz, yz, xz, or xy)
C++ Type:MooseEnum
Options:xx, yy, zz, yz, xz, xy
Controllable:No
Description:The column of the material matrix this kernel acts in. (xx, yy, zz, yz, xz, or xy)
dx_xxsolution in xx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xx
dx_xysolution in xy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xy
dx_yysolution in yy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yy
dy_xxsolution in xx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xx
dy_xysolution in xy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xy
dy_yysolution in yy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yy
rowThe row of the material matrix this kernel acts in. (xx, yy, zz, yz, xz, or xy)
C++ Type:MooseEnum
Options:xx, yy, zz, yz, xz, xy
Controllable:No
Description:The row of the material matrix this kernel acts in. (xx, yy, zz, yz, xz, or xy)

Required Parameters

base_nameOptional parameter that allows the user to define multiple mechanics material systems on the same block, i.e. for multiple phases
C++ Type:std::string
Controllable:No
Description:Optional parameter that allows the user to define multiple mechanics material systems on the same block, i.e. for multiple phases
blockThe list of blocks (ids or names) that this object will be applied
C++ Type:std::vector<SubdomainName>
Controllable:No
Description:The list of blocks (ids or names) that this object will be applied
dx_yzsolution in yz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yz
dx_zxsolution in zx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zx
dx_zzsolution in zz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zz
dy_yzsolution in yz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yz
dy_zxsolution in zx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zx
dy_zzsolution in zz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zz
dz_xxsolution in xx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xx
dz_xysolution in xy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in xy
dz_yysolution in yy
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yy
dz_yzsolution in yz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in yz
dz_zxsolution in zx
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zx
dz_zzsolution in zz
C++ Type:std::vector<VariableName>
Controllable:No
Description:solution in zz
execute_onTIMESTEP_ENDThe list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, MULTIAPP_FIXED_POINT_END, MULTIAPP_FIXED_POINT_BEGIN, FINAL, CUSTOM, ALWAYS.
Default:TIMESTEP_END
C++ Type:ExecFlagEnum
Options:NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, MULTIAPP_FIXED_POINT_END, MULTIAPP_FIXED_POINT_BEGIN, FINAL, CUSTOM, ALWAYS, TRANSFER
Controllable:No
Description:The list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, MULTIAPP_FIXED_POINT_END, MULTIAPP_FIXED_POINT_BEGIN, FINAL, CUSTOM, ALWAYS.
prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.
C++ Type:MaterialPropertyName
Controllable:No
Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

Optional Parameters

allow_duplicate_execution_on_initialFalseIn the case where this UserObject is depended upon by an initial condition, allow it to be executed twice during the initial setup (once before the IC and again after mesh adaptivity (if applicable).
Default:False
C++ Type:bool
Controllable:No
Description:In the case where this UserObject is depended upon by an initial condition, allow it to be executed twice during the initial setup (once before the IC and again after mesh adaptivity (if applicable).
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.
execution_order_group0Execution order groups are executed in increasing order (e.g., the lowest number is executed first). Note that negative group numbers may be used to execute groups before the default (0) group. Please refer to the user object documentation for ordering of user object execution within a group.
Default:0
C++ Type:int
Controllable:No
Description:Execution order groups are executed in increasing order (e.g., the lowest number is executed first). Note that negative group numbers may be used to execute groups before the default (0) group. Please refer to the user object documentation for ordering of user object execution within a group.
force_postauxFalseForces the UserObject to be executed in POSTAUX
Default:False
C++ Type:bool
Controllable:No
Description:Forces the UserObject to be executed in POSTAUX
force_preauxFalseForces the UserObject to be executed in PREAUX
Default:False
C++ Type:bool
Controllable:No
Description:Forces the UserObject to be executed in PREAUX
force_preicFalseForces the UserObject to be executed in PREIC during initial setup
Default:False
C++ Type:bool
Controllable:No
Description:Forces the UserObject to be executed in PREIC during initial setup
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
outputsVector of output names where you would like to restrict the output of variables(s) associated with this object
C++ Type:std::vector<OutputName>
Controllable:No
Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object
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

References

J. D. Hales, M. R. Tonks, K. Chockalingam, D. M. Perez, S. R. Novascone, B. W. Spencer, and R. L. Williamson. Asymptotic expansion homogenization for multiscale nuclear fuel analysis. Computational Materials Science, 99:290–297, March 2015. URL: http://dx.doi.org/10.1016/j.commatsci.2014.12.039, doi:10.1016/j.commatsci.2014.12.039.

@article{hales15homogenization,
    author = "Hales, J. D. and Tonks, M. R. and Chockalingam, K. and Perez, D. M. and Novascone, S. R. and Spencer, B. W. and Williamson, R. L.",
    title = "Asymptotic expansion homogenization for multiscale nuclear fuel analysis",
    journal = "Computational Materials Science",
    year = "2015",
    volume = "99",
    month = "March",
    pages = "290--297",
    doi = "10.1016/j.commatsci.2014.12.039",
    url = "http://dx.doi.org/10.1016/j.commatsci.2014.12.039"
}

(moose/modules/tensor_mechanics/test/tests/homogenization/anisoShortFiber.i)

#
# Test from:
#   Multiple Scale Analysis of Heterogeneous Elastic Structures Using
#   Homogenization Theory and Voronoi Cell Finite Element Method
#   by S.Ghosh et. al, Int J. Solids Structures, Vol. 32, No. 1,
#   pp. 27-62, 1995.
#
# From that paper, elastic constants should be:
# E1111: 122.4
# E2222: 151.2
# E1212:  42.1
# E1122:  36.23
#
# Note: this is for plane stress conditions
#

[Mesh]
  file = anisoShortFiber.e
  # To calculate matching values, refine the mesh one time.
  # We use a coarse mesh for speed in this test.
  # uniform_refine = 1
[]

[Variables]
  [./dx_xx]
    order = FIRST
    family = LAGRANGE
  [../]
  [./dy_xx]
    order = FIRST
    family = LAGRANGE
  [../]

  [./dx_yy]
    order = FIRST
    family = LAGRANGE
  [../]
  [./dy_yy]
    order = FIRST
    family = LAGRANGE
  [../]

  [./dx_xy]
    order = FIRST
    family = LAGRANGE
  [../]
  [./dy_xy]
    order = FIRST
    family = LAGRANGE
  [../]
[]


[Kernels]

  [./div_x_xx]
    type = StressDivergenceTensors
    component = 0
    variable = dx_xx
    displacements = 'dx_xx dy_xx'
    use_displaced_mesh = false
    base_name = xx
  [../]
  [./div_y_xx]
    type = StressDivergenceTensors
    component = 1
    variable = dy_xx
    displacements = 'dx_xx dy_xx'
    use_displaced_mesh = false
    base_name = xx
  [../]
  [./div_x_yy]
    type = StressDivergenceTensors
    component = 0
    variable = dx_yy
    displacements = 'dx_yy dy_yy'
    use_displaced_mesh = false
    base_name = yy
  [../]
  [./div_y_yy]
    type = StressDivergenceTensors
    component = 1
    variable = dy_yy
    displacements = 'dx_yy dy_yy'
    use_displaced_mesh = false
    base_name = yy
  [../]
  [./div_x_xy]
    type = StressDivergenceTensors
    component = 0
    variable = dx_xy
    displacements = 'dx_xy dy_xy'
    use_displaced_mesh = false
    base_name = xy
  [../]
  [./div_y_xy]
    type = StressDivergenceTensors
    component = 1
    variable = dy_xy
    displacements = 'dx_xy dy_xy'
    use_displaced_mesh = false
    base_name = xy
  [../]

  [./aeh_dx_xx]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dx_xx
    component = 0
    column = xx
    base_name = xx
  [../]
  [./aeh_dy_xx]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dy_xx
    component = 1
    column = xx
    base_name = xx
  [../]

  [./aeh_dx_yy]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dx_yy
    component = 0
    column = yy
    base_name = yy
  [../]
  [./aeh_dy_yy]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dy_yy
    component = 1
    column = yy
    base_name = yy
  [../]

  [./aeh_dx_xy]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dx_xy
    component = 0
    column = xy
    base_name = xy
  [../]
  [./aeh_dy_xy]
    type = AsymptoticExpansionHomogenizationKernel
    variable = dy_xy
    component = 1
    column = xy
    base_name = xy
  [../]
[]

[BCs]

  [./Periodic]
    [./top_bottom]
      primary = 30
      secondary = 40
      translation = '0 1 0'
    [../]

    [./left_right]
      primary = 10
      secondary = 20
      translation = '1 0 0'
    [../]
  [../]

  [./dx_xx_anchor]
    type = DirichletBC
    variable = dx_xx
    boundary = 1
    value = 0.0
  [../]

  [./dy_xx_anchor]
    type = DirichletBC
    variable = dy_xx
    boundary = 1
    value = 0.0
  [../]

  [./dx_yy_anchor]
    type = DirichletBC
    variable = dx_yy
    boundary = 1
    value = 0.0
  [../]

  [./dy_yy_anchor]
    type = DirichletBC
    variable = dy_yy
    boundary = 1
    value = 0.0
  [../]

  [./dx_xy_anchor]
    type = DirichletBC
    variable = dx_xy
    boundary = 1
    value = 0.0
  [../]

  [./dy_xy_anchor]
    type = DirichletBC
    variable = dy_xy
    boundary = 1
    value = 0.0
  [../]
[]

[Materials]

  [./elastic_stress_xx]
    type = ComputeLinearElasticStress
    base_name = xx
  [../]
  [./elastic_stress_yy]
    type = ComputeLinearElasticStress
    base_name = yy
  [../]
  [./elastic_stress_xy]
    type = ComputeLinearElasticStress
    base_name = xy
  [../]
  [./strain_xx]
    type = ComputeSmallStrain
    displacements = 'dx_xx dy_xx'
    base_name = xx
  [../]
  [./strain_yy]
    type = ComputeSmallStrain
    displacements = 'dx_yy dy_yy'
    base_name = yy
  [../]
  [./strain_xy]
    type = ComputeSmallStrain
    displacements = 'dx_xy dy_xy'
    base_name = xy
  [../]


  [./block1]
    type =  ComputeElasticityTensor
    block = 1
    fill_method = symmetric9
    C_ijkl = '81.360117 26.848839 26.848839 81.360117 26.848839 81.360117 27.255639 27.255639 27.255639'
    base_name = xx
  [../]

  [./block2]
    type =  ComputeElasticityTensor
    block = 1
    fill_method = symmetric9
    C_ijkl = '81.360117 26.848839 26.848839 81.360117 26.848839 81.360117 27.255639 27.255639 27.255639'
    base_name = yy
  [../]

  [./block3]
    type =  ComputeElasticityTensor
    block = 1
    fill_method = symmetric9
    C_ijkl = '81.360117 26.848839 26.848839 81.360117 26.848839 81.360117 27.255639 27.255639 27.255639'
    base_name = xy
  [../]

  [./block4]
    type =  ComputeElasticityTensor
    block = 2
    fill_method = symmetric9
    C_ijkl = '416.66667 83.33333 83.33333 416.6667 83.33333 416.66667 166.66667 166.66667 166.66667'
    base_name = xx
  [../]

  [./block5]
    type =  ComputeElasticityTensor
    block = 2
    fill_method = symmetric9
    C_ijkl = '416.66667 83.33333 83.33333 416.6667 83.33333 416.66667 166.66667 166.66667 166.66667'
    base_name = yy
  [../]

  [./block6]
    type =  ComputeElasticityTensor
    block = 2
    fill_method = symmetric9
    C_ijkl = '416.66667 83.33333 83.33333 416.6667 83.33333 416.66667 166.66667 166.66667 166.66667'
    base_name = xy
 [../]

[]

[Postprocessors]

  [./E1111]
    type = AsymptoticExpansionHomogenizationElasticConstants
    base_name = xx
    row = xx
    column = xx
    dx_xx = dx_xx
    dy_xx = dy_xx
    dx_yy = dx_yy
    dy_yy = dy_yy
    dx_xy = dx_xy
    dy_xy = dy_xy
    execute_on = 'initial timestep_end'
  [../]

  [./E2222]
    type = AsymptoticExpansionHomogenizationElasticConstants
    base_name = xx
    row = yy
    column = yy
    dx_xx = dx_xx
    dy_xx = dy_xx
    dx_yy = dx_yy
    dy_yy = dy_yy
    dx_xy = dx_xy
    dy_xy = dy_xy
    execute_on = 'initial timestep_end'
  [../]

  [./E1122]
    type = AsymptoticExpansionHomogenizationElasticConstants
    base_name = xx
    row = xx
    column = yy
    dx_xx = dx_xx
    dy_xx = dy_xx
    dx_yy = dx_yy
    dy_yy = dy_yy
    dx_xy = dx_xy
    dy_xy = dy_xy
    execute_on = 'initial timestep_end'
  [../]


  [./E2211]
    type = AsymptoticExpansionHomogenizationElasticConstants
    base_name = xy
    row = yy
    column = xx
    dx_xx = dx_xx
    dy_xx = dy_xx
    dx_yy = dx_yy
    dy_yy = dy_yy
    dx_xy = dx_xy
    dy_xy = dy_xy
    execute_on = 'initial timestep_end'
  [../]


  [./E1212]
    type = AsymptoticExpansionHomogenizationElasticConstants
    base_name = xx
    row = xy
    column = xy
    dx_xx = dx_xx
    dy_xx = dy_xx
    dx_yy = dx_yy
    dy_yy = dy_yy
    dx_xy = dx_xy
    dy_xy = dy_xy
    execute_on = 'initial timestep_end'
  [../]
[]

[Preconditioning]
 [./SMP]
  type = SMP
  full = true
 [../]
[]


[Executioner]

  type = Transient

  solve_type = 'PJFNK'

  petsc_options = '-ksp_gmres_modifiedgramschmidt'
  petsc_options_iname = '-ksp_gmres_restart -pc_type   -pc_hypre_type -pc_hypre_boomeramg_max_iter -pc_hypre_boomeramg_grid_sweeps_all -ksp_type -mat_mffd_type'
  petsc_options_value = '201                 hypre       boomeramg      2                            2                                   fgmres    ds'

  line_search = 'none'


  l_tol = 1e-4
  l_max_its = 40
  nl_max_its = 40
  nl_abs_tol = 1e-10
  nl_rel_tol = 1e-10

  start_time = 0.0
  end_time = 10.0
  num_steps = 1
  dt = 10

[]


[Outputs]
  exodus = true
[]