# Pulser
Pulser is a framework for composing, simulating and executing **pulse** sequences for neutral-atom quantum devices.
**Documentation** for the [latest release](https://pypi.org/project/pulser/) of `pulser` is available at <https://pulser.readthedocs.io> (for the docs tracking the `develop` branch of this repository, visit <https://pulser.readthedocs.io/en/latest> instead).
The source code can be found at <https://github.com/pasqal-io/Pulser>.
## Overview of Pulser
Pulser is designed to let users create experiments that are tailored to specific neutral-atom devices. This reduces the level of abstraction and gives you maximal flexibility and control over the behaviour of the relevant physical parameters, within the bounds set by the chosen device.
Consequently, Pulser breaks free from the paradigm of digital quantum computing
and also allows the creation of **analog** quantum simulations, outside of the
scope of traditional quantum circuit approaches. Whatever the type of experiment
or paradigm, if it can be done on the device, it can be done with Pulser.
Additionally, the ``pulser_simulation`` extension provides tools for classical simulation (using [QuTiP][qutip] libraries) to aid in the development and testing of new pulse sequences.
For a comprehensive overview of Pulser, check out [Pulser's white paper](https://quantum-journal.org/papers/q-2022-01-24-629/).
## Installation
To install the latest release of ``pulser``, have Python 3.9 or higher installed, then use ``pip``:
```bash
pip install pulser
```
The standard ``pulser`` distribution will install the core ``pulser`` package
and the ``pulser_simulation`` extension package, which is required if you want
to access the emulation features.
If you wish to install only the core ``pulser`` features, you can instead run:
```bash
pip install pulser-core
```
### Including PyTorch
To include PyTorch in your installation, append the ``[torch]`` suffix to the commands outlined above, i.e.
```bash
pip install pulser[torch]
```
for the standard ``pulser`` distribution with PyTorch, **or**
```bash
pip install pulser-core[torch]
```
for just the core features plus PyTorch support.
### Development install
If you wish to **install the development version of Pulser from source** instead, do the following from within this repository after cloning it:
```bash
git checkout develop
make dev-install
```
Bear in mind that this installation will track the contents of your local
Pulser repository folder, so if you checkout a different branch (e.g. ``master``),
your installation will change accordingly.
### Development Requirements (Optional)
To run the tutorials or the test suite locally, after installation first run the following to install the development requirements:
```bash
pip install -r dev_requirements.txt
```
Then, you can do the following to run the test suite and report test coverage:
```bash
pytest --cov
```
## Contributing
Want to contribute to Pulser? Great! See [How to Contribute][contributing] for information on how you can do so.
[qutip]: http://qutip.org/
[contributing]: https://github.com/pasqal-io/Pulser/blob/master/CONTRIBUTING.md
## Citing Pulser
Citation references are generated through Zenodo. Click the badge below to get the citation to the latest Pulser release.
[](https://doi.org/10.5281/zenodo.4707943)
Raw data
{
"_id": null,
"home_page": "https://github.com/pasqal-io/Pulser",
"name": "pulser",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Pulser Development Team",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# Pulser\n\nPulser is a framework for composing, simulating and executing **pulse** sequences for neutral-atom quantum devices.\n\n**Documentation** for the [latest release](https://pypi.org/project/pulser/) of `pulser` is available at <https://pulser.readthedocs.io> (for the docs tracking the `develop` branch of this repository, visit <https://pulser.readthedocs.io/en/latest> instead).\n\nThe source code can be found at <https://github.com/pasqal-io/Pulser>.\n\n## Overview of Pulser\n\nPulser is designed to let users create experiments that are tailored to specific neutral-atom devices. This reduces the level of abstraction and gives you maximal flexibility and control over the behaviour of the relevant physical parameters, within the bounds set by the chosen device.\n\nConsequently, Pulser breaks free from the paradigm of digital quantum computing\nand also allows the creation of **analog** quantum simulations, outside of the\nscope of traditional quantum circuit approaches. Whatever the type of experiment\nor paradigm, if it can be done on the device, it can be done with Pulser.\n\nAdditionally, the ``pulser_simulation`` extension provides tools for classical simulation (using [QuTiP][qutip] libraries) to aid in the development and testing of new pulse sequences.\n\nFor a comprehensive overview of Pulser, check out [Pulser's white paper](https://quantum-journal.org/papers/q-2022-01-24-629/).\n\n## Installation\n\nTo install the latest release of ``pulser``, have Python 3.9 or higher installed, then use ``pip``:\n\n```bash\npip install pulser\n```\n\nThe standard ``pulser`` distribution will install the core ``pulser`` package\nand the ``pulser_simulation`` extension package, which is required if you want\nto access the emulation features.\n\nIf you wish to install only the core ``pulser`` features, you can instead run:\n\n```bash\npip install pulser-core\n```\n\n### Including PyTorch\n\nTo include PyTorch in your installation, append the ``[torch]`` suffix to the commands outlined above, i.e.\n\n```bash\npip install pulser[torch]\n```\n\nfor the standard ``pulser`` distribution with PyTorch, **or**\n\n```bash\npip install pulser-core[torch]\n```\n\nfor just the core features plus PyTorch support.\n\n### Development install\n\nIf you wish to **install the development version of Pulser from source** instead, do the following from within this repository after cloning it:\n\n```bash\ngit checkout develop\nmake dev-install\n```\n\nBear in mind that this installation will track the contents of your local\nPulser repository folder, so if you checkout a different branch (e.g. ``master``),\nyour installation will change accordingly.\n\n### Development Requirements (Optional)\n\nTo run the tutorials or the test suite locally, after installation first run the following to install the development requirements:\n\n```bash\npip install -r dev_requirements.txt\n```\n\nThen, you can do the following to run the test suite and report test coverage:\n\n```bash\npytest --cov\n```\n\n## Contributing\n\nWant to contribute to Pulser? Great! See [How to Contribute][contributing] for information on how you can do so.\n\n[qutip]: http://qutip.org/\n[contributing]: https://github.com/pasqal-io/Pulser/blob/master/CONTRIBUTING.md\n\n## Citing Pulser\n\nCitation references are generated through Zenodo. Click the badge below to get the citation to the latest Pulser release.\n\n[](https://doi.org/10.5281/zenodo.4707943)\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "A pulse-level composer for neutral-atom quantum devices.",
"version": "1.3.0",
"project_urls": {
"Homepage": "https://github.com/pasqal-io/Pulser"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b8e36932db106f127a65771f75bb4817388bd734d00c474967cef77c1776e858",
"md5": "d3f59d3fd4767e2978e76e3b2e17e367",
"sha256": "200a2aa36c22e0f8086d589f590b4ba0b46faaaa92c926f72dbe103a3276db63"
},
"downloads": -1,
"filename": "pulser-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d3f59d3fd4767e2978e76e3b2e17e367",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6804,
"upload_time": "2025-02-14T17:16:56",
"upload_time_iso_8601": "2025-02-14T17:16:56.355292Z",
"url": "https://files.pythonhosted.org/packages/b8/e3/6932db106f127a65771f75bb4817388bd734d00c474967cef77c1776e858/pulser-1.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-14 17:16:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pasqal-io",
"github_project": "Pulser",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pulser"
}
JSON
