[Artwork] / [QisMLib]

QisMExplCounter

Welcome to the reference page for QisMExplCounter, an extended API of QisMLib, Artwork Conversion's CAD processing framework.

QisMExplCounter measures how much data is in a layout and where it is concentrated. Chip designs are built from cells that are reused many times over, so the number of shapes you would see if every reuse were expanded, known as the exploded count, can be far larger than the number of shapes actually stored. Knowing that count, and knowing which parts of the design are dense and which are sparse, helps a program plan how much work lies ahead and split it evenly across processors. The extension has two jobs:

  1. Count the exploded polygons and vertices for a chosen cell and set of layers, either by brute force over a region of interest, by a much faster hierarchical method for designs with lots of cell reuse, or down to a chosen nesting depth.

  2. Map density by breaking a region into tiles so that no tile holds more than a chosen number of vertices. One method divides by the vertices contained in each tile; another uses a quad-tree scheme based on the vertices crossing each tile. The resulting tile lists can be drawn to a file for inspection, trimmed to a percentage, shuffled, or sorted by area.

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

If you just want a quick count or density map of a file, the script commands are the quickest route. If you are using the API into your own software, start with the C++ programming interface.


QisMExplCounter C++ API (qismexplcounter.h)

QisMExplCounter

API to compute exploded polygon and vertex counts for a given cell and set of layers

Version Control

Cast to a pointer of another version in the class hierarchy (base/derived)

Get_last_error_msg

Get more information about the last error condition

Get_counts_full

Get exploded vertex count (estimated) over a region of interest using multi-threaded brute-force technique

Get_counts_hierarchical

Get exploded vertex count (exact) for a given cell using a hierarchical technique

QisMExplCounterV2

Get_counts_nl

Works exactly the same as Get_counts_full() except for the additional nesting level control. nesting_level < 1 implies ALL nesting levels

QisMExplCounterV3

Break_window_by_vertnum

Release_window_list

Break one or more ROIs (tiles) into smaller tiles based on the no. vertices contained within.

QisMExplCounterV4

Break_window_by_vertcross

Break a view of the database into smaller tiles based on the no. vertices crossing

QisMExplCounterV5

Break_window_by_vertcross_adv

Same as Break_window_by_vertcross with extensible options

QisMExplCounter commands

See qismexplcounter.h for the relevant C++ API

explcounter.count

explcounter.break_window_by_crossing

explcounter.break_window_by_vertnum

explcounter.delete_windows


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

Last Updated -- Wed Sep 30 00:57:27 UTC 2026