[Artwork] / [QisMLib] / [Programmer's Corner]

QisMRstrCmp2Files

Compare two GDSII/OASIS/DBLOAD files using QisMLib and QisMRaster

Command-line Reference

qismrstrcmp2files +inputA:{file-A} +inputB:{file-B} +out:{output-base-path} [OPTIONS]

Required

+inputA:{file-A}

• Path to a valid GDSII, OASIS or DBLOAD file as the first operand

+inputB:{file-B}

• Path to a valid GDSII, OASIS or DBLOAD file as the second operand

+out:{output-base-path}

• Base path of the output file (extension will be added automatically)

[VIEW SPEC]

[-cellA:{cell-name}]

• View cell for file-A
• If not specified, the deepest top cell is used

[-cellB:{cell-name}]

• View cell for file-B
• If not specified, it is set to the view cell of file-A

[-layers:{layer-list}]

• Comma-separated list of layer(s) or layer:datatype(s) to compare
• The specified layers MUST exist in both files
• If not specified or "ALL", all layers of file-A are used
• Overrides preceeding -layermapA: and -layermapB:

[-layermapA:{layer-mapping-fileA}]

[-layermapB:{layer-mapping-fileB}]

• Specify a layer map for file-A and/or file-B in case the layer numbers to be compared in the two files are not same but represent the same geometric information

  {layer-mapping} := [ALL-NULL][,{from}-{to}]+
  where {from},{to} := {layer}[:{datatype}]
  e.g -layermapA:1-3 (move layers 1:* to 3:* in file-A, all other layers loaded as-is)
      -layermapA:1-3:0 (move layers 1:* to 3:0 in file-A, all other layers loaded as-is)
      -layermapA:1:0-3:0 (move 1:0 to 3:0 in file-A, all other layers loaded as-is)
      -layermapA:ALL-NULL,1-3 (move layers 1:* to 3:* in file-A, drop all other layers)
      -layermapA:ALL-NULL,1-1 (drop all layers except 1:* in file-A)
  

• Overrides preceeding -layers:

[-resolution:PXS,{pixelsize} | -resolution:DPI,{dpi} | -resolution:DBU,{dbu}]

• Specify the resolution for generating raster images
• pixelsize is in file units
• Default: -resolution:PXS,1.0

[OUTPUT SPEC]

[-gds:{offset}]

• Generate a GDSII file with a text marker at locations where differences were found and polygons from both file in that vicinity. Polygons from file-A are written at the original layer:dttp while the polygons from file-B are written at layer:(dttp+offset)

[-csv]

• Generate a .csv file (cellname,layer:dttp,x,y) for each difference

[LOAD BALANCE]

[-ntw:{num-window-threads}]

• Specify the number of window/processor threads. Indicates the number of windows that will be processed in parallel
• Requires 1 license of QisMRstrCmp2Files per thread
• Limited to the number of licenses available
• Default: No. cores/2

[-ntp:{num-threads-per-window}]

• Specify the number of threads per window for raster operations
• Independent of licensing
• Default: 2

[-tile:NXY,{nx},{ny}]

• Break the area of comparison into {nx},{ny} equal sized tiles for all layers
• Default: -tile:BSZ,1.0

[-tile:WH,{width},{height}]

• Break the area of comparison into equal sized tiles of {width} x {height} size for all layers
• Default: -tile:BSZ,1.0

[-tile:BSZ,{est-buffer-sz-mb}]

• Break the area of comparison into equal sized tiles such that a raster image of that tile would fit into the specified buffer size in Mb
• Default: -tile:BSZ,1.0

[COMPARISON SPEC]

[-sliver:{value}]

• Ignore differences smalled than {value} pixels
• Default: 2 (a pixel difference of 1 is allowed by design in raster space even for equivalent data. Therefore a sliver of 1px is meaningless and could result in false positives)

[-limit:{count}]

• Terminate comparison as soon as atleast {count} differences are found
• Default: -limit:1 (Terminate on the very first difference)
• -limit:0 implies computing all differences

[-roi:{llx},{lly},{urx},{ury}]

• Only compare a specific region from both files
• {llx},{lly},{urx},{ury} are the lower-left and upper-right points of the region of interest
• Default: Entire extents of the view cell is compared

[MISC]

[-silent]

• Do not write any messages to stdout/stderr
• Default: Not silent

[-log:{log-file-path} | -log+:{log-file-path}]

• Enable logging and specify the log file path
• -log: Creates a new file, -log+ appends if that file exists
• Default: No log file created