cutout#

Edb.cutout(signal_list=None, reference_list=None, extent_type='ConvexHull', expansion_size=0.002, use_round_corner=False, output_aedb_path=None, open_cutout_at_end=True, use_pyaedt_cutout=True, number_of_threads=4, use_pyaedt_extent_computing=True, extent_defeature=0, remove_single_pin_components=False, custom_extent=None, custom_extent_units='mm', include_partial_instances=False, keep_voids=True, check_terminals=False, include_pingroups=False, expansion_factor=0, maximum_iterations=10, preserve_components_with_model=False, simple_pad_check=True, keep_lines_as_path=False, include_voids_in_extents=False)[source]#

Create a cutout using an approach entirely based on PyAEDT. This method replaces all legacy cutout methods in PyAEDT. It does in sequence: - delete all nets not in list, - create a extent of the nets, - check and delete all vias not in the extent, - check and delete all the primitives not in extent, - check and intersect all the primitives that intersect the extent.

Parameters:

signal_listlist: List of signal strings.
reference_listlist, optional: List of references to add. The default is ["GND"].
extent_typestr, optional: Type of the extension. Options are "Conforming", "ConvexHull", and "Bounding". The default is "Conforming".
expansion_sizefloat, str, optional: Expansion size ratio in meters. The default is 0.002.
use_round_cornerbool, optional: Whether to use round corners. The default is False.
output_aedb_pathstr, optional: Full path and name for the new AEDB file. If None, then current aedb will be cutout.
open_cutout_at_endbool, optional: Whether to open the cutout at the end. The default is True.
use_pyaedt_cutoutbool, optional: Whether to use new PyAEDT cutout method or EDB API method. New method is faster than native API method since it benefits of multithread.
number_of_threadsint, optional: Number of thread to use. Default is 4. Valid only if use_pyaedt_cutout is set to True.
use_pyaedt_extent_computingbool, optional: Whether to use legacy extent computing (experimental) or EDB API.
extent_defeaturefloat, optional: Defeature the cutout before applying it to produce simpler geometry for mesh (Experimental). It applies only to Conforming bounding box. Default value is 0 which disable it.
remove_single_pin_componentsbool, optional: Remove all Single Pin RLC after the cutout is completed. Default is False.
custom_extentlist: Points list defining the cutout shape. This setting will override extent_type field.
custom_extent_unitsstr: Units of the point list. The default is "mm". Valid only if custom_extend is provided.
include_partial_instancesbool, optional: Whether to include padstack instances that have bounding boxes intersecting with point list polygons. This operation may slow down the cutout export.Valid only if custom_extend and use_pyaedt_cutout is provided.
keep_voidsbool: Boolean used for keep or not the voids intersecting the polygon used for clipping the layout. Default value is True, False will remove the voids.Valid only if custom_extend is provided.
check_terminalsbool, optional: Whether to check for all reference terminals and increase extent to include them into the cutout. This applies to components which have a model (spice, touchstone or netlist) associated.
include_pingroupsbool, optional: Whether to check for all pingroups terminals and increase extent to include them into the cutout. It requires check_terminals.
expansion_factorint, optional: The method computes a float representing the largest number between the dielectric thickness or trace width multiplied by the expansion_factor factor. The trace width search is limited to nets with ports attached. Works only if use_pyaedt_cutout. Default is 0 to disable the search.
maximum_iterationsint, optional: Maximum number of iterations before stopping a search for a cutout with an error. Default is 10.
preserve_components_with_modelbool, optional: Whether to preserve all pins of components that have associated models (Spice or NPort). This parameter is applicable only for a PyAEDT cutout (except point list).
simple_pad_checkbool, optional: Whether to use the center of the pad to find the intersection with extent or use the bounding box. Second method is much slower and requires to disable multithread on padstack removal. Default is True.
keep_lines_as_pathbool, optional: Whether to keep the lines as Path after they are cutout or convert them to PolygonData. This feature works only in Electronics Desktop (3D Layout). If the flag is set to True it can cause issues in SiWave once the Edb is imported. Default is False to generate PolygonData of cut lines.
include_voids_in_extentsbool, optional: Whether to compute and include voids in pyaedt extent before the cutout. Cutout time can be affected. It works only with Conforming cutout. Default is False to generate extent without voids.

Returns:

List: List of coordinate points defining the extent used for clipping the design. If it failed return an empty list.

Examples

>>> from pyedb import Edb
>>> edb = Edb(r'C:\test.aedb', edbversion="2022.2")
>>> edb.logger.info_timer("Edb Opening")
>>> edb.logger.reset_timer()
>>> start = time.time()
>>> signal_list = []
>>> for net in edb.nets.netlist:
>>>      if "3V3" in net:
>>>           signal_list.append(net)
>>> power_list = ["PGND"]
>>> edb.cutout(signal_list=signal_list, reference_list=power_list, extent_type="Conforming")
>>> end_time = str((time.time() - start)/60)
>>> edb.logger.info("Total legacy cutout time in min %s", end_time)
>>> edb.nets.plot(signal_list, None, color_by_net=True)
>>> edb.nets.plot(power_list, None, color_by_net=True)
>>> edb.save_edb()
>>> edb.close_edb()