PCB Matrix Format
by Numerical Innovations, Inc. (www.numericalinnovations.com)
OPTIONS

MATRIX Array Level: 1

The available options to use. Options are not required. If any options are omitted, the default value will be used.

Note
Options can be used multiple times in a single matrix file. All options assigned remain permanent until Options is used again.
Fields in the OPTIONS
Description
GENERAL Options:
quiet Supress all processing messages.
no_step_repeat Explodes Step-Repeat (ie. arrayed data.)
paths_as_polygons Convert paths (ie. traces) to polygons.
flatten_hierarchy Flattens all hierarchy.
flatten_composite Flattens all composite data to polygons.
layer_sort=SORT_MODE

Determine how output layers are sorted. Choose from SORT_MODE(s): none, stackup, name, number. Default: stackup

default_units=NAME Use this units as the default units (default: millimeter)
default_font=NAME Use this font as the default (default: txt)
default_language=VALUE

Assign the language used in outputted files and reports. (Default: English) Coming soon, not implemented yet.

ignore_text Ignore text during import.
max_polygon=COUNT Max. points used in a polygon (default: 32765). Must be a positive number
scale=NUM Scale the output data. (default: 1.0)
arc_deviation=SIZE Tolerance using millimeters (default: .01)
arc_resolution=DEGREES Arc resolution in degrees (default: 3.0)
set_topcell=NAME Assign Top Cell to use (only if more than one). If empty attempt to find top cell (not guaranteed).
detect_layer_types Detect all layer types and stackup order based on layer names.
fab-generate_border Try to generate a border profile layer.
fab-trim_border

Removes all objects Outside PCB Border like silkscreen lines, overlapping pads, text, notes, drawing objects, etc.

set-database_extents=MODE Large, Normal, Small (Large if design exceeds 2 meters, Small for 1/10 nanometer accuracy). Default is Normal
use_mask_color=VALUE Default Mask color to use for Generated PDF reports. Choose mask color: green, blue, black, red, white, green matte. (default: green)
Note:You can also use RGB values to allow the exact color. For example:
use_mask_color=0,255,0
use_silk_color=VALUE Default Silkscreen color to use for Generated PDF reports. Choose silk color: white, yellow, red. (default: white)
Note:You can also use RGB values to allow the exact color. For example:
use_silk_color=255,255,255
use_boardfinish_color=VALUE Default Board Finish to use for Generated PDF reports. Choose finish: HASL, Gold, Silver. (default: hasl)
Note:You can also use RGB values to allow the exact color. For example:
use_boardfinish_color=180,180,185
use_drill_color=VALUE Color to use for Drill holes. Choose: clear, or RGB value. (default: hasl)
Note:You can also use RGB values to allow the exact color. For example:
use_drill_color=128,128,128
display_inside_inserts=YES|NO

Toggles the viewing of objects inside inserts. Default Yes.

OMIT/INCLUDE Objects:
omit_layers=NAME Layer names to ignore. Must be comma separated.
include_layers=NAME Layers to include. Must be comma separated. (Default is All layers are included).
omit_nets=NETS Net names to ignore. Must be comma separated.
include_nets=NETS Nets to include. Must be comma separated. (Default is All nets are included).
omit_components=REFDES Ignore Components by Reference designators. Must be comma separated.
include_components=REFDES Include Components by Reference designators. Must be comma separated. (Default is All components are included).
omit_components_pn=PARTNUM Ignore Components by Part Number. Must be comma separated.
include_components_pn=PARTNUM Include Components by Part Number. Must be comma separated. (Default is All components are included).
omit_bom Removes all Bom data
omit_stackup Removes all Stackup data
omit_document_layers Removes any Documentation layers
omit_tooltips Removes any Tool tip information
show_refdes Output Reference Designator Text over each component.
clip_box=L,B,R,T Clip design within specific box, using millimeters.
crossing_box=L,B,R,T Include objects which overalap a specific box, using millimeters.
window_box=L,B,R,T Include objects which are contained within a specific box, using millimeters.
clip_box_reverse=L,B,R,T Omit objects within specific box, using millimeters.
crossing_box_reverse=L,B,R,T Omit objects which overalap a specific box, using millimeters.
window_box_reverse=L,B,R,T

Omit objects which are contained within a specific box, using millimeters.

Gerber Import Options:IMPORTANT: Only use these when necessary.
gerber-import_default_360arc Import Gerber with 360-degree arcs mode. (Default 360 Arcs)
gerber-import_default_90arc Import Gerber with 90-degree Quad arcs mode.
gerber-import_fix_polygons Repair Gerber files that contain Self-Intersecting and Overlapping Polygons.
gerber-import_ignore_zero_length_draws Ignore any zero length draws.
gerber-import_flash_zero_length_draws Adds a flash for zero length draws. (Default)
gerber-import_end_newline End gerber block at newline char.
gerber-import_endchar=CHAR

End gerber block character (default: *)

Legacy Gerber Import Options:IMPORTANT: Only needed for older legacy Gerber format RS-274D.
gerber-import_units=English|Metric Import older legacy gerbers with either English (i.e Inch) or Metric units (default: Metric).
gerber-import_digits=INTEGER.DECIMAL Import older legacy gerbers with specified digits (default: 3.4).
gerber-import_type=TYPE Import older legacy gerbers type (default: absolute).
ABSOLUTE – Use Absolute coordinates during Gerber Import
INCREMENTAL – Use Incremental coordinates during Gerber Import
gerber-import_suppression=SUPPRESSION

Import older legacy gerbers zero suppression (default: none).
LEADING – Suppress Leading Zeros during Gerber Import
TRAILING – Suppress Trailing Zeros during Gerber Import
NONE – No Zero Suppression during Gerber Import
DECIMAL – Gerber cooridnates values contain a decimal point

PCB Preflight Options:Special options only available for PCB Preflight API.
preflight-extract_pcb_info Detects and extracts all PCB fabrication information, plus Assembly/BOM details.
preflight-autodetect_import Automatically detect file formats and import. If problems occur use matrix directly.
preflight-generate_viewer Output results in a vector graphics format for Viewers. PCB Preflight API only
preflight-compress_output=ZIPFILENAME Compress any exported files to a single Zip file.

Example OPTIONS:

<OPTIONS>
<quiet/>
<no_step_repeat/>
<max_polygon>30000</max_polygon>
<arc_resolution>2.5</arc_resolution>
<fab-generate_border/>
<fab-trim_border/>
</OPTIONS>