shapes

Shapes

Since R2025a

collapse all in page

    Syntax

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

    Description

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

    example

    Examples

    collapse all

    Open Live Script

    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

    collapse all

    The cadnet object specified as a string.

    Example: s = shapes(cadnetname)

    Data Types: string

    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

    collapse all

    Returns shape information for a cadnet object.

    Version History

    Introduced in R2025a