From c14ef182876e4671f7d2c7ed0b85ac18fda6d6a5 Mon Sep 17 00:00:00 2001 From: Alexander Condello Date: Wed, 11 Oct 2017 11:04:00 -0700 Subject: [PATCH] Updated README to rst and removed erroneous file * removed extra file * updated README to .rst, added badges for coveralls and appveyor * updated badges * removed target from badges * and now on one line... * more badge stuff --- README.md => README.rst | 28 ++++++++++++++---- dimod/composite_template.py | 57 ------------------------------------- 2 files changed, 22 insertions(+), 63 deletions(-) rename README.md => README.rst (74%) delete mode 100644 dimod/composite_template.py diff --git a/README.md b/README.rst similarity index 74% rename from README.md rename to README.rst index 591f5ac9d..11c46abe6 100644 --- a/README.md +++ b/README.rst @@ -1,10 +1,19 @@ -# dimod +dimod +===== -[![Build Status](https://travis-ci.org/dwavesystems/dimod.svg?branch=master)](https://travis-ci.org/dwavesystems/dimod) +.. image:: https://travis-ci.org/dwavesystems/dimod.svg?branch=master + :target: https://travis-ci.org/dwavesystems/dimod + +.. image:: https://ci.appveyor.com/api/projects/status/kfhg35q12fa0lux8?svg=true + :target: https://ci.appveyor.com/project/arcondello/dimod + +.. image:: https://coveralls.io/repos/github/dwavesystems/dimod/badge.svg?branch=master + :target: https://coveralls.io/github/dwavesystems/dimod?branch=master A shared API for QUBO/Ising samplers. -## Included Samplers +Included Samplers +----------------- dimod comes with a few samplers that are useful as reference implementations and for unit testing. @@ -12,7 +21,8 @@ dimod comes with a few samplers that are useful as reference implementations and * ExactSolver: determines the energy for every possible sample, but is extremely slow. * RandomSampler: Generates random samples. Used for testing. -## Basic Usage +Basic Usage +----------- ```python >>> import dimod @@ -39,17 +49,23 @@ The response object returned has many ways to access the information See documentation for more examples. -## Install +Install +------- Compatible with Python 2 and 3. `pip install dimod` +To install with optional components + +`pip install dimod[all]` + To install from source: `python setup.py install` -## License +License +------- Released under the Apache License 2.0. See LICENSE.txt diff --git a/dimod/composite_template.py b/dimod/composite_template.py deleted file mode 100644 index 549863e14..000000000 --- a/dimod/composite_template.py +++ /dev/null @@ -1,57 +0,0 @@ -""" -Samplers can be composed. This pattern allows pre- and post-processing -to be applied to binary quadratic programs without needing to change -the underlying sampler implementation. - -We refer to these layers as `composites`. Each composed sampler must -include at least one `sampler`, and possibly many composites. See -'dimod sampler composition pattern' figure below. - -Each composed sampler is itself a dimod sampler with all of the -included methods and parameters. In this way complex samplers -can be constructed. - - -Examples --------- - -We will be using the included composite :class:`.SpinReversalTransform` -and included samplers :class:`.ExactSolver` and -:class:`.SimulatedAnnealingSampler` in our examples. - -Building composed samplers are easy - ->>> composed_sampler_es = dimod.SpinReversalTransform(dimod.ExactSolver()) - -A composite layer can be applied to any dimod sampler. - ->>> composed_sampler_sa = dimod.SpinReversalTransform(dimod.SimulatedAnnealingSampler) - -These composed samplers themselves behave exactly like samplers. - ->>> h = {0: -1, 1: 1} ->>> response = composed_sampler_es.sample_ising(h, {}) ->>> list(response.samples()) -[{0: 1, 1: -1}, {0: -1, 1: -1}, {0: 1, 1: 1}, {0: -1, 1: 1}] - -Composite layers can also be nested. - ->>> composed_sampler_nested = dimod.SpinReversalTransform(composed_sampler_es) - -""" -from dimod import TemplateSampler - - -class TemplateComposite(TemplateSampler): - """Serves as a template for composites. Not intended to be used directly. - - Args: - *samplers: child sampler(s) of the composite. - - Attributes: - children (list): A list of child samplers or child composed samplers. - - """ - def __init__(self, *samplers): - TemplateSampler.__init__(self) - self.children = list(samplers)