[Artwork] / [QisMLib]

QisMNtrc

Welcome to the reference page for QisMNtrc, an extension of QisMLib, Artwork Conversion's CAD processing framework.

QisMNtrc traces nets. In a chip or circuit board layout, a net is the set of metal shapes that are electrically connected to one another, joined from one metal layer to the next by vias, the small openings that link layers together. Given a description of which layers are metal and which are vias, called a stackup, the extension follows the connections and hands back every polygon that belongs to the net. It works in two ways:

  1. Point tracing starts from a single point on a metal layer and finds the one net that passes through it.

  2. Region tracing takes one or more rectangular hot-spots and finds every net that touches them. It can also report which regions each net crosses and which nets cross each region.

Tracing runs on multiple threads, can be limited to a range of layers, can locate driver points where a net reaches the diffusion layer through a contact, and can stop early when a net grows beyond a chosen size. Since version 1.8 it also handles non-semiconductor designs such as printed circuit boards, including data imported from ODB++, a common circuit board exchange format.

This page is the complete reference for the extension. Here is what you will find, in the order it appears:

Developers new to the extension should start with the technology file syntax to see how a stackup is described, then move to the C++ programming interface. Anyone who just wants to trace a net can go straight to the script commands.

QisMNtrc QisMNtrc C++ API (qismntrc.h)QisMNtrcFlagsQisMNtrcNotifyVersion ControlBegin_netNet_boundaryNet_boundary_mtEnd_netNet_markerNet_infoNet_refresh_mtPointTraceArgsVersion ControlSet_view_cellGet_view_cellSet_seed_layerGet_seed_layerGet_seed_datatypeSet_seed_PointGet_seed_point_xGet_seed_point_yRegionTraceArgsVersion ControlSet_view_cellGet_view_cellSet_seed_layersGet_seed_layer_countGet_seed_layer_numbersGet_seed_dttp_numbersClear_regionsAdd_region_llurAdd_region_llwhAdd_region_cwhRegion_countGet_regionPreTraceOptionsVersion ControlCloneSet_optimal_tileGet_optimal_tile_nxGet_optimal_tile_nySet_max_via_sizeGet_max_via_sizeSet_order_rangeGet_start_orderGet_stop_orderPreTraceOptionsV2Set_design_is_semiGet_design_is_semiTraceOptionsVersion ControlSet_thread_numGet_thread_numSet_max_net_verticesGet_max_net_verticesSet_ignore_truncated_netsGet_ignore_truncated_netsSet_find_driversGet_find_driversSet_live_traceGet_live_traceQisMNtrcTracerVersion ControlGet_last_error_msgPoint_traceRegion_traceGet_regions_crossing_netGet_nets_crossing_regionQisMNtrcVersion ControlGet_last_error_msgNew_objectDelete_objectNew_stackupDelete_stackupOptimal_tilingOpen_traceClose_traceTechnology File SyntaxSyntax for METALSyntax for LAYERMAPSyntax for SYNTHESIZESyntax for DRIVER_INFOQisMNtrc Stackup C++ API (qismstackupdb.h)QisMNtrcOrderVersion ControlGet_last_error_msgOrder_numberSet_nameGet_nameSet_layer_expression_postfixSet_layer_expression_infixGet_layer_expression_postfixHas_layerIs_validResetQisMNtrcStackupVersion ControlObject_nameGet_last_error_msgResetResizeSizeEdit_orderGet_orderFind_by_layerFind_by_nameGet_stackup_layersIs_validPrint_stackupSet_driver_metalGet_driver_metalSet_driver_contactGet_driver_contactEdit_driver_diffusionGet_driver_diffusionQisMNtrc Commandsntrc.new_stackup_from_filestackup.layer_mapntrc.delete_stackupntrc.open_tracentrc.close_tracentrcer.point_tracentrcer.region_traceQisMNtrc Licensing (C++ API)QisMNtrc Licensing (Script)Version Historyv1.8 (2026-08)v1.7, v1.7.1 (2018-07-05)v1.6 (2018-03-30)v1.5 (2018-02-13)v1.4 (2017-11-16)v1.3 (2017-08-15)v1.2 (2017-07-26)v1.1 (2017-07-12)v1.0 (2017-05-09)


QisMNtrc C++ API (qismntrc.h)

QisMNtrcFlags

QisMNtrcNotify

Notification (Callback) API for a client requesting Point, Region tracing

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Begin_net

Notification at the start of receiving polygons for a net

Net_boundary

Net_boundary_mt

Notification to receive a single polygon for a net

End_net

Notification at the end of receiving polygons for a net

Net_marker

Used to notify driver points

Net_info

Progress/Information regarding a particular trace

Net_refresh_mt

A periodic refresh while the tracing is in progress so that the client can process essential GUI events etc.

PointTraceArgs

A data structure to store Point-tracing parameters

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Set_view_cell

Get_view_cell

Set/Get the view cell (to trace nets on)

Set_seed_layer

Get_seed_layer

Get_seed_datatype

Set/Get the layer (metal) of the seed point from where tracing begins

Set_seed_Point

Get_seed_point_x

Get_seed_point_y

Set/Get the co-ordinates of the point where the tracing begins

RegionTraceArgs

A data structure to store Region-tracing (hot-spot tracing) parameters

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Set_view_cell

Get_view_cell

Set/Get the view cell (to trace nets on)

Set_seed_layers

Get_seed_layer_count

Get_seed_layer_numbers

Get_seed_dttp_numbers

Set/Get the list of layer and datatype numbers (metal) to be used to find the seed points for tracing within the specified regions (hot-spots)

Clear_regions

Clear the list of regions (hot-spots)

Add_region_llur

Add_region_llwh

Add_region_cwh

Add a region (hot-spot) to the list

Region_count

Get_region

Get a region (hot-spot) from the list

PreTraceOptions

Data structure to store trace options that remain the same for a given view cell and stackup (and therefore QisMNtrcTracer)

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Clone

Create a new copy

Set_optimal_tile

Get_optimal_tile_nx

Get_optimal_tile_ny

Control the manner in which the data space is divided (tiling) for faster and parallel computation

Set_max_via_size

Get_max_via_size

Specify the maximum size of a rectangle to be treated as a via

Set_order_range

Get_start_order

Get_stop_order

Limit the range of order numbers involved in computation of nets

PreTraceOptionsV2

Extension (version = 2) for PreTraceOptions

Set_design_is_semi

Get_design_is_semi

Set/Get tracer made to indicate that the design is semiconductor (true) or non-semiconductor (false, PCB etc.)

TraceOptions

Data structure to store trace options that can change between traces

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Set_thread_num

Get_thread_num

Set/Get number of threads to be used for tracing

Set_max_net_vertices

Get_max_net_vertices

Set/Get Maximum number of vertices after which tracing of a net is to be truncated

Set_ignore_truncated_nets

Get_ignore_truncated_nets

Set/Get flag to ignore truncated nets

Set_find_drivers

Get_find_drivers

Set/Get driver detection ON/OFF

Set_live_trace

Get_live_trace

Set/Get live tracing (recieve net polygons on-the-fly) ON/OFF

QisMNtrcTracer

API to perform point and region (hot-spot) tracing

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Get_last_error_msg

Get error message and code corresponding to the last error condition

Point_trace

Trace a net from a single point on metal

Region_trace

Trace nets that cross one or more regions (hot-spots)

Get_regions_crossing_net

Get a list of regions that a specified net crosses

Get_nets_crossing_region

Get a list of nets that cross a specified region

QisMNtrc

The QisMLib Extension API that serves as a gateway to tracing nets

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Get_last_error_msg

Get error message and code corresponding to the last error condition

New_object

Delete_object

Create an instance of any one of the various QisMNtrc data structures

New_stackup

Delete_stackup

Create/Destroy an instance of the QisMNtrc stackup definition

Optimal_tiling

Compute the optimal tiling parameters for a given stackup and view cell

Open_trace

Create an instance of the net tracer

Close_trace

Destroy an instance of the net tracer

Technology File Syntax

Syntax for METAL

Syntax for LAYERMAP

Syntax for SYNTHESIZE

Syntax for DRIVER_INFO

QisMNtrc Stackup C++ API (qismstackupdb.h)

QisMNtrcOrder

Representation of a single stackup order

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Get_last_error_msg

Get the details of the last error

Order_number

Get the order number. ODD => METAL, EVEN => VIA. Order_number() >= 1

Set_name

Get_name

Set/Get the name of this stackup order

Set_layer_expression_postfix

Set the layer expression for this stackup order as a postfix string. Eg:

Set_layer_expression_infix

Set the layer expression for this stackup order as an infix string. Eg:

Get_layer_expression_postfix

Get the layer expression for this order as postfix

Has_layer

Returns true: If layer[:datatype] is associated with this order. If datatype == NULL, then layerNum MUST be fully associated with this order for return to be true.

Is_valid

true if Get_layer_expression_postfix() is non-empty string

Reset

Reset this order

QisMNtrcStackup

Representation of an entire stackup

Version Control

Cast a pointer to your handler to any type in the QisMNtrcNotify hierarchy using the version number

Object_name

Get the implentation name and version

Get_last_error_msg

Get details about the last error

Reset

Clear the entire stackup. Size() == 0

Resize

Specify a stackup size. MUST be an ODD number

Size

Get the stackup size (>= 1 if valid. 0 means empty)

Edit_order

Get_order

Retreive a specific order for editing or info. 1 <= orderNum <= Size()

Find_by_layer

Get order number associated with the specified layer[:datatype].

Find_by_name

Get order number associated with the specified name

Get_stackup_layers

Get a comma-separated list of all layer[:datatype] that participate in the current stackup (for all orders)

Is_valid

true if Size() >= 1 and for each order number, QisMNtrcOrder::Is_valid() == true. If false, call Get_last_error_msg for details

Print_stackup

Print the stackup definition to a file (expressed in postfix)

Set_driver_metal

Get_driver_metal

Set/Get the METAL order that connects to DIFFUSION via CONTACT for driver detection. 0 < Get_driver_metal() <= Size() and Get_driver_metal() is ODD

Set_driver_contact

Get_driver_contact

Set/Get the VIA order that connects DIFFUSION to CONTACT for driver detection. 0 < Get_driver_metal() < Size() and Get_driver_contact() is EVEN

Edit_driver_diffusion

Get_driver_diffusion

Edit/Get the DIFFUSION layer that connects to METAL via CONTACT for driver detection.

QisMNtrc Commands

QisMScript Commands associated with QisMNtrc

ntrc.new_stackup_from_file

Create a new stackup db from a text (.tlib) file

stackup.layer_map

Generate a layer-map string from a stackup db so that only the layers of interest are loaded

ntrc.delete_stackup

Delete a stackup db

ntrc.open_trace

Create a new instance of the nettrace object

ntrc.close_trace

ntrcer.point_trace

Trace a net from a single point (x, y, metal layer)

ntrcer.region_trace

Trace all nets that originate from a collection of regions (hot-spots)

QisMNtrc Licensing (C++ API)

OperationCodePolicy
Open_trace11059Check out ONE license per call
Close_trace11059Check in ONE license per call

QisMNtrc Licensing (Script)

OperationCodePolicy
ntrc.open_trace11059Check out ONE license per call
ntrc.close_trace11059Check in ONE license per call

Version History

v1.8 (2026-08)

v1.7, v1.7.1 (2018-07-05)

v1.6 (2018-03-30)

v1.5 (2018-02-13)

v1.4 (2017-11-16)

v1.3 (2017-08-15)

v1.2 (2017-07-26)

v1.1 (2017-07-12)

v1.0 (2017-05-09)


ARTWORK CONVERSION SOFTWARE, INC.
509 N. Sepulveda Blvd. Suite 201 Manhattan Beach, CA 90266  tel: 831.426.6163  email: info@artwork.surf

Last Updated -- Fri Oct 2 00:13:09 UTC 2026