# garrettj403/qmix architecture

> Architecture diagram of the GitHub repository garrettj403/qmix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/garrettj403/qmix
- Repository: https://github.com/garrettj403/qmix

## Overview

QMix is a Python package for simulating SIS-junction quasiparticle tunneling and analyzing mixer measurements. Its simulation workflow represents the embedding circuit and junction response, then uses harmonic balance to find junction voltages while calculating tunneling currents. Its experimental-data branch imports and analyzes DC I-V, pumped I-V, and IF measurements; the README documents simulation, optimization, and experimental analysis as product capabilities. Edges are limited to relationships shown by the README or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`qmix/respfn.py`](https://github.com/garrettj403/qmix/blob/master/qmix/respfn.py) (Junction response), [`qmix/harmonic_balance.py`](https://github.com/garrettj403/qmix/blob/master/qmix/harmonic_balance.py) (Harmonic balance), [`qmix/exp/exp_data.py`](https://github.com/garrettj403/qmix/blob/master/qmix/exp/exp_data.py) (Experimental data), [`qmix/exp/iv_data.py`](https://github.com/garrettj403/qmix/blob/master/qmix/exp/iv_data.py) (I-V analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["SIS simulation"]
  node_circuit["Embedding circuit<br/>[circuit.py]"]
  node_response["Junction response<br/>[respfn.py]"]
  node_balance["Harmonic balance"]
  node_current["Tunneling current<br/>[qtcurrent.py]"]
end

subgraph group_experimental["Experimental analysis"]
  node_expdata["Experimental data<br/>[exp_data.py]"]
  node_ivdata["I-V analysis<br/>[iv_data.py]"]
  node_ifdata["IF power analysis<br/>[if_data.py]"]
  node_ifresponse["IF response<br/>[if_response.py]"]
  node_clean["Data cleaning<br/>[clean_data.py]"]
  node_parameters["Analysis parameters<br/>[parameters.py]"]
end

subgraph group_math["Math functions"]
  node_filters["Signal filters<br/>[filters.py]"]
  node_ivmodels["I-V models<br/>[ivcurve_models.py]"]
  node_kk["Kramers-Kronig<br/>[kktrans.py]"]
  node_mathmisc["Math utilities<br/>[misc.py]"]
end

subgraph group_support["Runtime support"]
  node_misc["Progress display<br/>[progbar.py]"]
  node_terminal["Terminal output<br/>[terminal.py]"]
end

node_user(("QMix user"))

node_user -.->|"runs simulation"| node_balance
node_user -.->|"analyzes measurements"| node_expdata
node_balance -->|"uses circuit model"| node_circuit
node_balance -->|"interpolates response"| node_response
node_balance -->|"calculates currents"| node_current
node_expdata -->|"uses I-V analysis"| node_ivdata
node_expdata -->|"uses IF analysis"| node_ifdata
node_expdata -->|"references response analysis"| node_ifresponse
node_expdata -->|"loads defaults"| node_parameters
node_ivdata -->|"cleans measurements"| node_clean
node_ivdata -->|"filters measurements"| node_filters
node_ifdata -->|"cleans measurements"| node_clean
node_ifdata -->|"filters measurements"| node_filters
node_response -->|"uses transform"| node_kk
node_response -->|"uses curve models"| node_ivmodels
node_response -->|"uses filters"| node_filters
node_response -->|"uses math helpers"| node_mathmisc
node_balance -->|"reports progress"| node_misc
node_circuit -->|"prints status"| node_terminal

click node_circuit "https://github.com/garrettj403/qmix/blob/master/qmix/circuit.py"
click node_response "https://github.com/garrettj403/qmix/blob/master/qmix/respfn.py"
click node_balance "https://github.com/garrettj403/qmix/blob/master/qmix/harmonic_balance.py"
click node_current "https://github.com/garrettj403/qmix/blob/master/qmix/qtcurrent.py"
click node_expdata "https://github.com/garrettj403/qmix/blob/master/qmix/exp/exp_data.py"
click node_ivdata "https://github.com/garrettj403/qmix/blob/master/qmix/exp/iv_data.py"
click node_ifdata "https://github.com/garrettj403/qmix/blob/master/qmix/exp/if_data.py"
click node_ifresponse "https://github.com/garrettj403/qmix/blob/master/qmix/exp/if_response.py"
click node_clean "https://github.com/garrettj403/qmix/blob/master/qmix/exp/clean_data.py"
click node_parameters "https://github.com/garrettj403/qmix/blob/master/qmix/exp/parameters.py"
click node_filters "https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/filters.py"
click node_ivmodels "https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/ivcurve_models.py"
click node_kk "https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/kktrans.py"
click node_mathmisc "https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/misc.py"
click node_misc "https://github.com/garrettj403/qmix/blob/master/qmix/misc/progbar.py"
click node_terminal "https://github.com/garrettj403/qmix/blob/master/qmix/misc/terminal.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_circuit,node_response,node_balance,node_current,node_user toneBlue
class node_expdata,node_ivdata,node_ifdata,node_ifresponse,node_clean,node_parameters toneAmber
class node_filters,node_ivmodels,node_kk,node_mathmisc toneMint
class node_misc,node_terminal toneRose
```

## Components

### SIS simulation

- [Embedding circuit](https://github.com/garrettj403/qmix/blob/master/qmix/circuit.py): `qmix/circuit.py`
- [Junction response](https://github.com/garrettj403/qmix/blob/master/qmix/respfn.py): `qmix/respfn.py`
- [Harmonic balance](https://github.com/garrettj403/qmix/blob/master/qmix/harmonic_balance.py): `qmix/harmonic_balance.py`
- [Tunneling current](https://github.com/garrettj403/qmix/blob/master/qmix/qtcurrent.py): `qmix/qtcurrent.py`

### Experimental analysis

- [Experimental data](https://github.com/garrettj403/qmix/blob/master/qmix/exp/exp_data.py): `qmix/exp/exp_data.py`
- [I-V analysis](https://github.com/garrettj403/qmix/blob/master/qmix/exp/iv_data.py): `qmix/exp/iv_data.py`
- [IF power analysis](https://github.com/garrettj403/qmix/blob/master/qmix/exp/if_data.py): `qmix/exp/if_data.py`
- [IF response](https://github.com/garrettj403/qmix/blob/master/qmix/exp/if_response.py): `qmix/exp/if_response.py`
- [Data cleaning](https://github.com/garrettj403/qmix/blob/master/qmix/exp/clean_data.py): `qmix/exp/clean_data.py`
- [Analysis parameters](https://github.com/garrettj403/qmix/blob/master/qmix/exp/parameters.py): `qmix/exp/parameters.py`

### Math functions

- [Signal filters](https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/filters.py): `qmix/mathfn/filters.py`
- [I-V models](https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/ivcurve_models.py): `qmix/mathfn/ivcurve_models.py`
- [Kramers-Kronig](https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/kktrans.py): `qmix/mathfn/kktrans.py`
- [Math utilities](https://github.com/garrettj403/qmix/blob/master/qmix/mathfn/misc.py): `qmix/mathfn/misc.py`

### Runtime support

- [Progress display](https://github.com/garrettj403/qmix/blob/master/qmix/misc/progbar.py): `qmix/misc/progbar.py`
- [Terminal output](https://github.com/garrettj403/qmix/blob/master/qmix/misc/terminal.py): `qmix/misc/terminal.py`

### Other components

- **QMix user**

## Connections

- QMix user → Harmonic balance: runs simulation (evidence: `README.md`)
- QMix user → Experimental data: analyzes measurements (evidence: `README.md`)
- Harmonic balance → Embedding circuit: uses circuit model (evidence: `qmix/harmonic_balance.py`)
- Harmonic balance → Junction response: interpolates response (evidence: `qmix/harmonic_balance.py`)
- Harmonic balance → Tunneling current: calculates currents (evidence: `qmix/harmonic_balance.py`)
- Experimental data → I-V analysis: uses I-V analysis (evidence: `qmix/exp/exp_data.py`)
- Experimental data → IF power analysis: uses IF analysis (evidence: `qmix/exp/exp_data.py`)
- Experimental data → IF response: references response analysis (evidence: `qmix/exp/exp_data.py`)
- Experimental data → Analysis parameters: loads defaults (evidence: `qmix/exp/exp_data.py`)
- I-V analysis → Data cleaning: cleans measurements (evidence: `qmix/exp/iv_data.py`)
- I-V analysis → Signal filters: filters measurements (evidence: `qmix/exp/iv_data.py`)
- IF power analysis → Data cleaning: cleans measurements (evidence: `qmix/exp/if_data.py`)
- IF power analysis → Signal filters: filters measurements (evidence: `qmix/exp/if_data.py`)
- Junction response → Kramers-Kronig: uses transform (evidence: `qmix/respfn.py`)
- Junction response → I-V models: uses curve models (evidence: `qmix/respfn.py`)
- Junction response → Signal filters: uses filters (evidence: `qmix/respfn.py`)
- Junction response → Math utilities: uses math helpers (evidence: `qmix/respfn.py`)
- Harmonic balance → Progress display: reports progress (evidence: `qmix/harmonic_balance.py`)
- Embedding circuit → Terminal output: prints status (evidence: `qmix/circuit.py`)
