Metadata-Version: 2.1
Name: dimod
Version: 0.7.6
Summary: A shared API for binary quadratic model samplers.
Home-page: https://github.com/dwavesystems/dimod
Author: D-Wave Systems Inc.
Author-email: acondello@dwavesys.com
License: Apache 2.0
Download-URL: https://github.com/dwavesystems/dimod/releases
Description: .. image:: https://img.shields.io/pypi/v/dimod.svg
            :target: https://pypi.python.org/pypi/dimod
        
        .. image:: https://ci.appveyor.com/api/projects/status/2oc8vrxxh15ecgo1/branch/master?svg=true
            :target: https://ci.appveyor.com/project/dwave-adtt/dimod
        
        .. image:: https://codecov.io/gh/dwavesystems/dimod/branch/master/graph/badge.svg
          :target: https://codecov.io/gh/dwavesystems/dimod
        
        .. image:: https://readthedocs.com/projects/d-wave-systems-dimod/badge/?version=latest
          :target: https://docs.ocean.dwavesys.com/projects/dimod/en/latest/?badge=latest
        
        .. image:: https://circleci.com/gh/dwavesystems/dimod.svg?style=svg
            :target: https://circleci.com/gh/dwavesystems/dimod
        
        dimod
        =====
        
        .. index-start-marker1
        
        `dimod` is a shared API for binary quadratic samplers. It provides a binary quadratic
        model (BQM) class that contains Ising and quadratic unconstrained binary
        optimization (QUBO) models used by samplers such as the D-Wave system. It also
        provides utilities for constructing new samplers and composed samplers and for
        minor-embedding. Its reference examples include several samplers and composed
        samplers.
        
        .. index-end-marker1
        
        Learn more about `dimod on Read the Docs <http://dimod.readthedocs.io/en/latest/>`_\ .
        
        Example Usage
        -------------
        
        .. index-start-marker2
        
        This example constructs a simple QUBO and converts it to Ising format.
        
        >>> import dimod
        >>> bqm = dimod.BinaryQuadraticModel({0: -1, 1: -1}, {(0, 1): 2}, 0.0, dimod.BINARY)  # QUBO
        >>> bqm_ising = bqm.change_vartype(dimod.SPIN, inplace=False)  # Ising
        
        This example uses one of dimod's test samplers, ExactSampler, a solver that calculates
        the energies of all possible samples.
        
        >>> import dimod
        >>> h = {0: 0.0, 1: 0.0}
        >>> J = {(0, 1): -1.0}
        >>> bqm = dimod.BinaryQuadraticModel.from_ising(h, J)
        >>> response = dimod.ExactSolver().sample(bqm)
        >>> for sample, energy in response.data(['sample', 'energy']): print(sample, energy)
        {0: -1, 1: -1} -1.0
        {0: 1, 1: 1} -1.0
        {0: 1, 1: -1} 1.0
        {0: -1, 1: 1} 1.0
        
        .. index-end-marker2
        
        See the documentation for more examples.
        
        Installation
        ------------
        
        .. installation-start-marker
        
        Compatible with Python 2 and 3:
        
        .. code-block:: bash
        
            pip install dimod
        
        To install with optional components:
        
        .. code-block:: bash
        
            pip install dimod[all]
        
        To install from source:
        
        .. code-block:: bash
        
            pip install -r requirements.txt
            python setup.py install
        
        .. installation-end-marker
        
        License
        -------
        
        Released under the Apache License 2.0. See LICENSE file.
        
        Contribution
        ------------
        
        See CONTRIBUTING.rst file.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
Provides-Extra: all
