minus

Carve a shape from other shape

collapse all in page

Syntax

minus(shape1,shape2)
c = minus(shape1,shape2)

Description

minus(shape1,shape2) carves out shape2 from shape1 and plots the resultant shape. Alternatively, you can also use the '-' operator to carve out a shape from other shape (shape1 - shape2).

example

c = minus(shape1,shape2) generates the shape obtained by carving out shape2 from shape1 and returns a polygon object for resultant 2-D shape or a custom 3-D object for resultant 3-D shape. Alternatively, you can also use the '-' operator to carve out a shape from other shape (shape1 - shape2).

example

Examples

collapse all

Open Live Script

Create and view a rectangular shape.

r = antenna.Rectangle;
show(r)

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch. These objects represent PEC, myrectangle.

Create and view a circular shape.

c = antenna.Circle;
show(c)

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch. These objects represent PEC, mycircle.

Carve out the circle from the rectangle and view the resultant shape.

s = r-c;
show(s)

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch. These objects represent PEC, mypolygon.

Open Live Script

This example shows how to create a hollow square nut shape by carving out a sphere from a box shape.

Create and view a spherical shape.

a = shape.Sphere;
show(a)

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch.

Create and view a box shape.

b = shape.Box;
show(b)

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch.

Carve out the sphere from the box and view the resultant shape.

minus(b,a);

Figure contains an axes object. The axes object with xlabel x (m), ylabel y (m) contains 2 objects of type patch.

Input Arguments

collapse all

Shapes to perform subtract operation, specified as objects from the following list:

Example: minus(antenna.Rectangle,antenna.Circle)

Example: minus(shape.Box,shape.Sphere)

Output Arguments

collapse all

Resultant shape after carving out shape2 from shape1, returned as one of the following shape objects:

Example: antenna.Polygon

Example: shape.Polygon

Example: shape.Custom3D

Version History

Introduced in R2017a

See Also

| | | | | | | | | | | |