dumbbell

Create dumbbell shape on X-Y plane

Since R2023a

Description

Use the dumbbell object to create a dumbbell shape centered at the origin and on the X-Y plane.

Creation

Syntax

dumbbellshape = dumbbell

dumbbellshape = dumbbell(Name=Value)

Description

dumbbellshape = dumbbell creates a dumbbell shape centered on at the origin and on the X-Y plane.

dumbbellshape = dumbbell(Name=Value) sets Properties using one or more name-value arguments. For example, dumbbell(ReferencePoint=[1 1]) creates a dumbbell shape at the reference point [1 1]. Properties not specified retain their default values.

Properties

Name — Name of dumbbell shape

'mydumbbell' (default) | character vector | string scalar

Name of the dumbbell shape, specified as a character vector or string scalar.

Example: dumbbellshape = dumbbell(Name='dumbbellshape1')

Data Types: char | string

ReferencePoint — Reference point

[0 0] (default) | two-element vector

Reference point of the dumbbell shape in Cartesian coordinates, specified as a two-element vector.

Example: dumbbellshape = dumbbell(ReferencePoint=[1 1])

Data Types: double

Type — Type of dumbbell

'Polygon' (default) | 'Circle'

Type of dumbbell, specified as a 'Polygon' or a 'Circle'.

Example: dumbbellshape = dumbbell(Type='Circle')

Data Types: char

NumSides — Number of sides in polygon

4 (default) | positive scalar

Number of sides in the polygon, specified as a positive scalar in the range [3,8].

Example: dumbbellshape = dumbbell(Numsides=7)

Dependencies

To enable this property, set Type to 'Polygon'.

Data Types: double

ArmLength — Length of dumbbell arm

0.0200 (default) | positive scalar

Length of the dumbbell arm in meters, specified as a positive scalar.

Example: dumbbellshape = dumbbell(ArmLength=0.0400)

Data Types: double

ArmWidth — Width of dumbbell arm

0.00200 (default) | positive scalar

Width of the dumbbell arm in meters, specified as a positive scalar.

Example: dumbbellshape = dumbbell(ArmWidth=0.00400)

Data Types: double

SideLength — Length of polygon sides

0.0100 (default) | positive scalar

Length of the polygon sides in meters, specified as a positive scalar.

Example: dumbbellshape = dumbbell(SideLength=0.0300)

Dependencies

To enable this property, set Type to 'Polygon'.

Data Types: double

Diameter — Diameter of circle

0.0100 (default) | positive scalar

Diameter of the circle in meters, specified as a positive scalar.

Example: dumbbellshape = dumbbell(Diameter=0.0300)

Dependencies

To enable this property, set Type to 'Circle'.

Data Types: double

Object Functions

add	Boolean unite operation on two RF PCB shapes
and	Shape1 & Shape2 for RF PCB shapes
area	Calculate area of RF PCB shape in square meters
intersect	Boolean intersection operation on two RF PCB shapes
mesh	Change and view mesh properties of metal or dielectric in PCB component
mirrorX	Mirror shape along X-axis
mirrorY	Mirror shape along Y-axis
minus	Shape1 - Shape2 for RF PCB shapes
plus	Shape1 + Shape2 for RF PCB shapes
plot	Plot boundary of RF PCB shape
rotate	Rotate RF PCB shape about defined axis
rotateX	Rotate RF PCB shape about x-axis
rotateY	Rotate RF PCB shape about y-axis and angle
rotateZ	Rotate RF PCB shape about z-axis
subtract	Boolean subtraction operation on two RF PCB shapes
scale	Change size of RF PCB shape by fixed amount
show	Display PCB component structure or PCB shape
translate	Move RF PCB shape to new location

Examples

Dumbbell Shape with Default Shape

Create a dumbbell shape with default properties.

dumbbellshape = dumbbell

dumbbellshape = 
  dumbbell with properties:

              Name: 'mydumbbell'
    ReferencePoint: [0 0]
              Type: 'Polygon'
          NumSides: 4
         ArmLength: 0.0200
          ArmWidth: 0.0020
        SideLength: 0.0100

View the dumbbell shape.

show(dumbbellshape)

Circular Dumbbell

Create a dumbbell with circular heads.

dumbbellshape = dumbbell(Type='Circle')

dumbbellshape = 
  dumbbell with properties:

              Name: 'mydumbbell'
    ReferencePoint: [0 0]
              Type: 'Circle'
          Diameter: 0.0100
         ArmLength: 0.0200
          ArmWidth: 0.0020

View the dumbbell shape.

show(dumbbellshape)

Version History

Introduced in R2023a