libMesh::FEMContext Class Reference

This class provides all data required for a physics package (e.g. More...

#include <fem_context.h>

Inheritance diagram for libMesh::FEMContext:

Classes
struct	FENeeded
	Helper nested class for C++03-compatible "template typedef". More...

Public Types
enum	AlgebraicType {   NONE = 0, DOFS_ONLY, CURRENT, OLD,   OLD_DOFS_ONLY }
	Enum describing what data to use when initializing algebraic structures on each element. More...
typedef const DenseSubVector< Number > &(DiffContext::*	diff_subsolution_getter) (unsigned int) const
	Helper typedef to simplify refactoring. More...
typedef std::map< const NumericVector< Number > *, std::pair< DenseVector< Number >, std::vector< DenseSubVector< Number > > > >::iterator	localized_vectors_iterator
	Typedef for the localized_vectors iterator. More...

Public Member Functions
	FEMContext (const System &sys, const std::vector< unsigned int > *active_vars=nullptr, bool allocate_local_matrices=true)
	Constructor. More...
	FEMContext (const System &sys, int extra_quadrature_order, const std::vector< unsigned int > *active_vars=nullptr, bool allocate_local_matrices=true)
	Constructor. More...
virtual	~FEMContext ()
	Destructor. More...
void	use_default_quadrature_rules (int extra_quadrature_order=0)
	Use quadrature rules designed to over-integrate a mass matrix, plus extra_quadrature_order. More...
void	use_unweighted_quadrature_rules (int extra_quadrature_order=0)
	Use quadrature rules designed to exactly integrate unweighted undistorted basis functions, plus extra_quadrature_order. More...
bool	has_side_boundary_id (boundary_id_type id) const
	Reports if the boundary id is found on the current side. More...
void	side_boundary_ids (std::vector< boundary_id_type > &vec_to_fill) const
	As above, but fills in the std::set provided by the user. More...
Number	interior_value (unsigned int var, unsigned int qp) const
Number	side_value (unsigned int var, unsigned int qp) const
Number	point_value (unsigned int var, const Point &p) const
Gradient	interior_gradient (unsigned int var, unsigned int qp) const
Gradient	side_gradient (unsigned int var, unsigned int qp) const
Gradient	point_gradient (unsigned int var, const Point &p) const
Tensor	interior_hessian (unsigned int var, unsigned int qp) const
Tensor	side_hessian (unsigned int var, unsigned int qp) const
Tensor	point_hessian (unsigned int var, const Point &p) const
Number	fixed_interior_value (unsigned int var, unsigned int qp) const
Number	fixed_side_value (unsigned int var, unsigned int qp) const
Number	fixed_point_value (unsigned int var, const Point &p) const
Gradient	fixed_interior_gradient (unsigned int var, unsigned int qp) const
Gradient	fixed_side_gradient (unsigned int var, unsigned int qp) const
Gradient	fixed_point_gradient (unsigned int var, const Point &p) const
Tensor	fixed_interior_hessian (unsigned int var, unsigned int qp) const
Tensor	fixed_side_hessian (unsigned int var, unsigned int qp) const
Tensor	fixed_point_hessian (unsigned int var, const Point &p) const
template<typename OutputShape >
void	get_element_fe (unsigned int var, FEGenericBase< OutputShape > *&fe) const
	Accessor for interior finite element object for variable var for the largest dimension in the mesh. More...
FEBase *	get_element_fe (unsigned int var) const
	Accessor for interior finite element object for scalar-valued variable var for the largest dimension in the mesh. More...
template<typename OutputShape >
void	get_element_fe (unsigned int var, FEGenericBase< OutputShape > *&fe, unsigned short dim) const
	Accessor for interior finite element object for variable var for dimension dim. More...
void	get_element_fe (unsigned int var, FEAbstract *&fe, unsigned short dim) const
	Accessor for interior finite element object for variable var for dimension dim. More...
FEBase *	get_element_fe (unsigned int var, unsigned short dim) const
	Accessor for interior finite element object for scalar-valued variable var for dimension dim. More...
template<typename OutputShape >
void	get_side_fe (unsigned int var, FEGenericBase< OutputShape > *&fe) const
	Accessor for edge/face (2D/3D) finite element object for variable var for the largest dimension in the mesh. More...
FEBase *	get_side_fe (unsigned int var) const
	Accessor for side finite element object for scalar-valued variable var for the largest dimension in the mesh. More...
template<typename OutputShape >
void	get_side_fe (unsigned int var, FEGenericBase< OutputShape > *&fe, unsigned short dim) const
	Accessor for edge/face (2D/3D) finite element object for variable var for dimension dim. More...
void	get_side_fe (unsigned int var, FEAbstract *&fe, unsigned short dim) const
	Accessor for edge/face (2D/3D) finite element object for variable var for dimension dim. More...
FEBase *	get_side_fe (unsigned int var, unsigned short dim) const
	Accessor for side finite element object for scalar-valued variable var for dimension dim. More...
template<typename OutputShape >
void	get_edge_fe (unsigned int var, FEGenericBase< OutputShape > *&fe) const
	Accessor for edge (3D only!) finite element object for variable var. More...
void	get_edge_fe (unsigned int var, FEAbstract *&fe) const
FEBase *	get_edge_fe (unsigned int var) const
	Accessor for edge (3D only!) finite element object for scalar-valued variable var. More...
template<typename OutputType >
void	interior_value (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	interior_values (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &interior_values_vector) const
	Fills a vector of values of the _system_vector at the all the quadrature points in the current element interior. More...
template<typename OutputType >
void	side_value (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	side_values (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &side_values_vector) const
	Fills a vector of values of the _system_vector at the all the quadrature points on the current element side. More...
template<typename OutputType >
void	point_value (unsigned int var, const Point &p, OutputType &u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	interior_gradient (unsigned int var, unsigned int qp, OutputType &du) const
template<typename OutputType >
void	interior_gradients (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &interior_gradients_vector) const
	Fills a vector with the gradient of the solution variable var at all the quadrature points in the current element interior. More...
template<typename OutputType >
void	side_gradient (unsigned int var, unsigned int qp, OutputType &du) const
template<typename OutputType >
void	side_gradients (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &side_gradients_vector) const
	Fills a vector with the gradient of the solution variable var at all the quadrature points on the current element side. More...
template<typename OutputType >
void	point_gradient (unsigned int var, const Point &p, OutputType &grad_u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	interior_hessian (unsigned int var, unsigned int qp, OutputType &d2u) const
template<typename OutputType >
void	interior_hessians (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &d2u_vals) const
	Fills a vector of hessians of the _system_vector at the all the quadrature points in the current element interior. More...
template<typename OutputType >
void	side_hessian (unsigned int var, unsigned int qp, OutputType &d2u) const
template<typename OutputType >
void	side_hessians (unsigned int var, const NumericVector< Number > &_system_vector, std::vector< OutputType > &d2u_vals) const
	Fills a vector of hessians of the _system_vector at the all the quadrature points on the current element side. More...
template<typename OutputType >
void	point_hessian (unsigned int var, const Point &p, OutputType &hess_u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	interior_rate (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	interior_rate_gradient (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	side_rate (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	point_rate (unsigned int var, const Point &p, OutputType &u) const
template<typename OutputType >
void	interior_accel (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	side_accel (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	point_accel (unsigned int var, const Point &p, OutputType &u) const
template<typename OutputType >
void	fixed_interior_value (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	fixed_side_value (unsigned int var, unsigned int qp, OutputType &u) const
template<typename OutputType >
void	fixed_point_value (unsigned int var, const Point &p, OutputType &u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	fixed_interior_gradient (unsigned int var, unsigned int qp, OutputType &grad_u) const
template<typename OutputType >
void	fixed_side_gradient (unsigned int var, unsigned int qp, OutputType &grad_u) const
template<typename OutputType >
void	fixed_point_gradient (unsigned int var, const Point &p, OutputType &grad_u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	fixed_interior_hessian (unsigned int var, unsigned int qp, OutputType &hess_u) const
template<typename OutputType >
void	fixed_side_hessian (unsigned int var, unsigned int qp, OutputType &hess_u) const
template<typename OutputType >
void	fixed_point_hessian (unsigned int var, const Point &p, OutputType &hess_u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	interior_curl (unsigned int var, unsigned int qp, OutputType &curl_u) const
template<typename OutputType >
void	point_curl (unsigned int var, const Point &p, OutputType &curl_u, const Real tolerance=TOLERANCE) const
template<typename OutputType >
void	interior_div (unsigned int var, unsigned int qp, OutputType &div_u) const
virtual void	elem_reinit (Real theta) override
	Resets the current time in the context. More...
virtual void	elem_side_reinit (Real theta) override
	Resets the current time in the context. More...
virtual void	elem_edge_reinit (Real theta) override
	Resets the current time in the context. More...
virtual void	nonlocal_reinit (Real theta) override
	Gives derived classes the opportunity to reinitialize data needed for nonlocal calculations at a new point within a timestep. More...
virtual void	pre_fe_reinit (const System &, const Elem *e)
	Reinitializes local data vectors/matrices on the current geometric element. More...
virtual void	elem_fe_reinit (const std::vector< Point > *const pts=nullptr)
	Reinitializes interior FE objects on the current geometric element. More...
virtual void	side_fe_reinit ()
	Reinitializes side FE objects on the current geometric element. More...
virtual void	edge_fe_reinit ()
	Reinitializes edge FE objects on the current geometric element. More...
const QBase &	get_element_qrule () const
	Accessor for element interior quadrature rule for the dimension of the current _elem. More...
const QBase &	get_side_qrule () const
	Accessor for element side quadrature rule for the dimension of the current _elem. More...
const QBase &	get_element_qrule (unsigned short dim) const
	Accessor for element interior quadrature rule. More...
const QBase &	get_side_qrule (unsigned short dim) const
	Accessor for element side quadrature rule. More...
const QBase &	get_edge_qrule () const
	Accessor for element edge quadrature rule. More...
virtual void	set_mesh_system (System *sys)
	Tells the FEMContext that system sys contains the isoparametric Lagrangian variables which correspond to the coordinates of mesh nodes, in problems where the mesh itself is expected to move in time. More...
const System *	get_mesh_system () const
	Accessor for moving mesh System. More...
System *	get_mesh_system ()
	Accessor for moving mesh System. More...
unsigned int	get_mesh_x_var () const
	Accessor for x-variable of moving mesh System. More...
void	set_mesh_x_var (unsigned int x_var)
	Accessor for x-variable of moving mesh System. More...
unsigned int	get_mesh_y_var () const
	Accessor for y-variable of moving mesh System. More...
void	set_mesh_y_var (unsigned int y_var)
	Accessor for y-variable of moving mesh System. More...
unsigned int	get_mesh_z_var () const
	Accessor for z-variable of moving mesh System. More...
void	set_mesh_z_var (unsigned int z_var)
	Accessor for z-variable of moving mesh System. More...
bool	has_elem () const
	Test for current Elem object. More...
const Elem &	get_elem () const
	Accessor for current Elem object. More...
Elem &	get_elem ()
	Accessor for current Elem object. More...
unsigned char	get_side () const
	Accessor for current side of Elem object. More...
unsigned char	get_edge () const
	Accessor for current edge of Elem object. More...
unsigned char	get_dim () const
	Accessor for cached mesh dimension. More...
unsigned char	get_elem_dim () const
const std::set< unsigned char > &	elem_dimensions () const
void	elem_position_set (Real theta)
	Uses the coordinate data specified by mesh_*_position configuration to set the geometry of elem to the value it would take after a fraction theta of a timestep. More...
void	elem_position_get ()
	Uses the geometry of elem to set the coordinate data specified by mesh_*_position configuration. More...
void	set_algebraic_type (const AlgebraicType atype)
	Setting which determines whether to initialize algebraic structures (elem_*) on each element and set their values from current_local_solution. More...
AlgebraicType	algebraic_type () const
void	set_custom_solution (const NumericVector< Number > *custom_sol)
	Set a NumericVector to be used in place of current_local_solution for calculating elem_solution. More...
void	set_jacobian_tolerance (Real tol)
	Calls set_jacobian_tolerance() on all the FE objects controlled by this class. More...
FEType	find_hardest_fe_type ()
	Helper function for creating quadrature rules. More...
void	attach_quadrature_rules ()
	Helper function for attaching quadrature rules. More...
const std::vector< unsigned int > *	active_vars () const
	Return a pointer to the vector of active variables being computed for, or a null pointer if all variables in the system are active. More...
template<typename OutputShape >
FEGenericBase< OutputShape > *	build_new_fe (const FEGenericBase< OutputShape > *fe, const Point &p, const Real tolerance=TOLERANCE, const int get_derivative_level=-1) const
	Helper function to reduce some code duplication in the *_point_* methods. More...
template<>
FEGenericBase< Real > *	cached_fe (const unsigned int elem_dim, const FEType fe_type, const int get_derivative_level) const
template<>
FEGenericBase< RealGradient > *	cached_fe (const unsigned int elem_dim, const FEType fe_type, const int get_derivative_level) const
unsigned int	n_vars () const
	Number of variables in solution. More...
const System &	get_system () const
	Accessor for associated system. More...
const DenseVector< Number > &	get_elem_solution () const
	Accessor for element solution. More...
DenseVector< Number > &	get_elem_solution ()
	Non-const accessor for element solution. More...
const DenseSubVector< Number > &	get_elem_solution (unsigned int var) const
	Accessor for element solution of a particular variable corresponding to the variable index argument. More...
DenseSubVector< Number > &	get_elem_solution (unsigned int var)
	Accessor for element solution of a particular variable corresponding to the variable index argument. More...
const DenseVector< Number > &	get_elem_solution_rate () const
	Accessor for element solution rate of change w.r.t. More...
DenseVector< Number > &	get_elem_solution_rate ()
	Non-const accessor for element solution rate of change w.r.t. More...
const DenseSubVector< Number > &	get_elem_solution_rate (unsigned int var) const
	Accessor for element solution rate for a particular variable corresponding to the variable index argument. More...
DenseSubVector< Number > &	get_elem_solution_rate (unsigned int var)
	Accessor for element solution rate for a particular variable corresponding to the variable index argument. More...
const DenseVector< Number > &	get_elem_solution_accel () const
	Accessor for element solution accel of change w.r.t. More...
DenseVector< Number > &	get_elem_solution_accel ()
	Non-const accessor for element solution accel of change w.r.t. More...
const DenseSubVector< Number > &	get_elem_solution_accel (unsigned int var) const
	Accessor for element solution accel for a particular variable corresponding to the variable index argument. More...
DenseSubVector< Number > &	get_elem_solution_accel (unsigned int var)
	Accessor for element solution accel for a particular variable corresponding to the variable index argument. More...
const DenseVector< Number > &	get_elem_fixed_solution () const
	Accessor for element fixed solution. More...
DenseVector< Number > &	get_elem_fixed_solution ()
	Non-const accessor for element fixed solution. More...
const DenseSubVector< Number > &	get_elem_fixed_solution (unsigned int var) const
	Accessor for element fixed solution of a particular variable corresponding to the variable index argument. More...
DenseSubVector< Number > &	get_elem_fixed_solution (unsigned int var)
	Accessor for element fixed solution of a particular variable corresponding to the variable index argument. More...
const DenseVector< Number > &	get_elem_residual () const
	Const accessor for element residual. More...
DenseVector< Number > &	get_elem_residual ()
	Non-const accessor for element residual. More...
const DenseSubVector< Number > &	get_elem_residual (unsigned int var) const
	Const accessor for element residual of a particular variable corresponding to the variable index argument. More...
DenseSubVector< Number > &	get_elem_residual (unsigned int var)
	Non-const accessor for element residual of a particular variable corresponding to the variable index argument. More...
const DenseMatrix< Number > &	get_elem_jacobian () const
	Const accessor for element Jacobian. More...
DenseMatrix< Number > &	get_elem_jacobian ()
	Non-const accessor for element Jacobian. More...
const DenseSubMatrix< Number > &	get_elem_jacobian (unsigned int var1, unsigned int var2) const
	Const accessor for element Jacobian of particular variables corresponding to the variable index arguments. More...
DenseSubMatrix< Number > &	get_elem_jacobian (unsigned int var1, unsigned int var2)
	Non-const accessor for element Jacobian of particular variables corresponding to the variable index arguments. More...
const std::vector< Number > &	get_qois () const
	Const accessor for QoI vector. More...
std::vector< Number > &	get_qois ()
	Non-const accessor for QoI vector. More...
const std::vector< DenseVector< Number > > &	get_qoi_derivatives () const
	Const accessor for QoI derivatives. More...
std::vector< DenseVector< Number > > &	get_qoi_derivatives ()
	Non-const accessor for QoI derivatives. More...
const DenseSubVector< Number > &	get_qoi_derivatives (std::size_t qoi, unsigned int var) const
	Const accessor for QoI derivative of a particular qoi and variable corresponding to the index arguments. More...
DenseSubVector< Number > &	get_qoi_derivatives (std::size_t qoi, unsigned int var)
	Non-const accessor for QoI derivative of a particular qoi and variable corresponding to the index arguments. More...
const std::vector< dof_id_type > &	get_dof_indices () const
	Accessor for element dof indices. More...
std::vector< dof_id_type > &	get_dof_indices ()
	Non-const accessor for element dof indices. More...
const std::vector< dof_id_type > &	get_dof_indices (unsigned int var) const
	Accessor for element dof indices of a particular variable corresponding to the index argument. More...
std::vector< dof_id_type > &	get_dof_indices (unsigned int var)
	Accessor for element dof indices of a particular variable corresponding to the index argument. More...
unsigned int	n_dof_indices () const
	Total number of dof indices on the element. More...
unsigned int	n_dof_indices (unsigned int var) const
	Total number of dof indices of the particular variable corresponding to the index argument. More...
Real	get_system_time () const
	Accessor for the time variable stored in the system class. More...
Real	get_time () const
	Accessor for the time for which the current nonlinear_solution is defined. More...
void	set_time (Real time_in)
	Set the time for which the current nonlinear_solution is defined. More...
Real	get_elem_solution_derivative () const
	The derivative of the current elem_solution w.r.t. More...
Real	get_elem_solution_rate_derivative () const
	The derivative of the current elem_solution_rate w.r.t. More...
Real	get_elem_solution_accel_derivative () const
	The derivative of the current elem_solution_accel w.r.t. More...
Real	get_fixed_solution_derivative () const
	The derivative of the current fixed_elem_solution w.r.t. More...
bool	is_adjoint () const
	Accessor for querying whether we need to do a primal or adjoint solve. More...
bool &	is_adjoint ()
	Accessor for setting whether we need to do a primal or adjoint solve. More...
void	set_deltat_pointer (Real *dt)
	Points the _deltat member of this class at a timestep value stored in the creating System, for example DiffSystem::deltat. More...
Real	get_deltat_value ()
void	add_localized_vector (NumericVector< Number > &localized_vector, const System &sys)
	Adds a vector to the map of localized vectors. More...
DenseVector< Number > &	get_localized_vector (const NumericVector< Number > &localized_vector)
	Return a reference to DenseVector localization of localized_vector contained in the _localized_vectors map. More...
const DenseVector< Number > &	get_localized_vector (const NumericVector< Number > &localized_vector) const
	const accessible version of get_localized_vector function More...
DenseSubVector< Number > &	get_localized_subvector (const NumericVector< Number > &localized_vector, unsigned int var)
	Return a reference to DenseSubVector localization of localized_vector at variable var contained in the _localized_vectors map. More...
const DenseSubVector< Number > &	get_localized_subvector (const NumericVector< Number > &localized_vector, unsigned int var) const
	const accessible version of get_localized_subvector function More...

Public Attributes
unsigned char	side
	Current side for side_* to examine. More...
unsigned char	edge
	Current edge for edge_* to examine. More...
Real	time
	For time-dependent problems, this is the time t for which the current nonlinear_solution is defined. More...
const Real	system_time
	This is the time stored in the System class at the time this context was created, i.e. More...
Real	elem_solution_derivative
	The derivative of elem_solution with respect to the current nonlinear solution. More...
Real	elem_solution_rate_derivative
	The derivative of elem_solution_rate with respect to the current nonlinear solution, for use by systems with non default mass_residual terms. More...
Real	elem_solution_accel_derivative
	The derivative of elem_solution_accel with respect to the current nonlinear solution, for use by systems with non default mass_residual terms. More...
Real	fixed_solution_derivative
	The derivative of elem_fixed_solution with respect to the nonlinear solution, for use by systems constructing jacobians with elem_fixed_solution based methods. More...

Protected Member Functions
template<typename OutputShape >
FEGenericBase< OutputShape > *	cached_fe (const unsigned int elem_dim, const FEType fe_type, const int get_derivative_level) const
void	set_elem (const Elem *e)
	Helper function to promote accessor usage. More...
template<typename OutputType , typename FENeeded< OutputType >::value_getter fe_getter, diff_subsolution_getter subsolution_getter>
void	some_value (unsigned int var, unsigned int qp, OutputType &u) const
	Helper function to reduce some code duplication in the *interior_value methods. More...
template<typename OutputType , typename FENeeded< OutputType >::grad_getter fe_getter, diff_subsolution_getter subsolution_getter>
void	some_gradient (unsigned int var, unsigned int qp, OutputType &u) const
	Helper function to reduce some code duplication in the *interior_gradient methods. More...
template<typename OutputType , typename FENeeded< OutputType >::hess_getter fe_getter, diff_subsolution_getter subsolution_getter>
void	some_hessian (unsigned int var, unsigned int qp, OutputType &u) const
	Helper function to reduce some code duplication in the *interior_hessian methods. More...

Protected Attributes
std::unique_ptr< const std::vector< unsigned int > >	_active_vars
	Variables on which to enable calculations, or nullptr if all variables in the System are to be enabled. More...
System *	_mesh_sys
	System from which to acquire moving mesh information. More...
unsigned int	_mesh_x_var
	Variables from which to acquire moving mesh information. More...
unsigned int	_mesh_y_var
unsigned int	_mesh_z_var
AlgebraicType	_atype
	Keep track of what type of algebra reinitialization is to be done. More...
const NumericVector< Number > *	_custom_solution
	Data with which to do algebra reinitialization. More...
std::unique_ptr< FEGenericBase< Real > >	_real_fe
std::unique_ptr< FEGenericBase< RealGradient > >	_real_grad_fe
int	_real_fe_derivative_level
int	_real_grad_fe_derivative_level
bool	_real_fe_is_inf
bool	_real_grad_fe_is_inf
std::vector< std::map< FEType, std::unique_ptr< FEAbstract > > >	_element_fe
	Finite element objects for each variable's interior, sides and edges. More...
std::vector< std::map< FEType, std::unique_ptr< FEAbstract > > >	_side_fe
std::map< FEType, std::unique_ptr< FEAbstract > >	_edge_fe
std::vector< std::vector< FEAbstract * > >	_element_fe_var
	Pointers to the same finite element objects, but indexed by variable number. More...
std::vector< std::vector< FEAbstract * > >	_side_fe_var
std::vector< FEAbstract * >	_edge_fe_var
const BoundaryInfo &	_boundary_info
	Saved reference to BoundaryInfo on the mesh for this System. More...
const Elem *	_elem
	Current element for element_* to examine. More...
unsigned char	_dim
	Cached dimension of largest dimension element in this mesh. More...
unsigned char	_elem_dim
	Cached dimension of this->_elem. More...
std::set< unsigned char >	_elem_dims
	Cached dimensions of elements in the mesh, plus dimension 0 if SCALAR variables are in use. More...
std::vector< std::unique_ptr< QBase > >	_element_qrule
	Quadrature rule for element interior. More...
std::vector< std::unique_ptr< QBase > >	_side_qrule
	Quadrature rules for element sides The FEM context will try to find a quadrature rule that correctly integrates all variables. More...
std::unique_ptr< QBase >	_edge_qrule
	Quadrature rules for element edges. More...
int	_extra_quadrature_order
	The extra quadrature order for this context. More...
std::map< const NumericVector< Number > *, std::pair< DenseVector< Number >, std::vector< DenseSubVector< Number > > > >	_localized_vectors
	Contains pointers to vectors the user has asked to be localized, keyed with pairs of element localized versions of that vector and per variable views. More...
const bool	_have_local_matrices
	Whether we have local matrices allocated/initialized. More...
DenseVector< Number >	_elem_solution
	Element by element components of nonlinear_solution as adjusted by a time_solver. More...
std::vector< DenseSubVector< Number > >	_elem_subsolutions
DenseVector< Number >	_elem_solution_rate
	Element by element components of du/dt as adjusted by a time_solver. More...
std::vector< DenseSubVector< Number > >	_elem_subsolution_rates
DenseVector< Number >	_elem_solution_accel
	Element by element components of du/dt as adjusted by a time_solver. More...
std::vector< DenseSubVector< Number > >	_elem_subsolution_accels
DenseVector< Number >	_elem_fixed_solution
	Element by element components of nonlinear_solution at a fixed point in a timestep, for optional use by e.g. More...
std::vector< DenseSubVector< Number > >	_elem_fixed_subsolutions
DenseVector< Number >	_elem_residual
	Element residual vector. More...
DenseMatrix< Number >	_elem_jacobian
	Element jacobian: derivatives of elem_residual with respect to elem_solution. More...
std::vector< Number >	_elem_qoi
	Element quantity of interest contributions. More...
std::vector< DenseVector< Number > >	_elem_qoi_derivative
	Element quantity of interest derivative contributions. More...
std::vector< std::vector< DenseSubVector< Number > > >	_elem_qoi_subderivatives
std::vector< DenseSubVector< Number > >	_elem_subresiduals
	Element residual subvectors and (if _have_local_matrices) Jacobian submatrices. More...
std::vector< std::vector< DenseSubMatrix< Number > > >	_elem_subjacobians
std::vector< dof_id_type >	_dof_indices
	Global Degree of freedom index lists. More...
std::vector< std::vector< dof_id_type > >	_dof_indices_var

Private Member Functions
void	init_internal_data (const System &sys)
	Helper function used in constructors to set up internal data. More...
void	_do_elem_position_set (Real theta)
	Uses the coordinate data specified by mesh_*_position configuration to set the geometry of elem to the value it would take after a fraction theta of a timestep. More...
void	_update_time_from_system (Real theta)
	Update the time in the context object for the given value of theta, based on the values of "time" and "deltat" stored in the system which created this context. More...

Detailed Description

This class provides all data required for a physics package (e.g.

an FEMSystem subclass) to perform local element residual and jacobian integrations.

This class is part of the new DifferentiableSystem framework, which is still experimental. Users of this framework should beware of bugs and future API changes.

Author

Roy H. Stogner

Date

2009

Definition at line 62 of file fem_context.h.

Member Typedef Documentation

diff_subsolution_getter

typedef const DenseSubVector<Number>&(DiffContext::* libMesh::FEMContext::diff_subsolution_getter) (unsigned int) const

Helper typedef to simplify refactoring.

Definition at line 1103 of file fem_context.h.

localized_vectors_iterator

typedef std::map<const NumericVector<Number> *, std::pair<DenseVector<Number>, std::vector<DenseSubVector<Number> > > >::iterator libMesh::DiffContext::localized_vectors_iterator

inherited

Typedef for the localized_vectors iterator.

Definition at line 540 of file diff_context.h.

Member Enumeration Documentation

AlgebraicType

enum libMesh::FEMContext::AlgebraicType

Enum describing what data to use when initializing algebraic structures on each element.

Enumerator
NONE
DOFS_ONLY
CURRENT
OLD
OLD_DOFS_ONLY

Definition at line 971 of file fem_context.h.

                     { NONE = 0,  // Do not reinitialize dof_indices
                       DOFS_ONLY, // Reinitialize dof_indices, not
                                  // algebraic structures
                       CURRENT,   // Use dof_indices, current solution
                       OLD,       // Use old_dof_indices, custom solution
                       OLD_DOFS_ONLY}; // Reinitialize old_dof_indices, not

Constructor & Destructor Documentation

FEMContext() [1/2]

libMesh::FEMContext::FEMContext ( const System &  sys, const std::vector< unsigned int > *  active_vars = nullptr, bool  allocate_local_matrices = true  )

explicit

Constructor.

Allocates some but fills no data structures.

Optionally specify a limited number of variables to be "active" and thus calculated on. If active_vars is null then calculations will be prepared for every variable in sys.

Definition at line 39 of file fem_context.C.

References init_internal_data().

  : FEMContext(sys, sys.extra_quadrature_order, active_vars,
               allocate_local_matrices)
{
  init_internal_data(sys);
}

FEMContext() [2/2]

libMesh::FEMContext::FEMContext ( const System &  sys, int  extra_quadrature_order, const std::vector< unsigned int > *  active_vars = nullptr, bool  allocate_local_matrices = true  )

explicit

Constructor.

Specify the extra quadrature order instead of getting it from sys.

Optionally specify a limited number of variables to be "active" and thus calculated on. If active_vars is null then calculations will be prepared for every variable in sys.

Definition at line 48 of file fem_context.C.

References _active_vars, active_vars(), init_internal_data(), and libMesh::libmesh_assert().

  : DiffContext(sys, allocate_local_matrices),
    side(0), edge(0),
    _mesh_sys(nullptr),
    _mesh_x_var(0),
    _mesh_y_var(0),
    _mesh_z_var(0),
    _atype(CURRENT),
    _custom_solution(nullptr),
    _boundary_info(sys.get_mesh().get_boundary_info()),
    _elem(nullptr),
    _dim(cast_int<unsigned char>(sys.get_mesh().mesh_dimension())),
    _elem_dim(0), /* This will be reset in set_elem(). */
    _elem_dims(sys.get_mesh().elem_dimensions()),
    _element_qrule(4),
    _side_qrule(4),
    _extra_quadrature_order(extra_quadrature_order)
{
  if (active_vars)
    {
      libmesh_assert(!active_vars->empty());
      auto vars_copy =
        std::make_unique<std::vector<unsigned int>>(*active_vars);

      // We want to do quick binary_search later
      std::sort(vars_copy->begin(), vars_copy->end());

      _active_vars = std::move(vars_copy);
    }

  init_internal_data(sys);
}

~FEMContext()

libMesh::FEMContext::~FEMContext ( )

virtual

Destructor.

Definition at line 292 of file fem_context.C.

{
}

Member Function Documentation

_do_elem_position_set()

void libMesh::FEMContext::_do_elem_position_set ( Real  theta )

private

Uses the coordinate data specified by mesh_*_position configuration to set the geometry of elem to the value it would take after a fraction theta of a timestep.

This does the work of elem_position_set, but isn't safe to call without _mesh_sys/etc. defined first.

Definition at line 1607 of file fem_context.C.

References _mesh_sys, dim, get_elem(), get_elem_dim(), libMesh::DiffContext::get_elem_solution(), get_element_fe(), get_mesh_x_var(), get_mesh_y_var(), get_mesh_z_var(), libMesh::invalid_uint, libMesh::libmesh_assert(), libMesh::libmesh_real(), libMesh::FEMap::map_fe_type(), n_nodes, libMesh::Elem::n_nodes(), and libMesh::n_threads().

Referenced by elem_position_set().

{
  // This is too expensive to call unless we've been asked to move the mesh
  libmesh_assert (_mesh_sys);

  // This will probably break with threading when two contexts are
  // operating on elements which share a node
  libmesh_assert_equal_to (libMesh::n_threads(), 1);

  // If the coordinate data is in our own system, it's already
  // been set up for us, and we can ignore our input parameter theta
  //  if (_mesh_sys == this->number())
  //    {
  unsigned int n_nodes = this->get_elem().n_nodes();

#ifndef NDEBUG
  const unsigned char dim = this->get_elem_dim();

  // For simplicity we demand that mesh coordinates be stored
  // in a format that allows a direct copy
  libmesh_assert(this->get_mesh_x_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_x_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_elem_solution(this->get_mesh_x_var()).size() == n_nodes));
  libmesh_assert(this->get_mesh_y_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_y_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_elem_solution(this->get_mesh_y_var()).size() == n_nodes));
  libmesh_assert(this->get_mesh_z_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_z_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_elem_solution(this->get_mesh_z_var()).size() == n_nodes));
#endif

  // Set the new point coordinates
  if (this->get_mesh_x_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      const_cast<Elem &>(this->get_elem()).point(i)(0) =
        libmesh_real(this->get_elem_solution(this->get_mesh_x_var())(i));

  if (this->get_mesh_y_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      const_cast<Elem &>(this->get_elem()).point(i)(1) =
        libmesh_real(this->get_elem_solution(this->get_mesh_y_var())(i));

  if (this->get_mesh_z_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      const_cast<Elem &>(this->get_elem()).point(i)(2) =
        libmesh_real(this->get_elem_solution(this->get_mesh_z_var())(i));
  //    }
  // FIXME - If the coordinate data is not in our own system, someone
  // had better get around to implementing that... - RHS
  //  else
  //    {
  //      libmesh_not_implemented();
  //    }
}

_update_time_from_system()

void libMesh::FEMContext::_update_time_from_system ( Real  theta )

private

Update the time in the context object for the given value of theta, based on the values of "time" and "deltat" stored in the system which created this context.

Definition at line 1923 of file fem_context.C.

References libMesh::DiffContext::get_deltat_value(), libMesh::DiffContext::get_system_time(), libMesh::Real, and libMesh::DiffContext::set_time().

Referenced by elem_edge_reinit(), elem_reinit(), elem_side_reinit(), and nonlocal_reinit().

{
  // Update the "time" variable based on the value of theta.  For this
  // to work, we need to know the value of deltat, a pointer to which is now
  // stored by our parent DiffContext class.  Note: get_deltat_value() will
  // assert in debug mode if the requested pointer is nullptr.
  const Real deltat = this->get_deltat_value();

  this->set_time(theta*(this->get_system_time() + deltat) + (1.-theta)*this->get_system_time());
}

active_vars()

const std::vector<unsigned int>* libMesh::FEMContext::active_vars ( ) const

inline

Return a pointer to the vector of active variables being computed for, or a null pointer if all variables in the system are active.

Definition at line 1034 of file fem_context.h.

References _active_vars.

Referenced by FEMContext().

{ return _active_vars.get(); }

add_localized_vector()

void libMesh::DiffContext::add_localized_vector ( NumericVector< Number > &  localized_vector, const System &  sys  )

inherited

Adds a vector to the map of localized vectors.

We can later evaluate interior_values, interior_gradients and side_values for these fields these vectors represent.

Definition at line 125 of file diff_context.C.

References libMesh::DiffContext::_localized_vectors, and libMesh::System::n_vars().

{
  // Make an empty pair keyed with a reference to this _localized_vector
  _localized_vectors[&localized_vector] = std::make_pair(DenseVector<Number>(), std::vector<DenseSubVector<Number>>());

  unsigned int nv = sys.n_vars();

  _localized_vectors[&localized_vector].second.reserve(nv);

  // Fill the DenseSubVector with nv copies of DenseVector
  for (unsigned int i=0; i != nv; ++i)
    _localized_vectors[&localized_vector].second.emplace_back(_localized_vectors[&localized_vector].first);
}

algebraic_type()

AlgebraicType libMesh::FEMContext::algebraic_type ( ) const

inline

Definition at line 992 of file fem_context.h.

References _atype.

Referenced by build_new_fe(), and pre_fe_reinit().

{ return _atype; }

attach_quadrature_rules()

void libMesh::FEMContext::attach_quadrature_rules

(

)

Helper function for attaching quadrature rules.

Definition at line 127 of file fem_context.C.

References _active_vars, _edge_fe, _edge_qrule, _elem_dims, _element_fe, _element_qrule, _side_fe, _side_qrule, dim, libMesh::DiffContext::get_system(), libMesh::make_range(), libMesh::System::n_vars(), and libMesh::System::variable_type().

Referenced by use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

{
  const System & sys = this->get_system();

  auto attach_rules = [this, &sys](unsigned int v)
    {
      for (const auto & dim : _elem_dims)
        {
          FEType fe_type = sys.variable_type(v);

          _element_fe[dim][fe_type]->attach_quadrature_rule(_element_qrule[dim].get());
          if (dim)
            _side_fe[dim][fe_type]->attach_quadrature_rule(_side_qrule[dim].get());
          if (dim == 3)
            _edge_fe[fe_type]->attach_quadrature_rule(_edge_qrule.get());
        };
    };

  if (_active_vars)
    for (auto v : *_active_vars)
      attach_rules(v);
  else
    for (auto v : make_range(sys.n_vars()))
      attach_rules(v);
}

build_new_fe()

template<typename OutputShape >

template LIBMESH_EXPORT FEGenericBase< RealGradient > * libMesh::FEMContext::build_new_fe	(	const FEGenericBase< OutputShape > *	fe,
		const Point &	p,
		const Real	tolerance = TOLERANCE,
		const int	get_derivative_level = -1
	)		const

Helper function to reduce some code duplication in the *_point_* methods.

get_derivative_level should be -1 to get_ everything, 0 to get_phi, 1 to get_dphi, 2 to get_d2phi, or 3 to get_curl_phi

Definition at line 2023 of file fem_context.C.

References libMesh::FEAbstract::add_p_level_in_reinit(), algebraic_type(), libMesh::Elem::dim(), libMesh::FEType::family, libMesh::FEGenericBase< OutputType >::get_curl_phi(), libMesh::FEGenericBase< OutputType >::get_d2phi(), libMesh::FEGenericBase< OutputType >::get_dphi(), get_elem(), libMesh::FEAbstract::get_fe_type(), libMesh::FEGenericBase< OutputType >::get_phi(), has_elem(), libMesh::FEMap::inverse_map(), libMesh::Elem::JUST_COARSENED, libMesh::Elem::JUST_REFINED, libMesh::libmesh_assert(), OLD, libMesh::FEType::order, libMesh::FEAbstract::reinit(), and libMesh::SCALAR.

Referenced by fixed_point_gradient(), fixed_point_hessian(), fixed_point_value(), point_curl(), point_gradient(), point_hessian(), and point_value().

{
  FEType fe_type = fe->get_fe_type();

  // If we don't have an Elem to evaluate on, then the only functions
  // we can sensibly evaluate are the scalar dofs which are the same
  // everywhere.
  libmesh_assert(this->has_elem() || fe_type.family == SCALAR);

#ifdef LIBMESH_ENABLE_AMR
  const int add_p_level = fe->add_p_level_in_reinit();
  if ((algebraic_type() == OLD) &&
      this->has_elem())
    {
      if (this->get_elem().p_refinement_flag() == Elem::JUST_REFINED)
        fe_type.order -= add_p_level;
      else if (this->get_elem().p_refinement_flag() == Elem::JUST_COARSENED)
        fe_type.order += add_p_level;
    }
#endif // LIBMESH_ENABLE_AMR

  const unsigned int elem_dim = this->has_elem() ? this->get_elem().dim() : 0;

  FEGenericBase<OutputShape>* fe_new =
    cached_fe<OutputShape>(elem_dim, fe_type, get_derivative_level);
#ifdef LIBMESH_ENABLE_AMR
  fe_new->add_p_level_in_reinit(add_p_level);
#endif // LIBMESH_ENABLE_AMR

  // Map the physical co-ordinates to the master co-ordinates using the inverse_map from fe_interface.h
  // Build a vector of point co-ordinates to send to reinit
  Point master_point = this->has_elem() ?
    FEMap::inverse_map (elem_dim, &this->get_elem(), p, tolerance) :
    Point(0);

  std::vector<Point> coor(1, master_point);

  switch (get_derivative_level)
    {
    case -1:
      fe_new->get_phi();
      fe_new->get_dphi();
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
      fe_new->get_d2phi();
#endif
      fe_new->get_curl_phi();
      break;
    case 0:
      fe_new->get_phi();
      break;
    case 1:
      fe_new->get_dphi();
      break;
    case 2:
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
      fe_new->get_d2phi();
#else
      // here a different configuration is required.
      libmesh_not_implemented();
#endif
      break;
    case 3:
      fe_new->get_curl_phi();
      break;
    default:
      libmesh_error();
    }

  // Reinitialize the element and compute the shape function values at coor
  if (this->has_elem())
    fe_new->reinit (&this->get_elem(), &coor);
  else
    // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
    fe_new->reinit (nullptr, &coor);

  return fe_new;
}

cached_fe() [1/3]

template<typename OutputShape >

FEGenericBase<OutputShape>* libMesh::FEMContext::cached_fe ( const unsigned int  elem_dim, const FEType  fe_type, const int  get_derivative_level  ) const

protected

cached_fe() [2/3]

template<>

FEGenericBase<Real>* libMesh::FEMContext::cached_fe	(	const unsigned int	elem_dim,
		const FEType	fe_type,
		const int	get_derivative_level
	)		const

Definition at line 1938 of file fem_context.C.

References _real_fe, _real_fe_derivative_level, _real_fe_is_inf, libMesh::FEGenericBase< OutputType >::build(), libMesh::FEGenericBase< OutputType >::build_InfFE(), get_elem(), has_elem(), and libMesh::Elem::infinite().

{
#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
  const bool fe_needs_inf =
    this->has_elem() && this->get_elem().infinite();
#endif

  if (!_real_fe ||
      elem_dim != _real_fe->get_dim() ||
      fe_type != _real_fe->get_fe_type() ||
      get_derivative_level != _real_fe_derivative_level)
    {
      _real_fe_derivative_level = get_derivative_level;

      _real_fe =
#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
        fe_needs_inf ?
        FEGenericBase<Real>::build_InfFE(elem_dim, fe_type) :
#endif
        FEGenericBase<Real>::build(elem_dim, fe_type);
    }

#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
  else if (fe_needs_inf && !_real_fe_is_inf)
    _real_fe =
      FEGenericBase<Real>::build_InfFE(elem_dim, fe_type);
  else if (!fe_needs_inf && _real_fe_is_inf)
    _real_fe =
      FEGenericBase<Real>::build(elem_dim, fe_type);

  _real_fe_is_inf =
    (this->has_elem() && this->get_elem().infinite());
#endif

  return _real_fe.get();
}

cached_fe() [3/3]

template<>

FEGenericBase<RealGradient>* libMesh::FEMContext::cached_fe	(	const unsigned int	elem_dim,
		const FEType	fe_type,
		const int	get_derivative_level
	)		const

Definition at line 1980 of file fem_context.C.

References _real_grad_fe, _real_grad_fe_derivative_level, _real_grad_fe_is_inf, libMesh::FEGenericBase< OutputType >::build(), libMesh::FEGenericBase< OutputType >::build_InfFE(), get_elem(), has_elem(), and libMesh::Elem::infinite().

{
#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
  const bool fe_needs_inf =
    this->has_elem() && this->get_elem().infinite();
#endif

  if (!_real_grad_fe ||
      elem_dim != _real_grad_fe->get_dim() ||
      fe_type != _real_grad_fe->get_fe_type() ||
      get_derivative_level != _real_grad_fe_derivative_level)
    {
      _real_grad_fe_derivative_level = get_derivative_level;

      _real_grad_fe =
#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
        fe_needs_inf ?
        FEGenericBase<RealGradient>::build_InfFE(elem_dim, fe_type) :
#endif
        FEGenericBase<RealGradient>::build(elem_dim, fe_type);
    }

#ifdef LIBMESH_ENABLE_INFINITE_ELEMENTS
  else if (fe_needs_inf && !_real_grad_fe_is_inf)
    _real_grad_fe =
      FEGenericBase<RealGradient>::build_InfFE(elem_dim, fe_type);
  else if (!fe_needs_inf && _real_grad_fe_is_inf)
    _real_grad_fe =
      FEGenericBase<RealGradient>::build(elem_dim, fe_type);

  _real_grad_fe_is_inf =
    (this->has_elem() && this->get_elem().infinite());
#endif

  return _real_grad_fe.get();
}

edge_fe_reinit()

void libMesh::FEMContext::edge_fe_reinit ( )

virtual

Reinitializes edge FE objects on the current geometric element.

Definition at line 1514 of file fem_context.C.

References _edge_fe, get_edge(), get_elem(), and get_elem_dim().

Referenced by elem_edge_reinit().

{
  libmesh_assert_equal_to (this->get_elem_dim(), 3);

  // Initialize all the interior FE objects on elem/edge.
  // Logging of FE::reinit is done in the FE functions
  for (auto & pr : _edge_fe)
    pr.second->edge_reinit(&(this->get_elem()), this->get_edge());
}

elem_dimensions()

const std::set<unsigned char>& libMesh::FEMContext::elem_dimensions ( ) const

inline

Returns

Set of dimensions of elements present in the mesh at context initialization.

Definition at line 951 of file fem_context.h.

References _elem_dims.

Referenced by libMesh::RBEIMConstruction::enrich_eim_approximation_on_interiors(), ElasticitySystem::init_context(), libMesh::LaplacianErrorEstimator::init_context(), libMesh::VariationalSmootherSystem::init_context(), HilbertSystem::init_context(), libMesh::DiscontinuityMeasure::init_context(), libMesh::WrappedFunctor< Output >::init_context(), HeatSystem::init_context(), libMesh::KellyErrorEstimator::init_context(), libMesh::FEMSystem::init_context(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh(), and libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh_sides().

  { return _elem_dims; }

elem_edge_reinit()

void libMesh::FEMContext::elem_edge_reinit ( Real  theta )

overridevirtual

Resets the current time in the context.

Additionally, reinitialize Elem and FE objects if there's a moving mesh present in the system such that the mesh is deformed to its position at \( t_{\theta} \).

Reimplemented from libMesh::DiffContext.

Definition at line 1452 of file fem_context.C.

References _mesh_sys, _update_time_from_system(), edge_fe_reinit(), and elem_position_set().

{
  // Update the "time" variable of this context object
  this->_update_time_from_system(theta);

  // Handle a moving element if necessary
  if (_mesh_sys)
    {
      // FIXME - not threadsafe yet!
      elem_position_set(theta);
      edge_fe_reinit();
    }
}

elem_fe_reinit()

void libMesh::FEMContext::elem_fe_reinit ( const std::vector< Point > *const  pts = nullptr )

virtual

Reinitializes interior FE objects on the current geometric element.

Definition at line 1477 of file fem_context.C.

References _element_fe, dim, get_elem(), get_elem_dim(), has_elem(), and libMesh::libmesh_assert().

Referenced by libMesh::ExactSolution::_compute_error(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), assembly_with_dg_fem_context(), libMesh::VariationalSmootherSystem::compute_element_reference_volume(), elem_reinit(), HilbertSystem::element_time_derivative(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_sides(), libMesh::RBEIMConstruction::initialize_qp_data(), libMesh::FEMSystem::mesh_position_set(), nonlocal_reinit(), Integrate::operator()(), OverlappingAlgebraicGhostingTest::run_ghosting_test(), and OverlappingCouplingGhostingTest::run_sparsity_pattern_test().

{
  // Initialize all the interior FE objects on elem.
  // Logging of FE::reinit is done in the FE functions
  // We only reinit the FE objects for the current element
  // dimension
  const unsigned char dim = this->get_elem_dim();

  libmesh_assert( !_element_fe[dim].empty() );

  for (const auto & pr : _element_fe[dim])
    {
      if (this->has_elem())
        pr.second->reinit(&(this->get_elem()), pts);
      else
        // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
        pr.second->reinit(nullptr);
    }
}

elem_position_get()

void libMesh::FEMContext::elem_position_get

(

)

Uses the geometry of elem to set the coordinate data specified by mesh_*_position configuration.

Definition at line 1526 of file fem_context.C.

References _mesh_sys, libMesh::Elem::default_order(), dim, get_elem(), get_elem_dim(), libMesh::DiffContext::get_elem_solution(), get_element_fe(), get_mesh_x_var(), get_mesh_y_var(), get_mesh_z_var(), libMesh::invalid_uint, libMesh::libmesh_assert(), libMesh::FEMap::map_fe_type(), n_nodes, libMesh::Elem::n_nodes(), libMesh::n_threads(), and libMesh::Elem::point().

Referenced by libMesh::FEMSystem::mesh_position_get().

{
  // This is too expensive to call unless we've been asked to move the mesh
  libmesh_assert (_mesh_sys);

  // This will probably break with threading when two contexts are
  // operating on elements which share a node
  libmesh_assert_equal_to (libMesh::n_threads(), 1);

  // If the coordinate data is in our own system, it's already
  // been set up for us
  //  if (_mesh_sys == this->number())
  //    {
  unsigned int n_nodes = this->get_elem().n_nodes();

#ifndef NDEBUG
  const unsigned char dim = this->get_elem_dim();

  // For simplicity we demand that mesh coordinates be stored
  // in a format that allows a direct copy
  libmesh_assert(this->get_mesh_x_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_x_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_element_fe(this->get_mesh_x_var(), dim)->get_fe_type().order.get_order()
                  == this->get_elem().default_order()));
  libmesh_assert(this->get_mesh_y_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_y_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_element_fe(this->get_mesh_y_var(), dim)->get_fe_type().order.get_order()
                  == this->get_elem().default_order()));
  libmesh_assert(this->get_mesh_z_var() == libMesh::invalid_uint ||
                 (this->get_element_fe(this->get_mesh_z_var(), dim)->get_fe_type().family
                  == FEMap::map_fe_type(this->get_elem()) &&
                  this->get_element_fe(this->get_mesh_z_var(), dim)->get_fe_type().order.get_order()
                  == this->get_elem().default_order()));
#endif

  // Get degree of freedom coefficients from point coordinates
  if (this->get_mesh_x_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      (this->get_elem_solution(this->get_mesh_x_var()))(i) = this->get_elem().point(i)(0);

  if (this->get_mesh_y_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      (this->get_elem_solution(this->get_mesh_y_var()))(i) = this->get_elem().point(i)(1);

  if (this->get_mesh_z_var() != libMesh::invalid_uint)
    for (unsigned int i=0; i != n_nodes; ++i)
      (this->get_elem_solution(this->get_mesh_z_var()))(i) = this->get_elem().point(i)(2);
  //    }
  // FIXME - If the coordinate data is not in our own system, someone
  // had better get around to implementing that... - RHS
  //  else
  //    {
  //      libmesh_not_implemented();
  //    }
}

elem_position_set()

void libMesh::FEMContext::elem_position_set ( Real  theta )

inline

Uses the coordinate data specified by mesh_*_position configuration to set the geometry of elem to the value it would take after a fraction theta of a timestep.

Definition at line 1270 of file fem_context.h.

References _do_elem_position_set(), and _mesh_sys.

Referenced by elem_edge_reinit(), elem_reinit(), elem_side_reinit(), and libMesh::FEMSystem::mesh_position_set().

{
  if (_mesh_sys)
    this->_do_elem_position_set(theta);
}

elem_reinit()

void libMesh::FEMContext::elem_reinit ( Real  theta )

overridevirtual

Resets the current time in the context.

Additionally, reinitialize Elem and FE objects if there's a moving mesh present in the system such that the mesh is deformed to its position at \( t_{\theta} \).

Reimplemented from libMesh::DiffContext.

Definition at line 1413 of file fem_context.C.

References _mesh_sys, _update_time_from_system(), elem_fe_reinit(), elem_position_set(), and libMesh::n_threads().

{
  // Update the "time" variable of this context object
  this->_update_time_from_system(theta);

  // Handle a moving element if necessary.
  if (_mesh_sys)
    {
      // We assume that the ``default'' state
      // of the mesh is its final, theta=1.0
      // position, so we don't bother with
      // mesh motion in that case.
      if (theta != 1.0)
        {
          // FIXME - ALE is not threadsafe yet!
          libmesh_assert_equal_to (libMesh::n_threads(), 1);

          elem_position_set(theta);
        }
      elem_fe_reinit();
    }
}

elem_side_reinit()

void libMesh::FEMContext::elem_side_reinit ( Real  theta )

overridevirtual

Resets the current time in the context.

Additionally, reinitialize Elem and FE objects if there's a moving mesh present in the system such that the mesh is deformed to its position at \( t_{\theta} \).

Reimplemented from libMesh::DiffContext.

Definition at line 1437 of file fem_context.C.

References _mesh_sys, _update_time_from_system(), elem_position_set(), and side_fe_reinit().

{
  // Update the "time" variable of this context object
  this->_update_time_from_system(theta);

  // Handle a moving element if necessary
  if (_mesh_sys)
    {
      // FIXME - not threadsafe yet!
      elem_position_set(theta);
      side_fe_reinit();
    }
}

find_hardest_fe_type()

FEType libMesh::FEMContext::find_hardest_fe_type

(

)

Helper function for creating quadrature rules.

Definition at line 86 of file fem_context.C.

References _active_vars, libMesh::FEType::family, libMesh::DiffContext::get_system(), libMesh::make_range(), libMesh::System::n_vars(), libMesh::FEType::order, libMesh::SCALAR, and libMesh::System::variable_type().

Referenced by use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

{
  const System & sys = this->get_system();
  FEType hardest_fe_type =
    sys.variable_type(_active_vars ?
                      (*_active_vars)[0] : 0);

  auto check_var = [&hardest_fe_type, &sys](unsigned int v)
    {
      FEType fe_type = sys.variable_type(v);

      // Make sure we find a non-SCALAR FE family, even in the case
      // where the first variable(s) weren't
      if (hardest_fe_type.family == SCALAR)
        {
          hardest_fe_type.family = fe_type.family;
          hardest_fe_type.order = fe_type.order;
        }

      // FIXME - we don't yet handle mixed finite elements from
      // different families which require different quadrature rules
      // libmesh_assert_equal_to (fe_type.family, hardest_fe_type.family);

      // We need to detect SCALAR's so we can prepare FE objects for
      // them, and so we don't mistake high order scalars as a reason
      // to crank up the quadrature order on other types.
      if (fe_type.family != SCALAR && fe_type.order > hardest_fe_type.order)
        hardest_fe_type = fe_type;
    };

  if (_active_vars)
    for (auto v : *_active_vars)
      check_var(v);
  else
    for (auto v : make_range(sys.n_vars()))
      check_var(v);

  return hardest_fe_type;
}

fixed_interior_gradient() [1/2]

Gradient libMesh::FEMContext::fixed_interior_gradient	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The gradient of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 1082 of file fem_context.C.

{
  Gradient du;

  this->fixed_interior_gradient( var, qp, du );

  return du;
}

fixed_interior_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_interior_gradient	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	grad_u
	)		const

Returns

The gradient of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 1093 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_element_fe(), and some_gradient().

{
  this->some_gradient
    <OutputType,
     &FEMContext::get_element_fe
     <typename TensorTools::MakeReal
      <typename TensorTools::DecrementRank
       <OutputType>::type>::type>,
     &DiffContext::get_elem_fixed_solution>
    (var, qp, du);
}

fixed_interior_hessian() [1/2]

Tensor libMesh::FEMContext::fixed_interior_hessian	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The hessian of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 1109 of file fem_context.C.

{
  Tensor d2u;

  this->fixed_interior_hessian( var, qp, d2u );

  return d2u;
}

fixed_interior_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_interior_hessian	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	hess_u
	)		const

Returns

The hessian of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 1120 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_element_fe(), and some_hessian().

{
  this->some_hessian<OutputType,
                     &FEMContext::get_element_fe
                     <typename TensorTools::MakeReal
                      <typename TensorTools::DecrementRank
                       <typename TensorTools::DecrementRank
                        <OutputType>::type>::type>::type>,
                     &DiffContext::get_elem_fixed_solution>(var, qp, d2u);
}

fixed_interior_value() [1/2]

Number libMesh::FEMContext::fixed_interior_value	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The value of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 1059 of file fem_context.C.

{
  Number u = 0.;

  this->fixed_interior_value( var, qp, u );

  return u;
}

fixed_interior_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_interior_value	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The value of the fixed_solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 1071 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_element_fe(), and some_value().

{
  this->some_value<OutputType,
                   &FEMContext::get_element_fe
                   <typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_fixed_solution>(var, qp, u);
}

fixed_point_gradient() [1/2]

Gradient libMesh::FEMContext::fixed_point_gradient	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The gradient of the fixed_solution variable var at the physical point p on the current element.

Note

This API is currently present for backward compatibility.

Definition at line 1255 of file fem_context.C.

{
  Gradient grad_u;

  this->fixed_point_gradient( var, p, grad_u );

  return grad_u;
}

fixed_point_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_point_gradient	(	unsigned int	var,
		const Point &	p,
		OutputType &	grad_u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The gradient of the fixed_solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 1267 of file fem_context.C.

References libMesh::DiffContext::_elem_fixed_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_fixed_solution().

{
  typedef typename TensorTools::MakeReal
    <typename TensorTools::DecrementRank<OutputType>::type>::type
    OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (_elem_fixed_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_fixed_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 1 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputGradient>> &  dphi = fe_new->get_dphi();

  grad_u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    grad_u.add_scaled(dphi[l][0], coef(l));

  return;
}

fixed_point_hessian() [1/2]

Tensor libMesh::FEMContext::fixed_point_hessian	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The hessian of the fixed_solution variable var at the physical point p on the current element.

Note

This API is currently present for backward compatibility.

Definition at line 1306 of file fem_context.C.

{
  Tensor hess_u;

  this->fixed_point_hessian( var, p, hess_u );

  return hess_u;
}

fixed_point_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_point_hessian	(	unsigned int	var,
		const Point &	p,
		OutputType &	hess_u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The hessian of the fixed_solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 1318 of file fem_context.C.

References libMesh::DiffContext::_elem_fixed_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_fixed_solution().

{
  typedef typename TensorTools::DecrementRank<OutputType>::type Rank1Decrement;
  typedef typename TensorTools::DecrementRank<Rank1Decrement>::type Rank2Decrement;
  typedef typename TensorTools::MakeReal<Rank2Decrement>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (_elem_fixed_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_fixed_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 2 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputTensor>> &  d2phi = fe_new->get_d2phi();

  hess_u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    hess_u.add_scaled(d2phi[l][0], coef(l));

  return;
}

fixed_point_value() [1/2]

Number libMesh::FEMContext::fixed_point_value	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The value of the fixed_solution variable var at the physical point p on the current element.

Note

This API is currently present for backward compatibility.

Definition at line 1209 of file fem_context.C.

{
  Number u = 0.;

  this->fixed_point_value( var, p, u );

  return u;
}

fixed_point_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_point_value	(	unsigned int	var,
		const Point &	p,
		OutputType &	u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The value of the fixed_solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 1219 of file fem_context.C.

References libMesh::DiffContext::_elem_fixed_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_fixed_solution().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (_elem_fixed_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_fixed_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 0 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<OutputShape>> &  phi = fe_new->get_phi();

  u = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    u += phi[l][0] * coef(l);

  return;
}

fixed_side_gradient() [1/2]

Gradient libMesh::FEMContext::fixed_side_gradient	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The gradient of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This API is currently present for backward compatibility.

Definition at line 1159 of file fem_context.C.

{
  Gradient du;

  this->fixed_side_gradient( var, qp, du );

  return du;
}

fixed_side_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_side_gradient	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	grad_u
	)		const

Returns

The gradient of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 1170 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_side_fe(), and some_gradient().

{
  this->some_gradient<OutputType,
                      &FEMContext::get_side_fe
                      <typename TensorTools::MakeReal
                       <typename TensorTools::DecrementRank
                        <OutputType>::type>::type>,
                      &DiffContext::get_elem_fixed_solution>(var, qp, du);
}

fixed_side_hessian() [1/2]

Tensor libMesh::FEMContext::fixed_side_hessian	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The hessian of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This API is currently present for backward compatibility.

Definition at line 1184 of file fem_context.C.

{
  Tensor d2u;

  this->fixed_side_hessian( var, qp, d2u );

  return d2u;
}

fixed_side_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_side_hessian	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	hess_u
	)		const

Returns

The hessian of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 1194 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_side_fe(), and some_hessian().

{
  this->some_hessian<OutputType,
                     &FEMContext::get_side_fe
                     <typename TensorTools::MakeReal
                      <typename TensorTools::DecrementRank
                       <typename TensorTools::DecrementRank
                        <OutputType>::type>::type>::type>,
                     &DiffContext::get_elem_fixed_solution>(var, qp, d2u);
}

fixed_side_value() [1/2]

Number libMesh::FEMContext::fixed_side_value	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The value of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This API is currently present for backward compatibility.

Definition at line 1135 of file fem_context.C.

{
  Number u = 0.;

  this->fixed_side_value( var, qp, u );

  return u;
}

fixed_side_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::fixed_side_value	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The value of the fixed_solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 1146 of file fem_context.C.

References libMesh::DiffContext::get_elem_fixed_solution(), get_side_fe(), and some_value().

{
  this->some_value
    <OutputType,
     &FEMContext::get_side_fe
     <typename TensorTools::MakeReal<OutputType>::type>,
     &DiffContext::get_elem_fixed_solution>
    (var, qp, u);
}

get_deltat_value()

Real libMesh::DiffContext::get_deltat_value ( )

inherited

Returns

The value currently pointed to by this class's _deltat member

Definition at line 117 of file diff_context.C.

References libMesh::DiffContext::_deltat, and libMesh::libmesh_assert().

Referenced by _update_time_from_system().

{
  libmesh_assert(_deltat);

  return *_deltat;
}

get_dim()

unsigned char libMesh::FEMContext::get_dim ( ) const

inline

Accessor for cached mesh dimension.

This is the largest dimension of the elements in the mesh. For the dimension of this->_elem, use get_elem_dim();

Definition at line 936 of file fem_context.h.

References _dim.

Referenced by libMesh::VariationalSmootherSystem::element_time_derivative(), libMesh::DGFEMContext::neighbor_side_fe_reinit(), and SolidSystem::side_time_derivative().

  { return this->_dim; }

get_dof_indices() [1/4]

const std::vector<dof_id_type>& libMesh::DiffContext::get_dof_indices ( ) const

inlineinherited

Accessor for element dof indices.

Definition at line 363 of file diff_context.h.

References libMesh::DiffContext::_dof_indices.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), assembly_with_dg_fem_context(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyA2::boundary_assembly(), AssemblyF2::boundary_assembly(), A2::boundary_assembly(), A3::boundary_assembly(), F0::boundary_assembly(), Output0::boundary_assembly(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), FirstOrderScalarSystemBase::element_time_derivative(), SecondOrderScalarSystemFirstOrderTimeSolverBase::element_time_derivative(), fixed_point_gradient(), fixed_point_hessian(), fixed_point_value(), A0::interior_assembly(), B::interior_assembly(), M0::interior_assembly(), A1::interior_assembly(), AssemblyA0::interior_assembly(), AcousticsInnerProduct::interior_assembly(), AssemblyA1::interior_assembly(), A2::interior_assembly(), AssemblyA2::interior_assembly(), F0::interior_assembly(), OutputAssembly::interior_assembly(), EIM_IP_assembly::interior_assembly(), EIM_F::interior_assembly(), AssemblyEIM::interior_assembly(), InnerProductAssembly::interior_assembly(), AssemblyF0::interior_assembly(), AssemblyF1::interior_assembly(), Ex6InnerProduct::interior_assembly(), interior_curl(), interior_div(), interior_gradients(), interior_hessians(), interior_values(), libMesh::FEMPhysics::mass_residual(), FirstOrderScalarSystemBase::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual(), libMesh::FEMSystem::mesh_position_get(), libMesh::DGFEMContext::neighbor_side_fe_reinit(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), libMesh::FEMSystem::numerical_jacobian(), point_curl(), point_gradient(), point_hessian(), point_value(), pre_fe_reinit(), OverlappingCouplingGhostingTest::run_sparsity_pattern_test(), side_gradient(), side_gradients(), side_hessians(), side_values(), some_gradient(), some_hessian(), and some_value().

  { return _dof_indices; }

get_dof_indices() [2/4]

std::vector<dof_id_type>& libMesh::DiffContext::get_dof_indices ( )

inlineinherited

Non-const accessor for element dof indices.

Definition at line 369 of file diff_context.h.

References libMesh::DiffContext::_dof_indices.

  { return _dof_indices; }

get_dof_indices() [3/4]

const std::vector<dof_id_type>& libMesh::DiffContext::get_dof_indices ( unsigned int  var ) const

inlineinherited

Accessor for element dof indices of a particular variable corresponding to the index argument.

Definition at line 376 of file diff_context.h.

References libMesh::DiffContext::_dof_indices_var.

  {
    libmesh_assert_greater(_dof_indices_var.size(), var);
    return _dof_indices_var[var];
  }

get_dof_indices() [4/4]

std::vector<dof_id_type>& libMesh::DiffContext::get_dof_indices ( unsigned int  var )

inlineinherited

Accessor for element dof indices of a particular variable corresponding to the index argument.

Definition at line 386 of file diff_context.h.

References libMesh::DiffContext::_dof_indices_var.

  {
    libmesh_assert_greater(_dof_indices_var.size(), var);
    return _dof_indices_var[var];
  }

get_edge()

unsigned char libMesh::FEMContext::get_edge ( ) const

inline

Accessor for current edge of Elem object.

Definition at line 928 of file fem_context.h.

References edge.

Referenced by edge_fe_reinit().

  { return edge; }

get_edge_fe() [1/3]

template<typename OutputShape >

void libMesh::FEMContext::get_edge_fe ( unsigned int  var, FEGenericBase< OutputShape > *&  fe  ) const

inline

Accessor for edge (3D only!) finite element object for variable var.

Definition at line 1332 of file fem_context.h.

References _edge_fe_var.

{
  libmesh_assert_less ( var, _edge_fe_var.size() );
  fe = cast_ptr<FEGenericBase<OutputShape> *>( _edge_fe_var[var] );
}

get_edge_fe() [2/3]

void libMesh::FEMContext::get_edge_fe ( unsigned int  var, FEAbstract *&  fe  ) const

inline

Definition at line 1339 of file fem_context.h.

References _edge_fe_var.

{
  libmesh_assert_less ( var, _edge_fe_var.size() );
  fe = _edge_fe_var[var];
}

get_edge_fe() [3/3]

FEBase * libMesh::FEMContext::get_edge_fe ( unsigned int  var ) const

inline

Accessor for edge (3D only!) finite element object for scalar-valued variable var.

Definition at line 1346 of file fem_context.h.

References _edge_fe_var.

{
  libmesh_assert_less ( var, _edge_fe_var.size() );
  return cast_ptr<FEBase *>( _edge_fe_var[var] );
}

get_edge_qrule()

const QBase& libMesh::FEMContext::get_edge_qrule ( ) const

inline

Accessor for element edge quadrature rule.

Definition at line 831 of file fem_context.h.

References _edge_qrule.

  { return *(this->_edge_qrule); }

get_elem() [1/2]

const Elem& libMesh::FEMContext::get_elem ( ) const

inline

Accessor for current Elem object.

Definition at line 908 of file fem_context.h.

References _elem, and libMesh::libmesh_assert().

Referenced by _do_elem_position_set(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyA2::boundary_assembly(), AssemblyF2::boundary_assembly(), build_new_fe(), cached_fe(), libMesh::OldSolutionBase< Output, point_output >::check_old_context(), edge_fe_reinit(), elem_fe_reinit(), elem_position_get(), SolidSystem::element_time_derivative(), libMesh::VariationalSmootherSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), libMesh::OldSolutionCoefs< Output, point_output >::eval_at_node(), libMesh::OldSolutionValue< Output, point_output >::eval_at_node(), has_side_boundary_id(), libMesh::RBEIMConstruction::initialize_qp_data(), A0::interior_assembly(), A1::interior_assembly(), OutputAssembly::interior_assembly(), EIM_F::interior_assembly(), AssemblyEIM::interior_assembly(), libMesh::FEMSystem::mesh_position_set(), libMesh::FEMSystem::numerical_jacobian(), SlitFunc::operator()(), pre_fe_reinit(), side_boundary_ids(), NavierSystem::side_constraint(), side_fe_reinit(), and SolidSystem::side_time_derivative().

  { libmesh_assert(this->_elem);
    return *(this->_elem); }

get_elem() [2/2]

Elem& libMesh::FEMContext::get_elem ( )

inline

Accessor for current Elem object.

Definition at line 915 of file fem_context.h.

References _elem, and libMesh::libmesh_assert().

  { libmesh_assert(this->_elem);
    return *(const_cast<Elem *>(this->_elem)); }

get_elem_dim()

unsigned char libMesh::FEMContext::get_elem_dim ( ) const

inline

Returns

The dimension of this->_elem. For mixed dimension meshes, this may be different from get_dim(). If no element init has happened yet, fall back on get_dim().

Definition at line 944 of file fem_context.h.

References _dim, _elem, and _elem_dim.

Referenced by _do_elem_position_set(), edge_fe_reinit(), elem_fe_reinit(), elem_position_get(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_interiors(), fixed_point_gradient(), fixed_point_hessian(), fixed_point_value(), get_element_fe(), get_element_qrule(), get_side_fe(), get_side_qrule(), interior_curl(), interior_div(), interior_gradients(), interior_hessians(), interior_values(), point_curl(), point_gradient(), point_hessian(), point_value(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh(), side_fe_reinit(), side_gradient(), side_gradients(), side_hessians(), side_values(), some_gradient(), some_hessian(), and some_value().

  { return this->_elem ? this->_elem_dim : this->_dim; }

get_elem_fixed_solution() [1/4]

const DenseVector<Number>& libMesh::DiffContext::get_elem_fixed_solution ( ) const

inlineinherited

Accessor for element fixed solution.

Definition at line 210 of file diff_context.h.

References libMesh::DiffContext::_elem_fixed_solution.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::SteadySolver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), fixed_interior_gradient(), fixed_interior_hessian(), fixed_interior_value(), fixed_point_gradient(), fixed_point_hessian(), fixed_point_value(), fixed_side_gradient(), fixed_side_hessian(), fixed_side_value(), and pre_fe_reinit().

  { return _elem_fixed_solution; }

get_elem_fixed_solution() [2/4]

DenseVector<Number>& libMesh::DiffContext::get_elem_fixed_solution ( )

inlineinherited

Non-const accessor for element fixed solution.

Definition at line 216 of file diff_context.h.

References libMesh::DiffContext::_elem_fixed_solution.

  { return _elem_fixed_solution; }

get_elem_fixed_solution() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_elem_fixed_solution ( unsigned int  var ) const

inlineinherited

Accessor for element fixed solution of a particular variable corresponding to the variable index argument.

Definition at line 223 of file diff_context.h.

References libMesh::DiffContext::_elem_fixed_subsolutions.

  {
    libmesh_assert_greater(_elem_fixed_subsolutions.size(), var);
    return _elem_fixed_subsolutions[var];
  }

get_elem_fixed_solution() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_elem_fixed_solution ( unsigned int  var )

inlineinherited

Accessor for element fixed solution of a particular variable corresponding to the variable index argument.

Definition at line 233 of file diff_context.h.

References libMesh::DiffContext::_elem_fixed_subsolutions.

  {
    libmesh_assert_greater(_elem_fixed_subsolutions.size(), var);
    return _elem_fixed_subsolutions[var];
  }

get_elem_jacobian() [1/4]

const DenseMatrix<Number>& libMesh::DiffContext::get_elem_jacobian ( ) const

inlineinherited

Const accessor for element Jacobian.

Definition at line 274 of file diff_context.h.

References libMesh::DiffContext::_elem_jacobian, libMesh::DiffContext::_have_local_matrices, and libMesh::libmesh_assert().

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), libMesh::FEMSystem::assembly(), assembly_with_dg_fem_context(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyA2::boundary_assembly(), A2::boundary_assembly(), A3::boundary_assembly(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), NavierSystem::element_constraint(), CoupledSystem::element_constraint(), libMesh::EigenTimeSolver::element_residual(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), CoupledSystem::element_time_derivative(), libMesh::VariationalSmootherSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), B::interior_assembly(), A0::interior_assembly(), M0::interior_assembly(), A1::interior_assembly(), AssemblyA0::interior_assembly(), AcousticsInnerProduct::interior_assembly(), AssemblyA1::interior_assembly(), A2::interior_assembly(), AssemblyA2::interior_assembly(), EIM_IP_assembly::interior_assembly(), AssemblyEIM::interior_assembly(), InnerProductAssembly::interior_assembly(), Ex6InnerProduct::interior_assembly(), NavierSystem::mass_residual(), ElasticitySystem::mass_residual(), libMesh::FEMPhysics::mass_residual(), FirstOrderScalarSystemBase::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), libMesh::EigenTimeSolver::nonlocal_residual(), libMesh::FEMSystem::numerical_jacobian(), pre_fe_reinit(), OverlappingCouplingGhostingTest::run_sparsity_pattern_test(), NavierSystem::side_constraint(), LaplaceSystem::side_constraint(), libMesh::EigenTimeSolver::side_residual(), SolidSystem::side_time_derivative(), and CurlCurlSystem::side_time_derivative().

  {
    libmesh_assert(_have_local_matrices);
    return _elem_jacobian;
  }

get_elem_jacobian() [2/4]

DenseMatrix<Number>& libMesh::DiffContext::get_elem_jacobian ( )

inlineinherited

Non-const accessor for element Jacobian.

Definition at line 283 of file diff_context.h.

References libMesh::DiffContext::_elem_jacobian, libMesh::DiffContext::_have_local_matrices, and libMesh::libmesh_assert().

  {
    libmesh_assert(_have_local_matrices);
    return _elem_jacobian;
  }

get_elem_jacobian() [3/4]

const DenseSubMatrix<Number>& libMesh::DiffContext::get_elem_jacobian ( unsigned int  var1, unsigned int  var2  ) const

inlineinherited

Const accessor for element Jacobian of particular variables corresponding to the variable index arguments.

Definition at line 293 of file diff_context.h.

References libMesh::DiffContext::_elem_subjacobians, libMesh::DiffContext::_have_local_matrices, and libMesh::libmesh_assert().

  {
    libmesh_assert(_have_local_matrices);
    libmesh_assert_greater(_elem_subjacobians.size(), var1);
    libmesh_assert_greater(_elem_subjacobians[var1].size(), var2);
    return _elem_subjacobians[var1][var2];
  }

get_elem_jacobian() [4/4]

DenseSubMatrix<Number>& libMesh::DiffContext::get_elem_jacobian ( unsigned int  var1, unsigned int  var2  )

inlineinherited

Non-const accessor for element Jacobian of particular variables corresponding to the variable index arguments.

Only available if _have_local_matrices

Definition at line 306 of file diff_context.h.

References libMesh::DiffContext::_elem_subjacobians, libMesh::DiffContext::_have_local_matrices, and libMesh::libmesh_assert().

  {
    libmesh_assert(_have_local_matrices);
    libmesh_assert_greater(_elem_subjacobians.size(), var1);
    libmesh_assert_greater(_elem_subjacobians[var1].size(), var2);
    return _elem_subjacobians[var1][var2];
  }

get_elem_residual() [1/4]

const DenseVector<Number>& libMesh::DiffContext::get_elem_residual ( ) const

inlineinherited

Const accessor for element residual.

Definition at line 242 of file diff_context.h.

References libMesh::DiffContext::_elem_residual.

Referenced by libMesh::Euler2Solver::_general_residual(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), libMesh::FEMSystem::assembly(), assembly_with_dg_fem_context(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyF2::boundary_assembly(), F0::boundary_assembly(), Output0::boundary_assembly(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), NavierSystem::element_constraint(), CoupledSystem::element_constraint(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), libMesh::VariationalSmootherSystem::element_time_derivative(), CoupledSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), FirstOrderScalarSystemBase::element_time_derivative(), SecondOrderScalarSystemFirstOrderTimeSolverBase::element_time_derivative(), F0::interior_assembly(), OutputAssembly::interior_assembly(), EIM_F::interior_assembly(), AssemblyF0::interior_assembly(), AssemblyF1::interior_assembly(), NavierSystem::mass_residual(), ElasticitySystem::mass_residual(), libMesh::FEMPhysics::mass_residual(), FirstOrderScalarSystemBase::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), libMesh::FEMSystem::numerical_jacobian(), pre_fe_reinit(), NavierSystem::side_constraint(), LaplaceSystem::side_constraint(), SolidSystem::side_time_derivative(), CurlCurlSystem::side_time_derivative(), and ElasticitySystem::side_time_derivative().

  { return _elem_residual; }

get_elem_residual() [2/4]

DenseVector<Number>& libMesh::DiffContext::get_elem_residual ( )

inlineinherited

Non-const accessor for element residual.

Definition at line 248 of file diff_context.h.

References libMesh::DiffContext::_elem_residual.

  { return _elem_residual; }

get_elem_residual() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_elem_residual ( unsigned int  var ) const

inlineinherited

Const accessor for element residual of a particular variable corresponding to the variable index argument.

Definition at line 255 of file diff_context.h.

References libMesh::DiffContext::_elem_subresiduals.

  {
    libmesh_assert_greater(_elem_subresiduals.size(), var);
    return _elem_subresiduals[var];
  }

get_elem_residual() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_elem_residual ( unsigned int  var )

inlineinherited

Non-const accessor for element residual of a particular variable corresponding to the variable index argument.

Definition at line 265 of file diff_context.h.

References libMesh::DiffContext::_elem_subresiduals.

  {
    libmesh_assert_greater(_elem_subresiduals.size(), var);
    return _elem_subresiduals[var];
  }

get_elem_solution() [1/4]

const DenseVector<Number>& libMesh::DiffContext::get_elem_solution ( ) const

inlineinherited

Accessor for element solution.

Definition at line 112 of file diff_context.h.

References libMesh::DiffContext::_elem_solution.

Referenced by _do_elem_position_set(), libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::SteadySolver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), elem_position_get(), interior_curl(), interior_div(), interior_gradient(), interior_hessian(), interior_value(), libMesh::FEMSystem::mesh_position_get(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), libMesh::FEMSystem::numerical_jacobian(), point_curl(), point_gradient(), point_hessian(), point_value(), pre_fe_reinit(), side_gradient(), side_hessian(), and side_value().

  { return _elem_solution; }

get_elem_solution() [2/4]

DenseVector<Number>& libMesh::DiffContext::get_elem_solution ( )

inlineinherited

Non-const accessor for element solution.

Definition at line 118 of file diff_context.h.

References libMesh::DiffContext::_elem_solution.

  { return _elem_solution; }

get_elem_solution() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution ( unsigned int  var ) const

inlineinherited

Accessor for element solution of a particular variable corresponding to the variable index argument.

Definition at line 125 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolutions.

  {
    libmesh_assert_greater(_elem_subsolutions.size(), var);
    return _elem_subsolutions[var];
  }

get_elem_solution() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution ( unsigned int  var )

inlineinherited

Accessor for element solution of a particular variable corresponding to the variable index argument.

Definition at line 135 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolutions.

  {
    libmesh_assert_greater(_elem_subsolutions.size(), var);
    return _elem_subsolutions[var];
  }

get_elem_solution_accel() [1/4]

const DenseVector<Number>& libMesh::DiffContext::get_elem_solution_accel ( ) const

inlineinherited

Accessor for element solution accel of change w.r.t.

time.

Definition at line 177 of file diff_context.h.

References libMesh::DiffContext::_elem_solution_accel.

Referenced by libMesh::NewmarkSolver::_general_residual(), interior_accel(), pre_fe_reinit(), libMesh::FirstOrderUnsteadySolver::prepare_accel(), and side_accel().

  { return _elem_solution_accel; }

get_elem_solution_accel() [2/4]

DenseVector<Number>& libMesh::DiffContext::get_elem_solution_accel ( )

inlineinherited

Non-const accessor for element solution accel of change w.r.t.

time.

Definition at line 184 of file diff_context.h.

References libMesh::DiffContext::_elem_solution_accel.

  { return _elem_solution_accel; }

get_elem_solution_accel() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution_accel ( unsigned int  var ) const

inlineinherited

Accessor for element solution accel for a particular variable corresponding to the variable index argument.

Definition at line 191 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolution_accels.

  {
    libmesh_assert_greater(_elem_subsolution_accels.size(), var);
    return _elem_subsolution_accels[var];
  }

get_elem_solution_accel() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution_accel ( unsigned int  var )

inlineinherited

Accessor for element solution accel for a particular variable corresponding to the variable index argument.

Definition at line 201 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolution_accels.

  {
    libmesh_assert_greater(_elem_subsolution_accels.size(), var);
    return _elem_subsolution_accels[var];
  }

get_elem_solution_accel_derivative()

Real libMesh::DiffContext::get_elem_solution_accel_derivative ( ) const

inlineinherited

The derivative of the current elem_solution_accel w.r.t.

the unknown solution. Corresponding Jacobian contributions should be multiplied by this amount, or may be skipped if get_elem_solution_accel_derivative() is 0.

Definition at line 450 of file diff_context.h.

References libMesh::DiffContext::elem_solution_accel_derivative.

Referenced by ElasticitySystem::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), and SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual().

  { return elem_solution_accel_derivative; }

get_elem_solution_derivative()

Real libMesh::DiffContext::get_elem_solution_derivative ( ) const

inlineinherited

The derivative of the current elem_solution w.r.t.

the unknown solution. Corresponding Jacobian contributions should be multiplied by this amount, or may be skipped if get_elem_solution_derivative() is 0.

Definition at line 432 of file diff_context.h.

References libMesh::DiffContext::elem_solution_derivative.

Referenced by libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), NavierSystem::element_constraint(), ElasticitySystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), NavierSystem::mass_residual(), and NavierSystem::side_constraint().

  { return elem_solution_derivative; }

get_elem_solution_rate() [1/4]

const DenseVector<Number>& libMesh::DiffContext::get_elem_solution_rate ( ) const

inlineinherited

Accessor for element solution rate of change w.r.t.

time.

Definition at line 144 of file diff_context.h.

References libMesh::DiffContext::_elem_solution_rate.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), interior_rate(), interior_rate_gradient(), pre_fe_reinit(), libMesh::FirstOrderUnsteadySolver::prepare_accel(), and side_rate().

  { return _elem_solution_rate; }

get_elem_solution_rate() [2/4]

DenseVector<Number>& libMesh::DiffContext::get_elem_solution_rate ( )

inlineinherited

Non-const accessor for element solution rate of change w.r.t.

time.

Definition at line 151 of file diff_context.h.

References libMesh::DiffContext::_elem_solution_rate.

  { return _elem_solution_rate; }

get_elem_solution_rate() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution_rate ( unsigned int  var ) const

inlineinherited

Accessor for element solution rate for a particular variable corresponding to the variable index argument.

Definition at line 158 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolution_rates.

  {
    libmesh_assert_greater(_elem_subsolution_rates.size(), var);
    return _elem_subsolution_rates[var];
  }

get_elem_solution_rate() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_elem_solution_rate ( unsigned int  var )

inlineinherited

Accessor for element solution rate for a particular variable corresponding to the variable index argument.

Definition at line 168 of file diff_context.h.

References libMesh::DiffContext::_elem_subsolution_rates.

  {
    libmesh_assert_greater(_elem_subsolution_rates.size(), var);
    return _elem_subsolution_rates[var];
  }

get_elem_solution_rate_derivative()

Real libMesh::DiffContext::get_elem_solution_rate_derivative ( ) const

inlineinherited

The derivative of the current elem_solution_rate w.r.t.

the unknown solution. Corresponding Jacobian contributions should be multiplied by this amount, or may be skipped if get_elem_solution_rate_derivative() is 0.

Definition at line 441 of file diff_context.h.

References libMesh::DiffContext::elem_solution_rate_derivative.

Referenced by libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), FirstOrderScalarSystemBase::mass_residual(), and libMesh::FirstOrderUnsteadySolver::prepare_accel().

  { return elem_solution_rate_derivative; }

get_element_fe() [1/5]

template<typename OutputShape >

void libMesh::FEMContext::get_element_fe ( unsigned int  var, FEGenericBase< OutputShape > *&  fe  ) const

inline

Accessor for interior finite element object for variable var for the largest dimension in the mesh.

We default to the largest mesh dim if this method is called before the Elem * is set in the FEMContext, e.g. in FEMSystem::init_context (or a subclass).

Definition at line 277 of file fem_context.h.

References get_elem_dim().

Referenced by libMesh::ExactSolution::_compute_error(), _do_elem_position_set(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), assembly_with_dg_fem_context(), libMesh::VariationalSmootherSystem::compute_element_reference_volume(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), elem_position_get(), NavierSystem::element_constraint(), CoupledSystem::element_constraint(), PoissonSystem::element_postprocess(), LaplaceSystem::element_postprocess(), LaplaceQoI::element_qoi(), HeatSystem::element_qoi(), LaplaceQoI::element_qoi_derivative(), LaplaceSystem::element_qoi_derivative(), HeatSystem::element_qoi_derivative(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), libMesh::VariationalSmootherSystem::element_time_derivative(), CoupledSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_interiors(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_sides(), fixed_interior_gradient(), fixed_interior_hessian(), fixed_interior_value(), get_element_fe(), CoupledSystemQoI::init_context(), LaplaceQoI::init_context(), NavierSystem::init_context(), SolidSystem::init_context(), PoissonSystem::init_context(), LaplaceSystem::init_context(), CurlCurlSystem::init_context(), ElasticitySystem::init_context(), libMesh::VariationalSmootherSystem::init_context(), CoupledSystem::init_context(), HilbertSystem::init_context(), libMesh::ParsedFEMFunction< T >::init_context(), libMesh::WrappedFunctor< Output >::init_context(), HeatSystem::init_context(), ElasticityRBConstruction::init_context(), SimpleRBConstruction::init_context(), libMesh::FEMSystem::init_context(), libMesh::RBEIMConstruction::init_context(), libMesh::RBEIMConstruction::initialize_qp_data(), interior_accel(), B::interior_assembly(), A0::interior_assembly(), M0::interior_assembly(), A1::interior_assembly(), AssemblyA0::interior_assembly(), AcousticsInnerProduct::interior_assembly(), AssemblyA1::interior_assembly(), A2::interior_assembly(), AssemblyA2::interior_assembly(), F0::interior_assembly(), OutputAssembly::interior_assembly(), EIM_IP_assembly::interior_assembly(), EIM_F::interior_assembly(), AssemblyEIM::interior_assembly(), InnerProductAssembly::interior_assembly(), AssemblyF0::interior_assembly(), AssemblyF1::interior_assembly(), Ex6InnerProduct::interior_assembly(), interior_gradient(), interior_hessian(), interior_rate(), interior_rate_gradient(), NavierSystem::mass_residual(), ElasticitySystem::mass_residual(), libMesh::FEMPhysics::mass_residual(), Integrate::operator()(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh_sides(), OverlappingAlgebraicGhostingTest::run_ghosting_test(), OverlappingCouplingGhostingTest::run_sparsity_pattern_test(), and NavierSystem::side_constraint().

  { this->get_element_fe<OutputShape>(var,fe,this->get_elem_dim()); }

get_element_fe() [2/5]

FEBase* libMesh::FEMContext::get_element_fe ( unsigned int  var ) const

inline

Accessor for interior finite element object for scalar-valued variable var for the largest dimension in the mesh.

We default to the largest mesh dim if this method is called before the Elem * is set in the FEMContext, e.g. in FEMSystem::init_context (or a subclass).

Definition at line 286 of file fem_context.h.

References get_elem_dim(), and get_element_fe().

  { return this->get_element_fe(var,this->get_elem_dim()); }

get_element_fe() [3/5]

template<typename OutputShape >

void libMesh::FEMContext::get_element_fe ( unsigned int  var, FEGenericBase< OutputShape > *&  fe, unsigned short  dim  ) const

inline

Accessor for interior finite element object for variable var for dimension dim.

Definition at line 1278 of file fem_context.h.

References _element_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_element_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_element_fe_var[dim].size() ) );
  fe = cast_ptr<FEGenericBase<OutputShape> *>( (_element_fe_var[dim][var] ) );
}

get_element_fe() [4/5]

void libMesh::FEMContext::get_element_fe ( unsigned int  var, FEAbstract *&  fe, unsigned short  dim  ) const

inline

Accessor for interior finite element object for variable var for dimension dim.

Definition at line 1287 of file fem_context.h.

References _element_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_element_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_element_fe_var[dim].size() ) );
  fe = _element_fe_var[dim][var];
}

get_element_fe() [5/5]

FEBase * libMesh::FEMContext::get_element_fe ( unsigned int  var, unsigned short  dim  ) const

inline

Accessor for interior finite element object for scalar-valued variable var for dimension dim.

Definition at line 1296 of file fem_context.h.

References _element_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_element_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_element_fe_var[dim].size() ) );
  return cast_ptr<FEBase *>( (_element_fe_var[dim][var] ) );
}

get_element_qrule() [1/2]

const QBase& libMesh::FEMContext::get_element_qrule ( ) const

inline

Accessor for element interior quadrature rule for the dimension of the current _elem.

Definition at line 802 of file fem_context.h.

References get_elem_dim().

Referenced by assembly_with_dg_fem_context(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), NavierSystem::element_constraint(), CoupledSystem::element_constraint(), PoissonSystem::element_postprocess(), LaplaceSystem::element_postprocess(), LaplaceQoI::element_qoi(), HeatSystem::element_qoi(), LaplaceQoI::element_qoi_derivative(), LaplaceSystem::element_qoi_derivative(), HeatSystem::element_qoi_derivative(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), CoupledSystem::element_time_derivative(), libMesh::VariationalSmootherSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), FirstOrderScalarSystemBase::element_time_derivative(), SecondOrderScalarSystemFirstOrderTimeSolverBase::element_time_derivative(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_interiors(), libMesh::FEMPhysics::eulerian_residual(), B::interior_assembly(), A0::interior_assembly(), M0::interior_assembly(), A1::interior_assembly(), AssemblyA0::interior_assembly(), AcousticsInnerProduct::interior_assembly(), AssemblyA1::interior_assembly(), A2::interior_assembly(), AssemblyA2::interior_assembly(), F0::interior_assembly(), OutputAssembly::interior_assembly(), EIM_IP_assembly::interior_assembly(), EIM_F::interior_assembly(), AssemblyEIM::interior_assembly(), InnerProductAssembly::interior_assembly(), AssemblyF0::interior_assembly(), AssemblyF1::interior_assembly(), Ex6InnerProduct::interior_assembly(), NavierSystem::mass_residual(), ElasticitySystem::mass_residual(), libMesh::FEMPhysics::mass_residual(), FirstOrderScalarSystemBase::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual(), and libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh().

  { return this->get_element_qrule(this->get_elem_dim()); }

get_element_qrule() [2/2]

const QBase& libMesh::FEMContext::get_element_qrule ( unsigned short  dim ) const

inline

Accessor for element interior quadrature rule.

Definition at line 815 of file fem_context.h.

References _element_qrule, dim, and libMesh::libmesh_assert().

  { libmesh_assert(_element_qrule[dim]);
    return *(this->_element_qrule[dim]); }

get_fixed_solution_derivative()

Real libMesh::DiffContext::get_fixed_solution_derivative ( ) const

inlineinherited

The derivative of the current fixed_elem_solution w.r.t.

the unknown solution. Corresponding Jacobian contributions should be multiplied by this amount, or may be skipped if get_fixed_elem_solution_derivative() is 0.

Definition at line 459 of file diff_context.h.

References libMesh::DiffContext::fixed_solution_derivative.

  { return fixed_solution_derivative; }

get_localized_subvector() [1/2]

DenseSubVector< Number > & libMesh::DiffContext::get_localized_subvector ( const NumericVector< Number > &  localized_vector, unsigned int  var  )

inherited

Return a reference to DenseSubVector localization of localized_vector at variable var contained in the _localized_vectors map.

Definition at line 154 of file diff_context.C.

References libMesh::DiffContext::_localized_vectors.

Referenced by interior_gradients(), interior_hessians(), interior_values(), side_gradients(), side_hessians(), and side_values().

{
  return _localized_vectors[&localized_vector].second[var];
}

get_localized_subvector() [2/2]

const DenseSubVector< Number > & libMesh::DiffContext::get_localized_subvector ( const NumericVector< Number > &  localized_vector, unsigned int  var  ) const

inherited

const accessible version of get_localized_subvector function

Definition at line 160 of file diff_context.C.

References libMesh::DiffContext::_localized_vectors, and libMesh::libmesh_assert().

{
  auto localized_vectors_it = _localized_vectors.find(&localized_vector);
  libmesh_assert(localized_vectors_it != _localized_vectors.end());
  return localized_vectors_it->second.second[var];
}

get_localized_vector() [1/2]

DenseVector< Number > & libMesh::DiffContext::get_localized_vector ( const NumericVector< Number > &  localized_vector )

inherited

Return a reference to DenseVector localization of localized_vector contained in the _localized_vectors map.

Definition at line 140 of file diff_context.C.

References libMesh::DiffContext::_localized_vectors.

{
  return _localized_vectors[&localized_vector].first;
}

get_localized_vector() [2/2]

const DenseVector< Number > & libMesh::DiffContext::get_localized_vector ( const NumericVector< Number > &  localized_vector ) const

inherited

const accessible version of get_localized_vector function

Definition at line 146 of file diff_context.C.

References libMesh::DiffContext::_localized_vectors, and libMesh::libmesh_assert().

{
  auto localized_vectors_it = _localized_vectors.find(&localized_vector);
  libmesh_assert(localized_vectors_it != _localized_vectors.end());
  return localized_vectors_it->second.first;
}

get_mesh_system() [1/2]

const System* libMesh::FEMContext::get_mesh_system ( ) const

inline

Accessor for moving mesh System.

Definition at line 848 of file fem_context.h.

References _mesh_sys.

  { return this->_mesh_sys; }

get_mesh_system() [2/2]

System* libMesh::FEMContext::get_mesh_system ( )

inline

Accessor for moving mesh System.

Definition at line 854 of file fem_context.h.

References _mesh_sys.

  { return this->_mesh_sys; }

get_mesh_x_var()

unsigned int libMesh::FEMContext::get_mesh_x_var ( ) const

inline

Accessor for x-variable of moving mesh System.

Definition at line 860 of file fem_context.h.

References _mesh_x_var.

Referenced by _do_elem_position_set(), and elem_position_get().

  { return _mesh_x_var; }

get_mesh_y_var()

unsigned int libMesh::FEMContext::get_mesh_y_var ( ) const

inline

Accessor for y-variable of moving mesh System.

Definition at line 874 of file fem_context.h.

References _mesh_y_var.

Referenced by _do_elem_position_set(), and elem_position_get().

  { return _mesh_y_var; }

get_mesh_z_var()

unsigned int libMesh::FEMContext::get_mesh_z_var ( ) const

inline

Accessor for z-variable of moving mesh System.

Definition at line 888 of file fem_context.h.

References _mesh_z_var.

Referenced by _do_elem_position_set(), and elem_position_get().

  { return _mesh_z_var; }

get_qoi_derivatives() [1/4]

const std::vector<DenseVector<Number> >& libMesh::DiffContext::get_qoi_derivatives ( ) const

inlineinherited

Const accessor for QoI derivatives.

Definition at line 329 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi_derivative.

Referenced by LaplaceQoI::element_qoi_derivative(), LaplaceSystem::element_qoi_derivative(), HeatSystem::element_qoi_derivative(), pre_fe_reinit(), CoupledSystemQoI::side_qoi_derivative(), and LaplaceSystem::side_qoi_derivative().

  { return _elem_qoi_derivative; }

get_qoi_derivatives() [2/4]

std::vector<DenseVector<Number> >& libMesh::DiffContext::get_qoi_derivatives ( )

inlineinherited

Non-const accessor for QoI derivatives.

Definition at line 335 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi_derivative.

  { return _elem_qoi_derivative; }

get_qoi_derivatives() [3/4]

const DenseSubVector<Number>& libMesh::DiffContext::get_qoi_derivatives ( std::size_t  qoi, unsigned int  var  ) const

inlineinherited

Const accessor for QoI derivative of a particular qoi and variable corresponding to the index arguments.

Definition at line 342 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi_subderivatives.

  {
    libmesh_assert_greater(_elem_qoi_subderivatives.size(), qoi);
    libmesh_assert_greater(_elem_qoi_subderivatives[qoi].size(), var);
    return _elem_qoi_subderivatives[qoi][var];
  }

get_qoi_derivatives() [4/4]

DenseSubVector<Number>& libMesh::DiffContext::get_qoi_derivatives ( std::size_t  qoi, unsigned int  var  )

inlineinherited

Non-const accessor for QoI derivative of a particular qoi and variable corresponding to the index arguments.

Definition at line 353 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi_subderivatives.

  {
    libmesh_assert_greater(_elem_qoi_subderivatives.size(), qoi);
    libmesh_assert_greater(_elem_qoi_subderivatives[qoi].size(), var);
    return _elem_qoi_subderivatives[qoi][var];
  }

get_qois() [1/2]

const std::vector<Number>& libMesh::DiffContext::get_qois ( ) const

inlineinherited

Const accessor for QoI vector.

Definition at line 317 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi.

Referenced by LaplaceQoI::element_qoi(), HeatSystem::element_qoi(), and CoupledSystemQoI::side_qoi().

  { return _elem_qoi; }

get_qois() [2/2]

std::vector<Number>& libMesh::DiffContext::get_qois ( )

inlineinherited

Non-const accessor for QoI vector.

Definition at line 323 of file diff_context.h.

References libMesh::DiffContext::_elem_qoi.

  { return _elem_qoi; }

get_side()

unsigned char libMesh::FEMContext::get_side ( ) const

inline

Accessor for current side of Elem object.

Definition at line 922 of file fem_context.h.

References side.

Referenced by libMesh::RBConstruction::add_scaled_matrix_and_vector(), assembly_with_dg_fem_context(), side_fe_reinit(), and SolidSystem::side_time_derivative().

  { return side; }

get_side_fe() [1/5]

template<typename OutputShape >

void libMesh::FEMContext::get_side_fe ( unsigned int  var, FEGenericBase< OutputShape > *&  fe  ) const

inline

Accessor for edge/face (2D/3D) finite element object for variable var for the largest dimension in the mesh.

We default to the largest mesh dim if this method is called before the Elem * is set in the FEMContext, e.g. in FEMSystem::init_context (or a subclass).

Definition at line 317 of file fem_context.h.

References get_elem_dim().

Referenced by assembly_with_dg_fem_context(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyA2::boundary_assembly(), AssemblyF2::boundary_assembly(), A2::boundary_assembly(), A3::boundary_assembly(), F0::boundary_assembly(), Output0::boundary_assembly(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_sides(), libMesh::ParsedFEMFunction< T >::eval_args(), fixed_side_gradient(), fixed_side_hessian(), fixed_side_value(), get_side_fe(), CoupledSystemQoI::init_context(), NavierSystem::init_context(), SolidSystem::init_context(), PoissonSystem::init_context(), LaplaceSystem::init_context(), CurlCurlSystem::init_context(), ElasticitySystem::init_context(), libMesh::LaplacianErrorEstimator::init_context(), libMesh::VariationalSmootherSystem::init_context(), CoupledSystem::init_context(), HilbertSystem::init_context(), libMesh::DiscontinuityMeasure::init_context(), libMesh::ParsedFEMFunction< T >::init_context(), HeatSystem::init_context(), libMesh::KellyErrorEstimator::init_context(), ElasticityRBConstruction::init_context(), SimpleRBConstruction::init_context(), libMesh::RBEIMConstruction::init_context(), libMesh::RBEIMConstruction::initialize_qp_data(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh_sides(), side_accel(), LaplaceSystem::side_constraint(), side_hessian(), LaplaceSystem::side_postprocess(), CoupledSystemQoI::side_qoi(), CoupledSystemQoI::side_qoi_derivative(), LaplaceSystem::side_qoi_derivative(), side_rate(), SolidSystem::side_time_derivative(), CurlCurlSystem::side_time_derivative(), and ElasticitySystem::side_time_derivative().

  { this->get_side_fe<OutputShape>(var,fe,this->get_elem_dim()); }

get_side_fe() [2/5]

FEBase* libMesh::FEMContext::get_side_fe ( unsigned int  var ) const

inline

Accessor for side finite element object for scalar-valued variable var for the largest dimension in the mesh.

We default to the largest mesh dim if this method is called before the Elem * is set in the FEMContext, e.g. in FEMSystem::init_context (or a subclass).

Definition at line 326 of file fem_context.h.

References get_elem_dim(), and get_side_fe().

  { return this->get_side_fe(var,this->get_elem_dim()); }

get_side_fe() [3/5]

template<typename OutputShape >

void libMesh::FEMContext::get_side_fe ( unsigned int  var, FEGenericBase< OutputShape > *&  fe, unsigned short  dim  ) const

inline

Accessor for edge/face (2D/3D) finite element object for variable var for dimension dim.

Definition at line 1305 of file fem_context.h.

References _side_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_side_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_side_fe_var[dim].size() ) );
  fe = cast_ptr<FEGenericBase<OutputShape> *>( (_side_fe_var[dim][var] ) );
}

get_side_fe() [4/5]

void libMesh::FEMContext::get_side_fe ( unsigned int  var, FEAbstract *&  fe, unsigned short  dim  ) const

inline

Accessor for edge/face (2D/3D) finite element object for variable var for dimension dim.

Definition at line 1314 of file fem_context.h.

References _side_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_side_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_side_fe_var[dim].size() ) );
  fe = _side_fe_var[dim][var];
}

get_side_fe() [5/5]

FEBase * libMesh::FEMContext::get_side_fe ( unsigned int  var, unsigned short  dim  ) const

inline

Accessor for side finite element object for scalar-valued variable var for dimension dim.

Definition at line 1323 of file fem_context.h.

References _side_fe_var, dim, and libMesh::libmesh_assert().

{
  libmesh_assert( !_side_fe_var[dim].empty() );
  libmesh_assert_less ( var, (_side_fe_var[dim].size() ) );
  return cast_ptr<FEBase *>( (_side_fe_var[dim][var] ) );
}

get_side_qrule() [1/2]

const QBase& libMesh::FEMContext::get_side_qrule ( ) const

inline

Accessor for element side quadrature rule for the dimension of the current _elem.

Definition at line 809 of file fem_context.h.

References get_elem_dim().

Referenced by assembly_with_dg_fem_context(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyA2::boundary_assembly(), AssemblyF2::boundary_assembly(), A2::boundary_assembly(), A3::boundary_assembly(), F0::boundary_assembly(), Output0::boundary_assembly(), LaplaceSystem::side_constraint(), LaplaceSystem::side_postprocess(), CoupledSystemQoI::side_qoi(), CoupledSystemQoI::side_qoi_derivative(), LaplaceSystem::side_qoi_derivative(), SolidSystem::side_time_derivative(), CurlCurlSystem::side_time_derivative(), and ElasticitySystem::side_time_derivative().

  { return this->get_side_qrule(this->get_elem_dim()); }

get_side_qrule() [2/2]

const QBase& libMesh::FEMContext::get_side_qrule ( unsigned short  dim ) const

inline

Accessor for element side quadrature rule.

Definition at line 822 of file fem_context.h.

References _side_qrule, dim, and libMesh::libmesh_assert().

  {
    libmesh_assert(_side_qrule[dim]);
    return *(this->_side_qrule[dim]);
  }

get_system()

const System& libMesh::DiffContext::get_system ( ) const

inlineinherited

Accessor for associated system.

Definition at line 106 of file diff_context.h.

References libMesh::DiffContext::_system.

Referenced by attach_quadrature_rules(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyA2::boundary_assembly(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), HeatSystem::element_qoi(), HeatSystem::element_qoi_derivative(), HeatSystem::element_time_derivative(), find_hardest_fe_type(), CoupledSystemQoI::init_context(), libMesh::RBEIMConstruction::init_context(), libMesh::DGFEMContext::neighbor_side_fe_reinit(), and libMesh::DifferentiablePhysics::nonlocal_mass_residual().

  { return _system; }

get_system_time()

Real libMesh::DiffContext::get_system_time ( ) const

inlineinherited

Accessor for the time variable stored in the system class.

Definition at line 411 of file diff_context.h.

References libMesh::DiffContext::system_time.

Referenced by _update_time_from_system().

  { return system_time; }

get_time()

Real libMesh::DiffContext::get_time ( ) const

inlineinherited

Accessor for the time for which the current nonlinear_solution is defined.

Definition at line 417 of file diff_context.h.

References libMesh::DiffContext::time.

  { return time; }

has_elem()

bool libMesh::FEMContext::has_elem ( ) const

inline

Test for current Elem object.

Definition at line 902 of file fem_context.h.

References _elem.

Referenced by build_new_fe(), cached_fe(), elem_fe_reinit(), and pre_fe_reinit().

  { return (this->_elem != nullptr); }

has_side_boundary_id()

bool libMesh::FEMContext::has_side_boundary_id

(

boundary_id_type

id

)

const

Reports if the boundary id is found on the current side.

Definition at line 298 of file fem_context.C.

References _boundary_info, get_elem(), libMesh::BoundaryInfo::has_boundary_id(), and side.

Referenced by A2::boundary_assembly(), A3::boundary_assembly(), F0::boundary_assembly(), Output0::boundary_assembly(), CoupledSystemQoI::side_qoi(), CoupledSystemQoI::side_qoi_derivative(), and ElasticitySystem::side_time_derivative().

{
  return _boundary_info.has_boundary_id(&(this->get_elem()), side, id);
}

init_internal_data()

void libMesh::FEMContext::init_internal_data ( const System &  sys )

private

Helper function used in constructors to set up internal data.

Definition at line 198 of file fem_context.C.

References _active_vars, _edge_fe, _edge_fe_var, _elem_dims, _element_fe, _element_fe_var, _extra_quadrature_order, _side_fe, _side_fe_var, libMesh::FEAbstract::build(), dim, libMesh::FEType::family, libMesh::System::get_dof_map(), libMesh::libmesh_assert(), libMesh::make_range(), libMesh::System::n_vars(), libMesh::SCALAR, libMesh::DofMap::should_p_refine(), use_default_quadrature_rules(), and libMesh::System::variable_type().

Referenced by FEMContext().

{
  // Reserve space for the FEAbstract and QBase objects for each
  // element dimension possibility (0,1,2,3)

  // Note: we would simply resize() all four of these vectors, but
  // some compilers (ICC 19, MSVC) generate a diagnostic about copying
  // a std::unique_ptr in this case, so the following two lines are a
  // workaround.
  _element_fe = std::vector<std::map<FEType, std::unique_ptr<FEAbstract>>>(4);
  _side_fe = std::vector<std::map<FEType, std::unique_ptr<FEAbstract>>>(4);
  _element_fe_var.resize(4);
  _side_fe_var.resize(4);

  // We need to know which of our variables has the hardest
  // shape functions to numerically integrate.

  unsigned int nv = sys.n_vars();
  libmesh_assert (nv);

  bool have_scalar = false;

  if (_active_vars)
    {
      for (auto v : *_active_vars)
        if (sys.variable_type(v).family == SCALAR)
          {
            have_scalar = true;
            break;
          }
    }
  else
    {
      for (auto v : make_range(sys.n_vars()))
        if (sys.variable_type(v).family == SCALAR)
          {
            have_scalar = true;
            break;
          }
    }

  if (have_scalar)
    // SCALAR FEs have dimension 0 by assumption
    _elem_dims.insert(0);

  auto build_var_fe = [this, &sys](unsigned int dim,
                                   unsigned int i)
    {
      FEType fe_type = sys.variable_type(i);
      const auto & dof_map = sys.get_dof_map();
      const bool add_p_level = dof_map.should_p_refine(dof_map.var_group_from_var_number(i));

      auto & element_fe = _element_fe[dim][fe_type];
      auto & side_fe = _side_fe[dim][fe_type];
      if (!element_fe)
        {
          element_fe = FEAbstract::build(dim, fe_type);
          element_fe->add_p_level_in_reinit(add_p_level);
          side_fe = FEAbstract::build(dim, fe_type);
          side_fe->add_p_level_in_reinit(add_p_level);

          if (dim == 3)
          {
            auto & edge_fe = _edge_fe[fe_type];
            edge_fe = FEAbstract::build(dim, fe_type);
            edge_fe->add_p_level_in_reinit(add_p_level);
          }
        }

      _element_fe_var[dim][i] = element_fe.get();
      _side_fe_var[dim][i] = side_fe.get();
      if ((dim) == 3)
        _edge_fe_var[i] = _edge_fe[fe_type].get();
    };

  for (const auto & dim : _elem_dims)
    {
      // Create finite element objects
      _element_fe_var[dim].resize(nv);
      _side_fe_var[dim].resize(nv);
      if (dim == 3)
        _edge_fe_var.resize(nv);

      if (_active_vars)
        for (auto v : *_active_vars)
          build_var_fe(dim, v);
      else
        for (auto v : make_range(nv))
          build_var_fe(dim, v);
    }

  this->use_default_quadrature_rules(_extra_quadrature_order);
}

interior_accel()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_accel< Gradient >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The second time derivative (acceleration) of the solution variable var at the quadrature point qp on the current element interior.

Definition at line 1390 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution_accel(), get_element_fe(), and some_value().

Referenced by ElasticitySystem::mass_residual(), SecondOrderScalarSystemSecondOrderTimeSolverBase::mass_residual(), and SecondOrderScalarSystemFirstOrderTimeSolverBase::mass_residual().

{
  this->some_value<OutputType,
                   &FEMContext::get_element_fe
                   <typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution_accel>(var, qp, u);
}

interior_curl()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_curl< Gradient >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	curl_u
	)		const

Returns

The curl of the solution variable var at the physical point p on the current element.

Definition at line 598 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, libMesh::FEGenericBase< OutputType >::get_curl_phi(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

Referenced by CurlCurlSystem::element_time_derivative().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputShape>> & curl_phi = fe->get_curl_phi();

  // Accumulate solution curl
  curl_u = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    curl_u.add_scaled(curl_phi[l][qp], coef(l));

  return;
}

interior_div()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_div< Number >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	div_u
	)		const

Returns

The divergence of the solution variable var at the physical point p on the current element.

Definition at line 629 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, libMesh::FEGenericBase< OutputType >::get_div_phi(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename
    TensorTools::IncrementRank
    <typename TensorTools::MakeReal<OutputType>::type>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputDivergence>> & div_phi = fe->get_div_phi();

  // Accumulate solution curl
  div_u = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    div_u += div_phi[l][qp] * coef(l);

  return;
}

interior_gradient() [1/2]

Gradient libMesh::FEMContext::interior_gradient	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The gradient of the solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 467 of file fem_context.C.

Referenced by NavierSystem::element_constraint(), CoupledSystem::element_constraint(), PoissonSystem::element_postprocess(), NavierSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), CoupledSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), and libMesh::FEMPhysics::eulerian_residual().

{
  Gradient du;

  this->interior_gradient( var, qp, du );

  return du;
}

interior_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::interior_gradient	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	du
	)		const

Returns

The gradient of the solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 480 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution(), get_element_fe(), and some_gradient().

{
  this->some_gradient<OutputType,
                      &FEMContext::get_element_fe<typename TensorTools::MakeReal
                                                  <typename TensorTools::DecrementRank
                                                   <OutputType>::type>::type>,
                      &DiffContext::get_elem_solution>(var, qp, du);
}

interior_gradients()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_gradients< Tensor >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	interior_gradients_vector
	)		const

Fills a vector with the gradient of the solution variable var at all the quadrature points in the current element interior.

Note

This is the preferred API.

Definition at line 494 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), libMesh::FEGenericBase< OutputType >::get_dphi(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), and libMesh::index_range().

{
  typedef typename TensorTools::MakeReal
    <typename TensorTools::DecrementRank<OutputType>::type>::type
    OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputGradient>> & dphi = fe->get_dphi();

  // Loop over all the q_points in this finite element
  for (auto qp : index_range(du_vals))
    {
      OutputType & du = du_vals[qp];

      // Compute the gradient at this q_point
      du = 0;

      for (unsigned int l=0; l != n_dofs; l++)
        du.add_scaled(dphi[l][qp], coef(l));
    }

  return;
}

interior_hessian() [1/2]

Tensor libMesh::FEMContext::interior_hessian	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The hessian of the solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 532 of file fem_context.C.

{
  Tensor d2u;

  this->interior_hessian( var, qp, d2u );

  return d2u;
}

interior_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::interior_hessian	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	d2u
	)		const

Returns

The hessian of the solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 542 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution(), get_element_fe(), and some_hessian().

{
  this->some_hessian<OutputType,
                     &FEMContext::get_element_fe
                     <typename TensorTools::MakeReal
                      <typename TensorTools::DecrementRank
                       <typename TensorTools::DecrementRank
                        <OutputType>::type>::type>::type>,
                     &DiffContext::get_elem_solution>(var, qp, d2u);
}

interior_hessians()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_hessians< Tensor >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	d2u_vals
	)		const

Fills a vector of hessians of the _system_vector at the all the quadrature points in the current element interior.

This is the preferred API.

Definition at line 556 of file fem_context.C.

References libMesh::FEGenericBase< OutputType >::get_d2phi(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), and libMesh::index_range().

{
  typedef typename TensorTools::DecrementRank<OutputType>::type Rank1Decrement;
  typedef typename TensorTools::DecrementRank<Rank1Decrement>::type Rank2Decrement;
  typedef typename TensorTools::MakeReal<Rank2Decrement>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputTensor>> & d2phi = fe->get_d2phi();

  // Loop over all the q_points in this finite element
  for (auto qp : index_range(d2u_vals))
    {
      OutputType & d2u = d2u_vals[qp];

      // Compute the gradient at this q_point
      d2u = 0;

      for (unsigned int l=0; l != n_dofs; l++)
        d2u.add_scaled(d2phi[l][qp], coef(l));
    }

  return;
}

interior_rate()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_rate< Gradient >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The time derivative (rate) of the solution variable var at the quadrature point qp on the current element interior.

Definition at line 1359 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution_rate(), get_element_fe(), and some_value().

Referenced by libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), SecondOrderScalarSystemSecondOrderTimeSolverBase::damping_residual(), SecondOrderScalarSystemFirstOrderTimeSolverBase::damping_residual(), NavierSystem::mass_residual(), libMesh::FEMPhysics::mass_residual(), and FirstOrderScalarSystemBase::mass_residual().

{
  this->some_value<OutputType,
                   &FEMContext::get_element_fe
                   <typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution_rate>(var, qp, u);
}

interior_rate_gradient()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_rate_gradient< Tensor >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The time derivative (rate) of the solution gradient of variable var at the quadrature point qp on the current element interior.

Definition at line 1369 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution_rate(), get_element_fe(), and some_gradient().

{
  this->some_gradient<OutputType,
                      &FEMContext::get_element_fe<typename TensorTools::MakeReal
                                                  <typename TensorTools::DecrementRank
                                                   <OutputType>::type>::type>,
                      &DiffContext::get_elem_solution_rate>(var, qp, dudot);
}

interior_value() [1/2]

Number libMesh::FEMContext::interior_value	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The value of the solution variable var at the quadrature point qp on the current element interior.

Note

This API is currently present for backward compatibility.

Definition at line 412 of file fem_context.C.

Referenced by libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), LaplaceSystem::element_postprocess(), LaplaceQoI::element_qoi(), HeatSystem::element_qoi(), NavierSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), CoupledSystem::element_time_derivative(), and HilbertSystem::element_time_derivative().

{
  Number u;

  this->interior_value( var, qp, u );

  return u;
}

interior_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::interior_value	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The value of the solution variable var at the quadrature point qp on the current element interior.

Note

This is the preferred API.

Definition at line 422 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution(), and some_value().

{
  this->some_value<OutputType,
                   &FEMContext::get_element_fe<typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution>(var, qp, u);
}

interior_values()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::interior_values< Gradient >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	interior_values_vector
	)		const

Fills a vector of values of the _system_vector at the all the quadrature points in the current element interior.

Definition at line 432 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), libMesh::FEGenericBase< OutputType >::get_phi(), and libMesh::index_range().

Referenced by HeatSystem::element_qoi_derivative().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get the finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<OutputShape>> & phi = fe->get_phi();

  // Loop over all the q_points on this element
  for (auto qp : index_range(u_vals))
    {
      OutputType & u = u_vals[qp];

      // Compute the value at this q_point
      u = 0.;

      for (unsigned int l=0; l != n_dofs; l++)
        u += phi[l][qp] * coef(l);
    }

  return;
}

is_adjoint() [1/2]

bool libMesh::DiffContext::is_adjoint ( ) const

inlineinherited

Accessor for querying whether we need to do a primal or adjoint solve.

Definition at line 466 of file diff_context.h.

References libMesh::DiffContext::_is_adjoint.

  { return _is_adjoint; }

is_adjoint() [2/2]

bool& libMesh::DiffContext::is_adjoint ( )

inlineinherited

Accessor for setting whether we need to do a primal or adjoint solve.

Definition at line 473 of file diff_context.h.

References libMesh::DiffContext::_is_adjoint.

  { return _is_adjoint; }

n_dof_indices() [1/2]

unsigned int libMesh::DiffContext::n_dof_indices ( ) const

inlineinherited

Total number of dof indices on the element.

Definition at line 395 of file diff_context.h.

References libMesh::DiffContext::_dof_indices.

Referenced by NavierSystem::element_constraint(), CoupledSystem::element_constraint(), LaplaceQoI::element_qoi_derivative(), LaplaceSystem::element_qoi_derivative(), HeatSystem::element_qoi_derivative(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), PoissonSystem::element_time_derivative(), LaplaceSystem::element_time_derivative(), CurlCurlSystem::element_time_derivative(), ElasticitySystem::element_time_derivative(), CoupledSystem::element_time_derivative(), HilbertSystem::element_time_derivative(), HeatSystem::element_time_derivative(), NavierSystem::mass_residual(), ElasticitySystem::mass_residual(), NavierSystem::side_constraint(), LaplaceSystem::side_constraint(), CoupledSystemQoI::side_qoi_derivative(), LaplaceSystem::side_qoi_derivative(), SolidSystem::side_time_derivative(), CurlCurlSystem::side_time_derivative(), and ElasticitySystem::side_time_derivative().

  { return cast_int<unsigned int>(_dof_indices.size()); }

n_dof_indices() [2/2]

unsigned int libMesh::DiffContext::n_dof_indices ( unsigned int  var ) const

inlineinherited

Total number of dof indices of the particular variable corresponding to the index argument.

Definition at line 402 of file diff_context.h.

References libMesh::DiffContext::_dof_indices_var.

  {
    libmesh_assert_greater(_dof_indices_var.size(), var);
    return cast_int<unsigned int>(_dof_indices_var[var].size());
  }

n_vars()

unsigned int libMesh::DiffContext::n_vars ( ) const

inlineinherited

Number of variables in solution.

Definition at line 100 of file diff_context.h.

References libMesh::DiffContext::_dof_indices_var.

Referenced by libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), libMesh::FEMPhysics::eulerian_residual(), libMesh::LaplacianErrorEstimator::init_context(), libMesh::DiscontinuityMeasure::init_context(), libMesh::WrappedFunctor< Output >::init_context(), libMesh::KellyErrorEstimator::init_context(), libMesh::FEMPhysics::mass_residual(), libMesh::DGFEMContext::neighbor_side_fe_reinit(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), and libMesh::FEMSystem::numerical_jacobian().

  { return cast_int<unsigned int>(_dof_indices_var.size()); }

nonlocal_reinit()

void libMesh::FEMContext::nonlocal_reinit ( Real  theta )

overridevirtual

Gives derived classes the opportunity to reinitialize data needed for nonlocal calculations at a new point within a timestep.

Reimplemented from libMesh::DiffContext.

Definition at line 1467 of file fem_context.C.

References _update_time_from_system(), and elem_fe_reinit().

{
  // Update the "time" variable of this context object
  this->_update_time_from_system(theta);

  // We can reuse the Elem FE safely here.
  elem_fe_reinit();
}

point_accel()

template<typename OutputType >

void libMesh::FEMContext::point_accel	(	unsigned int	var,
		const Point &	p,
		OutputType &	u
	)		const

Returns

The second time derivative (acceleration) of the solution variable var at the physical point p on the current element.

point_curl()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::point_curl< Gradient >	(	unsigned int	var,
		const Point &	p,
		OutputType &	curl_u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The curl of the solution variable var at the physical point p on the current element.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 1023 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 3 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputShape>> &  curl_phi = fe_new->get_curl_phi();

  curl_u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    curl_u.add_scaled(curl_phi[l][0], coef(l));

  return;
}

point_gradient() [1/2]

Gradient libMesh::FEMContext::point_gradient	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The gradient of the solution variable var at the physical point p on the current element.

Note

This API is currently present for backward compatibility.

Definition at line 920 of file fem_context.C.

Referenced by libMesh::ParsedFEMFunction< T >::eval_args(), CoupledFEMFunctionsx::operator()(), and CoupledFEMFunctionsy::operator()().

{
  Gradient grad_u;

  this->point_gradient( var, p, grad_u );

  return grad_u;
}

point_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::point_gradient	(	unsigned int	var,
		const Point &	p,
		OutputType &	grad_u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The gradient of the solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 932 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename TensorTools::MakeReal
    <typename TensorTools::DecrementRank<OutputType>::type>::type
    OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 1 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputGradient>> &  dphi = fe_new->get_dphi();

  grad_u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    grad_u.add_scaled(dphi[l][0], coef(l));

  return;
}

point_hessian() [1/2]

Tensor libMesh::FEMContext::point_hessian	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The hessian of the solution variable var at the physical point p on the current element.

Note

This API currently present for backward compatibility.

Definition at line 972 of file fem_context.C.

Referenced by libMesh::ParsedFEMFunction< T >::eval_args().

{
  Tensor hess_u;

  this->point_hessian( var, p, hess_u );

  return hess_u;
}

point_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::point_hessian	(	unsigned int	var,
		const Point &	p,
		OutputType &	hess_u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The hessian of the solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 983 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename TensorTools::DecrementRank<OutputType>::type Rank1Decrement;
  typedef typename TensorTools::DecrementRank<Rank1Decrement>::type Rank2Decrement;
  typedef typename TensorTools::MakeReal<Rank2Decrement>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 2 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputTensor>> &  d2phi = fe_new->get_d2phi();

  hess_u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    hess_u.add_scaled(d2phi[l][0], coef(l));

  return;
}

point_rate()

template<typename OutputType >

void libMesh::FEMContext::point_rate	(	unsigned int	var,
		const Point &	p,
		OutputType &	u
	)		const

Returns

The time derivative (rate) of the solution variable var at the physical point p on the current element.

point_value() [1/2]

Number libMesh::FEMContext::point_value	(	unsigned int	var,
		const Point &	p
	)		const

Returns

The value of the solution variable var at the physical point p on the current element.

Note

This API is currently present for backward compatibility.

Definition at line 874 of file fem_context.C.

Referenced by libMesh::ParsedFEMFunction< T >::eval_args(), CoupledFEMFunctionsx::operator()(), CoupledFEMFunctionsy::operator()(), and NavierSystem::side_constraint().

{
  Number u = 0.;

  this->point_value( var, p, u );

  return u;
}

point_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::point_value	(	unsigned int	var,
		const Point &	p,
		OutputType &	u,
		const Real	tolerance = TOLERANCE
	)		const

Returns

The value of the solution variable var at the physical point p on the current element.

Note

This is the preferred API.

Allows evaluation of points within a relative tolerance outside the element.

Definition at line 884 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, build_new_fe(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * fe = nullptr;
  this->get_element_fe<OutputShape>( var, fe, this->get_elem_dim() );

  // Build a FE for calculating u(p)
  FEGenericBase<OutputShape> * fe_new =
    this->build_new_fe( fe, p, tolerance, 0 );

  // Get the values of the shape function derivatives
  const std::vector<std::vector<OutputShape>> &  phi = fe_new->get_phi();

  u = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    u += phi[l][0] * coef(l);

  return;
}

pre_fe_reinit()

void libMesh::FEMContext::pre_fe_reinit ( const System &  sys, const Elem *  e  )

virtual

Reinitializes local data vectors/matrices on the current geometric element.

Definition at line 1683 of file fem_context.C.

References _active_vars, _custom_solution, libMesh::DiffContext::_elem_qoi_subderivatives, libMesh::DiffContext::_have_local_matrices, libMesh::DiffContext::_localized_vectors, algebraic_type(), CURRENT, libMesh::System::current_local_solution, libMesh::DofMap::dof_indices(), DOFS_ONLY, libMesh::NumericVector< T >::get(), libMesh::DiffContext::get_dof_indices(), libMesh::System::get_dof_map(), get_elem(), libMesh::DiffContext::get_elem_fixed_solution(), libMesh::DiffContext::get_elem_jacobian(), libMesh::DiffContext::get_elem_residual(), libMesh::DiffContext::get_elem_solution(), libMesh::DiffContext::get_elem_solution_accel(), libMesh::DiffContext::get_elem_solution_rate(), libMesh::DiffContext::get_qoi_derivatives(), libMesh::DifferentiablePhysics::get_second_order_vars(), libMesh::DifferentiableSystem::get_time_solver(), libMesh::DenseVector< T >::get_values(), has_elem(), libMesh::TimeSolver::is_steady(), libMesh::make_range(), libMesh::System::n_qois(), libMesh::System::n_vars(), NONE, OLD, libMesh::DofMap::old_dof_indices(), OLD_DOFS_ONLY, libMesh::DenseVector< T >::resize(), libMesh::DenseMatrix< T >::resize(), set_elem(), libMesh::UnsteadySolver::time_order(), and libMesh::System::use_fixed_solution.

Referenced by libMesh::ExactSolution::_compute_error(), libMesh::RBConstruction::add_scaled_matrix_and_vector(), libMesh::FEMSystem::assembly(), assembly_with_dg_fem_context(), libMesh::VariationalSmootherSystem::compute_element_reference_volume(), HilbertSystem::element_time_derivative(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_interiors(), libMesh::RBEIMConstruction::enrich_eim_approximation_on_sides(), libMesh::RBEIMConstruction::initialize_qp_data(), libMesh::FEMSystem::mesh_position_get(), libMesh::FEMSystem::mesh_position_set(), libMesh::WeightedPatchRecoveryErrorEstimator::EstimateError::operator()(), Integrate::operator()(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh(), libMesh::RBParametrizedFunction::preevaluate_parametrized_function_on_mesh_sides(), libMesh::System::project_vector(), OverlappingAlgebraicGhostingTest::run_ghosting_test(), and OverlappingCouplingGhostingTest::run_sparsity_pattern_test().

{
  this->set_elem(e);

  if (algebraic_type() == CURRENT ||
      algebraic_type() == DOFS_ONLY)
    {
      // Initialize the per-element data for elem.
      if (this->has_elem())
        sys.get_dof_map().dof_indices (&(this->get_elem()), this->get_dof_indices());
      else
        // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
        sys.get_dof_map().dof_indices
          (static_cast<Elem*>(nullptr), this->get_dof_indices());
    }
#ifdef LIBMESH_ENABLE_AMR
  else if (algebraic_type() == OLD ||
           algebraic_type() == OLD_DOFS_ONLY)
    {
      // Initialize the per-element data for elem.
      if (this->has_elem())
        sys.get_dof_map().old_dof_indices (&(this->get_elem()), this->get_dof_indices());
      else
        // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
        sys.get_dof_map().old_dof_indices
          (static_cast<Elem*>(nullptr), this->get_dof_indices());
    }
#endif // LIBMESH_ENABLE_AMR

  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices().size());
  const unsigned int n_qoi = sys.n_qois();

  if (this->algebraic_type() != NONE &&
      this->algebraic_type() != DOFS_ONLY &&
      this->algebraic_type() != OLD_DOFS_ONLY)
    {
      // This also resizes elem_solution
      if (_custom_solution == nullptr)
        sys.current_local_solution->get(this->get_dof_indices(), this->get_elem_solution().get_values());
      else
        _custom_solution->get(this->get_dof_indices(), this->get_elem_solution().get_values());

      if (sys.use_fixed_solution)
        this->get_elem_fixed_solution().resize(n_dofs);

      // Only make space for these if we're using DiffSystem
      // This is assuming *only* DiffSystem is using elem_solution_rate/accel
      const DifferentiableSystem * diff_system = dynamic_cast<const DifferentiableSystem *>(&sys);
      if (diff_system)
        {
          // Now, we only need these if the solver is unsteady
          if (!diff_system->get_time_solver().is_steady())
            {
              this->get_elem_solution_rate().resize(n_dofs);

              // We only need accel space if the TimeSolver is second order
              const UnsteadySolver & time_solver = cast_ref<const UnsteadySolver &>(diff_system->get_time_solver());

              if (time_solver.time_order() >= 2 || !diff_system->get_second_order_vars().empty())
                this->get_elem_solution_accel().resize(n_dofs);
            }
        }

      if (algebraic_type() != OLD)
        {
          // These resize calls also zero out the residual and jacobian
          this->get_elem_residual().resize(n_dofs);
          if (this->_have_local_matrices)
            this->get_elem_jacobian().resize(n_dofs, n_dofs);

          this->get_qoi_derivatives().resize(n_qoi);
          this->_elem_qoi_subderivatives.resize(n_qoi);
          for (std::size_t q=0; q != n_qoi; ++q)
            (this->get_qoi_derivatives())[q].resize(n_dofs);
        }
    }

  // Initialize the per-variable data for elem.
  {
    unsigned int sub_dofs = 0;
    for (auto i : make_range(sys.n_vars()))
      {
        if (algebraic_type() == CURRENT ||
            algebraic_type() == DOFS_ONLY)
          {
            if (this->has_elem())
              sys.get_dof_map().dof_indices (&(this->get_elem()), this->get_dof_indices(i), i);
            else
              // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
              sys.get_dof_map().dof_indices
                (static_cast<Elem*>(nullptr), this->get_dof_indices(i), i);
          }
#ifdef LIBMESH_ENABLE_AMR
        else if (algebraic_type() == OLD ||
                 algebraic_type() == OLD_DOFS_ONLY)
          {
            if (this->has_elem())
              sys.get_dof_map().old_dof_indices (&(this->get_elem()), this->get_dof_indices(i), i);
            else
              // If !this->has_elem(), then we assume we are dealing with a SCALAR variable
              sys.get_dof_map().old_dof_indices
                (static_cast<Elem*>(nullptr), this->get_dof_indices(i), i);
          }
#endif // LIBMESH_ENABLE_AMR

        if (this->algebraic_type() != NONE &&
            this->algebraic_type() != DOFS_ONLY &&
            this->algebraic_type() != OLD_DOFS_ONLY)
          {
            const unsigned int n_dofs_var = cast_int<unsigned int>
              (this->get_dof_indices(i).size());


            if (!_active_vars ||
                std::binary_search(_active_vars->begin(),
                                   _active_vars->end(), i))
              {
                this->get_elem_solution(i).reposition
                  (sub_dofs, n_dofs_var);

                // Only make space for these if we're using DiffSystem
                // This is assuming *only* DiffSystem is using elem_solution_rate/accel
                const DifferentiableSystem * diff_system = dynamic_cast<const DifferentiableSystem *>(&sys);
                if (diff_system)
                  {
                    // Now, we only need these if the solver is unsteady
                    if (!diff_system->get_time_solver().is_steady())
                      {
                        this->get_elem_solution_rate(i).reposition
                          (sub_dofs, n_dofs_var);

                        // We only need accel space if the TimeSolver is second order
                        const UnsteadySolver & time_solver = cast_ref<const UnsteadySolver &>(diff_system->get_time_solver());

                        if (time_solver.time_order() >= 2 || !diff_system->get_second_order_vars().empty())
                          this->get_elem_solution_accel(i).reposition
                            (sub_dofs, n_dofs_var);
                      }
                  }

                if (sys.use_fixed_solution)
                  this->get_elem_fixed_solution(i).reposition
                    (sub_dofs, n_dofs_var);

                if (algebraic_type() != OLD)
                  {
                    this->get_elem_residual(i).reposition
                      (sub_dofs, n_dofs_var);

                    for (std::size_t q=0; q != n_qoi; ++q)
                      this->get_qoi_derivatives(q,i).reposition
                        (sub_dofs, n_dofs_var);

                    if (this->_have_local_matrices)
                      {
                        for (unsigned int j=0; j != i; ++j)
                          {
                            const unsigned int n_dofs_var_j =
                              cast_int<unsigned int>
                              (this->get_dof_indices(j).size());

                            this->get_elem_jacobian(i,j).reposition
                              (sub_dofs, this->get_elem_residual(j).i_off(),
                               n_dofs_var, n_dofs_var_j);
                            this->get_elem_jacobian(j,i).reposition
                              (this->get_elem_residual(j).i_off(), sub_dofs,
                               n_dofs_var_j, n_dofs_var);
                          }
                        this->get_elem_jacobian(i,i).reposition
                          (sub_dofs, sub_dofs,
                           n_dofs_var,
                           n_dofs_var);
                      }
                  }
              }

            sub_dofs += n_dofs_var;
          }
      }

    if (this->algebraic_type() != NONE &&
        this->algebraic_type() != DOFS_ONLY &&
        this->algebraic_type() != OLD &&
        this->algebraic_type() != OLD_DOFS_ONLY)
      libmesh_assert_equal_to (sub_dofs, n_dofs);
  }

  // Now do the localization for the user requested vectors
  if (this->algebraic_type() != NONE &&
      this->algebraic_type() != DOFS_ONLY &&
      this->algebraic_type() != OLD_DOFS_ONLY)
    {
      DiffContext::localized_vectors_iterator localized_vec_it = this->_localized_vectors.begin();
      const DiffContext::localized_vectors_iterator localized_vec_end = this->_localized_vectors.end();

      for (; localized_vec_it != localized_vec_end; ++localized_vec_it)
        {
          const NumericVector<Number> & current_localized_vector = *localized_vec_it->first;
          DenseVector<Number> & target_vector = localized_vec_it->second.first;

          current_localized_vector.get(this->get_dof_indices(), target_vector.get_values());

          // Initialize the per-variable data for elem.
          unsigned int sub_dofs = 0;
          auto init_localized_var_data = [this, localized_vec_it, &sub_dofs](unsigned int i)
            {
              const unsigned int n_dofs_var = cast_int<unsigned int>
                (this->get_dof_indices(i).size());

              // This is redundant with earlier initialization, isn't it? - RHS
              // sys.get_dof_map().dof_indices (&(this->get_elem()), this->get_dof_indices(i), i);

              localized_vec_it->second.second[i].reposition
                (sub_dofs, n_dofs_var);

              sub_dofs += n_dofs_var;
            };

          if (_active_vars)
            for (auto v : *_active_vars)
              init_localized_var_data(v);
          else
            for (auto v : make_range(sys.n_vars()))
              init_localized_var_data(v);

          libmesh_assert_equal_to (sub_dofs, n_dofs);
        }
    }
}

set_algebraic_type()

void libMesh::FEMContext::set_algebraic_type ( const AlgebraicType  atype )

inline

Setting which determines whether to initialize algebraic structures (elem_*) on each element and set their values from current_local_solution.

Algebraic initialization may be disabled for efficiency in cases where FEMContext is only used as a convenient container of FE objects.

Definition at line 986 of file fem_context.h.

References _atype.

Referenced by libMesh::OldSolutionBase< Output, point_output >::init_context().

  { _atype = atype; }

set_custom_solution()

void libMesh::FEMContext::set_custom_solution ( const NumericVector< Number > *  custom_sol )

inline

Set a NumericVector to be used in place of current_local_solution for calculating elem_solution.

Set to nullptr to restore the current_local_solution behavior. Advanced DifferentiableSystem specific capabilities will only be enabled in the current_local_solution case.

Definition at line 1001 of file fem_context.h.

References _custom_solution.

  { _custom_solution = custom_sol; }

set_deltat_pointer()

void libMesh::DiffContext::set_deltat_pointer ( Real *  dt )

inherited

Points the _deltat member of this class at a timestep value stored in the creating System, for example DiffSystem::deltat.

Definition at line 109 of file diff_context.C.

References libMesh::DiffContext::_deltat.

Referenced by libMesh::FEMSystem::init_context().

{
  // We may actually want to be able to set this pointer to nullptr, so
  // don't report an error for that.
  _deltat = dt;
}

set_elem()

void libMesh::FEMContext::set_elem ( const Elem *  e )

protected

Helper function to promote accessor usage.

Definition at line 1914 of file fem_context.C.

References _elem, _elem_dim, and libMesh::Elem::dim().

Referenced by pre_fe_reinit().

{
  this->_elem = e;

  // If e is nullptr, we assume it's SCALAR and set _elem_dim to 0.
  this->_elem_dim =
    cast_int<unsigned char>(this->_elem ? this->_elem->dim() : 0);
}

set_jacobian_tolerance()

void libMesh::FEMContext::set_jacobian_tolerance

(

Real

tol

)

Calls set_jacobian_tolerance() on all the FE objects controlled by this class.

(Actually, it calls this on the underlying)

Definition at line 1586 of file fem_context.C.

References _edge_fe, _element_fe, and _side_fe.

{
  for (auto & m : _element_fe)
    for (auto & pr : m)
      pr.second->get_fe_map().set_jacobian_tolerance(tol);

  for (auto & m : _side_fe)
    for (auto & pr : m)
      pr.second->get_fe_map().set_jacobian_tolerance(tol);

  for (auto & pr : _edge_fe)
    pr.second->get_fe_map().set_jacobian_tolerance(tol);
}

set_mesh_system()

virtual void libMesh::FEMContext::set_mesh_system ( System *  sys )

inlinevirtual

Tells the FEMContext that system sys contains the isoparametric Lagrangian variables which correspond to the coordinates of mesh nodes, in problems where the mesh itself is expected to move in time.

This should be set automatically if the FEMPhysics requires it.

Definition at line 842 of file fem_context.h.

References _mesh_sys.

  { this->_mesh_sys = sys; }

set_mesh_x_var()

void libMesh::FEMContext::set_mesh_x_var ( unsigned int  x_var )

inline

Accessor for x-variable of moving mesh System.

This should be set automatically if the FEMPhysics requires it.

Definition at line 868 of file fem_context.h.

References _mesh_x_var.

  { _mesh_x_var = x_var; }

set_mesh_y_var()

void libMesh::FEMContext::set_mesh_y_var ( unsigned int  y_var )

inline

Accessor for y-variable of moving mesh System.

This should be set automatically if the FEMPhysics requires it.

Definition at line 882 of file fem_context.h.

References _mesh_y_var.

  { _mesh_y_var = y_var; }

set_mesh_z_var()

void libMesh::FEMContext::set_mesh_z_var ( unsigned int  z_var )

inline

Accessor for z-variable of moving mesh System.

This should be set automatically if the FEMPhysics requires it.

Definition at line 896 of file fem_context.h.

References _mesh_z_var.

  { _mesh_z_var = z_var; }

set_time()

void libMesh::DiffContext::set_time ( Real  time_in )

inlineinherited

Set the time for which the current nonlinear_solution is defined.

Definition at line 423 of file diff_context.h.

References libMesh::DiffContext::time.

Referenced by _update_time_from_system().

  { time = time_in; }

side_accel()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::side_accel< Gradient >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The second time derivative (acceleration) of the solution variable var at the quadrature point qp on the current element side.

Definition at line 1402 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution_accel(), get_side_fe(), and some_value().

{
  this->some_value<OutputType,
                   &FEMContext::get_side_fe
                   <typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution_accel>(var, qp, u);
}

side_boundary_ids()

void libMesh::FEMContext::side_boundary_ids

(

std::vector< boundary_id_type > &

vec_to_fill

)

const

As above, but fills in the std::set provided by the user.

Definition at line 305 of file fem_context.C.

References _boundary_info, libMesh::BoundaryInfo::boundary_ids(), get_elem(), and side.

{
  _boundary_info.boundary_ids(&(this->get_elem()), side, vec_to_fill);
}

side_fe_reinit()

void libMesh::FEMContext::side_fe_reinit ( )

virtual

Reinitializes side FE objects on the current geometric element.

Reimplemented in libMesh::DGFEMContext.

Definition at line 1498 of file fem_context.C.

References _side_fe, dim, get_elem(), get_elem_dim(), get_side(), and libMesh::libmesh_assert().

Referenced by elem_side_reinit(), and libMesh::DGFEMContext::side_fe_reinit().

{
  // Initialize all the side FE objects on elem/side.
  // Logging of FE::reinit is done in the FE functions
  // We only reinit the FE objects for the current element
  // dimension
  const unsigned char dim = this->get_elem_dim();

  libmesh_assert( !_side_fe[dim].empty() );

  for (auto & pr : _side_fe[dim])
    pr.second->reinit(&(this->get_elem()), this->get_side());
}

side_gradient() [1/2]

Gradient libMesh::FEMContext::side_gradient	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The gradient of the solution variable var at the quadrature point qp on the current element side.

Note

This API is currently present for backward compatibility.

Definition at line 719 of file fem_context.C.

Referenced by LaplaceSystem::side_postprocess().

{
  Gradient du;

  this->side_gradient( var, qp, du );

  return du;
}

side_gradient() [2/2]

template<typename OutputType >

void libMesh::FEMContext::side_gradient	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	du
	)		const

Returns

The gradient of the solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 730 of file fem_context.C.

References libMesh::DiffContext::_elem_subsolutions, libMesh::DiffContext::get_dof_indices(), libMesh::FEGenericBase< OutputType >::get_dphi(), get_elem_dim(), and libMesh::DiffContext::get_elem_solution().

{
  typedef typename TensorTools::MakeReal
    <typename TensorTools::DecrementRank<OutputType>::type>::type
    OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  libmesh_assert_greater (this->_elem_subsolutions.size(), var);
  const DenseSubVector<Number> & coef = this->get_elem_solution(var);

  // Get finite element object
  FEGenericBase<OutputShape> * the_side_fe = nullptr;
  this->get_side_fe<OutputShape>( var, the_side_fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputGradient>> & dphi = the_side_fe->get_dphi();

  // Accumulate solution derivatives
  du = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    du.add_scaled(dphi[l][qp], coef(l));

  return;
}

side_gradients()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::side_gradients< Tensor >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	side_gradients_vector
	)		const

Fills a vector with the gradient of the solution variable var at all the quadrature points on the current element side.

Note

This is the preferred API.

Definition at line 764 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), libMesh::FEGenericBase< OutputType >::get_dphi(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), and libMesh::index_range().

{
  typedef typename TensorTools::MakeReal
    <typename TensorTools::DecrementRank<OutputType>::type>::type
    OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get finite element object
  FEGenericBase<OutputShape> * the_side_fe = nullptr;
  this->get_side_fe<OutputShape>( var, the_side_fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputGradient>> & dphi = the_side_fe->get_dphi();

  // Loop over all the q_points in this finite element
  for (auto qp : index_range(du_vals))
    {
      OutputType & du = du_vals[qp];

      du = 0;

      // Compute the gradient at this q_point
      for (unsigned int l=0; l != n_dofs; l++)
        du.add_scaled(dphi[l][qp], coef(l));
    }

  return;
}

side_hessian() [1/2]

Tensor libMesh::FEMContext::side_hessian	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The hessian of the solution variable var at the quadrature point qp on the current element side.

Note

This API is currently present for backward compatibility.

Definition at line 802 of file fem_context.C.

{
  Tensor d2u;

  this->side_hessian( var, qp, d2u );

  return d2u;
}

side_hessian() [2/2]

template<typename OutputType >

void libMesh::FEMContext::side_hessian	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	d2u
	)		const

Returns

The hessian of the solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 815 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution(), get_side_fe(), and some_hessian().

{
  this->some_hessian<OutputType,
                     &FEMContext::get_side_fe
                     <typename TensorTools::MakeReal
                      <typename TensorTools::DecrementRank
                       <typename TensorTools::DecrementRank
                        <OutputType>::type>::type>::type>,
                     &DiffContext::get_elem_solution>(var, qp, d2u);
}

side_hessians()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::side_hessians< Tensor >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	d2u_vals
	)		const

Fills a vector of hessians of the _system_vector at the all the quadrature points on the current element side.

This is the preferred API.

Definition at line 831 of file fem_context.C.

References libMesh::FEGenericBase< OutputType >::get_d2phi(), libMesh::DiffContext::get_dof_indices(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), and libMesh::index_range().

{
  typedef typename TensorTools::DecrementRank<OutputType>::type Rank1Decrement;
  typedef typename TensorTools::DecrementRank<Rank1Decrement>::type Rank2Decrement;
  typedef typename TensorTools::MakeReal<Rank2Decrement>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get finite element object
  FEGenericBase<OutputShape> * the_side_fe = nullptr;
  this->get_side_fe<OutputShape>( var, the_side_fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<typename FEGenericBase<OutputShape>::OutputTensor>> & d2phi = the_side_fe->get_d2phi();

  // Loop over all the q_points in this finite element
  for (auto qp : index_range(d2u_vals))
    {
      OutputType & d2u = d2u_vals[qp];

      // Compute the gradient at this q_point
      d2u = 0;

      for (unsigned int l=0; l != n_dofs; l++)
        d2u.add_scaled(d2phi[l][qp], coef(l));
    }

  return;
}

side_rate()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::side_rate< Gradient >	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The time derivative (rate) of the solution variable var at the quadrature point qp on the current element side.

Definition at line 1380 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution_rate(), get_side_fe(), and some_value().

{
  this->some_value<OutputType,
                   &FEMContext::get_side_fe
                   <typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution_rate>(var, qp, u);
}

side_value() [1/2]

Number libMesh::FEMContext::side_value	(	unsigned int	var,
		unsigned int	qp
	)		const

Returns

The value of the solution variable var at the quadrature point qp on the current element side.

Note

This API currently is present for backward compatibility.

Definition at line 661 of file fem_context.C.

Referenced by LaplaceSystem::side_constraint(), CoupledSystemQoI::side_qoi(), CoupledSystemQoI::side_qoi_derivative(), and CurlCurlSystem::side_time_derivative().

{
  Number u = 0.;

  this->side_value( var, qp, u );

  return u;
}

side_value() [2/2]

template<typename OutputType >

void libMesh::FEMContext::side_value	(	unsigned int	var,
		unsigned int	qp,
		OutputType &	u
	)		const

Returns

The value of the solution variable var at the quadrature point qp on the current element side.

Note

This is the preferred API.

Definition at line 673 of file fem_context.C.

References libMesh::DiffContext::get_elem_solution(), and some_value().

{
  this->some_value<OutputType,
                   &FEMContext::get_side_fe<typename TensorTools::MakeReal<OutputType>::type>,
                   &DiffContext::get_elem_solution>(var, qp, u);
}

side_values()

template<typename OutputType >

template LIBMESH_EXPORT void libMesh::FEMContext::side_values< Gradient >	(	unsigned int	var,
		const NumericVector< Number > &	_system_vector,
		std::vector< OutputType > &	side_values_vector
	)		const

Fills a vector of values of the _system_vector at the all the quadrature points on the current element side.

Definition at line 684 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), get_elem_dim(), libMesh::DiffContext::get_localized_subvector(), libMesh::FEGenericBase< OutputType >::get_phi(), and libMesh::index_range().

{
  typedef typename TensorTools::MakeReal<OutputType>::type OutputShape;

  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = get_localized_subvector(_system_vector, var);

  // Get the finite element object
  FEGenericBase<OutputShape> * the_side_fe = nullptr;
  this->get_side_fe<OutputShape>( var, the_side_fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector<OutputShape>> & phi = the_side_fe->get_phi();

  // Loop over all the q_points on this element
  for (auto qp : index_range(u_vals))
    {
      OutputType & u = u_vals[qp];

      // Compute the value at this q_point
      u = 0.;

      for (unsigned int l=0; l != n_dofs; l++)
        u += phi[l][qp] * coef(l);
    }

  return;
}

some_gradient()

template<typename OutputType , typename FEMContext::FENeeded< OutputType >::grad_getter fe_getter, FEMContext::diff_subsolution_getter subsolution_getter>

void libMesh::FEMContext::some_gradient ( unsigned int  var, unsigned int  qp, OutputType &  u  ) const

protected

Helper function to reduce some code duplication in the *interior_gradient methods.

Definition at line 349 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), libMesh::FEGenericBase< OutputType >::get_dphi(), and get_elem_dim().

Referenced by fixed_interior_gradient(), fixed_side_gradient(), interior_gradient(), and interior_rate_gradient().

{
  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = (this->*subsolution_getter)(var);

  // Get finite element object
  typename FENeeded<OutputType>::grad_base * fe = nullptr;
  (this->*fe_getter)( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector
                    <typename FENeeded<OutputType>::grad_base::OutputGradient>>
    & dphi = fe->get_dphi();

  // Accumulate solution derivatives
  du = 0;

  for (unsigned int l=0; l != n_dofs; l++)
    du.add_scaled(dphi[l][qp], coef(l));

  return;
}

some_hessian()

template<typename OutputType , typename FEMContext::FENeeded< OutputType >::hess_getter fe_getter, FEMContext::diff_subsolution_getter subsolution_getter>

void libMesh::FEMContext::some_hessian ( unsigned int  var, unsigned int  qp, OutputType &  u  ) const

protected

Helper function to reduce some code duplication in the *interior_hessian methods.

Definition at line 382 of file fem_context.C.

References libMesh::FEGenericBase< OutputType >::get_d2phi(), libMesh::DiffContext::get_dof_indices(), and get_elem_dim().

Referenced by fixed_interior_hessian(), fixed_side_hessian(), interior_hessian(), and side_hessian().

{
  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = (this->*subsolution_getter)(var);

  // Get finite element object
  typename FENeeded<OutputType>::hess_base * fe = nullptr;
  (this->*fe_getter)( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector
                    <typename FENeeded<OutputType>::hess_base::OutputTensor>>
    & d2phi = fe->get_d2phi();

  // Accumulate solution second derivatives
  d2u = 0.0;

  for (unsigned int l=0; l != n_dofs; l++)
    d2u.add_scaled(d2phi[l][qp], coef(l));

  return;
}

some_value()

template<typename OutputType , typename FEMContext::FENeeded< OutputType >::value_getter fe_getter, FEMContext::diff_subsolution_getter subsolution_getter>

void libMesh::FEMContext::some_value ( unsigned int  var, unsigned int  qp, OutputType &  u  ) const

protected

Helper function to reduce some code duplication in the *interior_value methods.

Definition at line 315 of file fem_context.C.

References libMesh::DiffContext::get_dof_indices(), get_elem_dim(), and libMesh::FEGenericBase< OutputType >::get_phi().

Referenced by fixed_interior_value(), fixed_side_value(), interior_accel(), interior_rate(), interior_value(), side_accel(), side_rate(), and side_value().

{
  // Get local-to-global dof index lookup
  const unsigned int n_dofs = cast_int<unsigned int>
    (this->get_dof_indices(var).size());

  // Get current local coefficients
  const DenseSubVector<Number> & coef = (this->*subsolution_getter)(var);
  libmesh_assert_equal_to(coef.size(), n_dofs);

  // Get finite element object
  typename FENeeded<OutputType>::value_base * fe = nullptr;
  (this->*fe_getter)( var, fe, this->get_elem_dim() );

  // Get shape function values at quadrature point
  const std::vector<std::vector
                    <typename FENeeded<OutputType>::value_shape>> & phi = fe->get_phi();
  libmesh_assert_equal_to(phi.size(), n_dofs);

  // Accumulate solution value
  u = 0.;

  for (unsigned int l=0; l != n_dofs; l++)
    {
      libmesh_assert_less(qp, phi[l].size());
      u += phi[l][qp] * coef(l);
    }
}

use_default_quadrature_rules()

void libMesh::FEMContext::use_default_quadrature_rules

(

int

extra_quadrature_order = 0

)

Use quadrature rules designed to over-integrate a mass matrix, plus extra_quadrature_order.

Definition at line 155 of file fem_context.C.

References _edge_qrule, _elem_dims, _element_qrule, _extra_quadrature_order, _side_qrule, attach_quadrature_rules(), libMesh::FEType::default_quadrature_rule(), dim, and find_hardest_fe_type().

Referenced by init_internal_data().

{
  _extra_quadrature_order = extra_quadrature_order;

  FEType hardest_fe_type = this->find_hardest_fe_type();

  for (const auto & dim : _elem_dims)
    {
      // Create an adequate quadrature rule
      _element_qrule[dim] =
        hardest_fe_type.default_quadrature_rule(dim, _extra_quadrature_order);
      if (dim)
        _side_qrule[dim] =
          hardest_fe_type.default_quadrature_rule(dim-1, _extra_quadrature_order);
      if (dim == 3)
        _edge_qrule = hardest_fe_type.default_quadrature_rule(1, _extra_quadrature_order);
    }

  this->attach_quadrature_rules();
}

use_unweighted_quadrature_rules()

void libMesh::FEMContext::use_unweighted_quadrature_rules

(

int

extra_quadrature_order = 0

)

Use quadrature rules designed to exactly integrate unweighted undistorted basis functions, plus extra_quadrature_order.

Definition at line 177 of file fem_context.C.

References _edge_qrule, _elem_dims, _element_qrule, _extra_quadrature_order, _side_qrule, attach_quadrature_rules(), dim, find_hardest_fe_type(), and libMesh::FEType::unweighted_quadrature_rule().

{
  _extra_quadrature_order = extra_quadrature_order;

  FEType hardest_fe_type = this->find_hardest_fe_type();

  for (const auto & dim : _elem_dims)
    {
      // Create an adequate quadrature rule
      _element_qrule[dim] =
        hardest_fe_type.unweighted_quadrature_rule(dim, _extra_quadrature_order);
      _side_qrule[dim] =
        hardest_fe_type.unweighted_quadrature_rule(dim-1, _extra_quadrature_order);
      if (dim == 3)
        _edge_qrule = hardest_fe_type.unweighted_quadrature_rule(1, _extra_quadrature_order);
    }

  this->attach_quadrature_rules();
}

Member Data Documentation

_active_vars

std::unique_ptr<const std::vector<unsigned int> > libMesh::FEMContext::_active_vars

protected

Variables on which to enable calculations, or nullptr if all variables in the System are to be enabled.

Definition at line 1054 of file fem_context.h.

Referenced by active_vars(), attach_quadrature_rules(), FEMContext(), find_hardest_fe_type(), init_internal_data(), and pre_fe_reinit().

_atype

AlgebraicType libMesh::FEMContext::_atype

protected

Keep track of what type of algebra reinitialization is to be done.

Definition at line 1069 of file fem_context.h.

Referenced by algebraic_type(), and set_algebraic_type().

_boundary_info

const BoundaryInfo& libMesh::FEMContext::_boundary_info

protected

Saved reference to BoundaryInfo on the mesh for this System.

Used to answer boundary id requests.

Definition at line 1187 of file fem_context.h.

Referenced by has_side_boundary_id(), and side_boundary_ids().

_custom_solution

const NumericVector<Number>* libMesh::FEMContext::_custom_solution

protected

Data with which to do algebra reinitialization.

Definition at line 1074 of file fem_context.h.

Referenced by pre_fe_reinit(), and set_custom_solution().

_dim

unsigned char libMesh::FEMContext::_dim

protected

Cached dimension of largest dimension element in this mesh.

Definition at line 1197 of file fem_context.h.

Referenced by libMesh::DGFEMContext::DGFEMContext(), get_dim(), and get_elem_dim().

_dof_indices

std::vector<dof_id_type> libMesh::DiffContext::_dof_indices

protectedinherited

Global Degree of freedom index lists.

Definition at line 639 of file diff_context.h.

Referenced by libMesh::DiffContext::get_dof_indices(), and libMesh::DiffContext::n_dof_indices().

_dof_indices_var

std::vector<std::vector<dof_id_type> > libMesh::DiffContext::_dof_indices_var

protectedinherited

Definition at line 640 of file diff_context.h.

Referenced by libMesh::DiffContext::get_dof_indices(), libMesh::DiffContext::n_dof_indices(), and libMesh::DiffContext::n_vars().

_edge_fe

std::map<FEType, std::unique_ptr<FEAbstract> > libMesh::FEMContext::_edge_fe

protected

Definition at line 1170 of file fem_context.h.

Referenced by attach_quadrature_rules(), edge_fe_reinit(), init_internal_data(), and set_jacobian_tolerance().

_edge_fe_var

std::vector<FEAbstract *> libMesh::FEMContext::_edge_fe_var

protected

Definition at line 1181 of file fem_context.h.

Referenced by get_edge_fe(), and init_internal_data().

_edge_qrule

std::unique_ptr<QBase> libMesh::FEMContext::_edge_qrule

protected

Quadrature rules for element edges.

If the FEM context is told to prepare for edge integration on 3D elements, it will try to find a quadrature rule that correctly integrates all variables. Because edge rules only apply to 3D elements, we don't need to worry about multiple dimensions

Definition at line 1233 of file fem_context.h.

Referenced by attach_quadrature_rules(), get_edge_qrule(), use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

_elem

const Elem* libMesh::FEMContext::_elem

protected

Current element for element_* to examine.

Definition at line 1192 of file fem_context.h.

Referenced by get_elem(), get_elem_dim(), has_elem(), and set_elem().

_elem_dim

unsigned char libMesh::FEMContext::_elem_dim

protected

Cached dimension of this->_elem.

Definition at line 1202 of file fem_context.h.

Referenced by get_elem_dim(), and set_elem().

_elem_dims

std::set<unsigned char> libMesh::FEMContext::_elem_dims

protected

Cached dimensions of elements in the mesh, plus dimension 0 if SCALAR variables are in use.

Definition at line 1208 of file fem_context.h.

Referenced by attach_quadrature_rules(), elem_dimensions(), init_internal_data(), use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

_elem_fixed_solution

DenseVector<Number> libMesh::DiffContext::_elem_fixed_solution

protectedinherited

Element by element components of nonlinear_solution at a fixed point in a timestep, for optional use by e.g.

stabilized methods

Definition at line 604 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_fixed_solution().

_elem_fixed_subsolutions

std::vector<DenseSubVector<Number> > libMesh::DiffContext::_elem_fixed_subsolutions

protectedinherited

Definition at line 605 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), fixed_point_gradient(), fixed_point_hessian(), fixed_point_value(), and libMesh::DiffContext::get_elem_fixed_solution().

_elem_jacobian

DenseMatrix<Number> libMesh::DiffContext::_elem_jacobian

protectedinherited

Element jacobian: derivatives of elem_residual with respect to elem_solution.

Only initialized if _have_local_matrices

Definition at line 616 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_jacobian().

_elem_qoi

std::vector<Number> libMesh::DiffContext::_elem_qoi

protectedinherited

Element quantity of interest contributions.

Definition at line 621 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_qois().

_elem_qoi_derivative

std::vector<DenseVector<Number> > libMesh::DiffContext::_elem_qoi_derivative

protectedinherited

Element quantity of interest derivative contributions.

Definition at line 626 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_qoi_derivatives().

_elem_qoi_subderivatives

std::vector<std::vector<DenseSubVector<Number> > > libMesh::DiffContext::_elem_qoi_subderivatives

protectedinherited

Definition at line 627 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), libMesh::DiffContext::get_qoi_derivatives(), and pre_fe_reinit().

_elem_residual

DenseVector<Number> libMesh::DiffContext::_elem_residual

protectedinherited

Element residual vector.

Definition at line 610 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_residual().

_elem_solution

DenseVector<Number> libMesh::DiffContext::_elem_solution

protectedinherited

Element by element components of nonlinear_solution as adjusted by a time_solver.

Definition at line 582 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_solution().

_elem_solution_accel

DenseVector<Number> libMesh::DiffContext::_elem_solution_accel

protectedinherited

Element by element components of du/dt as adjusted by a time_solver.

Definition at line 596 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_solution_accel().

_elem_solution_rate

DenseVector<Number> libMesh::DiffContext::_elem_solution_rate

protectedinherited

Element by element components of du/dt as adjusted by a time_solver.

Definition at line 589 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_solution_rate().

_elem_subjacobians

std::vector<std::vector<DenseSubMatrix<Number> > > libMesh::DiffContext::_elem_subjacobians

protectedinherited

Definition at line 634 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_jacobian().

_elem_subresiduals

std::vector<DenseSubVector<Number> > libMesh::DiffContext::_elem_subresiduals

protectedinherited

Element residual subvectors and (if _have_local_matrices) Jacobian submatrices.

Definition at line 633 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_residual().

_elem_subsolution_accels

std::vector<DenseSubVector<Number> > libMesh::DiffContext::_elem_subsolution_accels

protectedinherited

Definition at line 597 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_solution_accel().

_elem_subsolution_rates

std::vector<DenseSubVector<Number> > libMesh::DiffContext::_elem_subsolution_rates

protectedinherited

Definition at line 590 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), and libMesh::DiffContext::get_elem_solution_rate().

_elem_subsolutions

std::vector<DenseSubVector<Number> > libMesh::DiffContext::_elem_subsolutions

protectedinherited

Definition at line 583 of file diff_context.h.

Referenced by libMesh::DiffContext::DiffContext(), libMesh::DiffContext::get_elem_solution(), interior_curl(), interior_div(), point_curl(), point_gradient(), point_hessian(), point_value(), and side_gradient().

_element_fe

std::vector<std::map<FEType, std::unique_ptr<FEAbstract> > > libMesh::FEMContext::_element_fe

protected

Finite element objects for each variable's interior, sides and edges.

We store FE objects for each element dimension present in the mesh, except for edge_fe which only applies to 3D elements.

Definition at line 1168 of file fem_context.h.

Referenced by attach_quadrature_rules(), elem_fe_reinit(), init_internal_data(), and set_jacobian_tolerance().

_element_fe_var

std::vector<std::vector<FEAbstract *> > libMesh::FEMContext::_element_fe_var

protected

Pointers to the same finite element objects, but indexed by variable number.

We store FE objects for each element dimension present in the mesh, except for edge_fe_var which only applies for 3D elements.

Definition at line 1179 of file fem_context.h.

Referenced by get_element_fe(), and init_internal_data().

_element_qrule

std::vector<std::unique_ptr<QBase> > libMesh::FEMContext::_element_qrule

protected

Quadrature rule for element interior.

The FEM context will try to find a quadrature rule that correctly integrates all variables. We prepare quadrature rules for each element dimension in the mesh.

Definition at line 1216 of file fem_context.h.

Referenced by attach_quadrature_rules(), get_element_qrule(), use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

_extra_quadrature_order

int libMesh::FEMContext::_extra_quadrature_order

protected

The extra quadrature order for this context.

Definition at line 1238 of file fem_context.h.

Referenced by init_internal_data(), use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

_have_local_matrices

const bool libMesh::DiffContext::_have_local_matrices

protectedinherited

Whether we have local matrices allocated/initialized.

Definition at line 576 of file diff_context.h.

Referenced by libMesh::DiffContext::get_elem_jacobian(), and pre_fe_reinit().

_localized_vectors

std::map<const NumericVector<Number> *, std::pair<DenseVector<Number>, std::vector<DenseSubVector<Number> > > > libMesh::DiffContext::_localized_vectors

protectedinherited

Contains pointers to vectors the user has asked to be localized, keyed with pairs of element localized versions of that vector and per variable views.

Definition at line 571 of file diff_context.h.

Referenced by libMesh::DiffContext::add_localized_vector(), libMesh::DiffContext::get_localized_subvector(), libMesh::DiffContext::get_localized_vector(), and pre_fe_reinit().

_mesh_sys

System* libMesh::FEMContext::_mesh_sys

protected

System from which to acquire moving mesh information.

Definition at line 1059 of file fem_context.h.

Referenced by _do_elem_position_set(), elem_edge_reinit(), elem_position_get(), elem_position_set(), elem_reinit(), elem_side_reinit(), get_mesh_system(), and set_mesh_system().

_mesh_x_var

unsigned int libMesh::FEMContext::_mesh_x_var

protected

Variables from which to acquire moving mesh information.

Definition at line 1064 of file fem_context.h.

Referenced by get_mesh_x_var(), and set_mesh_x_var().

_mesh_y_var

unsigned int libMesh::FEMContext::_mesh_y_var

protected

Definition at line 1064 of file fem_context.h.

Referenced by get_mesh_y_var(), and set_mesh_y_var().

_mesh_z_var

unsigned int libMesh::FEMContext::_mesh_z_var

protected

Definition at line 1064 of file fem_context.h.

Referenced by get_mesh_z_var(), and set_mesh_z_var().

_real_fe

std::unique_ptr<FEGenericBase<Real> > libMesh::FEMContext::_real_fe

mutableprotected

Definition at line 1076 of file fem_context.h.

Referenced by cached_fe().

_real_fe_derivative_level

int libMesh::FEMContext::_real_fe_derivative_level

mutableprotected

Definition at line 1078 of file fem_context.h.

Referenced by cached_fe().

_real_fe_is_inf

bool libMesh::FEMContext::_real_fe_is_inf

mutableprotected

Definition at line 1082 of file fem_context.h.

Referenced by cached_fe().

_real_grad_fe

std::unique_ptr<FEGenericBase<RealGradient> > libMesh::FEMContext::_real_grad_fe

mutableprotected

Definition at line 1077 of file fem_context.h.

Referenced by cached_fe().

_real_grad_fe_derivative_level

int libMesh::FEMContext::_real_grad_fe_derivative_level

mutableprotected

Definition at line 1079 of file fem_context.h.

Referenced by cached_fe().

_real_grad_fe_is_inf

bool libMesh::FEMContext::_real_grad_fe_is_inf

mutableprotected

Definition at line 1083 of file fem_context.h.

Referenced by cached_fe().

_side_fe

std::vector<std::map<FEType, std::unique_ptr<FEAbstract> > > libMesh::FEMContext::_side_fe

protected

Definition at line 1169 of file fem_context.h.

Referenced by attach_quadrature_rules(), init_internal_data(), libMesh::DGFEMContext::neighbor_side_fe_reinit(), set_jacobian_tolerance(), and side_fe_reinit().

_side_fe_var

std::vector<std::vector<FEAbstract *> > libMesh::FEMContext::_side_fe_var

protected

Definition at line 1180 of file fem_context.h.

Referenced by get_side_fe(), and init_internal_data().

_side_qrule

std::vector<std::unique_ptr<QBase> > libMesh::FEMContext::_side_qrule

protected

Quadrature rules for element sides The FEM context will try to find a quadrature rule that correctly integrates all variables.

We prepare quadrature rules for each element dimension in the mesh.

Definition at line 1224 of file fem_context.h.

Referenced by attach_quadrature_rules(), get_side_qrule(), use_default_quadrature_rules(), and use_unweighted_quadrature_rules().

edge

unsigned char libMesh::FEMContext::edge

Current edge for edge_* to examine.

Definition at line 1018 of file fem_context.h.

Referenced by get_edge().

elem_solution_accel_derivative

Real libMesh::DiffContext::elem_solution_accel_derivative

inherited

The derivative of elem_solution_accel with respect to the current nonlinear solution, for use by systems with non default mass_residual terms.

Definition at line 510 of file diff_context.h.

Referenced by libMesh::NewmarkSolver::_general_residual(), libMesh::DiffContext::get_elem_solution_accel_derivative(), and libMesh::FirstOrderUnsteadySolver::prepare_accel().

elem_solution_derivative

Real libMesh::DiffContext::elem_solution_derivative

inherited

The derivative of elem_solution with respect to the current nonlinear solution.

Definition at line 496 of file diff_context.h.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), CoupledSystem::element_constraint(), libMesh::EigenTimeSolver::element_residual(), NavierSystem::element_time_derivative(), SolidSystem::element_time_derivative(), CoupledSystem::element_time_derivative(), libMesh::DiffContext::get_elem_solution_derivative(), and libMesh::EigenTimeSolver::side_residual().

elem_solution_rate_derivative

Real libMesh::DiffContext::elem_solution_rate_derivative

inherited

The derivative of elem_solution_rate with respect to the current nonlinear solution, for use by systems with non default mass_residual terms.

Definition at line 503 of file diff_context.h.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::NewmarkSolver::_general_residual(), libMesh::EigenTimeSolver::element_residual(), libMesh::DiffContext::get_elem_solution_rate_derivative(), libMesh::FEMPhysics::mass_residual(), libMesh::DifferentiablePhysics::nonlocal_mass_residual(), and libMesh::EigenTimeSolver::side_residual().

fixed_solution_derivative

Real libMesh::DiffContext::fixed_solution_derivative

inherited

The derivative of elem_fixed_solution with respect to the nonlinear solution, for use by systems constructing jacobians with elem_fixed_solution based methods.

Definition at line 517 of file diff_context.h.

Referenced by libMesh::EulerSolver::_general_residual(), libMesh::Euler2Solver::_general_residual(), libMesh::SteadySolver::_general_residual(), and libMesh::DiffContext::get_fixed_solution_derivative().

side

unsigned char libMesh::FEMContext::side

Current side for side_* to examine.

Definition at line 1013 of file fem_context.h.

Referenced by libMesh::RBConstruction::add_scaled_matrix_and_vector(), assembly_with_dg_fem_context(), AssemblyA0::boundary_assembly(), AssemblyA1::boundary_assembly(), AssemblyF0::boundary_assembly(), AssemblyF1::boundary_assembly(), AssemblyA2::boundary_assembly(), AssemblyF2::boundary_assembly(), get_side(), has_side_boundary_id(), libMesh::RBEIMConstruction::initialize_qp_data(), and side_boundary_ids().

system_time

const Real libMesh::DiffContext::system_time

inherited

This is the time stored in the System class at the time this context was created, i.e.

the time at the beginning of the current timestep. This value gets set in the constructor and unlike DiffContext::time, is not tweaked mid-timestep by transient solvers: it remains equal to the value it was assigned at construction.

Definition at line 490 of file diff_context.h.

Referenced by libMesh::DiffContext::get_system_time().

time

Real libMesh::DiffContext::time

inherited

For time-dependent problems, this is the time t for which the current nonlinear_solution is defined.

FIXME - this needs to be tweaked mid-timestep by all transient solvers!

Definition at line 481 of file diff_context.h.

Referenced by libMesh::DiffContext::get_time(), and libMesh::DiffContext::set_time().

---

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

• include/systems/fem_context.h
• src/systems/fem_context.C