splitRing

Create split ring shape on X-Y plane

Since R2023a

Description

Use the splitRing object to create a split-ring shape centered at the origin on the X-Y plane.

Creation

Syntax

splitringshape = splitRing

splitringshape = splitRing(Name=Value)

Description

splitringshape = splitRing creates a split-ring shape centered at the origin and on the X-Y plane.

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

The table below is a guide to using appropriate Properties with different splitRing shape types and number of rings.

Property	NumRings = 2	NumRings≠2	Type = 'Circle'	Type is polygon
Name	●	●	●	●
Type	●	●	●	●
ReferencePoint	●	●	●	●
NumRings		●	●	●
SideLength		●		●
RingDiameter		●	●
RingDiameterInner	●		●
RingDiameterOuter	●		●
SideLengthInner	●			●
SideLengthOuter	●			●
TraceWidth	●	●	●	●
SplitAngle	●	●	●
SplitSide	●	●		●
SplitGap	●	●	●	●

Properties

Name — Name of split-ring shape

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

Name of the split-ring shape, specified as a character vector or string scalar.

Example: splitringshape = splitRing(Name='splitringshape1')

Data Types: char | string

Type — Shape of split ring

'Circle' (default) | 'Triangle' | 'Square' | 'Hexagon' | 'Octagon'

Shape of split ring, specified as: 'Circle', 'Triangle', 'Square', 'Hexagon', or 'Octagon'.

Example: splitringshape = splitRing(Type='Hexagon')

Data Types: char

ReferencePoint — Reference point

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

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

Example: splitringshape = splitRing(ReferencePoint=[1 1])

Data Types: double

NumRings — Number of rings

2 (default) | positive scalar

Number of rings in the shape, specified as a positive scalar.

Example: rings = splitRing(NumRings = 4)

Data Types: positive integer

SideLength — Side length of split ring when the Type is 'Triangle', 'Square', 'Hexagon', 'Octagon'

[1.5e-3 3e-3 5e-3] (default) | positive vector

Side length of the split ring in meters, specified as a positive scalar.

Example: splitringshape = splitRing(SideLength=[1.4e-3 3.1e-3 5.2e-3 7.7e-3])

Note

The number of elements in SideLength must be the same as the number of rings as set in NumRings

Dependencies

To enable this property, set Type to 'Triangle', 'Hexagon', 'Square', or 'Octagon'.

Data Types: double

RingDiameter — Diameter of the split ring when the Type is Circle

[1.5e-3 3e-3 5e-3] (default) | positive vector

Diameter of the split ring in meters, when the Type is 'Circle', specified as a positive vector.

Example: splitringshape = splitRing(RingDiameter=[1.4e-3 3.1e-3 5.4e-3 7.8e-3])

Note

The number of elements in RingDiameter must be the same as the number of rings as set in NumRings

Dependencies

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

Data Types: double

RingDiameterInner — Diameter of inner ring

0.0015 (default) | positive scalar

Diameter of the inner ring in meters, when the Type is 'Circle', specified as a positive scalar.

Example: splitringshape = splitRing(RingDiameterInner=0.0025)

Note

UseRingDiameterInner only when NumRings is set to 2. Use RingDiameter when NumRings is not equal to 2.

Dependencies

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

Data Types: double

RingDiameterOuter — Diameter of outer ring

0.0030 (default) | positive scalar

Diameter of the outer ring in meters, when Type is 'Circle', specified as a positive scalar.

Example: splitringshape = splitRing(RingDiameterOuter=0.0040)

Note

UseRingDiameterOuter only when NumRings is set to 2. Use RingDiameter when NumRings is not equal to 2.

Dependencies

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

Data Types: double

SideLengthInner — Side length of inner ring

0.0015 (default) | positive scalar

Side length of the inner ring in meters, specified as a positive scalar.

Example: splitringshape = splitRing(SideLengthInner=0.0025)

Note

UseSideLengthInner only when NumRings is set to 2. Use RingDiameter when NumRings is not equal to 2.

Dependencies

To enable this property, set Type to 'Triangle', 'Hexagon', 'Square', or 'Octagon'.

Data Types: double

SideLengthOuter — Side length of outer ring

0.0030 (default) | positive scalar

Side length of the outer ring in meters, specified as a positive scalar.

Example: splitringshape = splitRing(SideLengthOuter=0.0030)

Note

UseSideLengthOuter only when NumRings is set to 2. Use RingDiameter when NumRings is not equal to 2.

Dependencies

To enable this property, set Type to 'Triangle', 'Hexagon', 'Square', or 'Octagon'.

Data Types: double

TraceWidth — Width of all rings

2.0000e-04 (default) | positive scalar

Width of all rings in meters, specified as a positive scalar.

Example: splitringshape = splitRing(TraceWidth=5.0000e-04)

Data Types: double

SplitAngle — Angle of split

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

Angle of the split between the inner and outer ring in degrees, specified as a two-element vector.

Example: splitringshape = splitRing(SplitAngle=[10 10])

Note

The number of elements in SplitAngle must be the same as the number of rings as set in NumRings

Dependencies

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

Data Types: double

SplitSide — Side of split in polygon

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

Side of the split between the inner and outer ring in meters, specified as a two-element vector.

Example: splitringshape = splitRing(SplitSide=[2 2])

Note

The number of elements in Splitside must be the same as the number of rings as set in NumRings

Dependencies

To enable this property, set Type to 'Triangle', 'Hexagon', 'Square', or 'Octagon'.

Data Types: double

SplitGap — Width of split

3.0000e-04 (default) | positive scalar

Width of the split gap in all rings of the split ring in meters, specified as a positive scalar.

Example: splitringshape = splitRing(SplitSide=2.0000e-04)

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
minus	Shape1 - Shape2 for RF PCB shapes
plus	Shape1 + Shape2 for RF PCB shapes
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

Split-Ring Shape with Default Values

Create a default split-ring shape.

splitringshape = splitRing

splitringshape = 
  splitRing with properties:

                 Name: 'mysplitring'
                 Type: 'Circle'
       ReferencePoint: [0 0]
             NumRings: 2
    RingDiameterInner: 0.0015
    RingDiameterOuter: 0.0030
           TraceWidth: 2.0000e-04
             SplitGap: 3.0000e-04
           SplitAngle: [0 0]

View the shape.

show(splitringshape)

Hexagonal Split Ring

Create a hexagonal split ring.

splitringshape = splitRing('Type','Hexagon');
show(splitringshape)

Mesh it with maximum edge length of 0.5 mm.

figure; mesh(splitringshape,'MaxEdgeLength',0.5e-3);

Triangle Shape with Four Split Rings

Create a four-ring split ring, then rotate it

s = splitRing(Type="Triangle",NumRings=4,SideLength=[1.5e-3 3e-3 5e-3 8e-3],SplitSide=[1 1 1 1])

s = 
  splitRing with properties:

              Name: 'mysplitring'
              Type: 'Triangle'
    ReferencePoint: [0 0]
          NumRings: 4
        SideLength: [0.0015 0.0030 0.0050 0.0080]
        TraceWidth: 2.0000e-04
          SplitGap: 3.0000e-04
         SplitSide: [1 1 1 1]

show(s)

s = rotateZ(s,270)

s = 
  splitRing with properties:

              Name: 'mysplitring'
              Type: 'Triangle'
    ReferencePoint: [0 0]
          NumRings: 4
        SideLength: [0.0015 0.0030 0.0050 0.0080]
        TraceWidth: 2.0000e-04
          SplitGap: 3.0000e-04
         SplitSide: [1 1 1 1]

show(s)

Version History

Introduced in R2023a