imat_fem/partition

imat_node/partition, imat_elem/partition, imat_tl/partition


Purpose

Partition an IMAT_FEM to the supplied DOF list.

Syntax

fem2=partition(fem,doflist,'silent')

Description

PARTITION will partition an IMAT_FEM using the supplied partitioning IDs.

DOFLIST is either an IMAT_CTRACE, numeric vector containing node IDs, or an IMAT_GROUP containing at minimum node IDs.

If DOFLIST is an IMAT_CTRACE or node list, if the FEM does not contain all of the nodes specified in the DOF list, only those that do match the nodes contained in the DOF list will be returned in the partitioned FEM. Elements and tracelines will be partitioned down to only those entities that are completely defined using the partitioned node list.

If DOFLIST is an IMAT_GROUP, PARTITION will first partition the FEM to the nodes in the group, keeping only the elements and tracelines that are fully defined by those nodes. If elements, tracelines, or coordinate systems are also in the group, it will partition the FEM to those entities as well.

Passing in the string 'silent' will suppress message displays.

Examples

>> fem=readunv('fem_file.unv')

fem =

IMAT_FEM Finite Element Model
         1 coordinate system
       527 nodes
       675 elements
         0 tracelines

>> fem2=fem.partition(fem.node.id(1:50))    % Partition down to the first 50 nodes
Partitioning nodes
Partitioning elements

fem2 =

IMAT_FEM Finite Element Model
         1 coordinate system
       477 nodes
       519 elements
         0 tracelines

>>

See Also

imat_fem/cat, imat_fem/validate