minus

Carve a shape from other shape

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).

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).

Examples

Carve out Circle from Rectangle

Create and view a rectangular shape.

r = antenna.Rectangle;
show(r)

Create and view a circular shape.

c = antenna.Circle;
show(c)

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

s = r-c;
show(s)

Create Hollow Square Nut Shape

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)

Create and view a box shape.

b = shape.Box;
show(b)

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

minus(b,a);

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.Sphere

Output Arguments

c — Resultant shape

antenna.Polygon | shape.Polygon | shape.Custom3D

2-D or 3-D shape obtained after carving out shape2 from shape1.

Example: antenna.Polygon

Example: shape.Polygon

Example: shape.Custom3D

Version History

Introduced in R2017a