Skip to main content
Latest version on PyPI Linux/MacOS/Windows build status Coverage report

dwave-cloud-client

D-Wave Cloud Client is a minimal implementation of the REST interface used to communicate with D-Wave Sampler API (SAPI) servers.

SAPI is an application layer built to provide resource discovery, permissions, and scheduling for quantum annealing resources at D-Wave Systems. This package provides a minimal Python interface to that layer without compromising the quality of interactions and workflow.

The example below instantiates a D-Wave Cloud Client and solver based on the local system’s auto-detected default configuration file and samples a random Ising problem tailored to fit the solver’s graph.

import random
from dwave.cloud import Client

# Connect using the default or environment connection information
with Client.from_config() as client:

    # Load the default solver
    solver = client.get_solver()

    # Build a random Ising model to exactly fit the graph the solver supports
    linear = {index: random.choice([-1, 1]) for index in solver.nodes}
    quad = {key: random.choice([-1, 1]) for key in solver.undirected_edges}

    # Send the problem for sampling, include solver-specific parameter 'num_reads'
    computation = solver.sample_ising(linear, quad, num_reads=100)

    # Print the first sample out of a hundred
    print(computation.samples[0])

Installation

Requires Python 3.8+:

pip install dwave-cloud-client

To install from source (available on GitHub in dwavesystems/dwave-cloud-client repo):

pip install -r requirements.txt
python setup.py install

License

Released under the Apache License 2.0. See LICENSE file.

Contributing

Ocean’s contributing guide has guidelines for contributing to Ocean packages.

Release Notes

D-Wave Cloud Client uses reno to manage its release notes.

When making a contribution to D-Wave Cloud Client that will affect users, create a new release note file by running

reno new your-short-descriptor-here

You can then edit the file created under releasenotes/notes/. Remove any sections not relevant to your changes. Commit the file along with your changes.

See reno’s user guide for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dwave_cloud_client-0.14.7.tar.gz (208.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dwave_cloud_client-0.14.7-py3-none-any.whl (170.5 kB view details)

Uploaded Python 3

File details

Details for the file dwave_cloud_client-0.14.7.tar.gz.

File metadata

  • Download URL: dwave_cloud_client-0.14.7.tar.gz
  • Upload date:
  • Size: 208.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for dwave_cloud_client-0.14.7.tar.gz
Algorithm Hash digest
SHA256 84421a97bc95c0b5062c936a34b5888a91ac8f6dfbf14f5f1e95776ad2be7159
MD5 db6b58071a29ac09f3cb9be5988ab2a3
BLAKE2b-256 cd731251ff33f054fb4a63bb9022c9beffa7767cca0aab50d1591d6e40a50a69

See more details on using hashes here.

File details

Details for the file dwave_cloud_client-0.14.7-py3-none-any.whl.

File metadata

File hashes

Hashes for dwave_cloud_client-0.14.7-py3-none-any.whl
Algorithm Hash digest
SHA256 cec41ab52bd81658ed15588424f818487de82a06465832a81842475b1a731cac
MD5 5834a27ae9a35ea7a9f14d449f1a8f78
BLAKE2b-256 e23ea684c0057c5f8a8e161596e4d13c1b839c6ca98c7cdced059307de41478b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page