Numerical Matrix Format
User Reference
NETLIST array

MATRIX Array Level: 2

Ensure the electrical connectivity of your PCB designs by comparing against an IPC Netlist file to identify possible electrical shorts, open nets, and any missing features.
NETLIST array is optional and it is used to perform the Netlist Comparison check.

Note
An IPC 356/A Netlist file is needed.
Common Fields in the NETLIST array
Description
job=NAME The name of the Job to perform Check. Required. Dynamic Job References are also supported.
units=MIL|MM Units to use for this dfmchecker array. Must be either: MIL or MM. (Default: MIL)
maximumErrorsPerRule=NUM The maximum number of Errors. After this number has been reached the Checker will no longer continue. This prevents unnecessary redundancy. (Default: 50)
maximumErrorsTotal=NUM The maximum number of Errors found. After this number has been reached the Checker will end. This prevents unnecessary redundancy. (Default: 500)
tolerance=VALUE Checks must not exceed this tolerance value to become a error. This prevents false errors due to mathematical rounding. (Default: 4 microns)
searchbox=L,B,R,T Optional. Creates an isolated area to perform check. This can be helpful to pinpoint specific areas of a design for DFM checks. Left, Bottom, Right, Top must be comma separated. (default: 0,0,0,0 is used then entire extents). This is OPTIONAL.
layerfilter=LAYERS Optional. Isolate layers to perform check. This can be helpful to pinpoint specific features of a design for DFM checks. Must be comma separated. This is OPTIONAL.
netFilter=NETS Optional. Isolate nets to perform check. This can be helpful to pinpoint specific features of a design. Must be comma separated. This is OPTIONAL.
ignoredcodes=DCODE_NUM

Optional. Omit any objects referencing the given dcodes. This can be helpful to remove non-critical features of a design (like Hatch patterns). Must be comma separated. This is OPTIONAL.

find_opennets Find any Open Nets.
find_shortednets Find any Shorts.
find_missingcopper Find any missing metal areas when a test point is present.
find_missingnets Find any metal areas without a net and a test point is present.
ipc_netlist_file=FILE File path of an IPC 356/A Netlist file (typically output by a PCB layout tool). The file path may be either Absolute or Relative. Only needed if a Netlist file was not loaded with Gerber/CAM files.
x_netlist_offset Offset the X location for all test points. Sometimes Netlist files are outputted from layout tools using a different coordinate system from the gerber and ODB++ files.
y_netlist_offset Offset the Y location for all test points. Sometimes Netlist files are outputted from layout tools using a different coordinate system from the gerber and ODB++ files.
netlist_scale_factor

Scale all test points. Sometimes Netlist files are outputted from layout tools using a different scale from the gerber and ODB++ files.

output_text_file=FILE Generates a Text Report File after Net Compare is complete. The file path may be either Absolute or Relative. (When possible always use relative paths)

Example:
output_text_file=Customer234/dfm_report-23433.txt
output_pdf_file=FILE

Generate a PDF Report File after Net Compare is complete. The file path may be either Absolute or Relative. (When possible always use relative paths)

Example:
output_pdf_file=dfm_report.pdf

output_2581_file=FILE

Generate an IPC-2581 (with DFX) after Net Compare is complete. This makes it easier to visually spot errors when loaded over existing CAD design. The file path may be either Absolute or Relative. (When possible always use relative paths). +2 Additional MATRIX Array Level

output_gerber_file=FILE Generate a Gerber File after Net Compare is complete. This makes it easier to visually spot errors when loaded over existing CAD design. The file path may be either Absolute or Relative. (When possible always use relative paths). +2 Additional MATRIX Array Level

Example NETLIST Array to perform Netlist Comparison:

NETLIST {
job=@active
units=mm
ipc_netlist_file=customer23/mySampleNetlist.ipc
find_opennets
find_shortednets
output_pdf_file=customer23/mySampleNetlist_comparison_report.pdf
}
#Minimum fields
NETLIST {
find_opennets
find_shortednets
output_pdf_file=Netlist_comparison_report.pdf
}

XML example:

<NETLIST>
<job>@active</job>
<UNITS>mm</UNITS>
<MinErrorSize>0.12</MinErrorSize>
<ipc_netlist_file>customer23/mySampleNetlist.ipc</ipc_netlist_file>
<find_opennets/>
<find_shortednets/>
<output_pdf_file>customer23/mySampleNetlist_comparison_report.pdf</output_pdf_file>
</NETLIST>

JSON example:

"NETLIST": {
"job": "@active",
"UNITS": "mm",
"MinErrorSize": 0.12,
"ipc_netlist_file": "customer23/mySampleNetlist.ipc",
"find_opennets": "",
"find_shortednets": "",
"output_pdf_file": "customer23/mySampleNetlist_comparison_report.pdf"
}