Subparts (Deprecated)

This filter implements the KiCost subparts mechanism.
It allows to have more than one part in the same schematic symbol.
Some people use it to include connectors and cables related to a connector in the PCB.
KiCost docs.
Its use is discouraged, if you want to include extra stuff in your BoM there are much better mechanisms. You can consolidate extra information from a CSV or complementary schematic.
Also consider specifying this filter as a local filter for particular outputs (like bom), use the pre_transform option.
You can also explicitly add extra components in the schematic and mark them as not for the PCB.

  • comment : [string] (default: '') A comment for documentation purposes.

  • name : [string] (default: '') Used to identify this particular filter definition.

  • check_multiplier : [list(string)] (default: computed for your project) List of fields to include for multiplier computation. If empty all fields in split_fields and manf_pn_field are used.

  • manf_field : [string] (default: 'manf') Field for the manufacturer name.

  • manf_pn_field : [string] (default: 'manf#') Field for the manufacturer part number.

  • modify_first_value : [boolean] (default: true) Modify even the value for the first component in the list (KiCost behavior).

  • modify_value : [boolean] (default: true) Add ‘- p N/M’ to the value.

  • mult_separators : [string] (default: ':') Separators used for the multiplier. Each character in this string is a valid separator.

  • multiplier : [boolean] (default: true) Enables the subpart multiplier mechanism.

  • ref_sep : [string] (default: '#') Separator used in the reference (i.e. R10#1).

  • separators : [string] (default: ';,') Separators used between subparts. Each character in this string is a valid separator.

  • split_fields : [list(string)] (default: ['arrow#', 'digikey#', 'farnell#', 'lcsc#', 'mouser#', 'newark#', 'rs#', 'tme#']) List of fields to split, usually the distributors part numbers.

  • split_fields_expand : [boolean] (default: false) When true the fields in split_fields are added to the internal names.

  • use_ref_sep_for_first : [boolean] (default: true) Force the reference separator use even for the first component in the list (KiCost behavior).

  • value_alt_field : [string] (default: 'value_subparts') Field containing replacements for the Value field. So we get real values for split parts.