qmix


Nameqmix JSON
Version 1.0.6 PyPI version JSON
download
home_pagehttps://garrettj403.github.io/QMix/
SummarySimulate SIS mixer operation
upload_time2020-07-09 04:09:57
maintainer
docs_urlNone
authorJohn Garrett
requires_python
licenseGPL v3
keywords sis mixers radio astronomy superconducting detectors terahertz instrumentation python
VCS
bugtrack_url
requirements matplotlib numba numpy scipy
Travis-CI No Travis.
coveralls test coverage No coveralls.
            QMix
====

**Quantum Mixing software**

[![PyPI version](https://badge.fury.io/py/QMix.svg)](https://badge.fury.io/py/QMix)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/QMix.svg)](https://pypi.org/project/QMix/)
[![Build Status](https://travis-ci.org/garrettj403/QMix.svg?branch=master)](https://travis-ci.org/garrettj403/QMix)
[![Coverage Status](https://coveralls.io/repos/github/garrettj403/QMix/badge.svg?branch=master)](https://coveralls.io/github/garrettj403/QMix?branch=master)
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://github.com/garrettj403/QMix/blob/master/LICENSE)

QMix is used to simulate the quasiparticle tunneling currents in Superconductor/Insulator/Superconductor (SIS) junctions. In radio astronomy, these junctions are used for heterodyne mixing at millimeter and submillimeter wavelengths. QMix can be used to simulate the behavior of SIS mixers, optimize their performance and investigate experimental results.

In order to calculate the quasiparticle tunneling currents, QMix uses *multi-tone spectral domain analysis* (see [references](https://garrettj403.github.io/QMix/references.html#references-related-to-multi-tone-spectral-domain-analysis)). Among other applications, this makes QMix ideal for simulating power saturation, higher-order harmonics, sub-harmonic pumping, harmonic mixing and frequency multiplication.

**Website:** https://garrettj403.github.io/QMix/

Getting Started
---------------

The easiest way to install QMix is using ``pip``:

    # for latest release
    python -m pip install QMix

    # for latest commit
    python -m pip install git+https://github.com/garrettj403/QMix.git

Take a look at the [QMix website](https://garrettj403.github.io/QMix/) for more information on how to use the QMix package and examples showing how to simulate SIS junctions. If you run into any problems, please create a new issue through the [issue tracker](https://github.com/garrettj403/QMix/issues) with the ``help wanted`` or ``question`` tag. In your message, make sure to include your operating system, Python version, and package versions for QMix, Numpy, SciPy and Matplotlib.

Contributing to QMix
--------------------

[![GitHub issues](https://img.shields.io/github/issues-raw/garrettj403/QMix.svg)](https://github.com/garrettj403/QMix/issues)
[![GitHub commits since latest release](https://img.shields.io/github/commits-since/garrettj403/QMix/latest.svg)](https://github.com/garrettj403/QMix/commits/master)

If you would like to contribute to the QMix project, please take a look at the [contribution instructions](https://github.com/garrettj403/QMix/blob/master/CONTRIBUTING.md). This document includes information on reporting bugs, requesting new features, creating pull requests and contributing new code.

To get a local copy of QMix running:

    # Download QMix
    git clone https://github.com/garrettj403/QMix.git QMix
    cd QMix/

    # Create a virtual environment using Anaconda
    conda env create -f environment.yml
    conda activate qmix

    # Install QMix
    python -m pip install -e .

    # Test installation
    pytest --verbose --color=yes tests/

Examples
--------

QMix can be used to simulate a wide variety of SIS junction behavior. A simple example is shown below for simulating an SIS mixer at 230 GHz. You can find more examples in the ``QMix/notebooks/`` directory or on the [QMix website](https://garrettj403.github.io/QMix/single-tone-simple.html). 

![](https://raw.githubusercontent.com/garrettj403/QMix/master/notebooks/results/multi-tone-results.png)

Citing QMix
-----------

If you use QMix, please cite the following papers:

[![DOI1](https://img.shields.io/badge/DOI%201%3A-10.21105%2Fjoss.01231-blue)](https://doi.org/10.21105/joss.01231)

    @article{Qmix1,
      author       = {J. D. Garrett and G. Yassin},
      title        = {{QMix: A Python package for simulating the quasiparticle tunneling currents in SIS junctions}},
      publisher    = {Journal of Open Source Software},
      month        = mar,
      year         = 2019,
      volume       = 4,
      number       = 35,
      pages        = 1231,
      doi          = {10.21105/joss.01231},
      url          = {https://doi.org/10.21105/joss.01231},
    }

[![DOI2](https://img.shields.io/badge/DOI%202%3A-10.1109%2FTTHZ.2019.2938993-blue)](https://doi.org/10.1109/TTHZ.2019.2938993)

    @article{Qmix2,
      author       = {J. D. Garrett and B.-K. Tan and F. Boussaha and C. Chaumont and G. Yassin},
      title        = {{Simulating the Behavior of a 230-GHz SIS Mixer Using Multitone Spectral Domain Analysis}},
      publisher    = {IEEE Transactions on Terahertz Science and Technology},
      month        = nov,
      year         = 2019,
      volume       = 9,
      number       = 6,
      pages        = {540--548},
      doi          = {10.1109/TTHZ.2019.2938993},
      url          = {https://ieeexplore.ieee.org/document/8822760/},
    }

You can also cite a specific version of QMix by citing the appropriate Zenodo archive:

[![DOI3](https://img.shields.io/badge/DOI%203%3A-10.5281%2Fzenodo.2538162-blue)](https://doi.org/10.5281/zenodo.2538162)

    @article{Qmix3,
      author       = {J. D. Garrett and G. Yassin},
      title        = {{garrettj403/QMix  (Version v1.0.4)}},
      month        = apr,
      year         = 2019,
      publisher    = {Zenodo},
      doi          = {10.5281/zenodo.2640907},
      url          = {http://doi.org/10.5281/zenodo.2640907}
    }

License
-------

QMix is released under a [GNU General Public License, Version 3](https://github.com/garrettj403/QMix/blob/master/LICENSE).
            

Raw data

            {
    "_id": null,
    "home_page": "https://garrettj403.github.io/QMix/",
    "name": "qmix",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "SIS mixers,radio astronomy,superconducting detectors,terahertz instrumentation,Python",
    "author": "John Garrett",
    "author_email": "garrettj403@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/f6/c7/310790eba357e20f2da8bf3bec2e8638320ac6d5e62f86863b01565aaaa4/qmix-1.0.6.tar.gz",
    "platform": "any",
    "description": "QMix\n====\n\n**Quantum Mixing software**\n\n[![PyPI version](https://badge.fury.io/py/QMix.svg)](https://badge.fury.io/py/QMix)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/QMix.svg)](https://pypi.org/project/QMix/)\n[![Build Status](https://travis-ci.org/garrettj403/QMix.svg?branch=master)](https://travis-ci.org/garrettj403/QMix)\n[![Coverage Status](https://coveralls.io/repos/github/garrettj403/QMix/badge.svg?branch=master)](https://coveralls.io/github/garrettj403/QMix?branch=master)\n[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://github.com/garrettj403/QMix/blob/master/LICENSE)\n\nQMix is used to simulate the quasiparticle tunneling currents in Superconductor/Insulator/Superconductor (SIS) junctions. In radio astronomy, these junctions are used for heterodyne mixing at millimeter and submillimeter wavelengths. QMix can be used to simulate the behavior of SIS mixers, optimize their performance and investigate experimental results.\n\nIn order to calculate the quasiparticle tunneling currents, QMix uses *multi-tone spectral domain analysis* (see [references](https://garrettj403.github.io/QMix/references.html#references-related-to-multi-tone-spectral-domain-analysis)). Among other applications, this makes QMix ideal for simulating power saturation, higher-order harmonics, sub-harmonic pumping, harmonic mixing and frequency multiplication.\n\n**Website:** https://garrettj403.github.io/QMix/\n\nGetting Started\n---------------\n\nThe easiest way to install QMix is using ``pip``:\n\n    # for latest release\n    python -m pip install QMix\n\n    # for latest commit\n    python -m pip install git+https://github.com/garrettj403/QMix.git\n\nTake a look at the [QMix website](https://garrettj403.github.io/QMix/) for more information on how to use the QMix package and examples showing how to simulate SIS junctions. If you run into any problems, please create a new issue through the [issue tracker](https://github.com/garrettj403/QMix/issues) with the ``help wanted`` or ``question`` tag. In your message, make sure to include your operating system, Python version, and package versions for QMix, Numpy, SciPy and Matplotlib.\n\nContributing to QMix\n--------------------\n\n[![GitHub issues](https://img.shields.io/github/issues-raw/garrettj403/QMix.svg)](https://github.com/garrettj403/QMix/issues)\n[![GitHub commits since latest release](https://img.shields.io/github/commits-since/garrettj403/QMix/latest.svg)](https://github.com/garrettj403/QMix/commits/master)\n\nIf you would like to contribute to the QMix project, please take a look at the [contribution instructions](https://github.com/garrettj403/QMix/blob/master/CONTRIBUTING.md). This document includes information on reporting bugs, requesting new features, creating pull requests and contributing new code.\n\nTo get a local copy of QMix running:\n\n    # Download QMix\n    git clone https://github.com/garrettj403/QMix.git QMix\n    cd QMix/\n\n    # Create a virtual environment using Anaconda\n    conda env create -f environment.yml\n    conda activate qmix\n\n    # Install QMix\n    python -m pip install -e .\n\n    # Test installation\n    pytest --verbose --color=yes tests/\n\nExamples\n--------\n\nQMix can be used to simulate a wide variety of SIS junction behavior. A simple example is shown below for simulating an SIS mixer at 230 GHz. You can find more examples in the ``QMix/notebooks/`` directory or on the [QMix website](https://garrettj403.github.io/QMix/single-tone-simple.html). \n\n![](https://raw.githubusercontent.com/garrettj403/QMix/master/notebooks/results/multi-tone-results.png)\n\nCiting QMix\n-----------\n\nIf you use QMix, please cite the following papers:\n\n[![DOI1](https://img.shields.io/badge/DOI%201%3A-10.21105%2Fjoss.01231-blue)](https://doi.org/10.21105/joss.01231)\n\n    @article{Qmix1,\n      author       = {J. D. Garrett and G. Yassin},\n      title        = {{QMix: A Python package for simulating the quasiparticle tunneling currents in SIS junctions}},\n      publisher    = {Journal of Open Source Software},\n      month        = mar,\n      year         = 2019,\n      volume       = 4,\n      number       = 35,\n      pages        = 1231,\n      doi          = {10.21105/joss.01231},\n      url          = {https://doi.org/10.21105/joss.01231},\n    }\n\n[![DOI2](https://img.shields.io/badge/DOI%202%3A-10.1109%2FTTHZ.2019.2938993-blue)](https://doi.org/10.1109/TTHZ.2019.2938993)\n\n    @article{Qmix2,\n      author       = {J. D. Garrett and B.-K. Tan and F. Boussaha and C. Chaumont and G. Yassin},\n      title        = {{Simulating the Behavior of a 230-GHz SIS Mixer Using Multitone Spectral Domain Analysis}},\n      publisher    = {IEEE Transactions on Terahertz Science and Technology},\n      month        = nov,\n      year         = 2019,\n      volume       = 9,\n      number       = 6,\n      pages        = {540--548},\n      doi          = {10.1109/TTHZ.2019.2938993},\n      url          = {https://ieeexplore.ieee.org/document/8822760/},\n    }\n\nYou can also cite a specific version of QMix by citing the appropriate Zenodo archive:\n\n[![DOI3](https://img.shields.io/badge/DOI%203%3A-10.5281%2Fzenodo.2538162-blue)](https://doi.org/10.5281/zenodo.2538162)\n\n    @article{Qmix3,\n      author       = {J. D. Garrett and G. Yassin},\n      title        = {{garrettj403/QMix  (Version v1.0.4)}},\n      month        = apr,\n      year         = 2019,\n      publisher    = {Zenodo},\n      doi          = {10.5281/zenodo.2640907},\n      url          = {http://doi.org/10.5281/zenodo.2640907}\n    }\n\nLicense\n-------\n\nQMix is released under a [GNU General Public License, Version 3](https://github.com/garrettj403/QMix/blob/master/LICENSE).",
    "bugtrack_url": null,
    "license": "GPL v3",
    "summary": "Simulate SIS mixer operation",
    "version": "1.0.6",
    "project_urls": {
        "Changelog": "https://github.com/garrettj403/QMix/blob/master/CHANGES.md",
        "Homepage": "https://garrettj403.github.io/QMix/",
        "Issue Tracker": "https://github.com/garrettj403/QMix/issues"
    },
    "split_keywords": [
        "sis mixers",
        "radio astronomy",
        "superconducting detectors",
        "terahertz instrumentation",
        "python"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f6c7310790eba357e20f2da8bf3bec2e8638320ac6d5e62f86863b01565aaaa4",
                "md5": "c2075aa1cc8cecef56712b2ed140f36e",
                "sha256": "07d410eb3e45a7ecc499e5b9ef5cd091b086f9fe11392b177ff13eb0690c7c45"
            },
            "downloads": -1,
            "filename": "qmix-1.0.6.tar.gz",
            "has_sig": false,
            "md5_digest": "c2075aa1cc8cecef56712b2ed140f36e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 77753,
            "upload_time": "2020-07-09T04:09:57",
            "upload_time_iso_8601": "2020-07-09T04:09:57.110201Z",
            "url": "https://files.pythonhosted.org/packages/f6/c7/310790eba357e20f2da8bf3bec2e8638320ac6d5e62f86863b01565aaaa4/qmix-1.0.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-07-09 04:09:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "garrettj403",
    "github_project": "QMix",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "matplotlib",
            "specs": []
        },
        {
            "name": "numba",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "scipy",
            "specs": []
        }
    ],
    "lcname": "qmix"
}
        
Elapsed time: 0.20543s