Tutorial Notebooks

Six Jupyter notebook tutorials covering the full pyEPR workflow. Tutorials 1, 2, and 4 require a live Ansys HFSS session. Tutorials 3, 5, and 6 run entirely with pip install pyEPR-quantum — no Ansys licence needed.

Tutorial 1 — End-to-End HFSS Workflow

Ansys HFSS required

Connect to HFSS, extract EPR participation ratios, and diagonalize the full Josephson Hamiltonian to get qubit frequencies, anharmonicities, and the χ matrix.

_tutorial_notebooks/Tutorial1.Startupexample.html

Tutorial 2 — Dielectric Loss & EPR Fields

Ansys HFSS required

Compute dielectric energy participation ratios, loss rates, and use the HFSS fields calculator for surface and volume integrals.

_tutorial_notebooks/Tutorial2.Fieldcalculations-dielectricenergyparticipationratios(EPRs).html

Tutorial 3 — Circuit QED Parameters

No HFSS required

Convert between E_J, E_C, L_J, and I_c; explore the transmon charge-basis model and energy spectrum.

_tutorial_notebooks/Tutorial3.toolbox_circuits.html

Tutorial 4 — Parametric Sweeps

Ansys HFSS required

Set up and run HFSS Optimetrics sweeps (linear, log, file-based), save fields, and batch-process results across sweep points.

_tutorial_notebooks/Tutorial4.Parametricsweepoptions.html

Tutorial 5 — Fluxonium & Generic Junction Potentials

No HFSS required

Diagonalize the exact cosine potential for fluxonium; define custom V(φ); handle asymmetric SQUIDs with large zero-point fluctuations.

_tutorial_notebooks/Tutorial5.GenericjunctionpotentialandfluxoniumEPR.html

Tutorial 6 — Numerical EPR without HFSS

No HFSS required

Supply frequencies, junction inductances, and φ_zpf directly to get the full χ matrix — no EM solver needed. Run on Binder ↗

_tutorial_notebooks/Tutorial6.EPRwithoutHFSS—purelynumericalworkflow.html