cirq-core 1.4.0.dev20240529225110__py3-none-any.whl → 1.5.0__py3-none-any.whl

cirq/work/sampler.py

@@ -14,22 +14,24 @@
 """Abstract base class for things sampling quantum circuits."""
 
 import collections
-from typing import Dict, FrozenSet, List, Optional, Sequence, Tuple, TYPE_CHECKING, Union
+from typing import Dict, FrozenSet, List, Optional, Sequence, Tuple, TYPE_CHECKING, TypeVar, Union
 
 import duet
 import pandas as pd
 
 from cirq import ops, protocols, study, value
 from cirq.work.observable_measurement import (
+    CheckpointFileOptions,
     measure_observables,
     RepetitionsStoppingCriteria,
-    CheckpointFileOptions,
 )
 from cirq.work.observable_settings import _hashable_param
 
 if TYPE_CHECKING:
     import cirq
 
+T = TypeVar('T')
+
 
 class Sampler(metaclass=value.ABCMetaImplementAnyOneOf):
     """Something capable of sampling quantum circuits. Simulator or hardware."""
@@ -233,13 +235,13 @@ class Sampler(metaclass=value.ABCMetaImplementAnyOneOf):
         """
         raise NotImplementedError
 
-    def run_batch(
+    async def run_batch_async(
         self,
         programs: Sequence['cirq.AbstractCircuit'],
         params_list: Optional[Sequence['cirq.Sweepable']] = None,
         repetitions: Union[int, Sequence[int]] = 1,
     ) -> Sequence[Sequence['cirq.Result']]:
-        """Runs the supplied circuits.
+        """Runs the supplied circuits asynchronously.
 
         Each circuit provided in `programs` will pair with the optional
         associated parameter sweep provided in the `params_list`, and be run
@@ -278,26 +280,12 @@ class Sampler(metaclass=value.ABCMetaImplementAnyOneOf):
                 of `params_list` or the length of `repetitions`.
         """
         params_list, repetitions = self._normalize_batch_args(programs, params_list, repetitions)
-        return [
-            self.run_sweep(circuit, params=params, repetitions=repetitions)
-            for circuit, params, repetitions in zip(programs, params_list, repetitions)
-        ]
-
-    async def run_batch_async(
-        self,
-        programs: Sequence['cirq.AbstractCircuit'],
-        params_list: Optional[Sequence['cirq.Sweepable']] = None,
-        repetitions: Union[int, Sequence[int]] = 1,
-    ) -> Sequence[Sequence['cirq.Result']]:
-        """Runs the supplied circuits asynchronously.
-
-        See docs for `cirq.Sampler.run_batch`.
-        """
-        params_list, repetitions = self._normalize_batch_args(programs, params_list, repetitions)
         return await duet.pstarmap_async(
             self.run_sweep_async, zip(programs, params_list, repetitions)
         )
 
+    run_batch = duet.sync(run_batch_async)
+
     def _normalize_batch_args(
         self,
         programs: Sequence['cirq.AbstractCircuit'],

cirq/work/sampler_test.py

@@ -14,11 +14,10 @@
 """Tests for cirq.Sampler."""
 from typing import Sequence
 
-import pytest
-
 import duet
 import numpy as np
 import pandas as pd
+import pytest
 import sympy
 
 import cirq
@@ -223,7 +222,9 @@ async def test_run_batch_async_calls_run_sweep_asynchronously():
     params_list = [params1, params2]
 
     class AsyncSampler(cirq.Sampler):
-        async def run_sweep_async(self, program, params, repetitions: int = 1):
+        async def run_sweep_async(
+            self, program, params, repetitions: int = 1, unused: duet.Limiter = duet.Limiter(None)
+        ):
             if params == params1:
                 await duet.sleep(0.001)
 

cirq/work/zeros_sampler.py

@@ -17,7 +17,7 @@ from typing import List, Optional, TYPE_CHECKING
 
 import numpy as np
 
-from cirq import devices, work, study
+from cirq import devices, study, work
 
 if TYPE_CHECKING:
     import cirq

cirq_core-1.5.0.dist-info/METADATA

@@ -0,0 +1,125 @@
+Metadata-Version: 2.2
+Name: cirq-core
+Version: 1.5.0
+Summary: A framework for creating, editing, and invoking Noisy Intermediate Scale Quantum (NISQ) circuits.
+Home-page: http://github.com/quantumlib/cirq
+Author: The Cirq Developers
+Author-email: cirq-dev@googlegroups.com
+Maintainer: The Quantum AI open-source software maintainers
+Maintainer-email: quantum-oss-maintainers@google.com
+License: Apache 2
+Keywords: algorithms,api,cirq,google,google quantum,nisq,python,quantum,quantum algorithms,quantum circuit,quantum circuit simulator,quantum computer simulator,quantum computing,quantum development kit,quantum information,quantum programming,quantum programming language,quantum simulation,sdk,simulation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Quantum Computing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs>=21.3.0
+Requires-Dist: duet>=0.2.8
+Requires-Dist: matplotlib~=3.7
+Requires-Dist: networkx~=3.1
+Requires-Dist: numpy>=1.25
+Requires-Dist: pandas~=2.0
+Requires-Dist: sortedcontainers~=2.0
+Requires-Dist: scipy~=1.11
+Requires-Dist: sympy
+Requires-Dist: typing_extensions>=4.2
+Requires-Dist: tqdm>=4.12
+Provides-Extra: contrib
+Requires-Dist: ply>=3.6; extra == "contrib"
+Requires-Dist: pylatex~=1.4; extra == "contrib"
+Requires-Dist: quimb>=1.8; extra == "contrib"
+Requires-Dist: opt_einsum; extra == "contrib"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<div align="center">
+<img width="220px" alt="Cirq logo"
+src="https://raw.githubusercontent.com/quantumlib/Cirq/refs/heads/main/docs/images/Cirq_logo_color.svg">
+</div>
+
+# cirq-core
+
+[Cirq] is a Python package for writing, manipulating, and running [quantum
+circuits](https://en.wikipedia.org/wiki/Quantum_circuit) on quantum computers
+and simulators. Cirq provides useful abstractions for dealing with today’s
+[noisy intermediate-scale quantum](https://arxiv.org/abs/1801.00862) (NISQ)
+computers, where the details of quantum hardware are vital to achieving
+state-of-the-art results. For more information about Cirq, please visit the
+[Cirq documentation site].
+
+This Python module is `cirq-core`, which contains all the code you need to
+write quantum algorithms for NISQ devices and run them on the built-in Cirq
+simulators.
+
+To run algorithms on a given quantum computing platform, you will also need to
+install an appropriate Cirq hardware interface module. Please visit the
+[hardware section of the Cirq documentation
+site](https://quantumai.google/cirq/hardware) for information about the
+hardware interface modules currently available.
+
+[Cirq]: https://github.com/quantumlib/cirq
+[Cirq documentation site]: https://quantumai.google/cirq
+
+## Installation
+
+There are two installation options for the `cirq-core` module:
+
+*   To install the stable version of `cirq-core`, use
+
+    ```shell
+    pip install cirq-core
+    ```
+
+*   To install the latest pre-release version of `cirq-core`, use
+
+    ```shell
+    pip install --upgrade cirq-core~=1.0.dev
+    ```
+
+    (The `~=` has a special meaning to `pip` of selecting the latest version
+    compatible with the `1.*` and `dev` in the name. Despite appearances,
+    this will not install an old version 1.0 release!)
+
+If you would like to install Cirq with all the optional modules, not just
+`cirq-core`, then instead of the above commands, use `pip install cirq` for the
+stable release or `pip install --upgrade cirq~=1.0.dev` for the latest pre-release
+version.
+
+## Documentation
+
+To get started with using Cirq, please refer to the [Cirq documentation site].
+
+For more information about getting help, reporting bugs, and other matters
+related to Cirq and the Cirq-Core integration module, please visit the [Cirq
+repository on GitHub](https://github.com/quantumlib/Cirq).
+
+## Disclaimer
+
+Cirq is not an official Google product. Copyright 2019 The Cirq Developers.