Welcome to the Pasqal analog emulators

There are currently two emulators, emu-sv and emu-mps, the specific documentation for which you can access from the list above. As of this writing, the emulators are provided for Linux and macOS but will not work under Windows.

Installation

Warning: installing any emulator will update pulser-core

Using `hatch`, `uv` or any pyproject-compatible Python manager

To add emu-sv or emu-mpsto your project, edit your pyproject.toml to add the line

  "<emulator>"

to the list of dependencies.

Using `pip` or `pipx`

To install the pipy package using pip or pipx

Create a venv if that's not done yet

$ python -m venv venv

Enter the venv

If you're running Unix:

$ . venv/bin/activate

Install the package

$ pip install <emulator>
# or
$ pipx install <emulator>

Join us on Slack or by e-mail to give us feedback about how you plan to use the emulators or if you require specific feature-upgrades.

Usage

For the time being, the easiest way to learn how to use the emulators is to look at the examples in the repo, the emu-sv notebooks and the emu-mps notebooks.

See also the emulator specific documentation for supported features, benchmarks etc.

Getting in touch

Pasqal Community Portal (forums, chat, tutorials, examples, code library).
GitHub Repository (source code, issue tracker).
Professional Support (if you need tech support, custom licenses, a variant of this library optimized for your workload, your own QPU, remote access to a QPU, ...)

Running a Pulser sequence and getting results

Several example notebooks are included in this documentation. Please see the links provided under usage

More Info

Many usage patterns are shared between all emulators. The computing observable page details how to compute observables (see here). The base classes enforcing the usage pattern are documented here.