<img src="https://raw.githubusercontent.com/QTC-UMD/rydiqule/main/docs/source/img/Rydiqule_Logo_Transparent_300.png" alt="rydiqule" style="max-width: 100%;">
The Rydberg Interactive Quantum module is a modeling library designed to simulate
the response of Rydberg atoms to arbitrary input RF waveforms.
It also functions as a general master equation solver based on the semi-classical density matrix method.
[](https://pypi.org/project/rydiqule)
[](https://anaconda.org/rydiqule/rydiqule)
[](https://python.org)
[](https://github.com/QTC-UMD/rydiqule/raw/main/LICENSE)
[](https://rydiqule.readthedocs.io/en/latest)
### Please cite as
B. N Miller, D. H. Meyer, T. Virtanen, C. M O'Brien, and K. C. Cox,
RydIQule: A Graph-based paradigm for modeling Rydberg and atomic sensors,
*Computer Physics Communications*, **294**, 108952 (2024)
[https://doi.org/10.1016/j.cpc.2023.108952](https://doi.org/10.1016/j.cpc.2023.108952)
## Installation
Installation is done via pip or conda.
See below for detailed instructions.
In all cases, it is highly recommended to install rydiqule in a virtual environment.
### Conda installation (recommended)
Installation via conda is recommended for rydiqule.
It handles dependency installation as well as a virtual environment to ensure packages do not conflict with other usages on the same system.
Finally, the `numpy` provided by anaconda has been compiled against optimized BLAS/LAPACK implementations, which results in much better performance in rydiqule itself.
Assuming you have not already created a separate environment for RydIQule (recommended), run the following to create a new environment:
```shell
(base) ~/> conda create -n rydiqule python=3.11
(base) ~/> conda activate rydiqule
```
RydIQule currently requires python >3.8.
For a new installation, it is recommended to use the newest supported python.
Now install via rydiqule's anaconda channel.
This channel provides rydiqule as well as its dependencies that are not available in the default anaconda channel.
If one of these dependencies is outdated, please raise an issue with the [vendoring repository](https://github.com/QTC-UMD/rydiqule-vendored-conda-builds).
```shell
(rydiqule) ~/> conda install -c rydiqule rydiqule
```
If you would like to install rydiqule in editable mode to locally modify its source,
this must be done using pip.
Follow the above to install rydiqule and its dependencies,
then run the following to uninstall rydiqule as provided by conda
and install the editable local repository.
```shell
(rydiqule) ~/> conda remove rydiqule --force
# following must be run from root of local repository
(rydiqule) ~/> pip install -e .
```
Note that editable installations require `git`.
This can be provided by a system-wide installation or via conda in the virtual environment (`conda install git`).
While rydiqule is a pure python package (ie it is platform independent), its core dependency ARC is not.
If a pre-built package of ARC is not available for your platform in our anaconda channel,
you will need to install ARC via `pip` to build it locally before installing `rydiqule`.
To see what architectures are supported, please see the [vendoring repository](https://github.com/QTC-UMD/rydiqule-vendored-conda-builds).
### Pure pip installation
To install normally, run:
```shell
pip install rydiqule
```
This command will use pip to install all necessary dependencies.
To install in an editable way (which allows edits of the source code),
run the following from the root directory of the cloned repository:
```shell
pip install -e .
```
Editable installation requires `git` to be installed.
### Confirm installation
Proper installation can be confirmed by executing the following commands in a python terminal.
```shell
>>> import rydiqule as rq
>>> rq.about()
Rydiqule
================
Rydiqule Version: 1.1.0
Installation Path: ~\Miniconda3\envs\rydiqule\lib\site-packages\rydiqule
Dependencies
================
NumPy Version: 1.24.3
SciPy Version: 1.10.1
Matplotlib Version: 3.7.1
ARC Version: 3.3.0
Python Version: 3.9.16
Python Install Path: ~\Miniconda3\envs\rydiqule
Platform Info: Windows (AMD64)
CPU Count: 12
Total System Memory: 128 GB
```
### Updating an existing installation
Upgrading an existing installation is simple.
Simply run the appropriate upgrade command for the installation method used.
For conda installations, run the following command to upgrade rydiqule
```shell
conda upgrade rydiqule
```
For `pip`, you can use the installation command to upgrade.
Optionally, include the update flag to greedily update dependencies as well.
```shell
pip install -U rydiqule
```
This command will also install any new dependencies that are required.
If using an editable install, simply replacing the files in the same directory is sufficient.
Though it is recommended to also run the appropriate pip update command as well to capture updated dependencies.
```shell
pip install -U -e .
```
### Dependencies
This package requires installation of the excellent [ARC](https://github.com/nikolasibalic/ARC-Alkali-Rydberg-Calculator) package, which is used to get Rydberg atomic properties.
It also requires other standard computation dependenices, such as `numpy`, `scipy`, `matplotlib`, etc.
These dependencies will be automatically installed if not already present.
Rydiqule's performance does depend on these depedencies.
In particular, `numpy` can be compiled with a variety of backends that implements
BLAS and LAPACK routines that can have different performance for different computer architectures.
When using Windows, it is recommended to install `numpy` from conda,
which is built against the IntelMKL and has generally shown the best performance for Intel-based PCs.
Optional timesolver backend dependencies include the [numbakit-ode](https://github.com/hgrecco/numbakit-ode)
and [CyRK](https://github.com/jrenaud90/CyRK) packages.
Both are available via `pip` or our anaconda channel.
They can be installed automatically via the optional extras specification for the `pip` command.
```shell
pip install rydiqule[backends]
```
For conda installations, these dependencies must be installed manually.
```shell
conda install -c rydiqule CyRK numbakit-ode
```
## Documentation
Documentation is available online at [readthedocs](https://rydiqule.readthedocs.io/en/latest).
PDF or EPUB formats of the documentation can be downloaded from the online documentation.
### Examples
Example jupyter notebooks that demonstrate RydIQule can be found in the `examples` subdirectory.
Printouts of these notebooks are available in the documentation as well.
## Support
Creation of this software was supported in part by the Defense Advanced Research Projects Agency (DARPA) Quantum Apertures program, DEVCOM Army Research Laboratory, and the Quantum Technology Center at the University of Maryland.
## Disclaimer
The views, opinions and/or findings expressed are those of the authors and should not be interpreted as representing the official views or policies of the Department of Defense or the U.S. Government.
## Contact
The github repository is for code distribution only.
While we monitor it,
we will not directly respond to issues or pull requests posted to it.
If you would like a response from the developers, please e-mail
david.h.meyer3.civ@army.mil or kevin.c.cox29.civ@army.mil
Raw data
{
"_id": null,
"home_page": null,
"name": "rydiqule",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "rydberg, atomic-physics, quantum-optics, atomic-sensors, electrometry",
"author": "ARL and NAWCWD",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/17/9d/8bf4c3f76a8e0ccad1c33fda7410feed2f2b3a05871b22e3630217954642/rydiqule-1.2.3.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/QTC-UMD/rydiqule/main/docs/source/img/Rydiqule_Logo_Transparent_300.png\" alt=\"rydiqule\" style=\"max-width: 100%;\">\n\nThe Rydberg Interactive Quantum module is a modeling library designed to simulate\nthe response of Rydberg atoms to arbitrary input RF waveforms.\nIt also functions as a general master equation solver based on the semi-classical density matrix method.\n\n[](https://pypi.org/project/rydiqule)\n[](https://anaconda.org/rydiqule/rydiqule)\n[](https://python.org)\n[](https://github.com/QTC-UMD/rydiqule/raw/main/LICENSE)\n[](https://rydiqule.readthedocs.io/en/latest)\n\n### Please cite as\n\nB. N Miller, D. H. Meyer, T. Virtanen, C. M O'Brien, and K. C. Cox,\nRydIQule: A Graph-based paradigm for modeling Rydberg and atomic sensors,\n*Computer Physics Communications*, **294**, 108952 (2024)\n[https://doi.org/10.1016/j.cpc.2023.108952](https://doi.org/10.1016/j.cpc.2023.108952)\n\n## Installation\n\nInstallation is done via pip or conda.\nSee below for detailed instructions.\n\nIn all cases, it is highly recommended to install rydiqule in a virtual environment.\n\n### Conda installation (recommended)\n\nInstallation via conda is recommended for rydiqule.\nIt handles dependency installation as well as a virtual environment to ensure packages do not conflict with other usages on the same system.\nFinally, the `numpy` provided by anaconda has been compiled against optimized BLAS/LAPACK implementations, which results in much better performance in rydiqule itself.\n\nAssuming you have not already created a separate environment for RydIQule (recommended), run the following to create a new environment:\n```shell\n(base) ~/> conda create -n rydiqule python=3.11\n(base) ~/> conda activate rydiqule\n```\nRydIQule currently requires python >3.8.\nFor a new installation, it is recommended to use the newest supported python.\n\nNow install via rydiqule's anaconda channel.\nThis channel provides rydiqule as well as its dependencies that are not available in the default anaconda channel.\nIf one of these dependencies is outdated, please raise an issue with the [vendoring repository](https://github.com/QTC-UMD/rydiqule-vendored-conda-builds).\n```shell\n(rydiqule) ~/> conda install -c rydiqule rydiqule\n```\n\nIf you would like to install rydiqule in editable mode to locally modify its source,\nthis must be done using pip.\nFollow the above to install rydiqule and its dependencies,\nthen run the following to uninstall rydiqule as provided by conda\nand install the editable local repository.\n```shell\n(rydiqule) ~/> conda remove rydiqule --force\n# following must be run from root of local repository\n(rydiqule) ~/> pip install -e .\n```\n\nNote that editable installations require `git`.\nThis can be provided by a system-wide installation or via conda in the virtual environment (`conda install git`).\n\nWhile rydiqule is a pure python package (ie it is platform independent), its core dependency ARC is not.\nIf a pre-built package of ARC is not available for your platform in our anaconda channel,\nyou will need to install ARC via `pip` to build it locally before installing `rydiqule`.\nTo see what architectures are supported, please see the [vendoring repository](https://github.com/QTC-UMD/rydiqule-vendored-conda-builds).\n\n\n### Pure pip installation\n\nTo install normally, run:\n```shell\npip install rydiqule\n```\nThis command will use pip to install all necessary dependencies.\n\nTo install in an editable way (which allows edits of the source code),\nrun the following from the root directory of the cloned repository:\n```shell\npip install -e .\n```\n\nEditable installation requires `git` to be installed.\n\n### Confirm installation\n\nProper installation can be confirmed by executing the following commands in a python terminal.\n```shell\n>>> import rydiqule as rq\n>>> rq.about()\n\n Rydiqule\n ================\n\nRydiqule Version: 1.1.0\nInstallation Path: ~\\Miniconda3\\envs\\rydiqule\\lib\\site-packages\\rydiqule\n\n Dependencies\n ================\n\nNumPy Version: 1.24.3\nSciPy Version: 1.10.1\nMatplotlib Version: 3.7.1\nARC Version: 3.3.0\nPython Version: 3.9.16\nPython Install Path: ~\\Miniconda3\\envs\\rydiqule\nPlatform Info: Windows (AMD64)\nCPU Count: 12\nTotal System Memory: 128 GB\n```\n\n### Updating an existing installation\n\nUpgrading an existing installation is simple.\nSimply run the appropriate upgrade command for the installation method used.\n\nFor conda installations, run the following command to upgrade rydiqule\n```shell\nconda upgrade rydiqule\n```\n\nFor `pip`, you can use the installation command to upgrade.\nOptionally, include the update flag to greedily update dependencies as well.\n```shell\npip install -U rydiqule\n```\nThis command will also install any new dependencies that are required.\n\nIf using an editable install, simply replacing the files in the same directory is sufficient.\nThough it is recommended to also run the appropriate pip update command as well to capture updated dependencies.\n```shell\npip install -U -e .\n```\n\n### Dependencies\n\nThis package requires installation of the excellent [ARC](https://github.com/nikolasibalic/ARC-Alkali-Rydberg-Calculator) package, which is used to get Rydberg atomic properties.\nIt also requires other standard computation dependenices, such as `numpy`, `scipy`, `matplotlib`, etc.\nThese dependencies will be automatically installed if not already present.\n\nRydiqule's performance does depend on these depedencies.\nIn particular, `numpy` can be compiled with a variety of backends that implements\nBLAS and LAPACK routines that can have different performance for different computer architectures.\nWhen using Windows, it is recommended to install `numpy` from conda,\nwhich is built against the IntelMKL and has generally shown the best performance for Intel-based PCs.\n\nOptional timesolver backend dependencies include the [numbakit-ode](https://github.com/hgrecco/numbakit-ode)\nand [CyRK](https://github.com/jrenaud90/CyRK) packages.\nBoth are available via `pip` or our anaconda channel.\nThey can be installed automatically via the optional extras specification for the `pip` command.\n```shell\npip install rydiqule[backends]\n```\n\nFor conda installations, these dependencies must be installed manually.\n```shell\nconda install -c rydiqule CyRK numbakit-ode\n```\n\n## Documentation\n\nDocumentation is available online at [readthedocs](https://rydiqule.readthedocs.io/en/latest).\nPDF or EPUB formats of the documentation can be downloaded from the online documentation.\n\n### Examples\n\nExample jupyter notebooks that demonstrate RydIQule can be found in the `examples` subdirectory.\nPrintouts of these notebooks are available in the documentation as well.\n\n## Support\n\nCreation of this software was supported in part by the Defense Advanced Research Projects Agency (DARPA) Quantum Apertures program, DEVCOM Army Research Laboratory, and the Quantum Technology Center at the University of Maryland.\n\n## Disclaimer\n\nThe views, opinions and/or findings expressed are those of the authors and should not be interpreted as representing the official views or policies of the Department of Defense or the U.S. Government.\n\n## Contact\n\nThe github repository is for code distribution only.\nWhile we monitor it, \nwe will not directly respond to issues or pull requests posted to it.\nIf you would like a response from the developers, please e-mail\ndavid.h.meyer3.civ@army.mil or kevin.c.cox29.civ@army.mil\n",
"bugtrack_url": null,
"license": "Apache",
"summary": "Rydberg Sensor Interactive Quantum Physics Module",
"version": "1.2.3",
"project_urls": null,
"split_keywords": [
"rydberg",
" atomic-physics",
" quantum-optics",
" atomic-sensors",
" electrometry"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "64f4840315bfae6d54b5e740d5113a17b6b774e1b6c61caa6c89152351378b9e",
"md5": "7f88a4ebc2b44fedebf4983eb09d8707",
"sha256": "f0875e828f5bb9e320e48a308f624c7883a2ce3fc10008c92bf6da7ccaab511b"
},
"downloads": -1,
"filename": "rydiqule-1.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7f88a4ebc2b44fedebf4983eb09d8707",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 86991,
"upload_time": "2024-12-04T01:15:25",
"upload_time_iso_8601": "2024-12-04T01:15:25.788876Z",
"url": "https://files.pythonhosted.org/packages/64/f4/840315bfae6d54b5e740d5113a17b6b774e1b6c61caa6c89152351378b9e/rydiqule-1.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "179d8bf4c3f76a8e0ccad1c33fda7410feed2f2b3a05871b22e3630217954642",
"md5": "9d5ae93963b777b00a638d9cbaf8e4cd",
"sha256": "b64e41fd4845f862b1984d6da1464f6662162f3bac6a5e5b448f9cb87a9296d7"
},
"downloads": -1,
"filename": "rydiqule-1.2.3.tar.gz",
"has_sig": false,
"md5_digest": "9d5ae93963b777b00a638d9cbaf8e4cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 93772,
"upload_time": "2024-12-04T01:15:27",
"upload_time_iso_8601": "2024-12-04T01:15:27.400651Z",
"url": "https://files.pythonhosted.org/packages/17/9d/8bf4c3f76a8e0ccad1c33fda7410feed2f2b3a05871b22e3630217954642/rydiqule-1.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-04 01:15:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "rydiqule"
}
JSON