ExcellonOptions parameters

  • metric_units : [boolean] (default: true) Use metric units instead of inches.

  • mirror_y_axis : [boolean] (default: false) Invert the Y axis.

  • output : [string] (default: '%f-%i%I%v.%x') name for the drill file, KiCad defaults if empty (%i=’PTH_drill’). Affected by global options.

  • pth_and_npth_single_file : [boolean] (default: true) Generate one file for both, plated holes and non-plated holes, instead of two separated files.

  • dnf_filter : [string | list(string)] (default: '_null') Name of the filter to mark components as not fitted. Is a short-cut to use for simple cases where a variant is an overkill.
    Can be used to fine-tune a variant for a particular output that needs extra filtering done before the variant.

  • exclude_filter : [string | list(string)] (default: '_null') Name of the filter to exclude components from processing. Is a short-cut to use for simple cases where a variant is an overkill.
    Can be used to fine-tune a variant for a particular output that needs extra filtering done before the variant.

  • generate_drill_files : [boolean] (default: true) Generate drill files. Set to False and choose map format if only map is to be generated.

  • left_digits : [number] (default: 0) number of digits for integer part of coordinates (0 is auto). Doesn’t apply to DECIMAL_FORMAT.
    Default is 3 and currently can’t be configured from the GUI, avoid using it.

  • map : [DrillMap parameters] [dict | string] (default: 'None') (choices: “hpgl”, “ps”, “gerber”, “dxf”, “svg”, “pdf”, “None”) Format for a graphical drill map. Not generated unless a format is specified.
    KiCad 10 doesn’t support HPGL.

  • minimal_header : [boolean] (default: false) Use a minimal header in the file.

  • npth_id : [string] Force this replacement for %i when generating NPTH files.

  • pre_transform : [string | list(string)] (default: '_null') Name of the filter to transform fields before applying other filters. Is a short-cut to use for simple cases where a variant is an overkill.
    Can be used to fine-tune a variant for a particular output that needs extra filtering done before the variant.

  • pth_id : [string] Force this replacement for %i when generating PTH and unified files.

  • right_digits : [number] (default: 0) number of digits for mantissa part of coordinates (0 is auto). Doesn’t apply to DECIMAL_FORMAT.
    Default is 3 and currently can’t be configured from the GUI, avoid using it.

  • route_mode_for_oval_holes : [boolean] (default: true) Use route command for oval holes (G00), otherwise use G85.

Note

if the PCB contains no drills the file won’t be generated.

  • use_aux_axis_as_origin : [boolean] (default: false) Use the auxiliary axis as origin for coordinates.

  • variant : [string] (default: '') Board variant to apply. Used for sub-PCBs.

  • zeros_format : [string] (default: 'DECIMAL_FORMAT') (choices: “DECIMAL_FORMAT”, “SUPPRESS_LEADING”, “SUPPRESS_TRAILING”, “KEEP_ZEROS”) How to handle the zeros.

Used dicts