add

Boolean unite operation on two shapes

Syntax

add(shape1,shape2)

add(shape1,shape2,RetainShape=0)

c = add(shape1,shape2)

c = add(shape1,shape2,RetainShape=0)

Description

add(shape1,shape2) unites the 2-D or 3-D shape1 and shape2 using the add operation retaining the individual shape boundaries and plots the resultant 2-D or 3-D shape. Adjust the Transparency property of the shapes to view the retained individual shape portion in the resultant shape. Alternatively, you can also use the '+' operator to add the two shapes together.

add(shape1,shape2,RetainShape=0) unites the 3-D shape1 and shape2 using the add operation by merging boundaries of both the shapes and plots the resultant 3-D shape.

c = add(shape1,shape2) unites the 2-D or 3-D shape1 and shape2 using the add operation while retaining the individual shape boundaries and returns a polygon object for the resultant 2-D shape or a custom 3-D object for the resultant 3-D shape. Adjust the Transparency property of the shapes to view the retained individual shape portion in the resultant shape. Alternatively, you can also use the '+' operator to add the two shapes together.

c = add(shape1,shape2,RetainShape=0) unites the 3-D shape1 and shape2 using the add operation by merging boundaries of both the shapes and returns a custom 3-D object for the resultant 3-D shape.

Examples

Add Two Circles

Create and view a default circle.

circle1 = antenna.Circle;

Create a circle with a radius of 1 m. The center of the circle is at [1 0].

circle2 = antenna.Circle(Center=[1 0],Radius=1);

Add the two circles.

add(circle1,circle2)

Add Two Shapes

Create a circle with a radius of 1m. The center of the circle is at [1 0].

circle1 = antenna.Circle(Center=[1 0],Radius=1);

Create a rectangle with a length of 2m and a width of 4m centered at the origin.

rect1 = antenna.Rectangle(Length=2,Width=2);

Add the two shapes together using the + function.

polygon1 = circle1+rect1

polygon1 = 
  Polygon with properties:

        Name: 'mypolygon'
    Vertices: [21x3 double]

show(polygon1)

Add 3-D Shapes

This example shows how to add two 3-D shapes and view the combined shape.

Create a box and a cylindrical shape.

b = shape.Box;
c = shape.Cylinder;
j = add(b,c)

j = 
  Custom3D with properties:

            Name: 'custom3D'
        Vertices: [100x3 double]
           Metal: 'PEC'
      Dielectric: 'Air'
           Color: 'Individual'
    Transparency: 'Individual'
       EdgeColor: 'Individual'

Alternatively, you can use '+' operator to add these shapes.

b + c; 

Input Arguments

shape1,shape2 — Shapes created using shape objects

shape object

2-D and 3-D geometric shapes created using shape objects in Custom 2-D and 3-D Antenna.

Example: antenna.Rectangle,antenna.Circle

Example: shape.Box,shape.Custom3D

Output Arguments

c — Resultant shape

antenna.Polygon object | shape.Polygon object | shape.Custom3D object

Shape obtained after uniting two 2-D or 3-D shapes.

Example: antenna.Polygon

Example: shape.Polygon

Example: shape.Custom3D

Version History

Introduced in R2017a