Files
LaGriT/documentation/lagrit_manual/commands/boundary_components.txt
2025-12-17 11:00:57 +08:00

108 lines
3.9 KiB
Plaintext
Executable File

.. _boundary_components:
&nbsp_place_holder;
> **_BOUNDARY_COMPONENTS_**
>
>> Calculate the number of connected components of a mesh. This is useful for
looking for holes in a mesh or as a diagnostic when looking at a single
material (itetclr, imt) and determining if the material is contiguous or
broken into multiple pieces.
>>
>> When the **node** option is invoked, the
boundary_components&nbsp_place_holder; module adds the node attribute
**numbnd** and **id_numb** to the current mesh object to which is written the
node number of a representative node of each outside boundary component. In
this mode 'connected' means that a set of nodes of type 'outside' (itp = 10 or
12) can be traversed via element edges that have both vertices of type
'outside'. This method is not really fool proof in detecting holes in a mesh
since one can traverse from the exterior of a mesh to an interior hole in the
mesh via an edge that is not really a boundary edge. More coding could deal
with this situation. In addition, the number of connected boundary components
and a representative node number from each boundary component is assigned to
the **numbnd** array. The number of nodes in each boundary set is
printed.&nbsp_place_holder;Non-boundary nodes are assigned **numbnd** = 0. If
the itp array is not current, it must be updated first, with the command
**resetpts/itp.** By default resetpts/itp is called when the node option is
invoked so the reset/noreset is optional. The node array **id_numb** is
similar to **numbnd** in that nodes associate with the same boundary component
have the same integer value, however **id_numb** is assigned values starting
with 1 and going up to the number of boundary components in sequential order.
>>
>> When the **node / material_id_number** option is invoked, the distinction
of boundary nodes as defined by itp array value is ignored. Instead, all nodes
with imt = material_id_number are examined and the number of edge connected
components is determined for just that material. Nodes with imt ¹
material_id_number are assigned numbnd = 0.
>>
>> When the **element** option is invoked, the element attribute **numbnd_e**
is added to the current mesh object. The number of connected components of the
mesh is computed where 'connected' means sets of elements can be traversed via
the element faces. The attribute numbnd_e is filled with the element number of
a representitive element of a connected set. In addition, the number of
connected components and a representative element number from each connected
component and the number of elements in each connected component set is
printed.&nbsp_place_holder;When the material_id_number option is invoked, only
elements with itetclr = material_id_number are examined. Elements with itetclr
¹ material_id_number are assigned **numbnd_e** = 0.
>
> FORMAT:
>
>> **boundary_components**- (this syntax is the same as boundary_components /
node)
>
>> **boundary_components** / node / [_reset_|noreset]
>>
>> **boundary_components** / node / material_id_number / [_reset_|noreset]
>
>> **boundary_components** / element / [reset|_noreset_]
>
>> **boundary_components** / element / material_id_number / [reset|_noreset_]
>
> EXAMPLE:
>
>> **boundary_components**
>>
>> **boundary_components** / element / 3
>>
>> &nbsp_place_holder;
![Example: boundary_components /
node](../../images/boundary_component_node.png)
![Example: boundary_components /
element](../../images/boundary_component_element.png)
**boundary_components / node** - note that the interior nodes have numbnd=0 and the nodes of the upper hole have the same value as the outside boundary since the upper hole can be reached by traversing an edge that is connected to the exterior.
**boundary_components / element** - note that the two pieces are have different values for numbnd_e even though element 15 is touching element 6. This is because one cannot traverse from the blue mesh (numbnd_e = 15) to the red mesh (numbnd_e = 24) through faces of the mesh.