---

Sundance::EquationSet Class Reference

#include <EquationSet.h>

List of all members.

Public Methods

• EquationSet ()

  empty ctor
  
  

• EquationSet (const ExprArray &test, const ExprArray &unk, const Expr &integral)

  construct an EquationSet given a variational equation with no replace-style essential boundary conditions.
  
  

• EquationSet (const ExprArray &test, const ExprArray &unk, const Expr &integral, const EssentialBC &bc)

  construct an EquationSet given a variational equation plus replace-style essential boundary conditions.
  
  

• const TSFArray< CellSet > & getCellSets () const

  get the list of cell sets used by the equations
  
  

• const TSFArray< WeakForm > & oneFormList (int cellSet) const

  get the list of one-forms that apply on the given cell set
  
  

• const TSFArray< WeakForm > & twoFormList (int cellSet) const

  get the list of two-forms that apply on the given cell set
  
  

• const TSFArray< ParametricMatrixElement > & getParametricElements (int br, int bc) const

  get the unmeshed matrix elements for a block
  
  

• const TSFArray< ParametricVectorElement > & getParametricElements (int br) const

  get the unmeshed vector elements for a block
  
  

• AbstractFunctionSpace createRowSpace (int blockRow, const Mesh &mesh) const

  create a discrete function space for the blockRow-th block of the row space.
  
  

• AbstractFunctionSpace createColSpace (int blockCol, const Mesh &mesh) const

  create a discrete function space for the blockCol-th block of the column space.
  
  

• int numBlockRows () const

  return the number of block rows
  
  

• int numBlockCols () const

  return the number of block columns
  
  

• int getReducedTestID (int blockRow, int testID) const

  map a funcID of a test function to the reduced testID on the blockRow-th block
  
  

• int getReducedUnkID (int blockCol, int unkID) const

  map a funcID of a unknown function to the reduced unkID on the blockCol-th block
  
  

• int numTestParameters (int blockRow) const

  return the number of parametric equations in a block row
  
  

• int numUnknownParameters (int blockCol) const

  return the number of parametric unknowns in a block col
  
  

• bool isParametricRow (int blockRow) const

  indicate whether the blockRow-th row is a parametric constraint
  
  

• bool isParametricColumn (int blockCol) const

  indicate whether the blockCol-th column is a parametric variable
  
  

• bool isZeroBlock (int blockRow, int blockCol) const

  indicate whether the (blockRow, blockCol) block of the system matrix is identically zero.
  
  

• bool isZeroBlock (int blockRow) const

  indicate whether the blockRow-th block of the system vector is identically zero.
  
  

• XMLObject toXML () const

  write to XML
  
  

Private Methods

• void init (const Expr &integral, const EssentialBC &bc)

  initialization steps common to all ctors
  
  

• void addOneForm (int cs, int blockRow, const Expr &var, const Expr &coeff, const QuadratureFamily &quad, bool isBC)

  add a new one-form to the one-form list.
  
  

• void addTwoForm (int cs, int blockRow, int blockCol, const Expr &var, const Expr &unk, const Expr &coeff, const QuadratureFamily &quad, bool isBC)

  add a new two-form to the one-form list.
  
  

• void groupByCellSet (const Expr &eqns, TSFArray< TSFArray< QuadratureFamily > > &quad, TSFArray< ExprArray > &exprs, ExprArray &parametricTermsInsideIntegrals, ExprArray &fieldTermsOutsideIntegrals)

  group quadrature rules and expressions by cell set
  
  

Private Attributes

• TSFArray< CellSet > cellSets_
• ExprArray test_
• ExprArray unk_
• TSFArray< TSFArray< WeakForm > > oneForms_
• TSFArray< TSFArray< WeakForm > > twoForms_
• TSFArray< TSFArray< TSFArray<
  ParametricMatrixElement > > > parametricMatrixBlocks_
• TSFArray< TSFArray< ParametricVectorElement > > parametricVectorBlocks_
• TSFArray< TSFHashtable< int,
  int > > testIDToReducedIDMap_
• TSFArray< TSFHashtable< int,
  int > > unkIDToReducedIDMap_
• TSFArray< bool > isParametricRow_
• TSFArray< bool > isParametricColumn_
• TSFArray< int > numTestParameters_
• TSFArray< int > numUnknownParameters_
• TSFArray< TSFArray< bool > > isZeroBlockMatrix_
• TSFArray< bool > isZeroBlockVector_
• TSFArray< TSFArray< TSFNonDupArray<
  BasisFamily > > > testBasisList_
• TSFArray< TSFArray< TSFNonDupArray<
  BasisFamily > > > unkBasisList_
• TSFArray< TSFArray< TSFNonDupArray<
  CellSet > > > testDomainList_
• TSFArray< TSFArray< TSFNonDupArray<
  CellSet > > > unkDomainList_

Static Private Attributes

• bool verbose_

Related Functions

(Note that these are not member functions.)

• ostream & operator<< (ostream &os, EquationSet &eqnSet)

  write to a stream
  
  

---

Detailed Description

Equation set is a collection of all variational equations and boundary conditions pertinent to a problem, listed by CellSet. An equationSet also contains a specification of the block structure of the unknown and test function spaces.

The information contained in an equation set is sufficient to build a table of weak forms for the problem. However, the equation set contains no information about the mesh and thus cannot by itself produce discrete function spaces or DOF maps. The discrete function spaces are created in the createRowSpace and createColSpace methods which take the problem mesh as an argument.

Definition at line 41 of file EquationSet.h.

---

Constructor & Destructor Documentation

Sundance::EquationSet::EquationSet (    )

Sundance::EquationSet::EquationSet (  const ExprArray &    test, const ExprArray &    unk, const Expr &    integral )

The ExprArray arguments specify the block structure of the unknown and test spaces.

Sundance::EquationSet::EquationSet (  const ExprArray &    test, const ExprArray &    unk, const Expr &    integral, const EssentialBC &    bc )

The ExprArray arguments specify the block structure of the unknown and test spaces.

---

Member Function Documentation

const TSFArray<CellSet>& Sundance::EquationSet::getCellSets (    )  const [inline]

Definition at line 62 of file EquationSet.h. References cellSets_.

const TSFArray<WeakForm>& Sundance::EquationSet::oneFormList (  int    cellSet )  const [inline]

Definition at line 65 of file EquationSet.h. References oneForms_.

const TSFArray<WeakForm>& Sundance::EquationSet::twoFormList (  int    cellSet )  const [inline]

Definition at line 69 of file EquationSet.h. References twoForms_.

const TSFArray<ParametricMatrixElement>& Sundance::EquationSet::getParametricElements (  int    br, int    bc )  const [inline]

Definition at line 73 of file EquationSet.h. References parametricMatrixBlocks_.

const TSFArray<ParametricVectorElement>& Sundance::EquationSet::getParametricElements (  int    br )  const [inline]

Definition at line 78 of file EquationSet.h. References parametricVectorBlocks_.

AbstractFunctionSpace Sundance::EquationSet::createRowSpace (  int    blockRow, const Mesh &    mesh )  const

AbstractFunctionSpace Sundance::EquationSet::createColSpace (  int    blockCol, const Mesh &    mesh )  const

int Sundance::EquationSet::numBlockRows (    )  const [inline]

Definition at line 94 of file EquationSet.h. References Sundance::ExprArray::length(), and test_.

int Sundance::EquationSet::numBlockCols (    )  const [inline]

Definition at line 97 of file EquationSet.h. References Sundance::ExprArray::length(), and unk_.

int Sundance::EquationSet::getReducedTestID (  int    blockRow, int    testID )  const

int Sundance::EquationSet::getReducedUnkID (  int    blockCol, int    unkID )  const

int Sundance::EquationSet::numTestParameters (  int    blockRow )  const [inline]

Definition at line 108 of file EquationSet.h. References numTestParameters_.

int Sundance::EquationSet::numUnknownParameters (  int    blockCol )  const [inline]

Definition at line 112 of file EquationSet.h. References numUnknownParameters_.

bool Sundance::EquationSet::isParametricRow (  int    blockRow )  const [inline]

Definition at line 117 of file EquationSet.h. References isParametricRow_.

bool Sundance::EquationSet::isParametricColumn (  int    blockCol )  const [inline]

Definition at line 122 of file EquationSet.h. References isParametricColumn_.

bool Sundance::EquationSet::isZeroBlock (  int    blockRow, int    blockCol )  const [inline]

Zero blocks are identified during parsing of the symbolic equation at build time Definition at line 129 of file EquationSet.h. References isZeroBlockMatrix_. Referenced by Sundance::DistributedMatrixBuilder::isZeroBlock().

bool Sundance::EquationSet::isZeroBlock (  int    blockRow )  const [inline]

Zero blocks are identified during parsing of the symbolic equation at build time Definition at line 135 of file EquationSet.h. References isZeroBlockVector_.

XMLObject Sundance::EquationSet::toXML (    )  const

Referenced by operator<<().

void Sundance::EquationSet::init (  const Expr &    integral, const EssentialBC &    bc )  [private]

void Sundance::EquationSet::addOneForm (  int    cs, int    blockRow, const Expr &    var, const Expr &    coeff, const QuadratureFamily &    quad, bool    isBC )  [private]

void Sundance::EquationSet::addTwoForm (  int    cs, int    blockRow, int    blockCol, const Expr &    var, const Expr &    unk, const Expr &    coeff, const QuadratureFamily &    quad, bool    isBC )  [private]

void Sundance::EquationSet::groupByCellSet (  const Expr &    eqns, TSFArray< TSFArray< QuadratureFamily > > &    quad, TSFArray< ExprArray > &    exprs, ExprArray &    parametricTermsInsideIntegrals, ExprArray &    fieldTermsOutsideIntegrals )  [private]

---

Friends And Related Function Documentation

ostream & operator<< (  ostream &    os, EquationSet &    eqnSet )  [related]

Definition at line 234 of file EquationSet.h. References toXML().

---

Member Data Documentation

TSFArray<CellSet> Sundance::EquationSet::cellSets_ [private]

Definition at line 168 of file EquationSet.h. Referenced by getCellSets().

ExprArray Sundance::EquationSet::test_ [private]

Definition at line 171 of file EquationSet.h. Referenced by numBlockRows().

ExprArray Sundance::EquationSet::unk_ [private]

Definition at line 174 of file EquationSet.h. Referenced by numBlockCols().

TSFArray<TSFArray<WeakForm> > Sundance::EquationSet::oneForms_ [private]

Definition at line 177 of file EquationSet.h. Referenced by oneFormList().

TSFArray<TSFArray<WeakForm> > Sundance::EquationSet::twoForms_ [private]

Definition at line 180 of file EquationSet.h. Referenced by twoFormList().

TSFArray<TSFArray<TSFArray<ParametricMatrixElement> > > Sundance::EquationSet::parametricMatrixBlocks_ [private]

Definition at line 184 of file EquationSet.h. Referenced by getParametricElements().

TSFArray<TSFArray<ParametricVectorElement> > Sundance::EquationSet::parametricVectorBlocks_ [private]

Definition at line 188 of file EquationSet.h. Referenced by getParametricElements().

TSFArray<TSFHashtable<int, int> > Sundance::EquationSet::testIDToReducedIDMap_ [private]

Definition at line 193 of file EquationSet.h.

TSFArray<TSFHashtable<int, int> > Sundance::EquationSet::unkIDToReducedIDMap_ [private]

Definition at line 197 of file EquationSet.h.

TSFArray<bool> Sundance::EquationSet::isParametricRow_ [private]

Definition at line 200 of file EquationSet.h. Referenced by isParametricRow().

TSFArray<bool> Sundance::EquationSet::isParametricColumn_ [private]

Definition at line 203 of file EquationSet.h. Referenced by isParametricColumn().

TSFArray<int> Sundance::EquationSet::numTestParameters_ [private]

Definition at line 206 of file EquationSet.h. Referenced by numTestParameters().

TSFArray<int> Sundance::EquationSet::numUnknownParameters_ [private]

Definition at line 209 of file EquationSet.h. Referenced by numUnknownParameters().

TSFArray<TSFArray<bool> > Sundance::EquationSet::isZeroBlockMatrix_ [private]

Definition at line 212 of file EquationSet.h. Referenced by isZeroBlock().

TSFArray<bool> Sundance::EquationSet::isZeroBlockVector_ [private]

Definition at line 215 of file EquationSet.h. Referenced by isZeroBlock().

TSFArray<TSFArray<TSFNonDupArray<BasisFamily> > > Sundance::EquationSet::testBasisList_ [private]

Definition at line 218 of file EquationSet.h.

TSFArray<TSFArray<TSFNonDupArray<BasisFamily> > > Sundance::EquationSet::unkBasisList_ [private]

Definition at line 221 of file EquationSet.h.

TSFArray<TSFArray<TSFNonDupArray<CellSet> > > Sundance::EquationSet::testDomainList_ [private]

Definition at line 224 of file EquationSet.h.

TSFArray<TSFArray<TSFNonDupArray<CellSet> > > Sundance::EquationSet::unkDomainList_ [private]

Definition at line 227 of file EquationSet.h.

bool Sundance::EquationSet::verbose_ [static, private]

Definition at line 230 of file EquationSet.h.

---

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

• EquationSet.h

---

Contact:

Kevin Long (krlong@ca.sandia.gov)


Documentation generated by