Conical product quadrature rules for Tri and Tet elements. More...
#include <quadrature_conical.h>
Public Member Functions | |
QConical (unsigned int d, Order o=INVALID_ORDER) | |
QConical (const QConical &)=default | |
QConical (QConical &&)=default | |
QConical & | operator= (const QConical &)=default |
QConical & | operator= (QConical &&)=default |
virtual | ~QConical ()=default |
virtual QuadratureType | type () const override |
ElemType | get_elem_type () const |
unsigned int | get_p_level () const |
unsigned int | n_points () const |
unsigned int | get_dim () const |
const std::vector< Point > & | get_points () const |
std::vector< Point > & | get_points () |
const std::vector< Real > & | get_weights () const |
std::vector< Real > & | get_weights () |
Point | qp (const unsigned int i) const |
Real | w (const unsigned int i) const |
virtual void | init (const ElemType type=INVALID_ELEM, unsigned int p_level=0) |
virtual void | init (const Elem &elem, const std::vector< Real > &vertex_distance_func, unsigned int p_level=0) |
Order | get_order () const |
void | print_info (std::ostream &os=libMesh::out) const |
void | scale (std::pair< Real, Real > old_range, std::pair< Real, Real > new_range) |
virtual bool | shapes_need_reinit () |
Static Public Member Functions | |
static std::unique_ptr< QBase > | build (const std::string &name, const unsigned int dim, const Order order=INVALID_ORDER) |
static std::unique_ptr< QBase > | build (const QuadratureType qt, const unsigned int dim, const Order order=INVALID_ORDER) |
static void | print_info (std::ostream &out=libMesh::out) |
static std::string | get_info () |
static unsigned int | n_objects () |
static void | enable_print_counter_info () |
static void | disable_print_counter_info () |
Public Attributes | |
bool | allow_rules_with_negative_weights |
Protected Types | |
typedef std::map< std::string, std::pair< unsigned int, unsigned int > > | Counts |
Protected Member Functions | |
virtual void | init_0D (const ElemType type=INVALID_ELEM, unsigned int p_level=0) |
void | tensor_product_quad (const QBase &q1D) |
void | tensor_product_hex (const QBase &q1D) |
void | tensor_product_prism (const QBase &q1D, const QBase &q2D) |
void | increment_constructor_count (const std::string &name) |
void | increment_destructor_count (const std::string &name) |
Protected Attributes | |
unsigned int | _dim |
Order | _order |
ElemType | _type |
unsigned int | _p_level |
std::vector< Point > | _points |
std::vector< Real > | _weights |
Static Protected Attributes | |
static Counts | _counts |
static Threads::atomic< unsigned int > | _n_objects |
static Threads::spin_mutex | _mutex |
static bool | _enable_print_counter = true |
Private Member Functions | |
virtual void | init_1D (const ElemType, unsigned int=0) override |
virtual void | init_2D (const ElemType _type=INVALID_ELEM, unsigned int p_level=0) override |
virtual void | init_3D (const ElemType _type=INVALID_ELEM, unsigned int p_level=0) override |
void | conical_product_tri (unsigned int p) |
void | conical_product_tet (unsigned int p) |
void | conical_product_pyramid (unsigned int p) |
Conical product quadrature rules for Tri and Tet elements.
This class implements the so-called conical product quadrature rules for Tri and Tet elements. These rules are generally non-optimal in the number of evaluation points, but have the following nice properties: .) All positive weights. .) Easily constructed for any order given the underlying 1D Gauss and Jacobi quadrature rules. The construction of these rules is given by e.g. A. H. Stroud, "Approximate Calculation of Multiple Integrals.", 1972.
Definition at line 43 of file quadrature_conical.h.
|
protectedinherited |
Data structure to log the information. The log is identified by the class name.
Definition at line 117 of file reference_counter.h.
|
inline |
Constructor. Declares the order of the quadrature rule.
Definition at line 50 of file quadrature_conical.h.
|
default |
Copy/move ctor, copy/move assignment operator, and destructor are all explicitly defaulted for this simple class.
|
default |
|
virtualdefault |
|
staticinherited |
Builds a specific quadrature rule based on the name
string. This enables selection of the quadrature rule at run-time. The input parameter name
must be mappable through the Utility::string_to_enum<>()
function.
This function allocates memory, therefore a std::unique_ptr<QBase>
is returned so that the user does not accidentally leak it.
Definition at line 40 of file quadrature_build.C.
References libMesh::QBase::_dim, libMesh::QBase::_order, and libMesh::QBase::type().
Referenced by libMesh::InfFE< Dim, T_radial, T_map >::attach_quadrature_rule().
|
staticinherited |
Builds a specific quadrature rule based on the QuadratureType. This enables selection of the quadrature rule at run-time.
This function allocates memory, therefore a std::unique_ptr<QBase>
is returned so that the user does not accidentally leak it.
Definition at line 51 of file quadrature_build.C.
References libMesh::QBase::_dim, libMesh::QBase::_order, libMesh::FIRST, libMesh::FORTYTHIRD, libMesh::out, libMesh::QCLOUGH, libMesh::QCONICAL, libMesh::QGAUSS, libMesh::QGAUSS_LOBATTO, libMesh::QGRID, libMesh::QGRUNDMANN_MOLLER, libMesh::QJACOBI_1_0, libMesh::QJACOBI_2_0, libMesh::QMONOMIAL, libMesh::QSIMPSON, libMesh::QTRAP, libMesh::THIRD, and libMesh::TWENTYTHIRD.
|
private |
Implementation of conical product rule for a Pyramid in 3D of order = _order+2*p.
Definition at line 181 of file quadrature_conical.C.
References libMesh::QBase::_order, libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::get_dim(), libMesh::QBase::n_points(), libMesh::QBase::qp(), libMesh::Real, and libMesh::QBase::w().
Referenced by init_3D().
|
private |
Implementation of conical product rule for a Tet in 3D of order = _order+2*p.
Definition at line 104 of file quadrature_conical.C.
References libMesh::QBase::_order, libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::get_dim(), libMesh::QBase::n_points(), libMesh::QBase::qp(), libMesh::QBase::scale(), and libMesh::QBase::w().
Referenced by init_3D().
|
private |
Implementation of conical product rule for a Tri in 2D of order = _order+2*p.
Definition at line 53 of file quadrature_conical.C.
References libMesh::QBase::_order, libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::get_dim(), libMesh::QBase::n_points(), libMesh::QBase::qp(), libMesh::QBase::scale(), and libMesh::QBase::w().
Referenced by init_2D().
|
staticinherited |
Definition at line 106 of file reference_counter.C.
References libMesh::ReferenceCounter::_enable_print_counter.
Referenced by libMesh::LibMeshInit::LibMeshInit().
|
staticinherited |
Methods to enable/disable the reference counter output from print_info()
Definition at line 100 of file reference_counter.C.
References libMesh::ReferenceCounter::_enable_print_counter.
|
inlineinherited |
Definition at line 136 of file quadrature.h.
References libMesh::QBase::_dim.
Referenced by libMesh::InfFE< Dim, T_radial, T_map >::attach_quadrature_rule(), conical_product_pyramid(), conical_product_tet(), and conical_product_tri().
|
inlineinherited |
Definition at line 117 of file quadrature.h.
References libMesh::QBase::_type.
|
staticinherited |
Gets a string containing the reference information.
Definition at line 47 of file reference_counter.C.
References libMesh::ReferenceCounter::_counts, and libMesh::Quality::name().
Referenced by libMesh::ReferenceCounter::print_info().
|
inlineinherited |
Definition at line 203 of file quadrature.h.
References libMesh::QBase::_order, and libMesh::QBase::_p_level.
Referenced by libMesh::InfFE< Dim, T_radial, T_map >::attach_quadrature_rule().
|
inlineinherited |
Definition at line 122 of file quadrature.h.
References libMesh::QBase::_p_level.
|
inlineinherited |
std::vector
containing the quadrature point locations in reference element space. Definition at line 142 of file quadrature.h.
References libMesh::QBase::_points.
Referenced by libMesh::QClough::init_1D(), init_1D(), libMesh::QMonomial::init_1D(), libMesh::QGrundmann_Moller::init_1D(), libMesh::QClough::init_2D(), libMesh::QGauss::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGauss::init_3D(), and libMesh::QMonomial::init_3D().
|
inlineinherited |
std::vector
containing the quadrature point locations in reference element space as a writable reference. Definition at line 148 of file quadrature.h.
References libMesh::QBase::_points.
|
inlineinherited |
std::vector
containing the quadrature weights. Definition at line 154 of file quadrature.h.
References libMesh::QBase::_weights.
Referenced by libMesh::QClough::init_1D(), init_1D(), libMesh::QMonomial::init_1D(), libMesh::QGrundmann_Moller::init_1D(), libMesh::QClough::init_2D(), libMesh::QGauss::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGauss::init_3D(), and libMesh::QMonomial::init_3D().
|
inlineinherited |
std::vector
containing the quadrature weights. Definition at line 160 of file quadrature.h.
References libMesh::QBase::_weights.
|
inlineprotectedinherited |
Increments the construction counter. Should be called in the constructor of any derived class that will be reference counted.
Definition at line 181 of file reference_counter.h.
References libMesh::ReferenceCounter::_counts, libMesh::Quality::name(), and libMesh::Threads::spin_mtx.
Referenced by libMesh::ReferenceCountedObject< RBParametrized >::ReferenceCountedObject().
|
inlineprotectedinherited |
Increments the destruction counter. Should be called in the destructor of any derived class that will be reference counted.
Definition at line 194 of file reference_counter.h.
References libMesh::ReferenceCounter::_counts, libMesh::Quality::name(), and libMesh::Threads::spin_mtx.
Referenced by libMesh::ReferenceCountedObject< RBParametrized >::~ReferenceCountedObject().
|
virtualinherited |
Initializes the data structures for a quadrature rule for an element of type type
.
Definition at line 28 of file quadrature.C.
References libMesh::QBase::_dim, libMesh::QBase::_p_level, libMesh::QBase::_type, libMesh::QBase::init_0D(), libMesh::QBase::init_1D(), libMesh::QBase::init_2D(), and libMesh::QBase::init_3D().
Referenced by libMesh::QBase::init(), libMesh::QClough::init_1D(), libMesh::QMonomial::init_1D(), libMesh::QClough::init_2D(), libMesh::QGaussLobatto::init_2D(), libMesh::QGrid::init_2D(), libMesh::QTrap::init_2D(), libMesh::QSimpson::init_2D(), libMesh::QGauss::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGaussLobatto::init_3D(), libMesh::QTrap::init_3D(), libMesh::QGrid::init_3D(), libMesh::QSimpson::init_3D(), libMesh::QGauss::init_3D(), libMesh::QMonomial::init_3D(), libMesh::QGauss::QGauss(), libMesh::QGaussLobatto::QGaussLobatto(), libMesh::QJacobi::QJacobi(), libMesh::QSimpson::QSimpson(), and libMesh::QTrap::QTrap().
|
virtualinherited |
Initializes the data structures for an element potentially "cut" by a signed distance function. The array vertex_distance_func
contains vertex values of the signed distance function. If the signed distance function changes sign on the vertices, then the element is considered to be cut.) This interface can be extended by derived classes in order to subdivide the element and construct a composite quadrature rule.
Definition at line 72 of file quadrature.C.
References libMesh::QBase::init(), and libMesh::Elem::type().
|
protectedvirtualinherited |
Initializes the 0D quadrature rule by filling the points and weights vectors with the appropriate values. Generally this is just one point with weight 1.
Definition at line 82 of file quadrature.C.
References libMesh::QBase::_points, and libMesh::QBase::_weights.
Referenced by libMesh::QBase::init().
|
overrideprivatevirtual |
The optimal "conical product" rule in 1D is simply Gauss.
Implements libMesh::QBase.
Definition at line 38 of file quadrature_conical.C.
References libMesh::QBase::_order, libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::get_points(), and libMesh::QBase::get_weights().
|
overrideprivatevirtual |
The conical product rules are defined in 2D only for Tris.
Reimplemented from libMesh::QBase.
Definition at line 27 of file quadrature_conical_2D.C.
References conical_product_tri(), libMesh::TRI3, and libMesh::TRI6.
|
overrideprivatevirtual |
The conical product rules are defined in 3D only for Tets.
Reimplemented from libMesh::QBase.
Definition at line 27 of file quadrature_conical_3D.C.
References conical_product_pyramid(), conical_product_tet(), libMesh::PYRAMID13, libMesh::PYRAMID14, libMesh::PYRAMID5, libMesh::TET10, and libMesh::TET4.
|
inlinestaticinherited |
Prints the number of outstanding (created, but not yet destroyed) objects.
Definition at line 83 of file reference_counter.h.
References libMesh::ReferenceCounter::_n_objects.
|
inlineinherited |
Definition at line 127 of file quadrature.h.
References libMesh::QBase::_points.
Referenced by libMesh::ExactSolution::_compute_error(), libMesh::System::calculate_norm(), libMesh::FirstOrderUnsteadySolver::compute_second_order_eqns(), conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QBase::print_info(), libMesh::QBase::tensor_product_hex(), libMesh::QBase::tensor_product_prism(), and libMesh::QBase::tensor_product_quad().
|
staticinherited |
Prints the reference information, by default to libMesh::out
.
Definition at line 87 of file reference_counter.C.
References libMesh::ReferenceCounter::_enable_print_counter, and libMesh::ReferenceCounter::get_info().
|
inlineinherited |
Prints information relevant to the quadrature rule, by default to libMesh::out.
Definition at line 378 of file quadrature.h.
References libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::n_points(), and libMesh::Real.
Referenced by libMesh::operator<<().
|
inlineinherited |
Definition at line 165 of file quadrature.h.
References libMesh::QBase::_points.
Referenced by conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QBase::tensor_product_hex(), libMesh::QBase::tensor_product_prism(), and libMesh::QBase::tensor_product_quad().
|
inherited |
Maps the points of a 1D quadrature rule defined by "old_range" to another 1D interval defined by "new_range" and scales the weights accordingly.
Definition at line 93 of file quadrature.C.
References libMesh::QBase::_dim, libMesh::QBase::_points, libMesh::QBase::_weights, and libMesh::Real.
Referenced by conical_product_tet(), and conical_product_tri().
|
inlinevirtualinherited |
true
if the shape functions need to be recalculated, false
otherwise.This may be required if the number of quadrature points or their position changes.
Definition at line 231 of file quadrature.h.
|
protectedinherited |
Computes the tensor product quadrature rule [q1D x q1D x q1D] from the 1D rule q1D. Used in the init_3D routines for hexahedral element types.
Definition at line 154 of file quadrature.C.
References libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::n_points(), libMesh::QBase::qp(), and libMesh::QBase::w().
Referenced by libMesh::QGaussLobatto::init_3D(), libMesh::QTrap::init_3D(), libMesh::QGrid::init_3D(), libMesh::QSimpson::init_3D(), and libMesh::QGauss::init_3D().
|
protectedinherited |
Computes the tensor product of a 1D quadrature rule and a 2D quadrature rule. Used in the init_3D routines for prismatic element types.
Definition at line 181 of file quadrature.C.
References libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::n_points(), libMesh::QBase::qp(), and libMesh::QBase::w().
Referenced by libMesh::QGrid::init_3D(), libMesh::QTrap::init_3D(), libMesh::QSimpson::init_3D(), and libMesh::QGauss::init_3D().
|
protectedinherited |
Constructs a 2D rule from the tensor product of q1D
with itself. Used in the init_2D()
routines for quadrilateral element types.
Definition at line 127 of file quadrature.C.
References libMesh::QBase::_points, libMesh::QBase::_weights, libMesh::QBase::n_points(), libMesh::QBase::qp(), and libMesh::QBase::w().
Referenced by libMesh::QGaussLobatto::init_2D(), libMesh::QTrap::init_2D(), libMesh::QGrid::init_2D(), libMesh::QSimpson::init_2D(), and libMesh::QGauss::init_2D().
|
overridevirtual |
Implements libMesh::QBase.
Definition at line 33 of file quadrature_conical.C.
References libMesh::QCONICAL.
|
inlineinherited |
Definition at line 174 of file quadrature.h.
References libMesh::QBase::_weights.
Referenced by conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QBase::tensor_product_hex(), libMesh::QBase::tensor_product_prism(), and libMesh::QBase::tensor_product_quad().
|
staticprotectedinherited |
Actually holds the data.
Definition at line 122 of file reference_counter.h.
Referenced by libMesh::ReferenceCounter::get_info(), libMesh::ReferenceCounter::increment_constructor_count(), and libMesh::ReferenceCounter::increment_destructor_count().
|
protectedinherited |
The spatial dimension of the quadrature rule.
Definition at line 325 of file quadrature.h.
Referenced by libMesh::QBase::build(), libMesh::QBase::get_dim(), libMesh::QBase::init(), libMesh::QGaussLobatto::QGaussLobatto(), libMesh::QJacobi::QJacobi(), libMesh::QSimpson::QSimpson(), libMesh::QTrap::QTrap(), and libMesh::QBase::scale().
|
staticprotectedinherited |
Flag to control whether reference count information is printed when print_info is called.
Definition at line 141 of file reference_counter.h.
Referenced by libMesh::ReferenceCounter::disable_print_counter_info(), libMesh::ReferenceCounter::enable_print_counter_info(), and libMesh::ReferenceCounter::print_info().
|
staticprotectedinherited |
Mutual exclusion object to enable thread-safe reference counting.
Definition at line 135 of file reference_counter.h.
|
staticprotectedinherited |
The number of objects. Print the reference count information when the number returns to 0.
Definition at line 130 of file reference_counter.h.
Referenced by libMesh::ReferenceCounter::n_objects(), libMesh::ReferenceCounter::ReferenceCounter(), and libMesh::ReferenceCounter::~ReferenceCounter().
|
protectedinherited |
The polynomial order which the quadrature rule is capable of integrating exactly.
Definition at line 331 of file quadrature.h.
Referenced by libMesh::QBase::build(), conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QBase::get_order(), libMesh::QClough::init_1D(), libMesh::QGaussLobatto::init_1D(), init_1D(), libMesh::QGrid::init_1D(), libMesh::QGauss::init_1D(), libMesh::QJacobi::init_1D(), libMesh::QMonomial::init_1D(), libMesh::QGrundmann_Moller::init_1D(), libMesh::QClough::init_2D(), libMesh::QGaussLobatto::init_2D(), libMesh::QGrid::init_2D(), libMesh::QGauss::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGrundmann_Moller::init_2D(), libMesh::QGaussLobatto::init_3D(), libMesh::QGrid::init_3D(), libMesh::QGauss::init_3D(), libMesh::QMonomial::init_3D(), and libMesh::QGrundmann_Moller::init_3D().
|
protectedinherited |
The p-level of the element for which the current values have been computed.
Definition at line 343 of file quadrature.h.
Referenced by libMesh::QBase::get_order(), libMesh::QBase::get_p_level(), and libMesh::QBase::init().
|
protectedinherited |
The locations of the quadrature points in reference element space.
Definition at line 349 of file quadrature.h.
Referenced by conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QGauss::dunavant_rule(), libMesh::QGauss::dunavant_rule2(), libMesh::QBase::get_points(), libMesh::QGrundmann_Moller::gm_rule(), libMesh::QBase::init_0D(), libMesh::QClough::init_1D(), libMesh::QGaussLobatto::init_1D(), init_1D(), libMesh::QTrap::init_1D(), libMesh::QGrid::init_1D(), libMesh::QSimpson::init_1D(), libMesh::QGauss::init_1D(), libMesh::QJacobi::init_1D(), libMesh::QMonomial::init_1D(), libMesh::QGrundmann_Moller::init_1D(), libMesh::QClough::init_2D(), libMesh::QTrap::init_2D(), libMesh::QGrid::init_2D(), libMesh::QSimpson::init_2D(), libMesh::QGauss::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGrid::init_3D(), libMesh::QTrap::init_3D(), libMesh::QGauss::init_3D(), libMesh::QSimpson::init_3D(), libMesh::QMonomial::init_3D(), libMesh::QGrundmann_Moller::init_3D(), libMesh::QGauss::keast_rule(), libMesh::QMonomial::kim_rule(), libMesh::QBase::n_points(), libMesh::QBase::print_info(), libMesh::QBase::qp(), libMesh::QBase::scale(), libMesh::QMonomial::stroud_rule(), libMesh::QBase::tensor_product_hex(), libMesh::QBase::tensor_product_prism(), libMesh::QBase::tensor_product_quad(), and libMesh::QMonomial::wissmann_rule().
|
protectedinherited |
The type of element for which the current values have been computed.
Definition at line 337 of file quadrature.h.
Referenced by libMesh::QBase::get_elem_type(), and libMesh::QBase::init().
|
protectedinherited |
The quadrature weights. The order of the weights matches the ordering of the _points vector.
Definition at line 355 of file quadrature.h.
Referenced by conical_product_pyramid(), conical_product_tet(), conical_product_tri(), libMesh::QGauss::dunavant_rule(), libMesh::QGauss::dunavant_rule2(), libMesh::QBase::get_weights(), libMesh::QGrundmann_Moller::gm_rule(), libMesh::QBase::init_0D(), libMesh::QClough::init_1D(), libMesh::QGaussLobatto::init_1D(), init_1D(), libMesh::QTrap::init_1D(), libMesh::QGrid::init_1D(), libMesh::QSimpson::init_1D(), libMesh::QGauss::init_1D(), libMesh::QJacobi::init_1D(), libMesh::QMonomial::init_1D(), libMesh::QGrundmann_Moller::init_1D(), libMesh::QClough::init_2D(), libMesh::QTrap::init_2D(), libMesh::QGrid::init_2D(), libMesh::QGauss::init_2D(), libMesh::QSimpson::init_2D(), libMesh::QMonomial::init_2D(), libMesh::QGrid::init_3D(), libMesh::QTrap::init_3D(), libMesh::QSimpson::init_3D(), libMesh::QGauss::init_3D(), libMesh::QMonomial::init_3D(), libMesh::QGrundmann_Moller::init_3D(), libMesh::QGauss::keast_rule(), libMesh::QMonomial::kim_rule(), libMesh::QBase::print_info(), libMesh::QBase::scale(), libMesh::QMonomial::stroud_rule(), libMesh::QBase::tensor_product_hex(), libMesh::QBase::tensor_product_prism(), libMesh::QBase::tensor_product_quad(), libMesh::QBase::w(), and libMesh::QMonomial::wissmann_rule().
|
inherited |
Flag (default true) controlling the use of quadrature rules with negative weights. Set this to false to require rules with all positive weights.
Rules with negative weights can be unsuitable for some problems. For example, it is possible for a rule with negative weights to obtain a negative result when integrating a positive function.
A particular example: if rules with negative weights are not allowed, a request for TET,THIRD (5 points) will return the TET,FIFTH (14 points) rule instead, nearly tripling the computational effort required!
Definition at line 246 of file quadrature.h.
Referenced by libMesh::QGrundmann_Moller::init_2D(), libMesh::QGauss::init_3D(), libMesh::QMonomial::init_3D(), and libMesh::QGrundmann_Moller::init_3D().