imat_fem/cat

imat_cs/cat, imat_node/cat, imat_elem/cat, imat_tl/cat


Purpose

Concatenate multiple IMAT_FEM objects into a single one.

Syntax

fout=cat(fem,fem2[,fem3][,fem4][,...])

Description

CAT will concatenate multiple IMAT_FEM objects into a single one. It will check each FEM entity (coordinate system, node, element, and traceline) for duplicate ids (labels). If any duplicates are found, and they are not an exact match (in other words, any of the attributes of that entity are different between the ones with matching labels), an error will result and an empty IMAT_FEM will be returned. If the entities are an exact match, the duplicates will be discarded.

Examples

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

fem =

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

>> fem2=cat(fem,fem,fem);    % The 2nd and 3rd fems are duplicates of the 1st

fem2 =

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

>> whos

Name       Size         Bytes  Class
fem        1x1         164452  imat_fem
fem2       1x1         164452  imat_fem

>> fem2=readunv('fem_file2.unv')

fem2 =

IMAT_FEM Finite Element Model
         1 coordinate system
       192 nodes
        46 elements
         0 tracelines

>> fem3=cat(fem,fem2);    % No duplicate entities in the two models
>> fem3

fem2 =



IMAT_FEM Finite Element Model

         1 coordinate system

       719 nodes

       721 elements

         0 tracelines

See Also

imat_fem/partition, imat_fem/validate