~InternalData();
/**
- * Gives write-access to the pointer to a @p InternalData of the @p
+ * Give write-access to the pointer to a @p InternalData of the @p
* base_noth base element.
*/
void set_fe_data(const unsigned int base_no,
typename FiniteElement<dim,spacedim>::InternalDataBase *);
/**
- * Gives read-access to the pointer to a @p InternalData of the @p
+ * Give read-access to the pointer to a @p InternalData of the @p
* base_noth base element.
*/
typename FiniteElement<dim,spacedim>::InternalDataBase &
get_fe_data (const unsigned int base_no) const;
/**
- * Gives read-access to the pointer to an object to which into which the
+ * Give read-access to the pointer to an object to which into which the
* <code>base_no</code>th base element will write its output when calling
* FiniteElement::fill_fe_values() and similar functions.
*/
* @{
*/
/**
- * Gives the interpolation matrix that interpolates a @p fe1- function to a
+ * Compute the interpolation matrix that interpolates a @p fe1-function to a
* @p fe2-function on each cell. The interpolation_matrix needs to be of
* size <tt>(fe2.dofs_per_cell, fe1.dofs_per_cell)</tt>.
*
FullMatrix<number> &interpolation_matrix);
/**
- * Gives the interpolation matrix that interpolates a @p fe1- function to a
+ * Compute the interpolation matrix that interpolates a @p fe1-function to a
* @p fe2-function, and interpolates this to a second @p fe1-function on
* each cell. The interpolation_matrix needs to be of size
* <tt>(fe1.dofs_per_cell, fe1.dofs_per_cell)</tt>.
FullMatrix<number> &interpolation_matrix);
/**
- * Gives the unit matrix minus the back interpolation matrix. The @p
+ * Compute the identity matrix minus the back interpolation matrix. The @p
* difference_matrix needs to be of size <tt>(fe1.dofs_per_cell,
* fe1.dofs_per_cell)</tt>.
*
- * This function gives the matrix that transforms a @p fe1 function $z$ to
+ * This function computes the matrix that transforms a @p fe1 function $z$ to
* $z-I_hz$ where $I_h$ denotes the interpolation operator from the @p fe1
* space to the @p fe2 space. This matrix hence is useful to evaluate error-
* representations where $z$ denotes the dual solution.
*/
//@{
/**
- * Gives the interpolation of a the @p dof1-function @p u1 to a @p
+ * Compute the interpolation of a the @p dof1-function @p u1 to a @p
* dof2-function @p u2. @p dof1 and @p dof2 need to be DoFHandlers based on
* the same triangulation.
*
OutVector &u2);
/**
- * Gives the interpolation of a the @p dof1-function @p u1 to a @p
+ * Compute the interpolation of a the @p dof1-function @p u1 to a @p
* dof2-function @p u2. @p dof1 and @p dof2 need to be DoFHandlers (or
* hp::DoFHandlers) based on the same triangulation. @p constraints is a
* hanging node constraints object corresponding to @p dof2. This object is
OutVector &u2);
/**
- * Gives the interpolation of the @p fe1-function @p u1 to a @p
+ * Compute the interpolation of the @p fe1-function @p u1 to a @p
* fe2-function, and interpolates this to a second @p fe1-function named @p
* u1_interpolated.
*
OutVector &u1_interpolated);
/**
- * Gives the interpolation of the @p dof1-function @p u1 to a @p
+ * Compute the interpolation of the @p dof1-function @p u1 to a @p
* dof2-function, and interpolates this to a second @p dof1-function named
* @p u1_interpolated. @p constraints1 and @p constraints2 are the hanging
* node constraints corresponding to @p dof1 and @p dof2, respectively.
OutVector &u1_interpolated);
/**
- * Gives $(Id-I_h)z_1$ for a given @p dof1-function $z_1$, where $I_h$ is
+ * Compute $(Id-I_h)z_1$ for a given @p dof1-function $z_1$, where $I_h$ is
* the interpolation from @p fe1 to @p fe2. The result $(Id-I_h)z_1$ is
* written into @p z1_difference.
*
OutVector &z1_difference);
/**
- * Gives $(Id-I_h)z_1$ for a given @p dof1-function $z_1$, where $I_h$ is
+ * Compute $(Id-I_h)z_1$ for a given @p dof1-function $z_1$, where $I_h$ is
* the interpolation from @p fe1 to @p fe2. The result $(Id-I_h)z_1$ is
* written into @p z1_difference. @p constraints1 and @p constraints2 are
* the hanging node constraints corresponding to @p dof1 and @p dof2,
OutVector &u2);
/**
- * Gives the patchwise extrapolation of a @p dof1 function @p z1 to a @p
+ * Compute the patchwise extrapolation of a @p dof1 function @p z1 to a @p
* dof2 function @p z2. @p dof1 and @p dof2 need to be DoFHandler objects
* based on the same triangulation. This function is used, for example, for
* extrapolating patchwise a piecewise linear solution to a piecewise
OutVector &z2);
/**
- * Gives the patchwise extrapolation of a @p dof1 function @p z1 to a @p
+ * Compute the patchwise extrapolation of a @p dof1 function @p z1 to a @p
* dof2 function @p z2. @p dof1 and @p dof2 need to be DoFHandler objects
* based on the same triangulation. @p constraints is a hanging node
* constraints object corresponding to @p dof2. This object is necessary