ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage > Class Template Reference

ADComputeMeanThermalExpansionFunctionEigenstrain computes an eigenstrain for thermal expansion according to a mean thermal expansion function. More...

#include <ADComputeMeanThermalExpansionFunctionEigenstrain.h>

Inheritance diagram for ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >:

Public Member Functions
	ADComputeMeanThermalExpansionFunctionEigenstrain (const InputParameters &parameters)

Static Public Member Functions
static InputParameters	validParams ()

Protected Member Functions
virtual Real	referenceTemperature () override
virtual ADReal	meanThermalExpansionCoefficient (const ADReal &temperature) override
virtual void	computeThermalStrain (ADReal &thermal_strain) override
virtual void	computeQpEigenstrain () override
	Compute the eigenstrain and store in _eigenstrain. More...
virtual void	initQpStatefulProperties () override
virtual void	computeQpProperties () override
	ADMaterialProperty (RankTwoTensor) &_eigenstrain
	Stores the current total eigenstrain. More...
ADReal	computeVolumetricStrainComponent (const ADReal volumetric_strain) const
	Helper function for models that compute the eigenstrain based on a volumetric strain. More...

Protected Attributes
const Function &	_thermal_expansion_function
const Real &	_thexp_func_ref_temp
	usingComputeMeanThermalExpansionEigenstrainBaseMembers
	usingComputeThermalExpansionEigenstrainBaseMembers
const ADVariableValue &	_temperature
const ADVariableValue &	_stress_free_temperature
	usingComputeEigenstrainBaseMembers
const std::string	_base_name
	Base name prepended to material property name. More...
std::string	_eigenstrain_name
	Material property name for the eigenstrain tensor. More...
bool &	_step_zero
	Restartable data to check for the zeroth and first time steps for thermal calculations. More...
	usingMaterialMembers

Detailed Description

template<ComputeStage compute_stage>
class ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >

ADComputeMeanThermalExpansionFunctionEigenstrain computes an eigenstrain for thermal expansion according to a mean thermal expansion function.

Definition at line 15 of file ADComputeMeanThermalExpansionFunctionEigenstrain.h.

Constructor & Destructor Documentation

ADComputeMeanThermalExpansionFunctionEigenstrain()

template<ComputeStage compute_stage>

ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::ADComputeMeanThermalExpansionFunctionEigenstrain

(

const InputParameters &

parameters

)

Definition at line 38 of file ADComputeMeanThermalExpansionFunctionEigenstrain.C.

  : ADComputeMeanThermalExpansionEigenstrainBase<compute_stage>(parameters),
    _thermal_expansion_function(getFunction("thermal_expansion_function")),
    _thexp_func_ref_temp(getParam<Real>("thermal_expansion_function_reference_temperature"))
{
}

Member Function Documentation

ADMaterialProperty()

template<ComputeStage compute_stage>

ADComputeEigenstrainBase< compute_stage >::ADMaterialProperty ( RankTwoTensor  ) &

protectedinherited

Stores the current total eigenstrain.

computeQpEigenstrain()

template<ComputeStage compute_stage>

void ADComputeThermalExpansionEigenstrainBase< compute_stage >::computeQpEigenstrain ( )

overrideprotectedvirtualinherited

Compute the eigenstrain and store in _eigenstrain.

Implements ADComputeEigenstrainBase< compute_stage >.

Definition at line 39 of file ADComputeThermalExpansionEigenstrainBase.C.

{
  ADReal thermal_strain = 0.0;
 
  computeThermalStrain(thermal_strain);
 
  _eigenstrain[_qp].zero();
  _eigenstrain[_qp].addIa(thermal_strain);
}

computeQpProperties()

template<ComputeStage compute_stage>

void ADComputeEigenstrainBase< compute_stage >::computeQpProperties ( )

overrideprotectedvirtualinherited

Definition at line 59 of file ADComputeEigenstrainBase.C.

{
  if (_t_step >= 1)
    _step_zero = false;
 
  // Skip the eigenstrain calculation in step zero because no solution is computed during
  // the zeroth step, hence computing the eigenstrain in the zeroth step would result in
  // an incorrect calculation of mechanical_strain, which is stateful.
  if (!_step_zero)
    computeQpEigenstrain();
}

computeThermalStrain()

template<ComputeStage compute_stage>

void ADComputeMeanThermalExpansionEigenstrainBase< compute_stage >::computeThermalStrain ( ADReal &  thermal_strain )

overrideprotectedvirtualinherited

Implements ADComputeThermalExpansionEigenstrainBase< compute_stage >.

Definition at line 33 of file ADComputeMeanThermalExpansionEigenstrainBase.C.

{
  const Real reference_temperature = referenceTemperature();
  const ADReal & current_temp = _temperature[_qp];
  const ADReal current_alphabar = meanThermalExpansionCoefficient(current_temp);
  const ADReal thexp_current_temp = current_alphabar * (current_temp - reference_temperature);
 
  // Mean linear thermal expansion coefficient relative to the reference temperature
  // evaluated at stress_free_temperature.  This is
  // \f$\bar{\alpha} = (\delta L(T_{sf}) / L) / (T_{sf} - T_{ref})\f$
  // where \f$T_sf\f$ is the stress-free temperature and \f$T_{ref}\f$ is the reference temperature.
  const ADReal alphabar_stress_free_temperature =
      meanThermalExpansionCoefficient(_stress_free_temperature[_qp]);
  // Thermal expansion relative to the reference temperature evaluated at stress_free_temperature
  // \f$(\delta L(T_sf) / L)\f$, where \f$T_sf\f$ is the stress-free temperature.
  const ADReal thexp_stress_free_temperature =
      alphabar_stress_free_temperature * (_stress_free_temperature[_qp] - referenceTemperature());
 
  // Per M. Niffenegger and K. Reichlin (2012), thermal_strain should be divided
  // by (1.0 + thexp_stress_free_temperature) to account for the ratio of
  // the length at the stress-free temperature to the length at the reference
  // temperature. It can be neglected because it is very close to 1,
  // but we include it for completeness here.
 
  thermal_strain =
      (thexp_current_temp - thexp_stress_free_temperature) / (1.0 + thexp_stress_free_temperature);
}

computeVolumetricStrainComponent()

template<ComputeStage compute_stage>

ADReal ADComputeEigenstrainBase< compute_stage >::computeVolumetricStrainComponent ( const ADReal  volumetric_strain ) const

protectedinherited

Helper function for models that compute the eigenstrain based on a volumetric strain.

This function computes the diagonal components of the eigenstrain tensor as logarithmic strains.

Parameters

volumetric_strain

The current volumetric strain to be applied

Returns

Current strain in one direction due to volumetric strain, expressed as a logarithmic strain

Definition at line 73 of file ADComputeEigenstrainBase.C.

{
  // The engineering strain in a given direction is:
  // epsilon_eng = cbrt(volumetric_strain + 1.0) - 1.0
  //
  // We need to provide this as a logarithmic strain to be consistent with the strain measure
  // used for finite strain:
  // epsilon_log = log(1.0 + epsilon_eng)
  //
  // This can be simplified down to a more direct form:
  // epsilon_log = log(cbrt(volumetric_strain + 1.0))
  // or:
  // epsilon_log = (1/3) log(volumetric_strain + 1.0)
 
  return std::log(volumetric_strain + 1.0) / 3.0;
}

initQpStatefulProperties()

template<ComputeStage compute_stage>

void ADComputeEigenstrainBase< compute_stage >::initQpStatefulProperties ( )

overrideprotectedvirtualinherited

Reimplemented in ADComputeInstantaneousThermalExpansionFunctionEigenstrain< compute_stage >.

Definition at line 50 of file ADComputeEigenstrainBase.C.

{
  // This property can be promoted to be stateful by other models that use it,
  // so it needs to be initalized.
  _eigenstrain[_qp].zero();
}

meanThermalExpansionCoefficient()

template<ComputeStage compute_stage>

ADReal ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::meanThermalExpansionCoefficient ( const ADReal &  temperature )

overrideprotectedvirtual

Implements ADComputeMeanThermalExpansionEigenstrainBase< compute_stage >.

Definition at line 54 of file ADComputeMeanThermalExpansionFunctionEigenstrain.C.

{
  return _thermal_expansion_function.value(MetaPhysicL::raw_value(temperature), Point());
}

referenceTemperature()

template<ComputeStage compute_stage>

Real ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::referenceTemperature ( )

overrideprotectedvirtual

Implements ADComputeMeanThermalExpansionEigenstrainBase< compute_stage >.

Definition at line 47 of file ADComputeMeanThermalExpansionFunctionEigenstrain.C.

{
  return _thexp_func_ref_temp;
}

validParams()

template<ComputeStage compute_stage>

InputParameters ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::validParams ( )

static

Definition at line 20 of file ADComputeMeanThermalExpansionFunctionEigenstrain.C.

{
  InputParameters params =
      ADComputeMeanThermalExpansionEigenstrainBase<compute_stage>::validParams();
  params.addClassDescription("Computes eigenstrain due to thermal expansion using a function that "
                             "describes the mean thermal expansion as a function of temperature");
  params.addRequiredParam<FunctionName>(
      "thermal_expansion_function",
      "Function describing the mean thermal expansion as a function of temperature");
  params.addRequiredParam<Real>("thermal_expansion_function_reference_temperature",
                                "Reference temperature for thermal_exansion_function (IMPORTANT: "
                                "this is different in general from the stress_free_temperature)");
 
  return params;
}

Member Data Documentation

_base_name

template<ComputeStage compute_stage>

const std::string ADComputeEigenstrainBase< compute_stage >::_base_name

protectedinherited

Base name prepended to material property name.

Definition at line 50 of file ADComputeEigenstrainBase.h.

_eigenstrain_name

template<ComputeStage compute_stage>

std::string ADComputeEigenstrainBase< compute_stage >::_eigenstrain_name

protectedinherited

Material property name for the eigenstrain tensor.

Definition at line 53 of file ADComputeEigenstrainBase.h.

_step_zero

template<ComputeStage compute_stage>

bool& ADComputeEigenstrainBase< compute_stage >::_step_zero

protectedinherited

Restartable data to check for the zeroth and first time steps for thermal calculations.

Definition at line 69 of file ADComputeEigenstrainBase.h.

_stress_free_temperature

template<ComputeStage compute_stage>

const ADVariableValue& ADComputeThermalExpansionEigenstrainBase< compute_stage >::_stress_free_temperature

protectedinherited

Definition at line 55 of file ADComputeThermalExpansionEigenstrainBase.h.

_temperature

template<ComputeStage compute_stage>

const ADVariableValue& ADComputeThermalExpansionEigenstrainBase< compute_stage >::_temperature

protectedinherited

Definition at line 54 of file ADComputeThermalExpansionEigenstrainBase.h.

_thermal_expansion_function

template<ComputeStage compute_stage>

const Function& ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::_thermal_expansion_function

protected

Definition at line 47 of file ADComputeMeanThermalExpansionFunctionEigenstrain.h.

_thexp_func_ref_temp

template<ComputeStage compute_stage>

const Real& ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::_thexp_func_ref_temp

protected

Definition at line 49 of file ADComputeMeanThermalExpansionFunctionEigenstrain.h.

usingComputeEigenstrainBaseMembers

template<ComputeStage compute_stage>

ADComputeThermalExpansionEigenstrainBase< compute_stage >::usingComputeEigenstrainBaseMembers

protectedinherited

Definition at line 57 of file ADComputeThermalExpansionEigenstrainBase.h.

usingComputeMeanThermalExpansionEigenstrainBaseMembers

template<ComputeStage compute_stage>

ADComputeMeanThermalExpansionFunctionEigenstrain< compute_stage >::usingComputeMeanThermalExpansionEigenstrainBaseMembers

protected

Definition at line 51 of file ADComputeMeanThermalExpansionFunctionEigenstrain.h.

usingComputeThermalExpansionEigenstrainBaseMembers

template<ComputeStage compute_stage>

ADComputeMeanThermalExpansionEigenstrainBase< compute_stage >::usingComputeThermalExpansionEigenstrainBaseMembers

protectedinherited

Definition at line 66 of file ADComputeMeanThermalExpansionEigenstrainBase.h.

usingMaterialMembers

template<ComputeStage compute_stage>

ADComputeEigenstrainBase< compute_stage >::usingMaterialMembers

protectedinherited

Definition at line 71 of file ADComputeEigenstrainBase.h.

---

The documentation for this class was generated from the following files:

• tensor_mechanics/include/materials/ADComputeMeanThermalExpansionFunctionEigenstrain.h
• tensor_mechanics/src/materials/ADComputeMeanThermalExpansionFunctionEigenstrain.C