Numerical Matrix Format
User Reference
OPTIONS array

MATRIX Array Level: 1

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

Note
Options array can be used multiple times in a single matrix file. All options assigned remain permanent until another Options array is used.
Fields in the OPTIONS array
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.
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)
default_font=NAME Use this font as the default (default: txt)
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
default_language=VALUE Assign the language used in outputted files and reports. (Default: English) Coming soon, not implemented yet.
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-compress_output Compress any exported files to a single Zip file.
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

Example OPTIONS Array:

OPTIONS {
quiet
no_step_repeat
max_polygon=30000
arc_resolution=2.5
fab-generate_border
fab-trim_border
}

XML example:

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

JSON example:

"OPTIONS": {
"quiet": {},
"no_step_repeat": {},
"max_polygon": "30000",
"arc_resolution": "2.5",
"fab-generate_border": {},
"fab-trim_border": {}
}