shapes

Shapes

Since R2025a

Syntax

s = shapes(layerobj)

Description

s = shapes(layerobj) returns the shape structure of a layer object which includes Surfaces, Pins, Vias, and Traces.

Examples

Get Shapes Information of a PCB Layer

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

Create a layer object

Create a layer object of metal layer 1 for all pcb entities

layerobj = layer(pfile,1)

layerobj = 
  layer with properties:

        pcBoard: [1×1 pcbFileRead]
    LayerNumber: 1
           Type: 'Pin'
    LayerHeight: 0.0184
    NumSurfaces: 1
        NumPins: 14
        NumVias: 4
      NumTraces: 21
     EntityList: [1×1 struct]

Get the layer shapes

Use the shapes function

shapes(layerobj)

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

Input Arguments

layerobj — layer object

object

The input specified as a layer object.

Example: s = shapes(layername)

Data Types: string

Output Arguments

s — shape

structure

s is returned as a structure with fields showing the shapes in the layer object.

Version History

Introduced in R2025a