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

QisMXor2Files

A console program to geometrically compare two GDSII/OASIS/DBLOAD files

Command-line Reference

qismcompare2files +inputA:{file-A} +inputB:{file-B} +output:{output-gds-file} 
  [VIEW] [OUTPUT] [LOAD BALANCE] [COMPARISON] [MISC]

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

+output:{output-gds-file}

• Path of a GDSII output (XOR) to be created

[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

  xxxxxxxxxx
  {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:

[OUTPUT SPEC]

[-xorinput:{layer-offset}]

• For each tile where a difference was found, write the polygons from file-A and file-B at the specified layer offset. E.g if the layer-offset is 100 and a difference was found on layer 1:1, output layer 1:0 contains the XOR polygons, 101:1 contains polygons from file-A layer 1:1, 201:1 contains polygons from file-B layer 1:1
• Default: Only the XOR output is written

[LOAD BALANCE SPEC]

[-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 QisMBoolFiles 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 boolean operations
• Independent of licensing
• Default: 2

[-tiles:{nx},{ny}]

• Break the area of comparison into {nx},{ny} equal sized tiles for all layers
• Default: {nx},{ny} is automatically computed for each layer depending on the amount of data present

[-tilev:{n-vertices}]

• Control the number of tiles using an estimate of the number of vertices per tile. This works only if the tiling is auto-determined (-tiles: is not used)
• Default: 75000

[-dynamicwin:{num-vertices}]

• Dynamically break up tiles containing more than {num-vertices}*2 vertices into quads for re-processing. This results in much faster comparison especially when the data density not uniform across the entire comparison space
• Default: 0 (OFF). Each tile is processed as-is

[COMPARISON SPEC]

[-sliver:{value}]

• Remove polygons that are smaller then {value} specified in file-units
• Default: 0.0 (no sliver removal)

[-limit:{count}]

• Terminate comparison as soon as atleast {count} differences (XOR polygons) 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