shapes

Shapes

Since R2025a

Syntax

s = shapes(cadnetobj,Type = 'Surfaces')

Description

s = shapes(cadnetobj,Type = 'Surfaces') returns the shapes of cadnet objectcadnetobj for the entity Type 'Surfaces'.

Examples

Get Shapes of a Cadnet

Use the shapes function to get the shapes data of a cadnet

Read-in a pcb file

Use the pcbFileRead object to read in a file. Accepted file formats are:

• ODB++

• Allegro

• Native

Here we are using a native format file

pfile = pcbFileRead('native_ExampleBoard_Allegro')

pfile = 
  pcbFileRead with properties:

           FileName: 'native_ExampleBoard_Allegro'
          NumLayers: 5
         MetalLayer: [1 3 5]
    DielectricLayer: [2 4]
        LayerHeight: [0.0184 0.0104 0.0092 0.0012 0]
         NumCadnets: 7
       NumPadStacks: 6
      NumComponents: 8
           NumParts: 5

Get cadnet list

cadnetList(pfile)

ans=7×4 table
    CadnetIdx        CadnetName         NumPins    Length
    _________    ___________________    _______    ______

        1        {'Unconnected_Net'}       3           0 
        2        {'NET_OUTV'       }       2       0.615 
        3        {'NET_GND'        }       1        0.46 
        4        {'NET_IN22'       }       2       0.645 
        5        {'NET_IN11'       }       4       0.488 
        6        {'NET_INNEG'      }       2       0.515 
        7        {'NET_INPOS'      }       2       0.676 

Create a cadnet object

Create a cadnet object of cadnet 'NET_IN11'

cadobj = cadnet(pfile,"NET_IN11")

cadobj = 
  cadnet with properties:

        pcBoard: [1×1 pcbFileRead]
     CadnetName: 'NET_IN11'
        NumPins: 4
    NumSurfaces: 2
        NumVias: 4
      NumTraces: 4
    TotalLength: 0.4880
        Voltage: 'NoDef'
     LayerRange: [1 3 5]
     EntityList: [1×1 struct]

Get the shapes

Use the shapes function to get shape data for 'NET_IN11'

shapes(cadobj)

ans = struct with fields:
    Surfaces: [1×2 antenna.Polygon]
        Pins: [1×4 antenna.Polygon]
        Vias: [1×4 antenna.Polygon]
      Traces: [1×4 antenna.Polygon]

Input Arguments

cadnetobj — cadnet

object

The cadnet object specified as a string.

Example: s = shapes(cadnetname)

Data Types: string

Type — Type

all (default) | 'Surfaces' | 'Pins' | 'Vias' | 'Traces'

Optional entity type specified as a string. When no entity type is specified shapes of all entities will be returned.

Example: s = shapes(cadnetname, Type='Vias') returns the shapes of vias.

Data Types: string

Output Arguments

s — shapes

table

Returns shape information for a cadnet object.

Version History

Introduced in R2025a