addCell

R2026b

Combine two geometries by adding one inside a cell of another

collapse all in page

    Syntax

    g3 = addCell(g1,g2)

    Description

    g3 = addCell(g1,g2) creates nonempty cells inside g1 using all cells of g2. All cells of the geometry g2 must be contained inside one cell of the geometry g1. Ensure that the geometries do not have enclosed cavities and do not intersect one another.

    The combined geometry contains cells from both geometries. The cells from g1 retain their original IDs, while the cells from g2 are numbered starting with N+1, where N is the number of cells in g1.

    Note

    After modifying a geometry, always call generateMesh to ensure a proper mesh association with the new geometry.

    example

    Examples

    collapse all

    Open Live Script

    Create and plot a geometry.

    g1 = multicuboid(2,2,2,Zoffset=-1);
pdegplot(g1,CellLabels="on",FaceAlpha=0.5)

    Cuboid geometry with cell label C1 shown with transparent faces

    Import and plot another geometry.

    g2 = importGeometry("DampingMounts.stl");
pdegplot(g2,CellLabels="on",FaceAlpha=0.5)

    Damping mounts geometry with cell labels C1 through C4

    Scale and move the second geometry to fit entirely within the cube g1.

    g2 = scale(g2,[1/1500 1/1500 1/100]);
g2 = translate(g2,[-0.5 -0.5 -0.5]);

    Plot the result.

    pdegplot(g2,CellLabels="on",FaceAlpha=0.5)

    Damping mounts geometry scaled and translated to fit inside a unit cube

    Combine the geometries and plot the result. The combined geometry g3 contains cells from both geometries. The cell from g1 keeps its ID, and the cells from g2 are now C2, C3, C4, and C5.

    g3 = addCell(g1,g2);
pdegplot(g3,CellLabels="on",FaceAlpha=0.4)

    Combined geometry showing the cube (C1) containing four damping mount cells, with transparent faces

    Input Arguments

    collapse all

    3-D geometry, specified as an fegeometry object or a DiscreteGeometry object.

    3-D geometry, specified as an fegeometry object or a DiscreteGeometry object.

    Output Arguments

    collapse all

    Resulting 3-D geometry, returned as an fegeometry object or a DiscreteGeometry object. If both g1 and g2 are DiscreteGeometry objects, the resulting geometry g3 is also a DiscreteGeometry object. Otherwise, it is an fegeometry object.

    Version History

    Introduced in R2021a

    expand all

    See Also

    Functions

    Objects