qiskit 1.3.0__cp39-abi3-win32.whl

qiskit/providers/providerutils.py

@@ -0,0 +1,110 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2017, 2023.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""Utilities for providers."""
+from __future__ import annotations
+
+import logging
+from collections.abc import Callable
+
+from qiskit.providers.backend import Backend
+
+logger = logging.getLogger(__name__)
+
+
+def filter_backends(
+    backends: list[Backend], filters: Callable[[Backend], bool] | None = None, **kwargs
+) -> list[Backend]:
+    """Return the backends matching the specified filtering.
+
+    Filter the `backends` list by their `configuration` or `status`
+    attributes, or from a boolean callable. The criteria for filtering can
+    be specified via `**kwargs` or as a callable via `filters`, and the
+    backends must fulfill all specified conditions.
+
+    Args:
+        backends (list[Backend]): list of backends.
+        filters (callable): filtering conditions as a callable.
+        **kwargs: dict of criteria.
+
+    Returns:
+        list[Backend]: a list of backend instances matching the
+            conditions.
+    """
+
+    def _match_all(obj, criteria):
+        """Return True if all items in criteria matches items in obj."""
+        return all(getattr(obj, key_, None) == value_ for key_, value_ in criteria.items())
+
+    # Inspect the backends to decide which filters belong to
+    # backend.configuration and which ones to backend.status, as it does
+    # not involve querying the API.
+    configuration_filters = {}
+    status_filters = {}
+    for key, value in kwargs.items():
+        if all(key in backend.configuration() for backend in backends):
+            configuration_filters[key] = value
+        else:
+            status_filters[key] = value
+
+    # 1. Apply backend.configuration filtering.
+    if configuration_filters:
+        backends = [b for b in backends if _match_all(b.configuration(), configuration_filters)]
+
+    # 2. Apply backend.status filtering (it involves one API call for
+    # each backend).
+    if status_filters:
+        backends = [b for b in backends if _match_all(b.status(), status_filters)]
+
+    # 3. Apply acceptor filter.
+    backends = list(filter(filters, backends))
+
+    return backends
+
+
+def resolve_backend_name(
+    name: str, backends: list[Backend], deprecated: dict[str, str], aliased: dict[str, list[str]]
+) -> str:
+    """Resolve backend name from a deprecated name or an alias.
+
+    A group will be resolved in order of member priorities, depending on
+    availability.
+
+    Args:
+        name (str): name of backend to resolve
+        backends (list[Backend]): list of available backends.
+        deprecated (dict[str: str]): dict of deprecated names.
+        aliased (dict[str: list[str]]): dict of aliased names.
+
+    Returns:
+        str: resolved name (name of an available backend)
+
+    Raises:
+        LookupError: if name cannot be resolved through regular available
+            names, nor deprecated, nor alias names.
+    """
+    # account for BackendV2
+    available = []
+    for backend in backends:
+        available.append(backend.name() if backend.version == 1 else backend.name)
+
+    resolved_name = deprecated.get(name, aliased.get(name, name))
+    if isinstance(resolved_name, list):
+        resolved_name = next((b for b in resolved_name if b in available), "")
+
+    if resolved_name not in available:
+        raise LookupError(f"backend '{name}' not found.")
+
+    if name in deprecated:
+        logger.warning("Backend '%s' is deprecated. Use '%s'.", name, resolved_name)
+
+    return resolved_name

qiskit/pulse/__init__.py

@@ -0,0 +1,158 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2017, 2019.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+r"""
+===========================
+Pulse (:mod:`qiskit.pulse`)
+===========================
+
+.. currentmodule:: qiskit.pulse
+
+Qiskit-Pulse is a pulse-level quantum programming kit. This lower level of
+programming offers the user more control than programming with
+:py:class:`~qiskit.circuit.QuantumCircuit`\ s.
+
+Extracting the greatest performance from quantum hardware requires real-time
+pulse-level instructions. Pulse answers that need: it enables the quantum
+physicist *user* to specify the exact time dynamics of an experiment.
+It is especially powerful for error mitigation techniques.
+
+The input is given as arbitrary, time-ordered signals (see: :ref:`Instructions <pulse-insts>`)
+scheduled in parallel over multiple virtual hardware or simulator resources
+(see: :ref:`Channels <pulse-channels>`). The system also allows the user to recover the
+time dynamics of the measured output.
+
+This is sufficient to allow the quantum physicist to explore and correct for
+noise in a quantum system.
+
+.. automodule:: qiskit.pulse.instructions
+.. automodule:: qiskit.pulse.library
+.. automodule:: qiskit.pulse.channels
+.. automodule:: qiskit.pulse.schedule
+.. automodule:: qiskit.pulse.transforms
+.. automodule:: qiskit.pulse.builder
+
+.. currentmodule:: qiskit.pulse
+
+Configuration
+=============
+
+.. autosummary::
+   :toctree: ../stubs/
+
+   InstructionScheduleMap
+
+Exceptions
+==========
+
+.. autoexception:: PulseError
+.. autoexception:: BackendNotSet
+.. autoexception:: NoActiveBuilder
+.. autoexception:: UnassignedDurationError
+.. autoexception:: UnassignedReferenceError
+"""
+
+# Builder imports.
+from qiskit.pulse.builder import (
+    # Construction methods.
+    active_backend,
+    build,
+    num_qubits,
+    qubit_channels,
+    samples_to_seconds,
+    seconds_to_samples,
+    # Instructions.
+    acquire,
+    barrier,
+    call,
+    delay,
+    play,
+    reference,
+    set_frequency,
+    set_phase,
+    shift_frequency,
+    shift_phase,
+    snapshot,
+    # Channels.
+    acquire_channel,
+    control_channels,
+    drive_channel,
+    measure_channel,
+    # Contexts.
+    align_equispaced,
+    align_func,
+    align_left,
+    align_right,
+    align_sequential,
+    frequency_offset,
+    phase_offset,
+    # Macros.
+    macro,
+    measure,
+    measure_all,
+    delay_qubits,
+)
+from qiskit.pulse.channels import (
+    AcquireChannel,
+    ControlChannel,
+    DriveChannel,
+    MeasureChannel,
+    MemorySlot,
+    RegisterSlot,
+    SnapshotChannel,
+)
+from qiskit.pulse.configuration import (
+    Discriminator,
+    Kernel,
+    LoConfig,
+    LoRange,
+)
+from qiskit.pulse.exceptions import (
+    PulseError,
+    BackendNotSet,
+    NoActiveBuilder,
+    UnassignedDurationError,
+    UnassignedReferenceError,
+)
+from qiskit.pulse.instruction_schedule_map import InstructionScheduleMap
+from qiskit.pulse.instructions import (
+    Acquire,
+    Delay,
+    Instruction,
+    Play,
+    SetFrequency,
+    SetPhase,
+    ShiftFrequency,
+    ShiftPhase,
+    Snapshot,
+)
+from qiskit.pulse.library import (
+    Constant,
+    Drag,
+    Gaussian,
+    GaussianSquare,
+    GaussianSquareDrag,
+    gaussian_square_echo,
+    Sin,
+    Cos,
+    Sawtooth,
+    Triangle,
+    Square,
+    GaussianDeriv,
+    Sech,
+    SechDeriv,
+    SymbolicPulse,
+    ScalableSymbolicPulse,
+    Waveform,
+)
+from qiskit.pulse.library.samplers.decorators import functional_pulse
+from qiskit.pulse.schedule import Schedule, ScheduleBlock