GRINS::HeatTransfer< Conductivity > Class Template Reference

Physics class for Heat Transfer. More...

#include <heat_transfer.h>

Inheritance diagram for GRINS::HeatTransfer< Conductivity >:

Collaboration diagram for GRINS::HeatTransfer< Conductivity >:

Public Member Functions
	HeatTransfer (const std::string &physics_name, const GetPot &input)
	~HeatTransfer ()
virtual void	register_postprocessing_vars (const GetPot &input, PostProcessedQuantities< libMesh::Real > &postprocessing)
	Register postprocessing variables for HeatTransfer. More...
virtual void	element_time_derivative (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Time dependent part(s) of physics for element interiors. More...
virtual void	mass_residual (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Mass matrix part(s) for element interiors. All boundary terms lie within the time_derivative part. More...
virtual void	compute_postprocessed_quantity (unsigned int quantity_index, const AssemblyContext &context, const libMesh::Point &point, libMesh::Real &value)
	Compute value of postprocessed quantities at libMesh::Point. More...
Public Member Functions inherited from GRINS::HeatTransferBase< Conductivity >
	HeatTransferBase (const std::string &physics_name, const std::string &core_physics_name, const GetPot &input)
	~HeatTransferBase ()
virtual void	init_variables (libMesh::FEMSystem *system)
	Initialization Heat Transfer variables. More...
virtual void	set_time_evolving_vars (libMesh::FEMSystem *system)
	Sets velocity variables to be time-evolving. More...
virtual void	init_context (AssemblyContext &context)
	Initialize context for added physics variables. More...
virtual void	register_parameter (const std::string &param_name, libMesh::ParameterMultiAccessor< libMesh::Number > &param_pointer) const
	Each subclass will register its copy of an independent. More...
Public Member Functions inherited from GRINS::Physics
	Physics (const GRINS::PhysicsName &physics_name, const GetPot &input)
virtual	~Physics ()
virtual bool	enabled_on_elem (const libMesh::Elem *elem)
	Find if current physics is active on supplied element. More...
void	set_is_steady (bool is_steady)
	Sets whether this physics is to be solved with a steady solver or not. More...
bool	is_steady () const
	Returns whether or not this physics is being solved with a steady solver. More...
virtual void	auxiliary_init (MultiphysicsSystem &system)
	Any auxillary initialization a Physics class may need. More...
virtual void	side_time_derivative (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Time dependent part(s) of physics for boundaries of elements on the domain boundary. More...
virtual void	nonlocal_time_derivative (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Time dependent part(s) of physics for scalar variables. More...
virtual void	element_constraint (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Constraint part(s) of physics for element interiors. More...
virtual void	side_constraint (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Constraint part(s) of physics for boundaries of elements on the domain boundary. More...
virtual void	nonlocal_constraint (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Constraint part(s) of physics for scalar variables. More...
virtual void	damping_residual (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Damping matrix part(s) for element interiors. All boundary terms lie within the time_derivative part. More...
virtual void	nonlocal_mass_residual (bool compute_jacobian, AssemblyContext &context, CachedValues &cache)
	Mass matrix part(s) for scalar variables. More...
void	init_ics (libMesh::FEMSystem *system, libMesh::CompositeFunction< libMesh::Number > &all_ics)
virtual void	compute_element_time_derivative_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_side_time_derivative_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_nonlocal_time_derivative_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_element_constraint_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_side_constraint_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_nonlocal_constraint_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_damping_residual_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_mass_residual_cache (const AssemblyContext &context, CachedValues &cache)
virtual void	compute_nonlocal_mass_residual_cache (const AssemblyContext &context, CachedValues &cache)
ICHandlingBase *	get_ic_handler ()
Public Member Functions inherited from GRINS::ParameterUser
	ParameterUser (const std::string &user_name)
virtual	~ParameterUser ()
virtual void	set_parameter (libMesh::Number &param_variable, const GetPot &input, const std::string &param_name, libMesh::Number param_default)
	Each subclass can simultaneously read a parameter value from. More...
virtual void	set_parameter (libMesh::ParsedFunction< libMesh::Number, libMesh::Gradient > &func, const GetPot &input, const std::string &func_param_name, const std::string &param_default)
	Each subclass can simultaneously read a parsed function from. More...
virtual void	set_parameter (libMesh::ParsedFEMFunction< libMesh::Number > &func, const GetPot &input, const std::string &func_param_name, const std::string &param_default)
	Each subclass can simultaneously read a parsed function from. More...
virtual void	move_parameter (const libMesh::Number &old_parameter, libMesh::Number &new_parameter)
	When cloning an object, we need to update parameter pointers. More...
virtual void	move_parameter (const libMesh::ParsedFunction< libMesh::Number, libMesh::Gradient > &old_func, libMesh::ParsedFunction< libMesh::Number, libMesh::Gradient > &new_func)
	When cloning an object, we need to update parameter pointers. More...
virtual void	move_parameter (const libMesh::ParsedFEMFunction< libMesh::Number > &old_func, libMesh::ParsedFEMFunction< libMesh::Number > &new_func)
	When cloning an object, we need to update parameter pointers. More...

Private Member Functions
	HeatTransfer ()

Private Attributes
unsigned int	_k_index
	Index from registering this postprocessed quantity. More...

Additional Inherited Members
Static Public Member Functions inherited from GRINS::Physics
static void	set_is_axisymmetric (bool is_axisymmetric)
	Set whether we should treat the problem as axisymmetric. More...
static bool	is_axisymmetric ()
Static Public Attributes inherited from GRINS::ParameterUser
static std::string	zero_vector_function = std::string("{0}")
	A parseable function string with LIBMESH_DIM components, all 0. More...
Protected Member Functions inherited from GRINS::Physics
libMesh::UniquePtr< libMesh::FEGenericBase< libMesh::Real > >	build_new_fe (const libMesh::Elem *elem, const libMesh::FEGenericBase< libMesh::Real > *fe, const libMesh::Point p)
void	parse_enabled_subdomains (const GetPot &input, const std::string &physics_name)
Protected Attributes inherited from GRINS::HeatTransferBase< Conductivity >
unsigned int	_dim
	Physical dimension of problem. More...
VelocityFEVariables	_flow_vars
PressureFEVariable	_press_var
PrimitiveTempFEVariables	_temp_vars
libMesh::Number	_rho
	Material parameters, read from input. More...
libMesh::Number	_Cp
Conductivity	_k
	Conductivity. More...
Protected Attributes inherited from GRINS::Physics
const PhysicsName	_physics_name
	Name of the physics object. Used for reading physics specific inputs. More...
GRINS::ICHandlingBase *	_ic_handler
std::set< libMesh::subdomain_id_type >	_enabled_subdomains
	Subdomains on which the current Physics class is enabled. More...
Static Protected Attributes inherited from GRINS::Physics
static bool	_is_steady = false
	Caches whether or not the solver that's being used is steady or not. More...
static bool	_is_axisymmetric = false
	Caches whether we are solving an axisymmetric problem or not. More...

Detailed Description

template<class Conductivity>
class GRINS::HeatTransfer< Conductivity >

Physics class for Heat Transfer.

Definition at line 40 of file heat_transfer.h.

Constructor & Destructor Documentation

template<class K >

GRINS::HeatTransfer< K >::HeatTransfer	(	const std::string &	physics_name,
		const GetPot &	input
	)

Definition at line 45 of file heat_transfer.C.

References GRINS::Physics::_ic_handler.

    : HeatTransferBase<K>(physics_name, PhysicsNaming::heat_transfer(), input),
    _k_index(0)
  {
    this->_ic_handler = new GenericICHandler( physics_name, input );
  }

template<class Conductivity >

GRINS::HeatTransfer< Conductivity >::~HeatTransfer ( )

inline

Definition at line 46 of file heat_transfer.h.

{};

template<class Conductivity >

GRINS::HeatTransfer< Conductivity >::HeatTransfer ( )

private

Member Function Documentation

template<class K >

void GRINS::HeatTransfer< K >::compute_postprocessed_quantity ( unsigned int  quantity_index, const AssemblyContext &  context, const libMesh::Point &  point, libMesh::Real &  value  )

virtual

Compute value of postprocessed quantities at libMesh::Point.

Reimplemented from GRINS::Physics.

Definition at line 285 of file heat_transfer.C.

  {
    if( quantity_index == this->_k_index )
      {
        value = this->_k(point, context.get_time());
      }

    return;
  }

template<class K >

void GRINS::HeatTransfer< K >::element_time_derivative ( bool  compute_jacobian, AssemblyContext &  context, CachedValues &  cache  )

virtual

Time dependent part(s) of physics for element interiors.

Reimplemented from GRINS::Physics.

Definition at line 84 of file heat_transfer.C.

References GRINS::Physics::is_axisymmetric().

  {
#ifdef GRINS_USE_GRVY_TIMERS
    this->_timer->BeginTimer("HeatTransfer::element_time_derivative");
#endif

    // The number of local degrees of freedom in each variable.
    const unsigned int n_T_dofs = context.get_dof_indices(this->_temp_vars.T()).size();
    const unsigned int n_u_dofs = context.get_dof_indices(this->_flow_vars.u()).size();

    //TODO: check n_T_dofs is same as n_u_dofs, n_v_dofs, n_w_dofs

    // We get some references to cell-specific data that
    // will be used to assemble the linear system.

    // Element Jacobian * quadrature weights for interior integration.
    const std::vector<libMesh::Real> &JxW =
      context.get_element_fe(this->_temp_vars.T())->get_JxW();

    // The temperature shape functions at interior quadrature points.
    const std::vector<std::vector<libMesh::Real> >& T_phi =
      context.get_element_fe(this->_temp_vars.T())->get_phi();

    // The velocity shape functions at interior quadrature points.
    const std::vector<std::vector<libMesh::Real> >& vel_phi =
      context.get_element_fe(this->_flow_vars.u())->get_phi();

    // The temperature shape function gradients (in global coords.)
    // at interior quadrature points.
    const std::vector<std::vector<libMesh::RealGradient> >& T_gradphi =
      context.get_element_fe(this->_temp_vars.T())->get_dphi();

    const std::vector<libMesh::Point>& u_qpoint =
      context.get_element_fe(this->_flow_vars.u())->get_xyz();

    libMesh::DenseSubMatrix<libMesh::Number> &KTT = context.get_elem_jacobian(this->_temp_vars.T(), this->_temp_vars.T()); // R_{T},{T}

    libMesh::DenseSubMatrix<libMesh::Number> &KTu = context.get_elem_jacobian(this->_temp_vars.T(), this->_flow_vars.u()); // R_{T},{u}
    libMesh::DenseSubMatrix<libMesh::Number> &KTv = context.get_elem_jacobian(this->_temp_vars.T(), this->_flow_vars.v()); // R_{T},{v}
    libMesh::DenseSubMatrix<libMesh::Number>* KTw = NULL;

    libMesh::DenseSubVector<libMesh::Number> &FT = context.get_elem_residual(this->_temp_vars.T()); // R_{T}

    if( this->_dim == 3 )
      {
        KTw = &context.get_elem_jacobian(this->_temp_vars.T(), this->_flow_vars.w()); // R_{T},{w}
      }

    // Now we will build the element Jacobian and residual.
    // Constructing the residual requires the solution and its
    // gradient from the previous timestep.  This must be
    // calculated at each quadrature point by summing the
    // solution degree-of-freedom values by the appropriate
    // weight functions.
    unsigned int n_qpoints = context.get_element_qrule().n_points();

    for (unsigned int qp=0; qp != n_qpoints; qp++)
      {
        // Compute the solution & its gradient at the old Newton iterate.
        libMesh::Number u, v;
        u = context.interior_value(this->_flow_vars.u(), qp);
        v = context.interior_value(this->_flow_vars.v(), qp);

        libMesh::Gradient grad_T;
        grad_T = context.interior_gradient(this->_temp_vars.T(), qp);

        libMesh::NumberVectorValue U (u,v);
        if (this->_dim == 3)
          U(2) = context.interior_value(this->_flow_vars.w(), qp);

        const libMesh::Number r = u_qpoint[qp](0);

        libMesh::Real jac = JxW[qp];

        // Compute the conductivity at this qp
        libMesh::Real _k_qp = this->_k(context, qp);

        if(Physics::is_axisymmetric())
          {
            jac *= r;
          }

        // First, an i-loop over the  degrees of freedom.
        for (unsigned int i=0; i != n_T_dofs; i++)
          {
            FT(i) += jac *
              (-this->_rho*this->_Cp*T_phi[i][qp]*(U*grad_T)    // convection term
               -_k_qp*(T_gradphi[i][qp]*grad_T) );  // diffusion term

            if (compute_jacobian)
              {
                for (unsigned int j=0; j != n_T_dofs; j++)
                  {
                    // TODO: precompute some terms like:
                    //   this->_rho*this->_Cp*T_phi[i][qp]*(vel_phi[j][qp]*T_grad_phi[j][qp])

                    KTT(i,j) += jac * context.get_elem_solution_derivative() *
                      (-this->_rho*this->_Cp*T_phi[i][qp]*(U*T_gradphi[j][qp])  // convection term
                       -_k_qp*(T_gradphi[i][qp]*T_gradphi[j][qp])); // diffusion term
                  } // end of the inner dof (j) loop

                // Matrix contributions for the Tu, Tv and Tw couplings (n_T_dofs same as n_u_dofs, n_v_dofs and n_w_dofs)
                for (unsigned int j=0; j != n_u_dofs; j++)
                  {
                    KTu(i,j) += jac * context.get_elem_solution_derivative()*(-this->_rho*this->_Cp*T_phi[i][qp]*(vel_phi[j][qp]*grad_T(0)));
                    KTv(i,j) += jac * context.get_elem_solution_derivative()*(-this->_rho*this->_Cp*T_phi[i][qp]*(vel_phi[j][qp]*grad_T(1)));
                    if (this->_dim == 3)
                      (*KTw)(i,j) += jac * context.get_elem_solution_derivative()*(-this->_rho*this->_Cp*T_phi[i][qp]*(vel_phi[j][qp]*grad_T(2)));
                  } // end of the inner dof (j) loop

              } // end - if (compute_jacobian && context.get_elem_solution_derivative())

          } // end of the outer dof (i) loop
      } // end of the quadrature point (qp) loop

#ifdef GRINS_USE_GRVY_TIMERS
    this->_timer->EndTimer("HeatTransfer::element_time_derivative");
#endif

    return;
  }

template<class K >

void GRINS::HeatTransfer< K >::mass_residual ( bool  compute_jacobian, AssemblyContext &  context, CachedValues &  cache  )

virtual

Mass matrix part(s) for element interiors. All boundary terms lie within the time_derivative part.

Reimplemented from GRINS::Physics.

Definition at line 209 of file heat_transfer.C.

References GRINS::Physics::is_axisymmetric().

  {
#ifdef GRINS_USE_GRVY_TIMERS
    this->_timer->BeginTimer("HeatTransfer::mass_residual");
#endif

    // First we get some references to cell-specific data that
    // will be used to assemble the linear system.

    // Element Jacobian * quadrature weights for interior integration
    const std::vector<libMesh::Real> &JxW =
      context.get_element_fe(this->_temp_vars.T())->get_JxW();

    // The shape functions at interior quadrature points.
    const std::vector<std::vector<libMesh::Real> >& phi =
      context.get_element_fe(this->_temp_vars.T())->get_phi();

    const std::vector<libMesh::Point>& u_qpoint =
      context.get_element_fe(this->_flow_vars.u())->get_xyz();

    // The number of local degrees of freedom in each variable
    const unsigned int n_T_dofs = context.get_dof_indices(this->_temp_vars.T()).size();

    // The subvectors and submatrices we need to fill:
    libMesh::DenseSubVector<libMesh::Real> &F = context.get_elem_residual(this->_temp_vars.T());

    libMesh::DenseSubMatrix<libMesh::Real> &M = context.get_elem_jacobian(this->_temp_vars.T(), this->_temp_vars.T());

    unsigned int n_qpoints = context.get_element_qrule().n_points();

    for (unsigned int qp = 0; qp != n_qpoints; ++qp)
      {
        // For the mass residual, we need to be a little careful.
        // The time integrator is handling the time-discretization
        // for us so we need to supply M(u_fixed)*u' for the residual.
        // u_fixed will be given by the fixed_interior_value function
        // while u' will be given by the interior_rate function.
        libMesh::Real T_dot;
        context.interior_rate(this->_temp_vars.T(), qp, T_dot);

        const libMesh::Number r = u_qpoint[qp](0);

        libMesh::Real jac = JxW[qp];

        if(Physics::is_axisymmetric())
          {
            jac *= r;
          }

        for (unsigned int i = 0; i != n_T_dofs; ++i)
          {
            F(i) -= this->_rho*this->_Cp*T_dot*phi[i][qp]*jac;

            if( compute_jacobian )
              {
                for (unsigned int j=0; j != n_T_dofs; j++)
                  {
                    // We're assuming rho, cp are constant w.r.t. T here.
                    M(i,j) -= this->_rho*this->_Cp*phi[j][qp]*phi[i][qp]*jac * context.get_elem_solution_rate_derivative();
                  }
              }// End of check on Jacobian

          } // End of element dof loop

      } // End of the quadrature point loop

#ifdef GRINS_USE_GRVY_TIMERS
    this->_timer->EndTimer("HeatTransfer::mass_residual");
#endif

    return;
  }

template<class K >

void GRINS::HeatTransfer< K >::register_postprocessing_vars ( const GetPot &  input, PostProcessedQuantities< libMesh::Real > &  postprocessing  )

virtual

Register postprocessing variables for HeatTransfer.

Reimplemented from GRINS::Physics.

Definition at line 53 of file heat_transfer.C.

References GRINS::PhysicsNaming::heat_transfer(), and GRINS::PostProcessedQuantities< NumericType >::register_quantity().

  {
    std::string section = "Physics/"+PhysicsNaming::heat_transfer()+"/output_vars";

    if( input.have_variable(section) )
      {
        unsigned int n_vars = input.vector_variable_size(section);

        for( unsigned int v = 0; v < n_vars; v++ )
          {
            std::string name = input(section,"DIE!",v);

            if( name == std::string("k") )
              {
                this->_k_index = postprocessing.register_quantity( name );
              }
            else
              {
                std::cerr << "Error: Invalid output_vars value for "+PhysicsNaming::heat_transfer() << std::endl
                          << "       Found " << name << std::endl
                          << "       Acceptable values are: k" << std::endl;
                libmesh_error();
              }
          }
      }

    return;
  }

Member Data Documentation

template<class Conductivity >

unsigned int GRINS::HeatTransfer< Conductivity >::_k_index

private

Index from registering this postprocessed quantity.

Definition at line 76 of file heat_transfer.h.

---

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

• src/physics/include/grins/heat_transfer.h
• src/physics/src/heat_transfer.C