# Qiskit Nature
[](https://opensource.org/licenses/Apache-2.0)
**Qiskit Nature** is an open-source framework which supports solving quantum mechanical natural
science problems using quantum computing algorithms. This includes finding ground and excited
states of electronic and vibrational structure problems, measuring the dipole moments of molecular
systems, solving the Ising and Fermi-Hubbard models on lattices, and much more.
The code comprises various modules revolving around:
- data loading from chemistry drivers or file formats
- second-quantized operator construction and manipulation
- translating from the second-quantized to the qubit space
- a quantum circuit library of natural science targeted ansatze
- natural science specific algorithms and utilities to make the use of
algorithms from [Qiskit Algorithms](https://qiskit-community.github.io/qiskit-algorithms/) easier
- and much more
## Installation
We encourage installing Qiskit Nature via the pip tool (a python package manager).
```bash
pip install qiskit-nature
```
**pip** will handle all dependencies automatically and you will always install the latest
(and well-tested) version.
If you want to work on the very latest work-in-progress versions, either to try features ahead of
their official release or if you want to contribute to Qiskit Nature, then you can install from source.
To do this follow the instructions in the
[documentation](https://qiskit-community.github.io/qiskit-nature/getting_started.html#installation).
### Optional Installs
To run chemistry experiments using Qiskit Nature, it is recommended that you install
a classical computation chemistry software program/library interfaced by Qiskit.
Several, as listed below, are supported, and while logic to interface these programs is supplied by
Qiskit Nature via the above pip installation, the dependent programs/libraries themselves need
to be installed separately.
- [Gaussian 16™](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.gaussiand.html), a commercial chemistry program
- [PSI4](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.psi4d.html), a chemistry program that exposes a Python interface allowing for accessing internal objects
- [PySCF](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.pyscfd.html), an open-source Python chemistry program
The above codes can be used in a very limited fashion through Qiskit Nature.
While this is useful for getting started and testing purposes, a better experience can be had in the reversed order of responsibility.
That is, in a setup where the classical code runs the Qiskit Nature components.
Such an integration currently exists for the following packages:
- PySCF via [qiskit-nature-pyscf](https://qiskit-community.github.io/qiskit-nature-pyscf/)
If you are interested in using Psi4, we are actively looking for help to get started on a similar integration in [qiskit-nature-psi4](https://github.com/qiskit-community/qiskit-nature-psi4).
Additionally, you may find the following optional dependencies useful:
- [sparse](https://github.com/pydata/sparse/), a library for sparse multi-dimensional arrays. When installed, Qiskit Nature can leverage this to reduce the memory requirements of your calculations.
- [opt_einsum](https://github.com/dgasmith/opt_einsum), a tensor contraction order optimizer for `np.einsum`.
## Creating Your First Chemistry Programming Experiment in Qiskit
Check our [getting started page](https://qiskit-community.github.io/qiskit-nature/getting_started.html)
for a first example on how to use Qiskit Nature.
### Further examples
Learning path notebooks may be found in the
[Nature Tutorials](https://qiskit-community.github.io/qiskit-nature/tutorials/index.html) section
of the documentation and are a great place to start.
----------------------------------------------------------------------------------------------------
## Contribution Guidelines
If you'd like to contribute to Qiskit, please take a look at our
[contribution guidelines](https://github.com/qiskit-community/qiskit-nature/blob/main/CONTRIBUTING.md).
This project adheres to Qiskit's [code of conduct](https://github.com/qiskit-community/qiskit-nature/blob/main/CODE_OF_CONDUCT.md).
By participating, you are expected to uphold this code.
We use [GitHub issues](https://github.com/qiskit-community/qiskit-nature/issues) for tracking requests and bugs. Please
[join the Qiskit Slack community](https://qisk.it/join-slack)
for discussion and simple questions.
For questions that are more suited for a forum, we use the **Qiskit** tag in [Stack Overflow](https://stackoverflow.com/questions/tagged/qiskit).
## Authors and Citation
Qiskit Nature was inspired, authored and brought about by the collective work of a team of researchers.
Qiskit Nature continues to grow with the help and work of
[many people](https://github.com/qiskit-community/qiskit-nature/graphs/contributors), who contribute
to the project at different levels.
If you use Qiskit Nature, please cite the following references:
- Qiskit, as per the provided [BibTeX file](https://github.com/Qiskit/qiskit/blob/main/CITATION.bib).
- Qiskit Nature, as per https://doi.org/10.5281/zenodo.7828767
## License
This project uses the [Apache License 2.0](https://github.com/qiskit-community/qiskit-nature/blob/main/LICENSE.txt).
However there is some code that is included under other licensing as follows:
* The [Gaussian 16 driver](https://github.com/qiskit-community/qiskit-nature/tree/main/qiskit_nature/second_q/drivers/gaussiand) in `qiskit-nature`
contains [work](https://github.com/qiskit-community/qiskit-nature/tree/main/qiskit_nature/second_q/drivers/gaussiand/gauopen) licensed under the
[Gaussian Open-Source Public License](https://github.com/qiskit-community/qiskit-nature/blob/main/qiskit_nature/second_q/drivers/gaussiand/gauopen/LICENSE.txt).
Raw data
{
"_id": null,
"home_page": "https://github.com/Qiskit/qiskit-nature",
"name": "qiskit-nature",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "qiskit sdk quantum nature chemistry physics",
"author": "Qiskit Nature Development Team",
"author_email": "qiskit@us.ibm.com",
"download_url": "https://files.pythonhosted.org/packages/89/36/d8dfb1b241a5c3ec5a8868bc4d7311af23dc741c81d0d8b93a6fb63c0366/qiskit-nature-0.7.2.tar.gz",
"platform": null,
"description": "# Qiskit Nature\n\n[](https://opensource.org/licenses/Apache-2.0)\n\n**Qiskit Nature** is an open-source framework which supports solving quantum mechanical natural\nscience problems using quantum computing algorithms. This includes finding ground and excited\nstates of electronic and vibrational structure problems, measuring the dipole moments of molecular\nsystems, solving the Ising and Fermi-Hubbard models on lattices, and much more.\n\n\n\nThe code comprises various modules revolving around:\n\n- data loading from chemistry drivers or file formats\n- second-quantized operator construction and manipulation\n- translating from the second-quantized to the qubit space\n- a quantum circuit library of natural science targeted ansatze\n- natural science specific algorithms and utilities to make the use of\n algorithms from [Qiskit Algorithms](https://qiskit-community.github.io/qiskit-algorithms/) easier\n- and much more\n\n## Installation\n\nWe encourage installing Qiskit Nature via the pip tool (a python package manager).\n\n```bash\npip install qiskit-nature\n```\n\n**pip** will handle all dependencies automatically and you will always install the latest\n(and well-tested) version.\n\nIf you want to work on the very latest work-in-progress versions, either to try features ahead of\ntheir official release or if you want to contribute to Qiskit Nature, then you can install from source.\nTo do this follow the instructions in the\n [documentation](https://qiskit-community.github.io/qiskit-nature/getting_started.html#installation).\n\n### Optional Installs\n\nTo run chemistry experiments using Qiskit Nature, it is recommended that you install\na classical computation chemistry software program/library interfaced by Qiskit.\nSeveral, as listed below, are supported, and while logic to interface these programs is supplied by\nQiskit Nature via the above pip installation, the dependent programs/libraries themselves need\nto be installed separately.\n\n- [Gaussian 16™](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.gaussiand.html), a commercial chemistry program\n- [PSI4](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.psi4d.html), a chemistry program that exposes a Python interface allowing for accessing internal objects\n- [PySCF](https://qiskit-community.github.io/qiskit-nature/apidocs/qiskit_nature.second_q.drivers.pyscfd.html), an open-source Python chemistry program\n\nThe above codes can be used in a very limited fashion through Qiskit Nature.\nWhile this is useful for getting started and testing purposes, a better experience can be had in the reversed order of responsibility.\nThat is, in a setup where the classical code runs the Qiskit Nature components.\nSuch an integration currently exists for the following packages:\n\n- PySCF via [qiskit-nature-pyscf](https://qiskit-community.github.io/qiskit-nature-pyscf/)\n\nIf you are interested in using Psi4, we are actively looking for help to get started on a similar integration in [qiskit-nature-psi4](https://github.com/qiskit-community/qiskit-nature-psi4).\n\nAdditionally, you may find the following optional dependencies useful:\n\n- [sparse](https://github.com/pydata/sparse/), a library for sparse multi-dimensional arrays. When installed, Qiskit Nature can leverage this to reduce the memory requirements of your calculations.\n- [opt_einsum](https://github.com/dgasmith/opt_einsum), a tensor contraction order optimizer for `np.einsum`.\n\n## Creating Your First Chemistry Programming Experiment in Qiskit\n\nCheck our [getting started page](https://qiskit-community.github.io/qiskit-nature/getting_started.html)\nfor a first example on how to use Qiskit Nature.\n\n### Further examples\n\nLearning path notebooks may be found in the\n[Nature Tutorials](https://qiskit-community.github.io/qiskit-nature/tutorials/index.html) section\nof the documentation and are a great place to start.\n\n\n----------------------------------------------------------------------------------------------------\n\n\n## Contribution Guidelines\n\nIf you'd like to contribute to Qiskit, please take a look at our\n[contribution guidelines](https://github.com/qiskit-community/qiskit-nature/blob/main/CONTRIBUTING.md).\nThis project adheres to Qiskit's [code of conduct](https://github.com/qiskit-community/qiskit-nature/blob/main/CODE_OF_CONDUCT.md).\nBy participating, you are expected to uphold this code.\n\nWe use [GitHub issues](https://github.com/qiskit-community/qiskit-nature/issues) for tracking requests and bugs. Please\n[join the Qiskit Slack community](https://qisk.it/join-slack)\nfor discussion and simple questions.\nFor questions that are more suited for a forum, we use the **Qiskit** tag in [Stack Overflow](https://stackoverflow.com/questions/tagged/qiskit).\n\n## Authors and Citation\n\nQiskit Nature was inspired, authored and brought about by the collective work of a team of researchers.\nQiskit Nature continues to grow with the help and work of\n[many people](https://github.com/qiskit-community/qiskit-nature/graphs/contributors), who contribute\nto the project at different levels.\nIf you use Qiskit Nature, please cite the following references:\n\n- Qiskit, as per the provided [BibTeX file](https://github.com/Qiskit/qiskit/blob/main/CITATION.bib).\n- Qiskit Nature, as per https://doi.org/10.5281/zenodo.7828767\n\n## License\n\nThis project uses the [Apache License 2.0](https://github.com/qiskit-community/qiskit-nature/blob/main/LICENSE.txt).\n\nHowever there is some code that is included under other licensing as follows:\n\n* The [Gaussian 16 driver](https://github.com/qiskit-community/qiskit-nature/tree/main/qiskit_nature/second_q/drivers/gaussiand) in `qiskit-nature`\n contains [work](https://github.com/qiskit-community/qiskit-nature/tree/main/qiskit_nature/second_q/drivers/gaussiand/gauopen) licensed under the\n [Gaussian Open-Source Public License](https://github.com/qiskit-community/qiskit-nature/blob/main/qiskit_nature/second_q/drivers/gaussiand/gauopen/LICENSE.txt).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Qiskit Nature: A library of quantum computing chemistry/physics experiments",
"version": "0.7.2",
"project_urls": {
"Bug Tracker": "https://github.com/Qiskit/qiskit-nature/issues",
"Documentation": "https://qiskit-community.github.io/qiskit-nature/",
"Homepage": "https://github.com/Qiskit/qiskit-nature",
"Source Code": "https://github.com/Qiskit/qiskit-nature"
},
"split_keywords": [
"qiskit",
"sdk",
"quantum",
"nature",
"chemistry",
"physics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "66162bf5c270457dbda2123604108f007f4b7087fa5a3913e60f5a4f75b76d92",
"md5": "391a6fa1a32d7c39ebaa039ce6a7a5cf",
"sha256": "9bc8900626b9a6f9c5dbe44589c53932408a661d61ad9003b8feadb30979cc05"
},
"downloads": -1,
"filename": "qiskit_nature-0.7.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "391a6fa1a32d7c39ebaa039ce6a7a5cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 2156071,
"upload_time": "2024-02-23T10:20:44",
"upload_time_iso_8601": "2024-02-23T10:20:44.884597Z",
"url": "https://files.pythonhosted.org/packages/66/16/2bf5c270457dbda2123604108f007f4b7087fa5a3913e60f5a4f75b76d92/qiskit_nature-0.7.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8936d8dfb1b241a5c3ec5a8868bc4d7311af23dc741c81d0d8b93a6fb63c0366",
"md5": "28b74a13c42eaf7e6740be076f501cef",
"sha256": "621b9bb88c0fa4c705948af86e3ef7d36bb8e7aa11b95801264527de58fcd694"
},
"downloads": -1,
"filename": "qiskit-nature-0.7.2.tar.gz",
"has_sig": false,
"md5_digest": "28b74a13c42eaf7e6740be076f501cef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2185596,
"upload_time": "2024-02-23T10:20:50",
"upload_time_iso_8601": "2024-02-23T10:20:50.390598Z",
"url": "https://files.pythonhosted.org/packages/89/36/d8dfb1b241a5c3ec5a8868bc4d7311af23dc741c81d0d8b93a6fb63c0366/qiskit-nature-0.7.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-23 10:20:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Qiskit",
"github_project": "qiskit-nature",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "qiskit",
"specs": [
[
">=",
"0.44"
]
]
},
{
"name": "qiskit-algorithms",
"specs": [
[
">=",
"0.2.1"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"1.4"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.17"
]
]
},
{
"name": "psutil",
"specs": [
[
">=",
"5"
]
]
},
{
"name": "setuptools",
"specs": [
[
">=",
"40.1.0"
]
]
},
{
"name": "typing_extensions",
"specs": []
},
{
"name": "h5py",
"specs": []
},
{
"name": "rustworkx",
"specs": [
[
">=",
"0.12"
]
]
}
],
"tox": true,
"lcname": "qiskit-nature"
}
JSON
