dwave-inspector


Namedwave-inspector JSON
Version 0.5.2 PyPI version JSON
download
home_pagehttps://github.com/dwavesystems/dwave-inspector
SummaryD-Wave Problem Inspector tool
upload_time2024-11-26 16:03:52
maintainerNone
docs_urlNone
authorD-Wave Systems Inc.
requires_python>=3.9
licenseApache 2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            .. image:: https://badge.fury.io/py/dwave-inspector.svg
    :target: https://badge.fury.io/py/dwave-inspector
    :alt: Latest version on PyPI

.. image:: https://circleci.com/gh/dwavesystems/dwave-inspector.svg?style=shield
    :target: https://circleci.com/gh/dwavesystems/dwave-inspector
    :alt: Linux/MacOS build status

.. image:: https://codecov.io/gh/dwavesystems/dwave-inspector/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/dwavesystems/dwave-inspector
    :alt: Coverage report


================
D-Wave Inspector
================

.. index-start-marker

A tool for visualizing problems submitted to, and answers received from, a
D-Wave structured solver such as an Advantage\ |TM| quantum computer.

.. |TM| replace:: :sup:`TM`

.. index-end-marker


Example
=======

.. example-start-marker

This example shows a typical usage: a binary quadratic model minor-embedded 
onto a quantum processing unit (QPU).

.. code-block:: python

    from dwave.system import DWaveSampler, EmbeddingComposite
    import dimod
    import dwave.inspector

    # Get sampler
    sampler = EmbeddingComposite(DWaveSampler())

    # Define a problem
    x, y, z = dimod.Binaries(['x', 'y', 'z'])
    bqm = x*y - x*z + 2*y

    # Sample
    sampleset = sampler.sample(bqm, num_reads=100)

    # Inspect
    dwave.inspector.show(sampleset)

.. example-end-marker


Installation or Building
========================

.. installation-start-marker

If `D-Wave Ocean SDK 2.0+ <https://docs.ocean.dwavesys.com/>`_ is installed:

.. code-block:: bash

    dwave install inspector

Otherwise, install the package from PyPI:

.. code-block:: bash

    pip install dwave-inspector

and then install the closed-source dependency with:

.. code-block:: bash

    pip install dwave-inspectorapp --extra-index=https://pypi.dwavesys.com/simple

Please note this closed-source dependency is released under the 
`D-Wave EULA <https://docs.ocean.dwavesys.com/en/stable/licenses/inspector.html>`_ 
license.

Alternatively, clone and build from source:

.. code-block:: bash

    git clone https://github.com/dwavesystems/dwave-inspector.git
    cd dwave-inspector
    pip install -r requirements.txt
    python setup.py install

When building from source, the closed-source component still needs to be
installed as above.

.. installation-end-marker


License
=======

Released under the Apache License 2.0. See `<LICENSE>`_ file.

Visualization component released under the 
`D-Wave EULA <https://docs.ocean.dwavesys.com/en/stable/licenses/inspector.html>`_.

Contributing
============

Ocean's `contributing guide <https://docs.ocean.dwavesys.com/en/stable/contributing.html>`_
has guidelines for contributing to Ocean packages.

Release Notes
-------------

D-Wave Inspector uses `reno <https://docs.openstack.org/reno/>`_ to manage
its release notes.

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

.. code-block:: bash

    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 <https://docs.openstack.org/reno/latest/user/usage.html>`_
for details.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/dwavesystems/dwave-inspector",
    "name": "dwave-inspector",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": "D-Wave Systems Inc.",
    "author_email": "radomir@dwavesys.com",
    "download_url": "https://files.pythonhosted.org/packages/5d/b3/8a206fd824d14cffea9f25828aac31212e037a1f28861f4ec4ee49981670/dwave_inspector-0.5.2.tar.gz",
    "platform": null,
    "description": ".. image:: https://badge.fury.io/py/dwave-inspector.svg\n    :target: https://badge.fury.io/py/dwave-inspector\n    :alt: Latest version on PyPI\n\n.. image:: https://circleci.com/gh/dwavesystems/dwave-inspector.svg?style=shield\n    :target: https://circleci.com/gh/dwavesystems/dwave-inspector\n    :alt: Linux/MacOS build status\n\n.. image:: https://codecov.io/gh/dwavesystems/dwave-inspector/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/dwavesystems/dwave-inspector\n    :alt: Coverage report\n\n\n================\nD-Wave Inspector\n================\n\n.. index-start-marker\n\nA tool for visualizing problems submitted to, and answers received from, a\nD-Wave structured solver such as an Advantage\\ |TM| quantum computer.\n\n.. |TM| replace:: :sup:`TM`\n\n.. index-end-marker\n\n\nExample\n=======\n\n.. example-start-marker\n\nThis example shows a typical usage: a binary quadratic model minor-embedded \nonto a quantum processing unit (QPU).\n\n.. code-block:: python\n\n    from dwave.system import DWaveSampler, EmbeddingComposite\n    import dimod\n    import dwave.inspector\n\n    # Get sampler\n    sampler = EmbeddingComposite(DWaveSampler())\n\n    # Define a problem\n    x, y, z = dimod.Binaries(['x', 'y', 'z'])\n    bqm = x*y - x*z + 2*y\n\n    # Sample\n    sampleset = sampler.sample(bqm, num_reads=100)\n\n    # Inspect\n    dwave.inspector.show(sampleset)\n\n.. example-end-marker\n\n\nInstallation or Building\n========================\n\n.. installation-start-marker\n\nIf `D-Wave Ocean SDK 2.0+ <https://docs.ocean.dwavesys.com/>`_ is installed:\n\n.. code-block:: bash\n\n    dwave install inspector\n\nOtherwise, install the package from PyPI:\n\n.. code-block:: bash\n\n    pip install dwave-inspector\n\nand then install the closed-source dependency with:\n\n.. code-block:: bash\n\n    pip install dwave-inspectorapp --extra-index=https://pypi.dwavesys.com/simple\n\nPlease note this closed-source dependency is released under the \n`D-Wave EULA <https://docs.ocean.dwavesys.com/en/stable/licenses/inspector.html>`_ \nlicense.\n\nAlternatively, clone and build from source:\n\n.. code-block:: bash\n\n    git clone https://github.com/dwavesystems/dwave-inspector.git\n    cd dwave-inspector\n    pip install -r requirements.txt\n    python setup.py install\n\nWhen building from source, the closed-source component still needs to be\ninstalled as above.\n\n.. installation-end-marker\n\n\nLicense\n=======\n\nReleased under the Apache License 2.0. See `<LICENSE>`_ file.\n\nVisualization component released under the \n`D-Wave EULA <https://docs.ocean.dwavesys.com/en/stable/licenses/inspector.html>`_.\n\nContributing\n============\n\nOcean's `contributing guide <https://docs.ocean.dwavesys.com/en/stable/contributing.html>`_\nhas guidelines for contributing to Ocean packages.\n\nRelease Notes\n-------------\n\nD-Wave Inspector uses `reno <https://docs.openstack.org/reno/>`_ to manage\nits release notes.\n\nWhen making a contribution to D-Wave Inspector that will affect users, create\na new release note file by running:\n\n.. code-block:: bash\n\n    reno new your-short-descriptor-here\n\nYou can then edit the file created under ``releasenotes/notes/``.\nRemove any sections not relevant to your changes.\nCommit the file along with your changes.\n\nSee reno's `user guide <https://docs.openstack.org/reno/latest/user/usage.html>`_\nfor details.\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "D-Wave Problem Inspector tool",
    "version": "0.5.2",
    "project_urls": {
        "Homepage": "https://github.com/dwavesystems/dwave-inspector"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c1c3062fc6ad4ee304eef6fe743557dd064a780b8b0ef86a1162578faf32dfbf",
                "md5": "f559ea991cdeb6fc214f795443cb6907",
                "sha256": "dba2725aea29e9f69db6afd691bd6fe0b6b48c0853b2ce018a0ed86498be0279"
            },
            "downloads": -1,
            "filename": "dwave_inspector-0.5.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f559ea991cdeb6fc214f795443cb6907",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 30806,
            "upload_time": "2024-11-26T16:03:51",
            "upload_time_iso_8601": "2024-11-26T16:03:51.683999Z",
            "url": "https://files.pythonhosted.org/packages/c1/c3/062fc6ad4ee304eef6fe743557dd064a780b8b0ef86a1162578faf32dfbf/dwave_inspector-0.5.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5db38a206fd824d14cffea9f25828aac31212e037a1f28861f4ec4ee49981670",
                "md5": "f31f76287a7d88d9523b28049ea50aa7",
                "sha256": "1e2824a3063e8ca7a897dda2dcc557a09bbb0026b8b69a2d2f1408cd4ba4fae5"
            },
            "downloads": -1,
            "filename": "dwave_inspector-0.5.2.tar.gz",
            "has_sig": false,
            "md5_digest": "f31f76287a7d88d9523b28049ea50aa7",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 35512,
            "upload_time": "2024-11-26T16:03:52",
            "upload_time_iso_8601": "2024-11-26T16:03:52.825308Z",
            "url": "https://files.pythonhosted.org/packages/5d/b3/8a206fd824d14cffea9f25828aac31212e037a1f28861f4ec4ee49981670/dwave_inspector-0.5.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-26 16:03:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "dwavesystems",
    "github_project": "dwave-inspector",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": false,
    "circle": true,
    "requirements": [],
    "lcname": "dwave-inspector"
}
        
Elapsed time: 0.35376s