[Artwork] / [QisMLib]

QisMPatterns Extension

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

QisMPatterns finds shapes that repeat throughout a layout and stores each distinct shape only once, together with every location where it appears. Chip and board designs are full of such repetition: the same pad, via, or contact may occur millions of times. Collecting them into patterns makes the data far smaller and faster to work with. The extension recognizes four kinds of pattern: polygons, paths (also called traces), boxes, and ellipses, which at present must be circles. It has three jobs:

  1. Build a pattern database by feeding it shapes one at a time, from a polygon container, or directly from a view of a loaded file. Each new shape is compared against the shapes already seen, within an optional tolerance, and is either registered as a new pattern or recorded as another occurrence of an existing one. Circle detection can be switched on to save considerable time and memory.

  2. Query the database, filtering by layer or by vertex count, and receive each pattern along with its individual placements and any regular grids of placements it detects.

  3. Write out the result either as a GDSII or OASIS file, in which each pattern becomes its own cell placed by reference or by array, or as a monochrome raster image built with the framework's raster engine.

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

If you want to compact a file or produce an image from it, start with the script commands. If you are embedding pattern detection in your own software, start with the glossary and then move to the C++ programming interface.

QisMPatterns ExtensionQisMPatterns GlossaryPatternPattern DBQisMPatterns C++ API (qismpatterns.h)QisMPatternsRasterVersion control (QisMPatternsRaster)RSTRSPARAMSBUFN QisMPatternsOptsPAT_DETECT_ELLIPSESPAT_DETECT_ARCSAG_DBU_GPAT_ACSV_SPAT_ACSP_SQisMPatternsCadOptsCAD_TOP_NAME_SCAD_ARC_RES_GCAD_ARC_SAG_DBU_GCAD_MIN_REP_DCAD_NO_AREFSCAD_OASISQisMPatternsImgOptsIMG_INVERTIMG_R2LIMG_B2TQisMGetPatternPatCodeVersion control (QisMGetPattern)On_begin_poly_patternOn_poly_pattern_posOn_poly_pattern_arrayOn_end_poly_patternOn_begin_path_patternOn_path_pattern_posOn_path_pattern_arrayOn_end_path_patternOn_begin_box_patternOn_box_pattern_posOn_box_pattern_arrayOn_end_box_patternOn_begin_ellipse_patternOn_ellipse_pattern_posOn_ellipse_pattern_arrayOn_end_ellipse_patternQisMPatternizerVersion control (QisMPatternizer)Get_error_msg (QisMPatternizer)Get_error_tag (QisMPatternizer)Get_error_context (QisMPatternizer)Add_or_matchAdd_or_match_uuAdd_or_match_pathAdd_or_match_path_uuAdd_or_match_boxAdd_or_match_box_uuAdd_or_match_ellipseAdd_or_match_ellipse_uuAdd_bstoreAdd_viewMatchMatch_uuResetCopyConsolidateMerge_inGet_allGet_lGet_ldGet_nvWrite_to_imgWrite_to_cadSizeSize_ellipsesGet_extentsGet_reportQisMPatternsVersion control (QisMPatterns)Get_error_msg (QisMPatterns) Get_error_tag (QisMPatterns)Get_error_context (QisMPatterns)Create_patternizerDestroy_patternizerImage_setupImage_cleanupQisMPatterns Commandspatterns.createpatterns.create_from_bstorepatterns.create_from_viewpatternizer.write_to_cadpatternizer.write_to_imgpatterns.destroyQisMPatterns Licensing (API)QisMPatterns Licensing (Script)QisMPatterns Version History qismpatterns dl/so v1.0 2024-02-15


QisMPatterns Glossary

Pattern

Pattern DB

QisMPatterns C++ API (qismpatterns.h)

QisMPatternsRaster

Version control (QisMPatternsRaster)

RSTRS

PARAMS

BUF

N

QisMPatternsOpts

PAT_DETECT_ELLIPSES

PAT_DETECT_ARCSAG_DBU_G

PAT_ACSV_S

PAT_ACSP_S

QisMPatternsCadOpts

CAD_TOP_NAME_S

CAD_ARC_RES_G

CAD_ARC_SAG_DBU_G

CAD_MIN_REP_D

CAD_NO_AREFS

CAD_OASIS

QisMPatternsImgOpts

IMG_INVERT

IMG_R2L

IMG_B2T

QisMGetPattern

PatCode

Version control (QisMGetPattern)

On_begin_poly_pattern

On_poly_pattern_pos

On_poly_pattern_array

On_end_poly_pattern

On_begin_path_pattern

On_path_pattern_pos

On_path_pattern_array

On_end_path_pattern

On_begin_box_pattern

On_box_pattern_pos

On_box_pattern_array

On_end_box_pattern

On_begin_ellipse_pattern

On_ellipse_pattern_pos

On_ellipse_pattern_array

On_end_ellipse_pattern

QisMPatternizer

Version control (QisMPatternizer)

Get_error_msg (QisMPatternizer)

Get_error_tag (QisMPatternizer)

Get_error_context (QisMPatternizer)

Add_or_match

Add_or_match_uu

Add_or_match_path

Add_or_match_path_uu

Add_or_match_box

Add_or_match_box_uu

Add_or_match_ellipse

Add_or_match_ellipse_uu

Add_bstore

Add_view

Match

Match_uu

Reset

Copy

Consolidate

Merge_in

Get_all

Get_l

Get_ld

Get_nv

Write_to_img

Write_to_cad

Size

Size_ellipses

Get_extents

Get_report

QisMPatterns

Version control (QisMPatterns)

Get_error_msg (QisMPatterns)

Get_error_tag (QisMPatterns)

Get_error_context (QisMPatterns)

Create_patternizer

Destroy_patternizer

Image_setup

Image_cleanup


QisMPatterns Commands

QisMScript Commands to group polygons into repeating patterns

patterns.create

patterns.create_from_bstore

patterns.create_from_view

patternizer.write_to_cad

patternizer.write_to_img

patterns.destroy

QisMPatterns Licensing (API)

QisMPatterns Licensing (Script)


QisMPatterns Version History

qismpatterns dl/so v1.0 2024-02-15


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