Component Types¶

Overview¶

Components are RF/microwave parts installed at specific temperature stages along the wiring path.

All components share these common fields:

Field	Type	Required	Description
`type`	string	Yes	Component type
`model`	string	Yes	Model number
`serial`	string	No	Serial number

Types¶

Attenuator¶

Reduces signal power by a fixed amount.

Field	Type	Description
`value_dB`	number	Attenuation in dB

type: attenuator
model: XMA-2082-6431-20
value_dB: 20

Filter¶

Passes or blocks specific frequency ranges.

Field	Type	Description
`filter_type`	string	Filter type (e.g., `Lowpass`, `Eccosorb`)

type: filter
model: KL-Lowpass-12G
filter_type: Lowpass

Isolator¶

Allows signal to pass in one direction only. No type-specific fields.

type: isolator
model: QCI-CIC4-12

Amplifier¶

Increases signal power.

Field	Type	Description
`amplifier_type`	string	Amplifier type (e.g., `HEMT`, `RT`)
`gain_dB`	number	Gain in dB

type: amplifier
model: LNF-LNC4_8C
amplifier_type: HEMT
gain_dB: 38

Component Catalog¶

All components must be defined in a components.yaml catalog and referenced by key name in wiring configurations:

# components.yaml
XMA-10dB:
  type: attenuator
  model: XMA-2082-6431-10
  value_dB: 10

XMA-20dB:
  type: attenuator
  model: XMA-2082-6431-20
  value_dB: 20

K&L-LPF:
  type: filter
  model: K&L-5VLF
  filter_type: Lowpass

LNF-HEMT:
  type: amplifier
  model: LNF-LNC03_14A
  amplifier_type: HEMT
  gain_dB: 40

These keys are then used in wiring files — both in module definitions and per-line overrides (add / remove):

# control.yaml
modules:
  ctrl:
    stages:
      50K:
        - XMA-10dB       # ← catalog key reference
      4K:
        - XMA-20dB
      MXC:
        - XMA-20dB
        - Eccosorb

lines:
  - line_id: C00
    qubit: Q00
    module: ctrl
    stages:
      Still:
        add:
          - K&L-LPF       # ← catalog key reference in override

Centralizing component definitions in the catalog ensures consistency across all wiring files and makes it easy to update a component's properties in one place.