www.mooseframework.org
MechanicsActionPD.C
Go to the documentation of this file.
1 //* This file is part of the MOOSE framework
2 //* https://www.mooseframework.org
3 //*
4 //* All rights reserved, see COPYRIGHT for full restrictions
5 //* https://github.com/idaholab/moose/blob/master/COPYRIGHT
6 //*
7 //* Licensed under LGPL 2.1, please see LICENSE for details
8 //* https://www.gnu.org/licenses/lgpl-2.1.html
9 
10 #include "Factory.h"
11 #include "FEProblemBase.h"
12 #include "Conversion.h"
13 #include "MooseObjectAction.h"
14 #include "MechanicsActionPD.h"
15 
16 #include "libmesh/string_to_enum.h"
17 
18 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "setup_mesh_complete");
19 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "create_problem_complete");
20 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "add_aux_variable");
21 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "add_user_object");
22 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "add_ic");
23 registerMooseAction("PeridynamicsApp", MechanicsActionPD, "add_kernel");
24 
25 template <>
26 InputParameters
28 {
29  InputParameters params = validParams<Action>();
30  params.addClassDescription("Class for setting up peridynamic kernels");
31 
32  params.addRequiredParam<std::vector<VariableName>>(
33  "displacements", "Nonlinear variable names for the displacements");
34  MooseEnum formulation_option("BOND ORDINARY_STATE NONORDINARY_STATE");
35  params.addRequiredParam<MooseEnum>("formulation",
36  formulation_option,
37  "Available peridynamic formulation options: " +
38  formulation_option.getRawNames());
39  MooseEnum stabilization_option("FORCE SELF", "SELF");
40  params.addParam<MooseEnum>(
41  "stabilization",
42  stabilization_option,
43  "Available stabilization options for Non-Ordinary State Based Peridynamics: " +
44  stabilization_option.getRawNames());
45  params.addParam<bool>(
46  "full_jacobian",
47  false,
48  "Parameter to set whether to use full jacobian for state based formulation or not");
49  MooseEnum strain_type("SMALL FINITE", "SMALL");
50  params.addParam<MooseEnum>("strain", strain_type, "Strain formulation");
51  params.addParam<VariableName>("temperature", "Nonlinear variable name for the temperature");
52  params.addParam<VariableName>("out_of_plane_strain",
53  "Nonlinear variable name for the out_of_plane strain for "
54  "plane stress using SNOSPD formulation");
55  params.addParam<std::vector<SubdomainName>>("block",
56  "List of ids of the blocks (subdomains) that the "
57  "peridynamic mechanics kernel will be applied to");
58  params.addParam<std::vector<AuxVariableName>>("save_in", "The displacement residuals");
59  params.addParam<std::vector<AuxVariableName>>("diag_save_in",
60  "The displacement diagonal preconditioner terms");
61  params.addParam<std::vector<MaterialPropertyName>>(
62  "eigenstrain_names",
63  "List of eigenstrains to be coupled in non-ordinary state-based mechanics kernels");
64 
65  return params;
66 }
67 
68 MechanicsActionPD::MechanicsActionPD(const InputParameters & params)
69  : Action(params),
70  _displacements(getParam<std::vector<VariableName>>("displacements")),
71  _ndisp(_displacements.size()),
72  _formulation(getParam<MooseEnum>("formulation")),
73  _stabilization(getParam<MooseEnum>("stabilization")),
74  _strain(getParam<MooseEnum>("strain")),
75  _subdomain_names(getParam<std::vector<SubdomainName>>("block")),
76  _subdomain_ids(),
77  _save_in(getParam<std::vector<AuxVariableName>>("save_in")),
78  _diag_save_in(getParam<std::vector<AuxVariableName>>("diag_save_in"))
79 {
80  // Consistency check
81  if (_save_in.size() != 0 && _save_in.size() != _ndisp)
82  mooseError("Number of save_in variables should equal to the number of displacement variables ",
83  _ndisp);
84 
85  if (_diag_save_in.size() != 0 && _diag_save_in.size() != _ndisp)
86  mooseError(
87  "Number of diag_save_in variables should equal to the number of displacement variables ",
88  _ndisp);
89 }
90 
91 void
93 {
94  if (_current_task == "setup_mesh_complete")
95  {
96  // get subdomain IDs
97  for (auto & name : _subdomain_names)
98  _subdomain_ids.insert(_mesh->getSubdomainID(name));
99  }
100  else if (_current_task == "create_problem_complete")
101  {
102  // Gather info about all other master actions for adding (aux)variables
103  auto actions = _awh.getActions<MechanicsActionPD>();
104  for (const auto & action : actions)
105  {
106  const auto size_before = _subdomain_id_union.size();
107  const auto added_size = action->_subdomain_ids.size();
108  _subdomain_id_union.insert(action->_subdomain_ids.begin(), action->_subdomain_ids.end());
109  const auto size_after = _subdomain_id_union.size();
110 
111  if (size_after != size_before + added_size)
112  mooseError("The block restrictions in the Peridynamics/Mechanics/Master actions must be "
113  "non-overlapping.");
114 
115  if (added_size == 0 && actions.size() > 1)
116  mooseError(
117  "No Peridynamics/Mechanics/Master action can be block unrestricted if more than one "
118  "Peridynamics/Mechanics/Master action is specified.");
119  }
120  }
121  else if (_current_task == "add_aux_variable")
122  {
123  // add the bond_status aux variable to all peridynamic domains
124  const std::string var_type = "MooseVariableConstMonomial";
125  InputParameters params = _factory.getValidParams(var_type);
126  params.set<MooseEnum>("order") = "CONSTANT";
127  params.set<MooseEnum>("family") = "MONOMIAL";
128 
129  if (!_subdomain_id_union.empty())
130  for (const SubdomainID & id : _subdomain_id_union)
131  params.set<std::vector<SubdomainName>>("block").push_back(Moose::stringify(id));
132 
133  _problem->addAuxVariable(var_type, "bond_status", params);
134  }
135  else if (_current_task == "add_ic")
136  {
137  const std::string ic_type = "ConstantIC";
138  const std::string ic_name = name() + "bond_status";
139 
140  InputParameters params = _factory.getValidParams(ic_type);
141  params.set<VariableName>("variable") = "bond_status";
142  params.set<Real>("value") = 1.0;
143 
144  // check whether this object is restricted to certain block?
145  if (isParamValid("block"))
146  params.set<std::vector<SubdomainName>>("block") = _subdomain_names;
147 
148  _problem->addInitialCondition(ic_type, ic_name, params);
149  }
150  else if (_current_task == "add_user_object")
151  {
152  // add ghosting UO
153  const std::string uo_type = "GhostElemPD";
154  const std::string uo_name = name() + "GhostElemPD";
155 
156  InputParameters params = _factory.getValidParams(uo_type);
157  params.set<bool>("use_displaced_mesh") = (_strain == "FINITE");
158 
159  _problem->addUserObject(uo_type, uo_name, params);
160  }
161  else if (_current_task == "add_kernel")
162  {
163  const std::string kernel_name = getKernelName();
164  InputParameters params = getKernelParameters(kernel_name);
165 
166  for (unsigned int i = 0; i < _ndisp; ++i)
167  {
168  const std::string kernel_object_name = name() + "Peridynamics_" + Moose::stringify(i);
169 
170  params.set<unsigned int>("component") = i;
171  params.set<NonlinearVariableName>("variable") = _displacements[i];
172 
173  if (_save_in.size() != 0)
174  params.set<std::vector<AuxVariableName>>("save_in") = {_save_in[i]};
175  if (_diag_save_in.size() != 0)
176  params.set<std::vector<AuxVariableName>>("diag_save_in") = {_diag_save_in[i]};
177 
178  _problem->addKernel(kernel_name, kernel_object_name, params);
179  }
180  }
181  else
182  mooseError("Task error in MechanicsActionPD");
183 }
184 
185 std::string
187 {
188  std::string name;
189 
190  if (_formulation == "BOND")
191  name = "MechanicsBPD";
192  else if (_formulation == "ORDINARY_STATE")
193  name = "MechanicsOSPD";
194  else if (_formulation == "NONORDINARY_STATE")
195  {
196  if (_stabilization == "FORCE")
197  name = "ForceStabilizedSmallStrainMechanicsNOSPD";
198  else if (_stabilization == "SELF")
199  {
200  if (_strain == "FINITE")
201  name = "FiniteStrainMechanicsNOSPD";
202  else
203  name = "SmallStrainMechanicsNOSPD";
204  }
205  else
206  paramError("stabilization", "Unknown PD stabilization scheme. Choose from: FORCE SELF");
207  }
208  else
209  paramError(
210  "formulation",
211  "Unsupported peridynamic formulation. Choose from: BOND ORDINARY_STATE NONORDINARY_STATE");
212 
213  return name;
214 }
215 
216 InputParameters
218 {
219  InputParameters params = _factory.getValidParams(name);
220 
221  params.applyParameters(parameters(),
222  {"displacements",
223  "temperature",
224  "out_of_plane_strain",
225  "eigenstrain_names",
226  "use_displaced_mesh",
227  "save_in",
228  "diag_save_in"});
229 
230  params.set<std::vector<VariableName>>("displacements") = _displacements;
231  if (isParamValid("temperature"))
232  params.set<std::vector<VariableName>>("temperature") = {getParam<VariableName>("temperature")};
233  if (isParamValid("out_of_plane_strain"))
234  params.set<std::vector<VariableName>>("out_of_plane_strain") = {
235  getParam<VariableName>("out_of_plane_strain")};
236 
237  // peridynamics modules are formulated based on initial configuration
238  params.set<bool>("use_displaced_mesh") = false;
239 
240  if (_formulation == "NONORDINARY_STATE" && isParamValid("eigenstrain_names"))
241  {
242  params.set<std::vector<MaterialPropertyName>>("eigenstrain_names") =
243  getParam<std::vector<MaterialPropertyName>>("eigenstrain_names");
244  }
245 
246  return params;
247 }
MechanicsActionPD::_ndisp
const unsigned int _ndisp
Definition: MechanicsActionPD.h:46
validParams< MechanicsActionPD >
InputParameters validParams< MechanicsActionPD >()
Definition: MechanicsActionPD.C:27
MechanicsActionPD::_subdomain_names
std::vector< SubdomainName > _subdomain_names
vector of subdomain names from provided blocks
Definition: MechanicsActionPD.h:61
MechanicsActionPD::MechanicsActionPD
MechanicsActionPD(const InputParameters &params)
Definition: MechanicsActionPD.C:68
MechanicsActionPD::getKernelName
virtual std::string getKernelName()
Function to get the kernel name based on the value of member variables: _formulation and _stabilizati...
Definition: MechanicsActionPD.C:186
MechanicsActionPD::_save_in
std::vector< AuxVariableName > _save_in
Residual debugging.
Definition: MechanicsActionPD.h:71
MechanicsActionPD::_subdomain_id_union
std::set< SubdomainID > _subdomain_id_union
set of SubdomainID generated from the combined block restrictions of all TensorMechanics/Master actio...
Definition: MechanicsActionPD.h:68
MechanicsActionPD::_formulation
const MooseEnum _formulation
Option of which peridynamic model needs to be setup: BOND, ORDINARY_STATE or NONORDINARY_STATE.
Definition: MechanicsActionPD.h:51
MechanicsActionPD::getKernelParameters
virtual InputParameters getKernelParameters(std::string name)
Function to get the input parameters for a given kernel name.
Definition: MechanicsActionPD.C:217
MechanicsActionPD::_displacements
std::vector< VariableName > _displacements
Displacement variables.
Definition: MechanicsActionPD.h:45
MechanicsActionPD::act
virtual void act() override
Definition: MechanicsActionPD.C:92
MechanicsActionPD::_strain
const MooseEnum _strain
Option of strain formulation: SMALL or FINITE.
Definition: MechanicsActionPD.h:58
name
const std::string name
Definition: Setup.h:21
registerMooseAction
registerMooseAction("PeridynamicsApp", MechanicsActionPD, "setup_mesh_complete")
MechanicsActionPD::_subdomain_ids
std::set< SubdomainID > _subdomain_ids
set of subdomain IDs generated from the passed in vector of subdomain names
Definition: MechanicsActionPD.h:64
MechanicsActionPD::_diag_save_in
std::vector< AuxVariableName > _diag_save_in
Definition: MechanicsActionPD.h:72
MechanicsActionPD
Action class to setup peridynamic models for solid mechanics problems.
Definition: MechanicsActionPD.h:22
MechanicsActionPD::_stabilization
const MooseEnum _stabilization
Option of stabilization scheme for correspondence material model (non-ordinary state based): FORCE or...
Definition: MechanicsActionPD.h:55
MechanicsActionPD.h