qutip-qtrl


Namequtip-qtrl JSON
Version 0.1.1 PyPI version JSON
download
home_pagehttps://github.com/qutip/qutip-qtrl
SummaryThe QuTiP quantum optimal control package
upload_time2024-02-12 21:44:37
maintainer
docs_urlNone
authorAlexander Pitchford, Paul D. Nation, Robert J. Johansson, Chris Granade, Arne Grimsmo, Nathan Shammah, Shahnawaz Ahmed, Neill Lambert, Eric Giguere, Boxi Li, Jake Lishman, Simon Cross, Asier Galicia
requires_python
licenseBSD 3-Clause License
keywords quantum physics dynamics optimal control
VCS
bugtrack_url
requirements numpy scipy qutip
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # qutip-qtrl

[![build](https://github.com/qutip/qutip-qtrl/workflows/Tests/badge.svg)](https://github.com/qutip/qutip-qtrl/actions)
[![Documentation Status](https://readthedocs.org/projects/qutip-qtrl/badge/?version=stable)](https://qutip-qtrl.readthedocs.io/en/stable/)
[![PyPI version](https://badge.fury.io/py/qutip-qtrl.svg)](https://badge.fury.io/py/qutip-qtrl)
[![Maintainability](https://api.codeclimate.com/v1/badges/30293d7b8eb249f8d679/maintainability)](https://codeclimate.com/github/qutip/qutip-qtrl/maintainability)
[![Coverage Status](https://coveralls.io/repos/github/qutip/qutip-qtrl/badge.svg)](https://coveralls.io/github/qutip/qutip-qtrl)

The qutip-qtrl package used to be a module ``qutip.control`` under [QuTiP (Quantum Toolbox in Python)](http://qutip.org/index.html).
From QuTiP 5.0, the community has decided to decrease the size of the core QuTiP package by reducing the external dependencies, in order to simplify maintenance.
Hence a few modules are separated from the core QuTiP and will become QuTiP family packages.
They are still maintained by the QuTiP team but hosted under different repositories in the [QuTiP organization](https://github.com/qutip).

The qutip-qtrl package, QuTiP quantum optimal control, aims at providing advanced tools for the optimal control of quantum devices.
Compared to other libraries for quantum optimal control, qutip-qtrl puts additional emphasis on the physics layer and the interaction with the QuTiP package.
The package offers support for both the CRAB and GRAPE methods.

If you would like to know the future development plan and ideas, have a look at the [qutip documentation for ideas](https://qutip.org/docs/latest/development/ideas.html).

Quick start
-----------
To install the package, use
```
pip install qutip-qtrl
```

Migrating from ``qutip.control``
--------------------------------
As the introduction suggested, this package is based on a module in the [QuTiP](http://qutip.org/docs/latest/) package `qutip.control`.
If you were using the `qutip` package and now want to try out the new features included in this package, you can simply install this package and replace all the `qutip.control` in your import statement with `qutip_qtrl`. Everything should work smoothly as usual.

Documentation and tutorials
---------------------------
The documentation of `qutip-qtrl` updated to the latest development version is hosted at [qutip-qtrl.readthedocs.io/](https://qutip-qtrl.readthedocs.io/en/stable/).
Tutorials related to using quantum optimal control in `qutip-qtrl` can be found [*here*](https://qutip.org/qutip-tutorials/#optimal-control).

Installation from source
------------------------
If you want to edit the source code, please download the source code and run the following command under the root `qutip-qtrl` folder,
```
pip install --upgrade pip
pip install -e .
```
which makes sure that you are up to date with the latest `pip` version. Contribution guidelines are available [*here*](https://qutip-qtrl.readthedocs.io/en/latest/contribution-code.html).

To build and test the documentation, additional packages need to be installed:

```
pip install pytest matplotlib sphinx numpydoc sphinx_rtd_theme
```

Under the `doc` directory, use
```
make html
```
to build the documentation, or
```
make doctest
```
to test the code in the documentation.

Testing
-------
To test the installation, choose the correct branch that matches with the version, e.g., `qutip-qtrl-0.2.X` for version 0.2. Then download the source code and run from the `qutip-qtrl` directory.
```
pytest tests
```

Citing `qutip-qtrl`
-------------------
If you use `qutip-qtrl` in your research, please cite the original QuTiP papers that are available [here](https://dml.riken.jp/?s=QuTiP).

Support
-------
This package is supported and maintained by the same developers group as QuTiP.

[![Powered by NumFOCUS](https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A)](https://numfocus.org)
[![Unitary Fund](https://img.shields.io/badge/Supported%20By-UNITARY%20FUND-brightgreen.svg?style=flat)](https://unitary.fund)

QuTiP development is supported by [Nori's lab](http://dml.riken.jp/)
at RIKEN, by the University of Sherbrooke, by Chalmers University of Technology, by Macquarie University and by Aberystwyth University,
[among other supporting organizations](http://qutip.org/#supporting-organizations).

License
-------
[![license](https://img.shields.io/badge/license-New%20BSD-blue.svg)](http://en.wikipedia.org/wiki/BSD_licenses#3-clause_license_.28.22Revised_BSD_License.22.2C_.22New_BSD_License.22.2C_or_.22Modified_BSD_License.22.29)

You are free to use this software, with or without modification, provided that the conditions listed in the LICENSE.txt file are satisfied.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/qutip/qutip-qtrl",
    "name": "qutip-qtrl",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "quantum,physics,dynamics,optimal,control",
    "author": "Alexander Pitchford, Paul D. Nation, Robert J. Johansson, Chris Granade, Arne Grimsmo, Nathan Shammah, Shahnawaz Ahmed, Neill Lambert, Eric Giguere, Boxi Li, Jake Lishman, Simon Cross, Asier Galicia",
    "author_email": "qutip-admin@googlegroups.com",
    "download_url": "https://files.pythonhosted.org/packages/28/da/41a14a639af80636334d32e77526b8264e73735d0a784a8c63de0e6a732e/qutip-qtrl-0.1.1.tar.gz",
    "platform": "Linux",
    "description": "# qutip-qtrl\n\n[![build](https://github.com/qutip/qutip-qtrl/workflows/Tests/badge.svg)](https://github.com/qutip/qutip-qtrl/actions)\n[![Documentation Status](https://readthedocs.org/projects/qutip-qtrl/badge/?version=stable)](https://qutip-qtrl.readthedocs.io/en/stable/)\n[![PyPI version](https://badge.fury.io/py/qutip-qtrl.svg)](https://badge.fury.io/py/qutip-qtrl)\n[![Maintainability](https://api.codeclimate.com/v1/badges/30293d7b8eb249f8d679/maintainability)](https://codeclimate.com/github/qutip/qutip-qtrl/maintainability)\n[![Coverage Status](https://coveralls.io/repos/github/qutip/qutip-qtrl/badge.svg)](https://coveralls.io/github/qutip/qutip-qtrl)\n\nThe qutip-qtrl package used to be a module ``qutip.control`` under [QuTiP (Quantum Toolbox in Python)](http://qutip.org/index.html).\nFrom QuTiP 5.0, the community has decided to decrease the size of the core QuTiP package by reducing the external dependencies, in order to simplify maintenance.\nHence a few modules are separated from the core QuTiP and will become QuTiP family packages.\nThey are still maintained by the QuTiP team but hosted under different repositories in the [QuTiP organization](https://github.com/qutip).\n\nThe qutip-qtrl package, QuTiP quantum optimal control, aims at providing advanced tools for the optimal control of quantum devices.\nCompared to other libraries for quantum optimal control, qutip-qtrl puts additional emphasis on the physics layer and the interaction with the QuTiP package.\nThe package offers support for both the CRAB and GRAPE methods.\n\nIf you would like to know the future development plan and ideas, have a look at the [qutip documentation for ideas](https://qutip.org/docs/latest/development/ideas.html).\n\nQuick start\n-----------\nTo install the package, use\n```\npip install qutip-qtrl\n```\n\nMigrating from ``qutip.control``\n--------------------------------\nAs the introduction suggested, this package is based on a module in the [QuTiP](http://qutip.org/docs/latest/) package `qutip.control`.\nIf you were using the `qutip` package and now want to try out the new features included in this package, you can simply install this package and replace all the `qutip.control` in your import statement with `qutip_qtrl`. Everything should work smoothly as usual.\n\nDocumentation and tutorials\n---------------------------\nThe documentation of `qutip-qtrl` updated to the latest development version is hosted at [qutip-qtrl.readthedocs.io/](https://qutip-qtrl.readthedocs.io/en/stable/).\nTutorials related to using quantum optimal control in `qutip-qtrl` can be found [*here*](https://qutip.org/qutip-tutorials/#optimal-control).\n\nInstallation from source\n------------------------\nIf you want to edit the source code, please download the source code and run the following command under the root `qutip-qtrl` folder,\n```\npip install --upgrade pip\npip install -e .\n```\nwhich makes sure that you are up to date with the latest `pip` version. Contribution guidelines are available [*here*](https://qutip-qtrl.readthedocs.io/en/latest/contribution-code.html).\n\nTo build and test the documentation, additional packages need to be installed:\n\n```\npip install pytest matplotlib sphinx numpydoc sphinx_rtd_theme\n```\n\nUnder the `doc` directory, use\n```\nmake html\n```\nto build the documentation, or\n```\nmake doctest\n```\nto test the code in the documentation.\n\nTesting\n-------\nTo test the installation, choose the correct branch that matches with the version, e.g., `qutip-qtrl-0.2.X` for version 0.2. Then download the source code and run from the `qutip-qtrl` directory.\n```\npytest tests\n```\n\nCiting `qutip-qtrl`\n-------------------\nIf you use `qutip-qtrl` in your research, please cite the original QuTiP papers that are available [here](https://dml.riken.jp/?s=QuTiP).\n\nSupport\n-------\nThis package is supported and maintained by the same developers group as QuTiP.\n\n[![Powered by NumFOCUS](https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A)](https://numfocus.org)\n[![Unitary Fund](https://img.shields.io/badge/Supported%20By-UNITARY%20FUND-brightgreen.svg?style=flat)](https://unitary.fund)\n\nQuTiP development is supported by [Nori's lab](http://dml.riken.jp/)\nat RIKEN, by the University of Sherbrooke, by Chalmers University of Technology, by Macquarie University and by Aberystwyth University,\n[among other supporting organizations](http://qutip.org/#supporting-organizations).\n\nLicense\n-------\n[![license](https://img.shields.io/badge/license-New%20BSD-blue.svg)](http://en.wikipedia.org/wiki/BSD_licenses#3-clause_license_.28.22Revised_BSD_License.22.2C_.22New_BSD_License.22.2C_or_.22Modified_BSD_License.22.29)\n\nYou are free to use this software, with or without modification, provided that the conditions listed in the LICENSE.txt file are satisfied.\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause License",
    "summary": "The QuTiP quantum optimal control package",
    "version": "0.1.1",
    "project_urls": {
        "Homepage": "https://github.com/qutip/qutip-qtrl"
    },
    "split_keywords": [
        "quantum",
        "physics",
        "dynamics",
        "optimal",
        "control"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "63cecd709ad09da8dc1936db314af37d36c321cc32fc7f572fa12c308d64608a",
                "md5": "a3b18e9c46e130a7a558c075002f42af",
                "sha256": "9fd24d7ea50efd5c07eaa93d823e97ee376b0d5f163bb76eea5a23586ebeb480"
            },
            "downloads": -1,
            "filename": "qutip_qtrl-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a3b18e9c46e130a7a558c075002f42af",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 89746,
            "upload_time": "2024-02-12T21:44:36",
            "upload_time_iso_8601": "2024-02-12T21:44:36.005381Z",
            "url": "https://files.pythonhosted.org/packages/63/ce/cd709ad09da8dc1936db314af37d36c321cc32fc7f572fa12c308d64608a/qutip_qtrl-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "28da41a14a639af80636334d32e77526b8264e73735d0a784a8c63de0e6a732e",
                "md5": "0a3a4c79102a86f214a44e2e9ed4bbe7",
                "sha256": "8cf71ce1652d2215edbf3d6ce055585162a442b3eb0007a1041c405b138639fc"
            },
            "downloads": -1,
            "filename": "qutip-qtrl-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0a3a4c79102a86f214a44e2e9ed4bbe7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 92917,
            "upload_time": "2024-02-12T21:44:37",
            "upload_time_iso_8601": "2024-02-12T21:44:37.372664Z",
            "url": "https://files.pythonhosted.org/packages/28/da/41a14a639af80636334d32e77526b8264e73735d0a784a8c63de0e6a732e/qutip-qtrl-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-12 21:44:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "qutip",
    "github_project": "qutip-qtrl",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.12"
                ]
            ]
        },
        {
            "name": "scipy",
            "specs": [
                [
                    ">=",
                    "1.0"
                ]
            ]
        },
        {
            "name": "qutip",
            "specs": [
                [
                    ">=",
                    "5.0"
                ]
            ]
        }
    ],
    "lcname": "qutip-qtrl"
}
        
Elapsed time: 0.18278s