FEMDocumentation`
FEMDocumentation`

NumericalRegion

NumericalRegion[]

represents data that is used for describing a numerical region.

Details

  • NumericalRegion[] is generated by ToNumericalRegion.
  • In standard output format, the bounding box and a symbolic representation of the region, if any, are shown.
  • NumericalRegion objects are used as input for InitializePDECoefficients, InitializeBoundaryConditions, and ToElementMesh.
  • NumericalRegion contains at least one region representation. NumericalRegion may contain both a symbolic representation of the region and ElementMesh representations of the region.
  • NumericalRegion has the following properties:
  • "BoundaryFunction"gives boundary function of symbolic region
    "BoundaryMesh"gives the boundary mesh if present
    "Bounds"gives the bounds
    "ClearCache"clears the cached meshes
    "Constraints"gives constraints
    "ElementMesh"gives the full mesh if present
    "EmbeddingDimension"gives the embedding dimensions
    "Predicates"gives the predicates of the region
    "PredicateVariables"gives the predicate variables of the region
    "Properties"gives the properties
    "SymbolicRegion"gives the symbolic region representation if any

Examples

Basic Examples  (6)

Load the package:

In[1]:=
Click for copyable input

Create a numerical region of a full region in two dimensions:

In[2]:=
Click for copyable input
Out[2]=

Extract the bounding box:

In[3]:=
Click for copyable input
Out[3]=

Extract the predicates:

In[4]:=
Click for copyable input
Out[4]=

Extract the embedding dimension:

In[5]:=
Click for copyable input
Out[5]=

Create a numerical region of a disk and extract the predicates and the predicate variables:

In[1]:=
Click for copyable input
Out[1]=
Out[1]=
Out[1]=

Extract the symbolic region:

In[2]:=
Click for copyable input
Out[2]=

Extract the boundary function:

In[3]:=
Click for copyable input
Out[3]=

The boundary function returns a value for which the zero contour is the region boundary, negative inside and positive outside.

Plot the boundary function:

In[4]:=
Click for copyable input
Out[4]=

Create a numerical region from an implicit region:

In[1]:=
Click for copyable input

Extract properties from the numerical region:

In[2]:=
Click for copyable input
Out[2]=

Create a numerical region of a full region in two dimensions:

In[1]:=
Click for copyable input
Out[1]=

Extract the ElementMesh:

In[2]:=
Click for copyable input
Out[2]=

Create an ElementMesh with ToElementMesh:

In[3]:=
Click for copyable input
Out[3]=

The ElementMesh field is now populated:

In[4]:=
Click for copyable input
Out[4]=

The boundary ElementMesh is now also populated:

In[5]:=
Click for copyable input
Out[5]=

Clear the meshes and constraints:

In[6]:=
Click for copyable input
In[7]:=
Click for copyable input
Out[7]=

Create a numerical region of a full region in two dimensions:

In[1]:=
Click for copyable input
Out[1]=

Initially, boundary and element meshes are not populated:

In[2]:=
Click for copyable input
Out[2]=

Create a boundary mesh:

In[3]:=
Click for copyable input
Out[3]=

The boundary mesh is now populated:

In[4]:=
Click for copyable input
Out[4]=

Create a mesh:

In[1]:=
Click for copyable input
Out[1]=

Define a NumericalRegion based on the mesh:

In[2]:=
Click for copyable input
Out[2]=

Retrieve the predicate and the symbolic region of the NumericalRegion:

In[3]:=
Click for copyable input
Out[3]=

Retrieve the bounding box and variables:

In[4]:=
Click for copyable input
Out[4]=

The meshes are the same:

In[5]:=
Click for copyable input
Out[5]=

There is no boundary mesh associated:

In[6]:=
Click for copyable input
Out[6]=