Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

SuperConducting Resonator Analysis and Plotting Software.

Project Description

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.


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

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(37.0 kB) Copy SHA256 Hash SHA256
Source Nov 8, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting