SuperConducting Resonator Analysis and Plotting Software.

pip install scraps==0.5.2


scraps stands for: SuperConducting Resonator Analysis and Plotting Software

Scraps is a package designed to help you analyze lots of data from superconducting resonators. The basic idea is that you hook up your VNA (or mixer) and measure S21 at several different temperatures and driving powers. Maybe you have a PID and some decent automation software that take several hundred traces, and now you don't know what to do with all that data. Enter scraps. Scraps will organize it all and run fits on it, and make pretty pictures you can show your advisor or funding committee or spouse (when asked what you do all day upon returning home) or even put into a journal article.

Currently scraps is designed to handle resonator S21 data at varying temperatures and input powers. There are plans to extend scraps to handle varying magnetic field also, as well as noise in addition to S21. If you would like to be a part of that, get involved by posting a message here.

Who is using scraps?

Scraps is in use at Argonne National Laboratory, Caltech, University of Chicago, Oxford and probably many other places! Recently a group at Oxford used scraps to fit MKID resonator data for this publication: MKID digital readout tuning with deep learning


Scraps is licensed under the MIT license, so feel free to copy it, play with it, modify it, etc. under those terms (which are pretty loose!).


Installation is as simple as:

pip install scraps

or if you want to get the may-not-be-stable developer version:

git clone
pip install -e /dir/where/you/cloned/scraps
cd /dir/where/you/cloned/scraps
git checkout develop

For complete API documentation, more in depth installation instructions and some example tutorials, see the official documentation at:


If you use scraps to make plots or analyze data for a publication, please cite the IEEE Applied Superconductivity Manuscript, DOI: 10.1109/TASC.2016.2625767:

   author={F. W. Carter and T. S. Khaire and V. Novosad and C. L. Chang},
   journal={IEEE Transactions on Applied Superconductivity},
   title={scraps: An Open-Source Python-Based Analysis Package for Analyzing and Plotting Superconducting Resonator Data},

Short description of files that aren't code:

  • Example1: a JuPyter notebook that will help you get started with the basics. Focus is on a single S21 sweep.
  • Example2: a slightly more advanced tutorial that focuses on lots of sweeps at several temperatures and powers.
  • Example3: an example showcasing some of the more advanced plotting features. The data for this notebook is at:
  • A ton of actual superconducting resonator data from a Nb microstrip resonator made at ANL.
  • A handy little bash script to turn the Example# notebooks into rst files in the docs folder properly.
  • readthedocs.yml and environment.yml: These are needed to properly build the documentation hosted at RTD.


Please post any bugs or feature requests here on GitHub. Bugs will be squashed ASAP. Feature requests will be seriously considered!

Copyright 2016, Faustin W. Carter