classiq 0.95.0__py3-none-any.whl → 0.96.0__py3-none-any.whl

classiq/_internals/api_wrapper.py

@@ -12,15 +12,6 @@ from classiq.interface.analyzer.analysis_params import AnalysisRBParams
 from classiq.interface.analyzer.result import GraphStatus, QmodCode
 from classiq.interface.enum_utils import StrEnum
 from classiq.interface.exceptions import ClassiqAPIError, ClassiqValueError
-from classiq.interface.execution.iqcc import (
-    IQCCAuthItemsDetails,
-    IQCCInitAuthData,
-    IQCCInitAuthResponse,
-    IQCCListAuthMethods,
-    IQCCListAuthTargets,
-    IQCCProbeAuthData,
-    IQCCProbeAuthResponse,
-)
 from classiq.interface.execution.primitives import PrimitivesInput
 from classiq.interface.executor import execution_request
 from classiq.interface.executor.quantum_program_params import (
@@ -488,80 +479,6 @@ class ApiWrapper:
             raise ClassiqAPIError(f"Unexpected value: {data}")
         return [HardwareInformation.model_validate(info) for info in data]
 
-    @classmethod
-    async def call_iqcc_init_auth(
-        cls,
-        data: IQCCInitAuthData,
-        http_client: httpx.AsyncClient | None = None,
-    ) -> IQCCInitAuthResponse:
-        response = await cls._call_task_pydantic(
-            http_method=HTTPMethod.PUT,
-            url=f"{routes.IQCC_INIT_AUTH_FULL_PATH}",
-            model=data,
-            http_client=http_client,
-        )
-        return IQCCInitAuthResponse.model_validate(response)
-
-    @classmethod
-    async def call_iqcc_probe_auth(
-        cls,
-        data: IQCCProbeAuthData,
-        http_client: httpx.AsyncClient | None = None,
-    ) -> IQCCProbeAuthResponse | None:
-        try:
-            response = await cls._call_task_pydantic(
-                http_method=HTTPMethod.PUT,
-                url=f"{routes.IQCC_PROBE_AUTH_FULL_PATH}",
-                model=data,
-                http_client=http_client,
-            )
-        except ClassiqAPIError as ex:
-            if ex.status_code == 418:
-                return None
-            raise
-
-        return IQCCProbeAuthResponse.model_validate(response)
-
-    @classmethod
-    async def call_iqcc_list_auth_scopes(
-        cls,
-        http_client: httpx.AsyncClient | None = None,
-    ) -> IQCCAuthItemsDetails:
-        response = await cls._call_task(
-            http_method=HTTPMethod.GET,
-            url=routes.IQCC_LIST_AUTH_SCOPES_FULL_PATH,
-            http_client=http_client,
-        )
-        return IQCCAuthItemsDetails.model_validate(response)
-
-    @classmethod
-    async def call_iqcc_list_auth_methods(
-        cls,
-        data: IQCCListAuthMethods,
-        http_client: httpx.AsyncClient | None = None,
-    ) -> IQCCAuthItemsDetails:
-        response = await cls._call_task_pydantic(
-            http_method=HTTPMethod.PUT,
-            url=routes.IQCC_LIST_AUTH_METHODS_FULL_PATH,
-            model=data,
-            http_client=http_client,
-        )
-        return IQCCAuthItemsDetails.model_validate(response)
-
-    @classmethod
-    async def call_iqcc_list_auth_targets(
-        cls,
-        data: IQCCListAuthTargets,
-        http_client: httpx.AsyncClient | None = None,
-    ) -> IQCCAuthItemsDetails:
-        response = await cls._call_task_pydantic(
-            http_method=HTTPMethod.PUT,
-            url=routes.IQCC_LIST_AUTH_TARGETS_FULL_PATH,
-            model=data,
-            http_client=http_client,
-        )
-        return IQCCAuthItemsDetails.model_validate(response)
-
     @classmethod
     async def call_get_all_budgets(cls) -> list[UserBudget]:
         data = await client().call_api(

classiq/applications/iqae/iqae.py

@@ -20,8 +20,10 @@ from classiq.qmod import (
     QCallable,
 )
 from classiq.qmod.builtins import Z, allocate, bind, within_apply
+from classiq.qmod.builtins.functions.allocation import drop
 from classiq.qmod.create_model_function import create_model
-from classiq.qmod.qfunc import qfunc
+from classiq.qmod.qfunc import qfunc, qperm
+from classiq.qmod.qmod_variable import Const
 from classiq.synthesis import synthesize
 
 
@@ -83,8 +85,8 @@ class IQAE:
         def space_transform(est_reg: QArray) -> None:
             state_prep_op(est_reg[0 : est_reg.len - 1], est_reg[est_reg.len - 1])
 
-        @qfunc
-        def oracle(est_reg: QArray) -> None:
+        @qperm
+        def oracle(est_reg: Const[QArray]) -> None:
             Z(est_reg[est_reg.len - 1])
 
         @qfunc
@@ -105,6 +107,7 @@ class IQAE:
                     est_reg,
                 ),
             )
+            drop(problem_vars)
 
         if self._model is None:
             self._model = create_model(

classiq/applications/qnn/gradients/simple_quantum_gradient.py

@@ -59,7 +59,7 @@ def _differentiate_tensor(
     # The minus comes from the way pytorch defines diff
     #   it diffs the second object minus the first
     #     where we want the first minus the second
-    diff = -tensor.diff(axis=axis).squeeze(axis)  # type: ignore[call-arg] # torch does accept `axis` keyword
+    diff = -tensor.diff(axis=axis).squeeze(axis)
     return diff / (2 * epsilon)
 
 

classiq/applications/qnn/qlayer.py

@@ -104,7 +104,7 @@ class QLayerFunction(torch.autograd.Function):
         )
 
     @staticmethod
-    def backward(  # type: ignore[override]
+    def backward(
         ctx: Any, grad_output: Tensor
     ) -> tuple[Tensor | None, Tensor | None, None, None, None, None]:
         """

classiq/applications/qnn/torch_utils.py

@@ -23,7 +23,7 @@ def get_shape_second_dimension(shape: torch.Size) -> int:
     if len(shape) == 1:
         return 1
     elif len(shape) == 2:
-        return shape[1]
+        return shape[1]  # type: ignore[index]
     else:
         raise ClassiqValueError("Invalid shape dimension - must be 1D or 2D")
 
@@ -33,7 +33,7 @@ def get_shape_first_dimension(shape: torch.Size) -> int:
         raise ClassiqValueError("Invalid shape type - must have `__len__`")
 
     if len(shape) in (1, 2):
-        return shape[0]
+        return shape[0]  # type: ignore[index]
     else:
         raise ClassiqValueError("Invalid shape dimension - must be 1D or 2D")
 

classiq/execution/__init__.py

@@ -8,7 +8,6 @@ from ..interface.executor.execution_preferences import __all__ as _ep_all
 from ..interface.executor.result import ExecutionDetails
 from ..interface.executor.vqe_result import VQESolverResult
 from .execution_session import ExecutionSession
-from .iqcc import generate_iqcc_token, generate_iqcc_token_async
 from .jobs import ExecutionJob, get_execution_jobs, get_execution_jobs_async
 from .qnn import execute_qnn
 from .user_budgets import (
@@ -33,8 +32,6 @@ __all__ = (
         "get_execution_jobs_async",
         "ExecutionSession",
         "execute_qnn",
-        "generate_iqcc_token",
-        "generate_iqcc_token_async",
         "get_budget",
         "get_budget_async",
         "set_budget_limit",

classiq/execution/user_budgets.py

@@ -14,7 +14,6 @@ PROVIDER_MAPPER = {
     ProviderVendor.OQC: "OQC",
     ProviderVendor.INTEL: "INTEL",
     ProviderVendor.AQT: "AQT",
-    ProviderVendor.IQCC: "IQCC",
     ProviderVendor.CLASSIQ: "CLASSIQ",
 }
 

classiq/interface/_version.py

@@ -3,5 +3,5 @@ from packaging.version import Version
 # This file was generated automatically
 # Please don't track in version control (DONTTRACK)
 
-SEMVER_VERSION = '0.95.0'
+SEMVER_VERSION = '0.96.0'
 VERSION = str(Version(SEMVER_VERSION))

classiq/interface/backend/backend_preferences.py

@@ -433,33 +433,6 @@ class AQTBackendPreferences(BackendPreferences):
     workspace: str = pydantic.Field(description="AQT workspace")
 
 
-class IQCCBackendPreferences(BackendPreferences):
-    """
-    NOTE: This is a work in progress and is subject to change.
-
-    Represents the backend preferences specific to IQCC (Israeli Quantum Computing
-    Center).
-
-    Attributes:
-        auth_token: The authorization token generated by calling `generate_iqcc_token`.
-        target_id: The target ID of the login node.
-        target_scope_id: The scope ID of the specified target.
-        ssh_user_name: The user name to use when connecting to the SSH server on the login node.
-        ssh_key: The private key to use when connecting to the SSH server on the login node.
-        slurm_account: The account to use when initiating SLURM jobs.
-    """
-
-    backend_service_provider: ProviderTypeVendor.IQCC = pydantic.Field(
-        default=ProviderVendor.IQCC
-    )
-    auth_token: str
-    target_id: str
-    target_scope_id: str
-    ssh_user_name: str
-    ssh_key: str
-    slurm_account: str
-
-
 class CINECABackendPreferences(BackendPreferences):
     """
     Represents the backend preferences specific to CINECA.
@@ -512,7 +485,6 @@ BackendPreferencesTypes = Union[
     OQCBackendPreferences,
     IntelBackendPreferences,
     AQTBackendPreferences,
-    IQCCBackendPreferences,
     CINECABackendPreferences,
 ]
 
@@ -530,7 +502,6 @@ __all__ = [
     "ClassiqSimulatorBackendNames",
     "GCPBackendPreferences",
     "IBMBackendPreferences",
-    "IQCCBackendPreferences",
     "IntelBackendNames",
     "IntelBackendPreferences",
     "IonqBackendNames",

classiq/interface/backend/quantum_backend_providers.py

@@ -20,7 +20,6 @@ class ProviderVendor(StrEnum):
     OQC = "OQC"
     INTEL = "Intel"
     AQT = "AQT"
-    IQCC = "IQCC"
     CINECA = "CINECA"
 
 
@@ -35,7 +34,6 @@ class ProviderTypeVendor:
     OQC = Literal[ProviderVendor.OQC]
     INTEL = Literal[ProviderVendor.INTEL]
     AQT = Literal[ProviderVendor.AQT]
-    IQCC = Literal[ProviderVendor.IQCC]
     CINECA = Literal[ProviderVendor.CINECA]
 
 

classiq/interface/generator/arith/register_user_input.py

@@ -19,7 +19,7 @@ class RegisterArithmeticInfo(HashablePydanticBaseModel):
     is_signed: bool = pydantic.Field(default=False)
     fraction_places: pydantic.NonNegativeInt = pydantic.Field(default=0)
     bypass_bounds_validation: bool = pydantic.Field(default=False)
-    bounds: PydanticFloatTuple = pydantic.Field(  # type: ignore[assignment]
+    bounds: PydanticFloatTuple = pydantic.Field(
         default=None,
         validate_default=True,
     )

classiq/interface/generator/hardware_efficient_ansatz.py

@@ -42,7 +42,7 @@ class HardwareEfficientAnsatz(function_params.FunctionParams):
         "If none specified - use connectivity map from the model hardware settings. "
         "If none specified as well, all qubit pairs will be connected.",
     )
-    num_qubits: pydantic.PositiveInt = pydantic.Field(  # type: ignore[assignment]
+    num_qubits: pydantic.PositiveInt = pydantic.Field(
         default=None,
         description="Number of qubits in the ansatz.",
         validate_default=True,

classiq/interface/generator/quantum_function_call.py

@@ -144,7 +144,7 @@ class SynthesisQuantumFunctionCall(BaseModel):
     power: PydanticPowerType = pydantic.Field(
         default=1, description="Number of successive calls to the operation"
     )
-    name: PydanticNonEmptyString = pydantic.Field(  # type: ignore[assignment]
+    name: PydanticNonEmptyString = pydantic.Field(
         default=None,
         validate_default=True,
         description="The name of the function instance. "

classiq/interface/hardware.py

@@ -32,7 +32,6 @@ class Provider(StrEnum):
     OQC = "OQC"
     INTEL = "Intel"
     AQT = "AQT"
-    IQCC = "IQCC"
     CINECA = "CINECA"
 
     @property

classiq/interface/server/routes.py

@@ -4,7 +4,6 @@ EXECUTION_SESSIONS_PREFIX = EXECUTION_PREFIX + "/sessions"
 CONVERSION_PREFIX = "/conversion"
 PROVIDERS_PREFIX = "/providers"
 
-IQCC_PREFIX = PROVIDERS_PREFIX + "/iqcc"
 USER_BUDGETS_PREFIX = "/user_budgets"
 
 
@@ -70,17 +69,6 @@ QASM_TO_QMOD_FULL_PATH = CONVERSION_PREFIX + QASM_TO_QMOD_SUFFIX
 
 STATIC_SEMANTICS_VALIDATION_PATH = "/validate_static_semantics"
 
-IQCC_INIT_AUTH_SUFFIX = "/init_auth"
-IQCC_INIT_AUTH_FULL_PATH = IQCC_PREFIX + IQCC_INIT_AUTH_SUFFIX
-IQCC_PROBE_AUTH_SUFFIX = "/probe_auth"
-IQCC_PROBE_AUTH_FULL_PATH = IQCC_PREFIX + IQCC_PROBE_AUTH_SUFFIX
-IQCC_LIST_AUTH_SCOPES_SUFFIX = "/auth_scopes"
-IQCC_LIST_AUTH_SCOPES_FULL_PATH = IQCC_PREFIX + IQCC_LIST_AUTH_SCOPES_SUFFIX
-IQCC_LIST_AUTH_METHODS_SUFFIX = "/auth_methods"
-IQCC_LIST_AUTH_METHODS_FULL_PATH = IQCC_PREFIX + IQCC_LIST_AUTH_METHODS_SUFFIX
-IQCC_LIST_AUTH_TARGETS_SUFFIX = "/auth_targets"
-IQCC_LIST_AUTH_TARGETS_FULL_PATH = IQCC_PREFIX + IQCC_LIST_AUTH_TARGETS_SUFFIX
-
 USER_BUDGETS_SUFFIX = "/all"
 USER_BUDGETS_FULL_PATH = USER_BUDGETS_PREFIX + USER_BUDGETS_SUFFIX
 USER_BUDGET_SET_LIMIT_SUFFIX = "/set_limit"

classiq/model_expansions/generative_functions.py

@@ -172,20 +172,18 @@ class _InterpreterExpandable(QFunc):
         scope_func_decls: dict[str, QuantumFunctionDeclaration] = {}
         for name, evaluated in self._interpreter._builder.current_scope.items():
             value = evaluated.value
+            if (
+                isinstance(value, list)
+                and len(value) > 0
+                and isinstance(value[0], FunctionClosure)
+            ):
+                value = value[0]
             if isinstance(value, FunctionClosure):
                 scope_func_decls[name] = QuantumFunctionDeclaration(
                     name=name,
                     positional_arg_declarations=value.positional_arg_declarations,
                 )
                 continue
-            op_param = self._interpreter._builder.current_function.parameters_dict.get(
-                name
-            )
-            if isinstance(op_param, QuantumOperandDeclaration):
-                scope_func_decls[name] = QuantumFunctionDeclaration(
-                    name=name,
-                    positional_arg_declarations=op_param.positional_arg_declarations,
-                )
         return (
             nameables_to_dict(self._interpreter._get_function_declarations())
             | scope_func_decls

classiq/open_library/functions/__init__.py

@@ -3,7 +3,7 @@ from .amplitude_amplification import (
     exact_amplitude_amplification,
 )
 from .amplitude_estimation import *
-from .amplitude_loading import load_amplitudes
+from .amplitude_loading import assign_amplitude_table
 from .discrete_sine_cosine_transform import *
 from .discrete_sine_cosine_transform import _qct_d_operator, _qct_pi_operator
 from .grover import *
@@ -12,7 +12,6 @@ from .hea import *
 from .lcu import *
 from .linear_pauli_rotation import *
 from .linear_pauli_rotation import _single_pauli
-from .lookup_table import get_lookup_table, span_lookup_table
 from .modular_exponentiation import *
 from .modular_exponentiation import _check_msb
 from .qaoa_penalty import *
@@ -93,13 +92,13 @@ __all__ = [
     "amplitude_amplification",
     "amplitude_estimation",
     "apply_to_all",
+    "assign_amplitude_table",
     "c_modular_multiply",
     "cc_modular_add",
     "encode_in_angle",
     "encode_on_bloch",
     "exact_amplitude_amplification",
     "full_hea",
-    "get_lookup_table",
     "gqsp",
     "grover_diffuser",
     "grover_operator",
@@ -113,7 +112,6 @@ __all__ = [
     "lcu",
     "lcu_pauli",
     "linear_pauli_rotations",
-    "load_amplitudes",
     "modular_add_qft_space",
     "modular_exp",
     "modular_increment",
@@ -129,6 +127,7 @@ __all__ = [
     "prepare_ghz_state",
     "prepare_int",
     "prepare_linear_amplitudes",
+    "prepare_select",
     "prepare_sparse_amplitudes",
     "prepare_uniform_interval_state",
     "prepare_uniform_trimmed_state",
@@ -154,7 +153,6 @@ __all__ = [
     "qsvt_lcu_step",
     "qsvt_step",
     "reflect_about_zero",
-    "span_lookup_table",
     "suzuki_trotter",
     "swap_test",
     "switch",

classiq/open_library/functions/amplitude_loading.py

@@ -6,7 +6,10 @@ from sympy import fwht
 from classiq.interface.exceptions import ClassiqValueError
 
 from classiq.qmod.builtins.functions import CX, RY
-from classiq.qmod.builtins.operations import bind, skip_control
+from classiq.qmod.builtins.operations import (
+    bind,
+    skip_control,
+)
 from classiq.qmod.qfunc import qfunc
 from classiq.qmod.qmod_variable import QArray, QBit, QNum
 
@@ -30,20 +33,36 @@ def _get_graycode_ctrls(size: int) -> list[int]:
 
 
 @qfunc
-def load_amplitudes(amplitudes: list[float], index: QNum, indicator: QBit) -> None:
+def assign_amplitude_table(
+    amplitudes: list[float], index: QNum, indicator: QBit
+) -> None:
     """
     [Qmod Classiq-library function]
 
     Load a specified list of real amplitudes into a quantum variable using an extra indicator qubit:
-    \\( |i\rangle|0\rangle \rightarrow a(i)\\,|i\rangle|1\rangle + \\sqrt{1 - a(i)^2}\\,|x\rangle|0\rangle \\).
+    \\( |i\\rangle|0\\rangle \\rightarrow a(i),\\ |i\\rangle|1\\rangle + \\sqrt{1 - a(i)^2},\\ |x\\rangle|0\\rangle \\).
     Here, \\(a(i)\\) is the i-th amplitude, determined by the QNum when the index is in state \\(i\\).
-    A list extracted from a given classical function \\(f(x)\\), with indexing according to a given QNum, can be obtained via the utility SDK function `get_lookup_table`.
-    This function expects the indicator qubit to be initialized to \\(|0\rangle\\).
+    A list extracted from a given classical function \\(f(x)\\), with indexing according to a given QNum, can be obtained via the utility SDK function `lookup_table`.
+    This function expects the indicator qubit to be initialized to \\(|0\\rangle\\).
 
     Args:
         amplitudes: Real values for the amplitudes
         index: The quantum variable used for amplitude indexing
         indicator: The quantum indicator qubit
+
+    Example:
+        ```python
+        from classiq import *
+
+
+        @qfunc
+        def main(x: Output[QNum[5, UNSIGNED, 5]], ind: Output[QBit]) -> None:
+            allocate(x)
+            hadamard_transform(x)
+            allocate(ind)
+
+            assign_amplitude_table(lookup_table(lambda x: x**2, x), x, ind)
+        ```
     """
     if len(amplitudes) != 2**index.size:
         raise ClassiqValueError(

classiq/open_library/functions/lcu.py

@@ -9,6 +9,7 @@ from classiq.open_library.functions.utility_functions import switch
 from classiq.qmod.builtins.functions import IDENTITY, X, Y, Z, inplace_prepare_state
 from classiq.qmod.builtins.operations import (
     control,
+    if_,
     repeat,
     within_apply,
 )
@@ -16,7 +17,7 @@ from classiq.qmod.builtins.structs import IndexedPauli, SparsePauliOp
 from classiq.qmod.cparam import CArray
 from classiq.qmod.qfunc import qfunc
 from classiq.qmod.qmod_variable import QArray, QBit, QNum
-from classiq.qmod.quantum_callable import QCallableList
+from classiq.qmod.quantum_callable import QCallable, QCallableList
 
 
 @qfunc
@@ -36,27 +37,23 @@ def apply_pauli_term(pauli_string: CArray[IndexedPauli], x: QArray[QBit]) -> Non
 
 
 @qfunc
-def lcu(
+def prepare_select(
     coefficients: list[float],
-    unitaries: QCallableList,
+    select: QCallable[QNum],
     block: QNum[Literal["max(ceiling(log(coefficients.len, 2)), 1)"]],
 ) -> None:
     """
     [Qmod Classiq-library function]
 
-    Implements a general linear combination of unitaries (LCU) procedure. The algorithm prepares a superposition
-    over the `unitaries` according to `magnitudes`, and then conditionally applies each unitary controlled by the `block`.
-
-    The operation is of the form:
-
-    $$\\sum_j \\alpha_j U_j$$
-
-    where $U_j$ is a unitary operation applied to `data`.
+    Applies the 'Prepare-Select' scheme used for Linear Combination of Unitaries (LCU).
+    Compared to the `lcu` function, here the Select operator should be provided directly, allowing to take advantage of some structure for
+    the unitaries of the LCU.
+    The select operator is defined by: $\\mathrm{SELECT} = \\sum_{j=0}^{m-1} |j\rangle\\!\\langle j|_{block} \\otimes U_j$.
 
     Args:
         coefficients: L1-normalized array of  $\\{ \\alpha_j \\}$ of the LCU coefficients.
-        unitaries: A list of quantum callable functions to be applied conditionally.
-        block: Quantum variable that holds the superposition index used for conditional application of each unitary.
+        select: A quantum callable to be applied between the state preparation and its inverse. Its input is the `block` variable, labeling the index of the unitaries in the LCU.
+        block: A Quantum variable that holds the index used as input for the 'select' operator.
     """
     coefficients = coefficients + [0] * (
         2**block.size - len(coefficients)  # type:ignore[operator]
@@ -68,16 +65,48 @@ def lcu(
     within_apply(
         lambda: inplace_prepare_state(magnitudes, 0, block),
         lambda: [
-            repeat(
-                count=unitaries.len,
-                iteration=lambda i: control(block == i, lambda: unitaries[i]()),
+            select(block),
+            if_(
+                not np.allclose(np.array(phases) % (2 * np.pi), 0),
+                lambda: apply_phase_table(phases, block),
             ),
-            # TODO: replace to sparse constant phase
-            apply_phase_table(phases, block),
         ],
     )
 
 
+@qfunc
+def lcu(
+    coefficients: list[float],
+    unitaries: QCallableList,
+    block: QNum[Literal["max(ceiling(log(coefficients.len, 2)), 1)"]],
+) -> None:
+    """
+    [Qmod Classiq-library function]
+
+    Implements a general linear combination of unitaries (LCU) procedure. The algorithm prepares a superposition
+    over the `unitaries` according to the given `coefficients`, and then conditionally applies each unitary controlled by the `block`.
+
+    The operation is of the form:
+
+    $$\\sum_j \\alpha_j U_j$$
+
+    where $U_j$ is a unitary operation applied to `data`.
+
+    Args:
+        coefficients: L1-normalized array of  $\\{ \\alpha_j \\}$ of the LCU coefficients.
+        unitaries: A list of quantum callable functions to be applied conditionally.
+        block: Quantum variable that holds the superposition index used for conditional application of each unitary.
+    """
+    prepare_select(
+        coefficients,
+        lambda _block: repeat(
+            count=unitaries.len,
+            iteration=lambda i: control(_block == i, lambda: unitaries[i]()),
+        ),
+        block,
+    )
+
+
 @qfunc
 def lcu_pauli(
     operator: SparsePauliOp,

classiq/open_library/functions/state_preparation.py

@@ -29,7 +29,7 @@ from classiq.qmod.builtins.operations import (
     within_apply,
 )
 from classiq.qmod.cparam import CArray, CInt, CReal
-from classiq.qmod.qfunc import qfunc
+from classiq.qmod.qfunc import qfunc, qperm
 from classiq.qmod.qmod_variable import Output, QArray, QBit, QNum
 from classiq.qmod.symbolic import (
     acos,
@@ -248,7 +248,7 @@ def prepare_bell_state(
     CX(qpair[0], qpair[1])
 
 
-@qfunc
+@qperm
 def inplace_prepare_int(value: CInt, target: QNum) -> None:
     """
     [Qmod Classiq-library function]
@@ -273,7 +273,7 @@ def inplace_prepare_int(value: CInt, target: QNum) -> None:
     target ^= value
 
 
-@qfunc
+@qperm
 def prepare_int(
     value: CInt,
     out: Output[QNum[Literal["floor(log(value, 2)) + 1"]]],
@@ -324,7 +324,7 @@ def _classical_hadamard_transform(arr: list[float]) -> np.ndarray:
     return 1 / np.sqrt(len(arr)) * np.array(sympy.fwht(np.array(arr)))
 
 
-@qfunc
+@qperm
 def apply_phase_table(
     phases: list[float],
     target: QArray[QBit, Literal["log(phases.len, 2)"]],
@@ -456,7 +456,7 @@ def prepare_dicke_state(k: int, qvar: QArray[QBit]) -> None:
         prepare_dicke_state_unary_input(k, qvar)
 
 
-@qfunc
+@qperm
 def prepare_basis_state(state: list[bool], arr: Output[QArray]) -> None:
     """
     [Qmod Classiq-library function]
@@ -515,7 +515,7 @@ def prepare_linear_amplitudes(x: QArray) -> None:
     hadamard_transform(x)
 
 
-@qfunc
+@qperm
 def swap_states(a: int, b: int, target: QArray) -> None:
     """
     Swap 2 computational basis states a and b, leave all other states untouched.
@@ -538,7 +538,7 @@ def swap_states(a: int, b: int, target: QArray) -> None:
     if anchor < target.len - 1:
         target_without_anchor.append(target[anchor + 1 : target.len])
 
-    @qfunc
+    @qperm
     def _xor_if_equal(n: CInt, ctrl: QNum, target: QBit) -> None:
         target ^= ctrl == n
 

classiq/qmod/builtins/functions/__init__.py

@@ -51,6 +51,7 @@ CORE_LIB_DECLS = [
         U,
         CCX,
         free,
+        drop,
         randomized_benchmarking,
         inplace_prepare_state,
         inplace_prepare_state_approx,
@@ -107,6 +108,7 @@ __all__ = [  # noqa: RUF022
     "apply",
     "exponentiation_with_depth_constraint",
     "free",
+    "drop",
     "inplace_prepare_amplitudes",
     "inplace_prepare_amplitudes_approx",
     "inplace_prepare_state",

classiq/qmod/builtins/functions/allocation.py

@@ -21,6 +21,27 @@ def free(in_: Input[QArray[QBit]]) -> None:
     pass
 
 
+@qperm(external=True)
+def drop(in_: Input[QArray[QBit]]) -> None:
+    """
+    [Qmod core-library function]
+
+    Discards the qubits allocated to a quantum variable which may be in any state,
+    preventing their further use.
+
+    Args:
+        in_: The quantum variable that will be dropped. Must be initialized before.
+
+    Note:
+        This operation can be used to bypass the restrictions on a local variable
+        that enable its uncomputation. The implication is that its qubits are left
+        dirty, possibly entangled with functional qubits, and never subsequently reused.
+
+        Functions which use `drop` cannot be inverted or used inside a _within_ block.
+    """
+    pass
+
+
 @qfunc(external=True)
 def prepare_state(
     probabilities: CArray[CReal],

classiq/qmod/builtins/operations.py

@@ -2,6 +2,7 @@ import inspect
 import sys
 from collections.abc import Callable, Mapping
 from functools import wraps
+from itertools import product
 from types import FrameType
 from typing import (
     Any,
@@ -48,6 +49,7 @@ from classiq.interface.model.skip_control import SkipControl
 from classiq.interface.model.statement_block import StatementBlock
 from classiq.interface.model.within_apply_operation import WithinApply
 
+from classiq.qmod.builtins.functions import H, S
 from classiq.qmod.generative import is_generative_mode
 from classiq.qmod.qmod_constant import QConstant
 from classiq.qmod.qmod_variable import Input, Output, QArray, QBit, QNum, QScalar, QVar
@@ -55,15 +57,21 @@ from classiq.qmod.quantum_callable import QCallable
 from classiq.qmod.quantum_expandable import prepare_arg
 from classiq.qmod.semantics.error_manager import ErrorManager
 from classiq.qmod.symbolic_expr import SymbolicExpr
-from classiq.qmod.utilities import Statements, get_source_ref, suppress_return_value
+from classiq.qmod.utilities import (
+    RealFunction,
+    Statements,
+    get_source_ref,
+    qnum_values,
+    suppress_return_value,
+)
 
 _MISSING_VALUE: Final[int] = -1
 
-Params = ParamSpec("Params")
-RetType = TypeVar("RetType")
+_Params = ParamSpec("_Params")
+_RetType = TypeVar("_RetType")
 
 
-def qmod_statement(func: Callable[Params, RetType]) -> Callable[Params, RetType]:
+def qmod_statement(func: Callable[_Params, _RetType]) -> Callable[_Params, _RetType]:
     @wraps(func)
     def wrapper(*args: Any, **kwargs: Any) -> Any:
         source_ref = get_source_ref(sys._getframe(1))
@@ -771,10 +779,65 @@ def _operand_to_body(
         raise ValueError(f"Unexpected operand type: {type(to_operand)}")
 
 
+def assign_amplitude_poly_sin(indicator: QBit, expr: Callable, *vars: QNum) -> None:
+    """
+    Encodes the value of the sine/cosine of a polynomial into the amplitude of the
+    respective computational basis state:
+    \\( |x_1, x_2, \\ldots, x_n\\rangle|0\\rangle \\rightarrow cos(poly(x_1, x_2, \\ldots, x_n)) + sin(poly(x_1, x_2, \\ldots, x_n))|x_1, x_2, \\ldots, x_n\\rangle|1\\rangle \\)
+
+    Args:
+        indicator: The quantum indicator qubit
+        expr: A polynomial function over `len(vars)` QNums
+        *vars: Quantum numerics
+    """
+    phase(-expr(*vars))
+    within_apply(
+        lambda: H(indicator),
+        lambda: control(indicator, lambda: phase(2 * expr(*vars))),
+    )
+    S(indicator)
+
+
+def _get_qnum_values(num: QNum) -> list[float]:
+    size = num.size
+    is_signed = num.is_signed
+    fraction_digits = num.fraction_digits
+    if (
+        not isinstance(size, int)
+        or not isinstance(is_signed, bool)
+        or not isinstance(fraction_digits, int)
+    ):
+        raise ClassiqValueError(f"QNum argument {str(num)!r} has symbolic attributes")
+
+    return qnum_values(size, is_signed, fraction_digits)
+
+
+def lookup_table(func: RealFunction, targets: QNum | list[QNum]) -> list[float]:
+    """
+    Reduces a classical function into a lookup table over all the possible values
+    of the quantum numbers.
+
+    Args:
+        func: A Python function
+        targets: One or more initialized quantum numbers
+
+    Returns:
+        The function's lookup table
+
+    Notes:
+        The QNum arguments must have generative attributes
+    """
+    if not isinstance(targets, list):
+        targets = [targets]
+    target_vals = [_get_qnum_values(target) for target in targets]
+    return [func(*vals[::-1]) for vals in product(*target_vals[::-1])]
+
+
 __all__ = [
     "allocate",
     "assign",
     "assign_amplitude",
+    "assign_amplitude_poly_sin",
     "bind",
     "block",
     "control",
@@ -782,6 +845,7 @@ __all__ = [
     "inplace_add",
     "inplace_xor",
     "invert",
+    "lookup_table",
     "phase",
     "power",
     "repeat",

classiq/qmod/utilities.py

@@ -3,7 +3,6 @@ import inspect
 import itertools
 import keyword
 import sys
-from collections import Counter
 from collections.abc import Callable, Iterable
 from enum import Enum as PythonEnum
 from types import FrameType
@@ -195,13 +194,4 @@ def qnum_attributes(max_size: int) -> list[tuple[int, bool, int]]:
     ]
 
 
-_VAR_NAME_COUNTER: Counter[str] = Counter()
-
-
-def get_temp_var_name(var_name: str = "temp") -> str:
-    n = _VAR_NAME_COUNTER[var_name]
-    _VAR_NAME_COUNTER[var_name] += 1
-    return f"{var_name}_{n}"
-
-
 RealFunction = Callable[Params, float]

{classiq-0.95.0.dist-info → classiq-0.96.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: classiq
-Version: 0.95.0
+Version: 0.96.0
 Summary: Classiq's Python SDK for quantum computing
 Keywords: quantum computing,quantum circuits,quantum algorithms,QAD,QDL
 Author: Classiq Technologies

{classiq-0.95.0.dist-info → classiq-0.96.0.dist-info}/RECORD

@@ -3,7 +3,7 @@ classiq/_analyzer_extras/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 classiq/_analyzer_extras/_ipywidgets_async_extension.py,sha256=cxdrzSOEQ8_2rLXcScDnhZoZAHqPmIhY-DhBPWLcNII,2200
 classiq/_analyzer_extras/interactive_hardware.py,sha256=9ZnQX_MZCF21s2skWXUjm4mYCBCeytJtxcnyTE1XU4g,3438
 classiq/_internals/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-classiq/_internals/api_wrapper.py,sha256=6GL6Zl9b66mmzvFBrsWp-uVZ3mAkofadxZN7hkRDBHw,20039
+classiq/_internals/api_wrapper.py,sha256=erBYv-ppjNzTB9DDBIx8zPUwqgvbnUGO8t88C1Jd4-c,17377
 classiq/_internals/async_utils.py,sha256=mcBzGZQYG3EdI7NkBwAO_MGsbF4RFMEUjN1Yoz1CiKE,3327
 classiq/_internals/authentication/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/_internals/authentication/auth0.py,sha256=6zkfNJypASlMAKimRLYDZAZEUI5KaM4lNWyai3ufXX4,4628
@@ -68,7 +68,7 @@ classiq/applications/combinatorial_optimization/examples/__init__.py,sha256=A0-j
 classiq/applications/hamiltonian/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/applications/hamiltonian/pauli_decomposition.py,sha256=Jdc1eKYb-rwacVbGkoifyGq1qHmfk-jLsFTr8MtwvR8,5255
 classiq/applications/iqae/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-classiq/applications/iqae/iqae.py,sha256=LV3tCuVFLpqKeL1ItyeigXmxZ4OY9KoUGPMHD6u8ui8,7315
+classiq/applications/iqae/iqae.py,sha256=9tQLFVP2u6J8GdZCm5qpUk3pCtfkUO-T99b2TRv6dS4,7465
 classiq/applications/qnn/__init__.py,sha256=_DQQo81JQ-LR0VY2AooqpRMj9ej9ubZfVl6ESoBPoqE,433
 classiq/applications/qnn/circuit_utils.py,sha256=QWRYnHhDgbFuEQIUYhFfShNFGgbsIB-ZcLkubztLsZQ,4345
 classiq/applications/qnn/datasets/__init__.py,sha256=HRQHIXGZOYqa4tIwUR3o31GiWVCtJOGW2xGV-gKAqUo,812
@@ -80,9 +80,9 @@ classiq/applications/qnn/datasets/dataset_xor.py,sha256=fN73XTbjtxQCm5KW0A4KAD2w
 classiq/applications/qnn/datasets/datasets_utils.py,sha256=LgerS3HPe82gVTMg6YLWFmKt5adZCHxxr7lPYNCqJpI,1363
 classiq/applications/qnn/gradients/__init__.py,sha256=md5sLINVaPeZUHJUe1ZtIcqLN_V_I2RKfBe3mO3zZs4,102
 classiq/applications/qnn/gradients/quantum_gradient.py,sha256=FtyrLbpN4lqOlrj86LFtUGvTUZs_Jajblzrau5a0-CE,1169
-classiq/applications/qnn/gradients/simple_quantum_gradient.py,sha256=QT1wh9SpSFtRH0-OxRsWxCKHlDjLumNwyVAcmR9r78w,5020
-classiq/applications/qnn/qlayer.py,sha256=X9cKYggtdlB75uFBwcdJSU-pKcp2EUVbJwTfaAWZDCQ,9026
-classiq/applications/qnn/torch_utils.py,sha256=y33WNDwKYQcjouPoESWVrEUnKmcOoH_mv10wW7iquGQ,4393
+classiq/applications/qnn/gradients/simple_quantum_gradient.py,sha256=5TGzxvWPtqpIKmZAJROXBYio1-1wNLhW4_eraTDKbII,4959
+classiq/applications/qnn/qlayer.py,sha256=HZLstEnVhK8ve5LX2O2ssIaUZEG0j8GJg4jMPqdPrHc,9000
+classiq/applications/qnn/torch_utils.py,sha256=eLxHZKqT7aamUkH8veOAFblBxQKe_0kM0TxMGejJ7DU,4439
 classiq/applications/qnn/types.py,sha256=ng51NBh-dXguC6yPGvDetww-O_75OAkcE8FFwWOCQ_Y,862
 classiq/applications/qsp/__init__.py,sha256=8Zr-aJ3SQMD7f4YaUikbKB6gDD0gOhPD_ZO9poaEtqY,169
 classiq/applications/qsp/qsp.py,sha256=7H2_oSZzt1C4dE8SKiRiH6h9P7sj2DZwi6jxpcGX4-U,13579
@@ -122,16 +122,15 @@ classiq/evaluators/qmod_type_inference/classical_type_inference.py,sha256=rPxvqR
 classiq/evaluators/qmod_type_inference/quantum_type_inference.py,sha256=3gMh44K7BiTY8W78AcytUPR-1n2xjiUyQ58JcgzKwdM,12609
 classiq/evaluators/quantum_type_utils.py,sha256=oTouwtHBM_xugCaa4kqd6L7YujRDMRxxqirtnzhzrJk,2792
 classiq/evaluators/type_type_match.py,sha256=XOI6oJiHkLdcx-RX9yyE2ARXFLbaWYW1Tq2YSlVAOJc,3269
-classiq/execution/__init__.py,sha256=tjAsQFbm8_9yj6cHXK_E0Eajs1F7REjcKstddpsvkDI,1524
+classiq/execution/__init__.py,sha256=vv6Gb5j8mmYw9czw4r2rX6OfZWdVMcMVXY2gPDCHsro,1391
 classiq/execution/all_hardware_devices.py,sha256=KpLefEISE03FDdgFPGggXeG7NAxBW4090gN4272Dl-E,368
 classiq/execution/execution_session.py,sha256=W1GzbdIyhndEmSqk_DQQLDFoTUTs82y418_qaOgsGRc,25570
-classiq/execution/iqcc.py,sha256=fG92ZwgZl_tAih0vndZpIKksVCQuLTk5pJy2X4LRkxA,4298
 classiq/execution/jobs.py,sha256=fw52prvnA9gLb10flBM2cCP7a5FN5f2xHc0i6knpJ1I,12059
 classiq/execution/qnn.py,sha256=zA-I-wvVkjyoigGvcG2W2KVbyKF5Z4X6hIQ3IPI-1xA,2436
-classiq/execution/user_budgets.py,sha256=k80pj6-rhkKi92dwrwnAyQbfqc5z9sAaShtArv8OyyE,4029
+classiq/execution/user_budgets.py,sha256=fZvHfwXEkcygoMT8N0XwauHkxCmZX93d1OVL0ZJ8ysU,3996
 classiq/executor.py,sha256=5j4bLYP4acxKTenFYnSEGf9tBDCjdpBiaBp86l78U_o,2278
 classiq/interface/__init__.py,sha256=cg7hD_XVu1_jJ1fgwmT0rMIoZHopNVeB8xtlmMx-E_A,83
-classiq/interface/_version.py,sha256=Hf8uksvpcfwUi31VXM5_c5n06QLj9nyULCr8wkWmbmU,197
+classiq/interface/_version.py,sha256=2BCf7M-1i8AXPhX0CDXXhI7qzz7Bbqqh8if5GpiYBcs,197
 classiq/interface/analyzer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/analyzer/analysis_params.py,sha256=34pFb5X5rPeZOe3TNxBq6oT5YJKcJ9ORyZ_7KRP-alA,2991
 classiq/interface/analyzer/cytoscape_graph.py,sha256=Ky2tSKdnCnA26896DPy64HSVudLnE3FzdGDUUf0nkI0,2345
@@ -142,11 +141,11 @@ classiq/interface/applications/iqae/generic_iqae.py,sha256=IdbdB3vJ6kUe2exSaHuSf
 classiq/interface/applications/iqae/iqae_result.py,sha256=S13A_mQKRTBaqO2NKJEJlgLl06I2Fz_C6F_4Xlp4fzQ,1770
 classiq/interface/ast_node.py,sha256=t1UtCIRn8vvjSlnw_ak4cbCHReo2X6AYBRn_uvKwmz4,925
 classiq/interface/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-classiq/interface/backend/backend_preferences.py,sha256=1zRN1Lltt-9gS5pJKSPOBChJErqaWvjn5tMBOx8PNFo,20571
+classiq/interface/backend/backend_preferences.py,sha256=1aOBYAN9bRbSJ6IBoRYY52W3Lu7Z2wCUm2WEV-snX14,19563
 classiq/interface/backend/ionq/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/backend/ionq/ionq_quantum_program.py,sha256=CbbM_SnnS3k0U6iznqRLSfjHSdbuAuXLcxvSDP6PcVY,1213
 classiq/interface/backend/pydantic_backend.py,sha256=XfG1u_8ZEq382P5LTHYEhjkDH7UZYY_1sl1O-RImSmk,1610
-classiq/interface/backend/quantum_backend_providers.py,sha256=VSSGvmrRKFCmatylkq-tzwCR5MeUEtSvImr6IDuinFI,7598
+classiq/interface/backend/quantum_backend_providers.py,sha256=dY8rXM5N_WruDNkVMTZSiAbfSBB6GwdkhLYxc0UgQrE,7540
 classiq/interface/chemistry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/chemistry/ansatz_library.py,sha256=9HbqdeAgJ0xd3xsPZwfLtS1KsFggSVucLI3E0IknkL0,322
 classiq/interface/chemistry/operator.py,sha256=PDm5q7jBVVT7yJYaWKdxLFuDPxQ8n4_cZXEiJd6SX1I,10239
@@ -179,7 +178,6 @@ classiq/interface/debug_info/debug_info.py,sha256=XyvpcH23tHoQ2uue3dGyV-zasjRNv7
 classiq/interface/enum_utils.py,sha256=QxkxLGgON8vdSzLZzHFlPEBJoGOqoIwpESEfLfRqN0w,312
 classiq/interface/exceptions.py,sha256=mK2fJtonRmcQ-zThyey5MhEGA1O0mkBpTGqz3z0OxTU,4390
 classiq/interface/execution/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-classiq/interface/execution/iqcc.py,sha256=__KIPbVdD3ow2u1rq8OKJE5V2wm3-hBoVPMIkwfY5v0,806
 classiq/interface/execution/primitives.py,sha256=Zqu5j2s8E7a0B6LyIRX4eEgq3hHqAjA5ptWg0gVLy5Q,1476
 classiq/interface/executor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/executor/constants.py,sha256=DtSx-1HArWE0hHjOZHY9WJBevt3hP7M8SrYO3eM3dgo,31
@@ -220,7 +218,7 @@ classiq/interface/generator/arith/extremum_operations.py,sha256=SVUoZFkNZCfI2wLC
 classiq/interface/generator/arith/logical_ops.py,sha256=0BfMHlcQIWpmxDU0szlYa51ewnqUgVp6qak5jjwtzco,2647
 classiq/interface/generator/arith/machine_precision.py,sha256=uh1qwWL056mSdcANKddz5G720plWvAxlXIp7a32Tdtg,68
 classiq/interface/generator/arith/number_utils.py,sha256=mh5pLrCA9sICklL8G6WC1kTjgGPh7sqvmCa8Q-V82FQ,4537
-classiq/interface/generator/arith/register_user_input.py,sha256=lpnTDXs1JE8UiIlVokEe9eBI86BXlpgQ-M7-bcDF1es,5160
+classiq/interface/generator/arith/register_user_input.py,sha256=nAPLslctQYYS4_ASDRYulY2PehtIi9Ih1_bi3JQyWF8,5132
 classiq/interface/generator/arith/unary_ops.py,sha256=mj-9dHtaXeFDreslFmPugCTKxlUsZ5ToqBpy0YbahBY,5369
 classiq/interface/generator/arith/uncomputation_methods.py,sha256=AbBAgOYTEJ2ufDyJLDew7RKCZPMS8vb7K0Ld6adInXk,136
 classiq/interface/generator/builtin_api_builder.py,sha256=xDn-gRte0n8fNB03hwPjQE8MZhfDJyNrJrmymtahohg,418
@@ -276,7 +274,7 @@ classiq/interface/generator/hamiltonian_evolution/qdrift.py,sha256=IFF015sz0gaqX
 classiq/interface/generator/hamiltonian_evolution/suzuki_trotter.py,sha256=JCYnbixIv5tZzDU4CTPW0m44Il7-NeAow4MgjAw0-K4,1957
 classiq/interface/generator/hardware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/generator/hardware/hardware_data.py,sha256=P9Y1I5Oobd5I8Ihrfd3kytWf-a7Ru8U09eiCcY3HpQE,8643
-classiq/interface/generator/hardware_efficient_ansatz.py,sha256=a_NXOtWMl314OcK9r17ccfC44GeaNVEHxSrD375GEZo,5080
+classiq/interface/generator/hardware_efficient_ansatz.py,sha256=nLY0lpVZEdbywbR-RsV_BurXiQ1mayETkYwtRhmm4Ic,5052
 classiq/interface/generator/identity.py,sha256=XDiA47DP7JirPaUMUqIQQgyahjWw7N3LGjF0LnZ5V_0,1263
 classiq/interface/generator/mcmt_method.py,sha256=wKS3ivhErKhxmes6Mb1sUwaJgcg48wVCk63oP2za1vQ,232
 classiq/interface/generator/mcu.py,sha256=Xkyi6VaStSoxmsSqaUrMgQJVcxXGq3dHPP4WbxPkUxA,3231
@@ -294,7 +292,7 @@ classiq/interface/generator/partitioned_register.py,sha256=wFWbncJ7lAEhbrT0WEm_x
 classiq/interface/generator/preferences/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/generator/preferences/optimization.py,sha256=7iEWWNFSxqi4XMb4JmOcfeN8KqvNMEcSjQw8P8yrdOA,1066
 classiq/interface/generator/preferences/qasm_to_qmod_params.py,sha256=K1MFAUK_uhRfedjfm_bV-ApZsqmJWzeRD37-hd3yaTg,417
-classiq/interface/generator/quantum_function_call.py,sha256=Mo7LZjk21W_4WJ0Oiz2MSyBcWcBFZd_0OgY00yUnvvY,24155
+classiq/interface/generator/quantum_function_call.py,sha256=_EBr9TR12XwVTd0FVWrbjZrAK963xu6yCcwgNBKQJTg,24127
 classiq/interface/generator/quantum_program.py,sha256=CQMe12Ns473EXuZRk6gXP4lyP59xj6AxGzAGzFmTEXY,7241
 classiq/interface/generator/randomized_benchmarking.py,sha256=D6KI_1fMF5oBydaal2WLmTSit6xSMtz0yDAIZMMO89Q,635
 classiq/interface/generator/range_types.py,sha256=bmm2NjRxaCoVJT5WMLjPDCrjGCbjzgjodlCDUNiGA68,2028
@@ -336,7 +334,7 @@ classiq/interface/generator/validations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5J
 classiq/interface/generator/validations/flow_graph.py,sha256=wEdGgHqQjDOdwji4MfMgi4Ig4Lme003wCEgkxnbHU8g,6187
 classiq/interface/generator/validations/validator_functions.py,sha256=ODvbPavjxx2skGdNdgT5d9ZsZjsp9XkHBUPK7oZBElY,1418
 classiq/interface/generator/visitor.py,sha256=009l7QuESO4eFxwppI-cz1MJlFRsCCIPXW9eDaPeCVY,3445
-classiq/interface/hardware.py,sha256=yh9DTGkgVKu1AdZIY-yatemluVkzC_esc-o6ijZyLeI,2422
+classiq/interface/hardware.py,sha256=_f8BGX0GI4qCbECNlXJFkFg1DxmVDtt3CK0rLJLOyt4,2404
 classiq/interface/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/helpers/classproperty.py,sha256=bCUTBCcZSZ7GRlfhyEuTlsAJclgMOCyjFtjJxmBYzj8,266
 classiq/interface/helpers/custom_encoders.py,sha256=X3QEHAJ9_4yB7B6bk-y0CEmtFPwnrjnENqQ8PlgGYN4,128
@@ -396,7 +394,7 @@ classiq/interface/pyomo_extension/pyomo_sympy_bimap.py,sha256=ED3DFL7hKnrrEoV4V3
 classiq/interface/pyomo_extension/set_pprint.py,sha256=jlyYUHfQXwyzPQIzstnTeIK6T62BcSPn3eJdD1Qjy7E,344
 classiq/interface/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/interface/server/global_versions.py,sha256=EyUtBCoGHjgS4jybiHI8wOZq3WOqvta2WYZc5MARkoA,274
-classiq/interface/server/routes.py,sha256=d1sNJE9WoBUykRJsGCgTWP3az8j__0C0LvXrpyLu36w,3804
+classiq/interface/server/routes.py,sha256=Of0wZl_RBJwW_8t2DZiZBJkZwRqY6BKxoW7eCmGHgsA,3181
 classiq/interface/source_reference.py,sha256=A44UHfPyUeOog8K4G1ftNLiU8WyYvUpkeVyA1PBLhWI,1844
 classiq/model_expansions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/model_expansions/arithmetic.py,sha256=N_y3KSS3UgVTVXAPfCWbWJ93o80b1tXD99dh90xbQqg,4949
@@ -407,7 +405,7 @@ classiq/model_expansions/capturing/mangling_utils.py,sha256=Vqk6T4s9e9km54oD8P_g
 classiq/model_expansions/closure.py,sha256=kqVeK2H8c42DIHji2dcBGCTEMF3VjV66FlnL7mPSWnk,4123
 classiq/model_expansions/debug_flag.py,sha256=JWzl9FFq2CLcvTg_sh-K8Dp_xXvewsTuFKhPjTCrsrs,107
 classiq/model_expansions/function_builder.py,sha256=DNj7NUtM3vYL-eCYWTGWhqgH89hbms6WkQTaZDze5UI,9090
-classiq/model_expansions/generative_functions.py,sha256=KB2_r_P7q35ncCeGTJiYAm_nEcJf6brQkaqPsuBpgIo,8387
+classiq/model_expansions/generative_functions.py,sha256=JUqDl6aSphEM5LdOjxuf0LLVcxOcfB4GycP65zbq6NI,8194
 classiq/model_expansions/interpreters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 classiq/model_expansions/interpreters/base_interpreter.py,sha256=4xT7uPNKoJIkSk3mOtWMLKKg_0P8Vb5ORdxi9sAiUZU,14626
 classiq/model_expansions/interpreters/frontend_generative_interpreter.py,sha256=YKoZsv9rB1KZBQqKjpVh73CIla6QrsEB1dpa-Hlnrx4,3836
@@ -445,22 +443,21 @@ classiq/model_expansions/visitors/symbolic_param_inference.py,sha256=goLFicRmxFu
 classiq/model_expansions/visitors/uncomputation_signature_inference.py,sha256=AYHoSNd1nWl2mFdLAceqkggqSdbu4SpYVtjgOioQAPg,12911
 classiq/model_expansions/visitors/variable_references.py,sha256=z6_vcra7sTak5mEhONXs77p7xO34Y8ZeeYCMuSfAui8,6587
 classiq/open_library/__init__.py,sha256=bmg_qqXCXo85hcU7_QCce-qYGrpAVSFNwTKCClsclrg,114
-classiq/open_library/functions/__init__.py,sha256=RWZqK-VhLGVp_5HPSMd3wqfjpIYc3r2n8vz2HTxj1Jg,3924
+classiq/open_library/functions/__init__.py,sha256=ISiQ8342FRuHULa6j5qAyQ4h2inxQcnbwl2eUUx1cDQ,3849
 classiq/open_library/functions/amplitude_amplification.py,sha256=WH2dqYbmmWHZX7beu7-EipnC6Gzn4En4D2gmB2sXvZI,3997
 classiq/open_library/functions/amplitude_estimation.py,sha256=iCkca5SQN_HQoJWk1_tLT56fHT72hu5QIt2pxSZQRko,1766
-classiq/open_library/functions/amplitude_loading.py,sha256=E21BMj_82e8EmR8uOC9zB1zcuQIFbSZcAcWvnI14MpE,2429
+classiq/open_library/functions/amplitude_loading.py,sha256=aJoAjqil2eKn_9X-tLYvoi1LfKyPE1rdTuW1o3c2Fdo,2791
 classiq/open_library/functions/discrete_sine_cosine_transform.py,sha256=F-yD4paGBFueWRK_Tr36aIxxBuzvXte1JtvizxKet68,4634
 classiq/open_library/functions/grover.py,sha256=e5LlbHj-nfR_iAhmRei4BuFJOjDFJrb2rBwzdwB-xfg,4688
 classiq/open_library/functions/hea.py,sha256=Nc9pj-4mGLZVQQKCaVRgrcPd4eViuz3Ji5ZeYzaCozg,4889
-classiq/open_library/functions/lcu.py,sha256=wzkavQZfIl1IsKPUou-sN6flb23YjT_4uR_khqG25Vk,4105
+classiq/open_library/functions/lcu.py,sha256=MZcxrxWVSngyw888RpH4Yum9eaQC0vwAKwq5K5_kygU,5268
 classiq/open_library/functions/linear_pauli_rotation.py,sha256=rjQTglfF1MVk1-Wmk6QWhUPOC7bOPRtBTttz7EjCfcc,2679
-classiq/open_library/functions/lookup_table.py,sha256=LUUn5ur1HqmvG-YhO8mUdVsTVUcN5BoY1da5xwbXTHk,2186
 classiq/open_library/functions/modular_exponentiation.py,sha256=Elpxo5K88SKz55ujyThLLfDuS5Jei59bgyiL_yKQo4A,8552
 classiq/open_library/functions/qaoa_penalty.py,sha256=bnsBlnLwmjAPB4CZ9m1SVPP-eGTnAKXXJwNB-_RuS_Y,4248
 classiq/open_library/functions/qft_functions.py,sha256=7pdPBq48QvyQkxHrF3rEKTf0J50qUu_2bN17lfSc7I0,1382
 classiq/open_library/functions/qpe.py,sha256=e7MBpOthBn73BdqhWpNGT0lkd6Jw3ZG7tE6n--IM0jc,2140
 classiq/open_library/functions/qsvt.py,sha256=-W9QkRWw07nS5_oN1Yaq7z7LjrwFmtf1HhVAV69Lqy4,16481
-classiq/open_library/functions/state_preparation.py,sha256=73rLbRwI86Kiz2EUICd-VodqPvAwUiWqEIKMLZzwALs,22764
+classiq/open_library/functions/state_preparation.py,sha256=h4Vn4CXoCsivGNPpDWefatWHOvcXGxCC7cwEwCuGqRo,22771
 classiq/open_library/functions/swap_test.py,sha256=hAjiJjZGeJP2qzEkVYmBVlEK44VcNibWZ-KqJwPEcFY,1048
 classiq/open_library/functions/utility_functions.py,sha256=-0r7dUdh1KJa93QORRlmPFM8ZDObyreB5Q5Jx4d9RBM,2539
 classiq/open_library/functions/variational.py,sha256=KYoqPKYRjgUXk_10RvogV0YiCG5kl7GZBHBJeeX82II,1715
@@ -471,8 +468,8 @@ classiq/qmod/builtins/classical_execution_primitives.py,sha256=b4gN4CZGrwOXTMPUC
 classiq/qmod/builtins/classical_functions.py,sha256=uTmHUfYbdi0HMc4DLGC5mMxTVpYu-wFZDD1CmZljx9M,455
 classiq/qmod/builtins/constants.py,sha256=FURSVt0dlIAw_xkGMyj89z4eub7vUdvUrPzaLTGUQxk,222
 classiq/qmod/builtins/enums.py,sha256=sfVZXLPZA0k98-Krm6PHRP6bC0mknXiL12l1_9Vp0IA,2399
-classiq/qmod/builtins/functions/__init__.py,sha256=kHR4_LlGV8_vAp9JrcPx0vzl8K5osUV2JT442WzmTRo,2607
-classiq/qmod/builtins/functions/allocation.py,sha256=Q6vazUA7ouKyZcoZ4F209wMuc4WymCBTuYdFWadSFvQ,6721
+classiq/qmod/builtins/functions/__init__.py,sha256=vKtDGwA7YC-Kz9DEP8IKqPViH8HH9IOxa9UNgPGaXiw,2633
+classiq/qmod/builtins/functions/allocation.py,sha256=sPDC4yKa1HyNlJvUXyqPd0GEemhHd4cpGMWAd-v9osc,7413
 classiq/qmod/builtins/functions/arithmetic.py,sha256=ikR4cDEYn0xyg1QS_F_ZFwtMLPezSN9XGuyc_C0pXnc,1846
 classiq/qmod/builtins/functions/benchmarking.py,sha256=TYY1VRd5DHl-mKTKeW5wF1txZgFsb3yPXM_rdgoLWCo,250
 classiq/qmod/builtins/functions/exponentiation.py,sha256=1y3l6ko8dP0f7SicjLzRkNYTKNudBr-K_lDVvaXzJ8s,8715
@@ -480,7 +477,7 @@ classiq/qmod/builtins/functions/mcx.py,sha256=MLx60OURHmqN2z0FKJKN_JiCvSgzk0m7ms
 classiq/qmod/builtins/functions/mid_circuit_measurement.py,sha256=UYtVbsl1vZSBU7x64-3s5EgbZ28fbvGx86j30rsts3w,415
 classiq/qmod/builtins/functions/operators.py,sha256=3IWFjUFhljY5CEe2ZU9Z8m33FzwM9E80IADcDcxVuNI,270
 classiq/qmod/builtins/functions/standard_gates.py,sha256=nkDSQWWcCtHMgxi8dQMqeZbx-XhJrQrC7obxxwYYMDQ,15847
-classiq/qmod/builtins/operations.py,sha256=OHTnPzS0yEEeBfn5yNAcjdzOzYvengEnw0rLFwxhWWQ,28555
+classiq/qmod/builtins/operations.py,sha256=ztwP6_PfuMQuvr4mlBInNCQXE37g66xZ7V8VdhNwd0I,30527
 classiq/qmod/builtins/structs.py,sha256=HMtbIi5IpEeekqSwigxY84EkKBUf8NtIiEvGkas4d94,5752
 classiq/qmod/cfunc.py,sha256=BVHvgVXAZS1SyE0g8Q-1YEMhNO566V0hnl4LZJS3Eg0,1088
 classiq/qmod/classical_function.py,sha256=QqG4Lg8qvd_OpfCsvI0Yv62DCG7tnY2otiXKPqy72EI,1115
@@ -525,12 +522,12 @@ classiq/qmod/symbolic.py,sha256=HtaHB7xz-KGt-tWmVw6Q4wlEq0MPLr99fPcbzqzdWoM,8178
 classiq/qmod/symbolic_expr.py,sha256=z49EyU_bzqc8qOlaOWcWH8A87ACS6aIkYzsLC0DmUBU,7601
 classiq/qmod/symbolic_type.py,sha256=27tY6pJMFt3EmXIKDJPrNFIUuanIlEu4OueseARbk10,260
 classiq/qmod/type_attribute_remover.py,sha256=NZmTXAsngWqthXjE8n-n6yE72fiWTFM12-TXXJ1kJ-Q,1242
-classiq/qmod/utilities.py,sha256=mP1eRQhD2RHN8DbNA5ufipYRHLlhHvCHclTFk3mf8VA,5679
+classiq/qmod/utilities.py,sha256=iS1adFBvnYm31PVkNIx2d6Ir5EqYoqo70B_t2pdPz7I,5443
 classiq/qmod/write_qmod.py,sha256=8xiZKCpy0y5c246DRow22-2YQm7F_eSTXY2KJRFAeds,3495
 classiq/quantum_program.py,sha256=9r1AvhPHDZb4lBEem5T5-mMqbojjyRWHysbJhAoNx80,2056
 classiq/synthesis.py,sha256=RedYU2XVovqd1nmZU4Nb3b705gBlDarXDqQ1A7ug6C0,9852
 classiq/visualization.py,sha256=SvLkPNN-RFd74wnH83eBNANjX11phBTo0wedTazr7VQ,975
-classiq-0.95.0.dist-info/licenses/LICENSE.txt,sha256=pIUwTWPybNElw1us8qbLyUuGDCH1_YioM4ol5tg0Zzw,13367
-classiq-0.95.0.dist-info/WHEEL,sha256=X16MKk8bp2DRsAuyteHJ-9qOjzmnY0x1aj0P1ftqqWA,78
-classiq-0.95.0.dist-info/METADATA,sha256=-sY5mtXDbe_cKXYIrkBpENRaGMbWeOMv4-c9HlFBS4U,3744
-classiq-0.95.0.dist-info/RECORD,,
+classiq-0.96.0.dist-info/licenses/LICENSE.txt,sha256=pIUwTWPybNElw1us8qbLyUuGDCH1_YioM4ol5tg0Zzw,13367
+classiq-0.96.0.dist-info/WHEEL,sha256=X16MKk8bp2DRsAuyteHJ-9qOjzmnY0x1aj0P1ftqqWA,78
+classiq-0.96.0.dist-info/METADATA,sha256=KVbYqgHjBtihYnewywLFGyvLdLzGb0f31abRTIlSZOs,3744
+classiq-0.96.0.dist-info/RECORD,,

classiq/execution/iqcc.py

@@ -1,128 +0,0 @@
-import time
-import webbrowser
-
-from classiq.interface.exceptions import ClassiqError
-from classiq.interface.execution.iqcc import (
-    IQCCAuthItemDetails,
-    IQCCInitAuthData,
-    IQCCListAuthMethods,
-    IQCCListAuthTargets,
-    IQCCProbeAuthData,
-)
-
-from classiq._internals.api_wrapper import ApiWrapper
-from classiq._internals.async_utils import syncify_function
-
-
-async def list_iqcc_auth_scopes_async() -> list[IQCCAuthItemDetails]:
-    """List available authentication scopes in IQCC Bounday.
-
-    Returns:
-        The available authentication scopes.
-    """
-    response = await ApiWrapper().call_iqcc_list_auth_scopes()
-    return response.items
-
-
-list_iqcc_auth_scopes = syncify_function(list_iqcc_auth_scopes_async)
-
-
-async def list_iqcc_auth_methods_async(auth_scope_id: str) -> list[IQCCAuthItemDetails]:
-    """List available authentication methods in IQCC Bounday for a specific scope.
-
-    Args:
-        auth_scope_id: The ID of the IQCC Boundary authentication scope.
-
-    Returns:
-        The available authentication methods.
-    """
-    response = await ApiWrapper().call_iqcc_list_auth_methods(
-        IQCCListAuthMethods(auth_scope_id=auth_scope_id)
-    )
-    return response.items
-
-
-list_iqcc_auth_methods = syncify_function(list_iqcc_auth_methods_async)
-
-
-async def generate_iqcc_token_async(
-    auth_scope_id: str,
-    auth_method_id: str,
-    timeout: float = 120,
-    probe_interval: float = 1,
-    print_auth_url: bool = True,
-) -> str:
-    """Interactively generate a token for use in IQCC backends.
-
-    Args:
-        auth_scope_id: The ID of the IQCC Boundary authentication scope.
-        auth_method_id: The ID of the IQCC Boundary authentication method.
-        timeout: Number of seconds to wait for the interactive authentication to complete.
-        probe_interval: Number of seconds to wait between probes of the authentication.
-        print_auth_url: Whether to print the authentication URL, useful for headless machines with no browser.
-
-    Returns:
-        The authentication token string to use directly in `IQCCBackendPreferences`.
-
-    Raises:
-        ClassiqError: In case timeout has reached before a successful authentication.
-    """
-    initiate_response = await ApiWrapper().call_iqcc_init_auth(
-        IQCCInitAuthData(auth_scope_id=auth_scope_id, auth_method_id=auth_method_id)
-    )
-
-    if print_auth_url:
-        print("Please proceed with authentication on your web browser.")  # noqa: T201
-        print("If no window has opened, use this link to authenticate:")  # noqa: T201
-        print(initiate_response.auth_url)  # noqa: T201
-
-    webbrowser.open_new_tab(initiate_response.auth_url)
-
-    start_time = time.monotonic()
-    while True:
-        time.sleep(probe_interval)
-        probe_response = await ApiWrapper().call_iqcc_probe_auth(
-            IQCCProbeAuthData(
-                auth_scope_id=auth_scope_id,
-                auth_method_id=auth_method_id,
-                token_id=initiate_response.token_id,
-            )
-        )
-        if probe_response is not None:
-            return probe_response.auth_token
-
-        if time.monotonic() - start_time > timeout:
-            raise ClassiqError(
-                f"Timeout has reached while probing IQCC authentication. Please try again and make sure to authenticate within {timeout} seconds, or increase the timeout."
-            )
-
-
-generate_iqcc_token = syncify_function(generate_iqcc_token_async)
-
-
-async def list_iqcc_auth_targets_async(
-    auth_scope_id: str,
-    auth_method_id: str,
-    auth_token: str,
-) -> list[IQCCAuthItemDetails]:
-    """List available authentication targets in IQCC Boundary for the user.
-
-    Args:
-        auth_scope_id: The ID of the IQCC Boundary authentication scope.
-        auth_method_id: The ID of the IQCC Boundary authentication method.
-        auth_token: The authentication token string returned from `generate_iqcc_token_async`.
-
-    Returns:
-        The available authentication targets.
-    """
-    response = await ApiWrapper().call_iqcc_list_auth_targets(
-        IQCCListAuthTargets(
-            auth_scope_id=auth_scope_id,
-            auth_method_id=auth_method_id,
-            auth_token=auth_token,
-        )
-    )
-    return response.items
-
-
-list_iqcc_auth_target = syncify_function(list_iqcc_auth_targets_async)

classiq/interface/execution/iqcc.py

@@ -1,42 +0,0 @@
-from pydantic import BaseModel, Field
-
-from classiq.interface.helpers.versioned_model import VersionedModel
-
-
-class IQCCInitAuthData(VersionedModel):
-    auth_scope_id: str
-    auth_method_id: str
-
-
-class IQCCInitAuthResponse(VersionedModel):
-    auth_url: str
-    token_id: str
-
-
-class IQCCProbeAuthData(IQCCInitAuthData):
-    token_id: str
-
-
-class IQCCProbeAuthResponse(VersionedModel):
-    auth_token: str
-
-
-class IQCCAuthItemDetails(BaseModel):
-    id: str
-    name: str
-    description: str
-    scope_id: str | None = Field(default=None)
-
-
-class IQCCAuthItemsDetails(VersionedModel):
-    items: list[IQCCAuthItemDetails]
-
-
-class IQCCListAuthMethods(VersionedModel):
-    auth_scope_id: str
-
-
-class IQCCListAuthTargets(VersionedModel):
-    auth_scope_id: str
-    auth_method_id: str
-    auth_token: str

classiq/open_library/functions/lookup_table.py

@@ -1,71 +0,0 @@
-from itertools import product
-
-from classiq.interface.exceptions import ClassiqValueError
-
-from classiq.qmod.builtins.operations import assign, bind, within_apply
-from classiq.qmod.qmod_variable import QNum
-from classiq.qmod.symbolic import subscript
-from classiq.qmod.utilities import RealFunction, get_temp_var_name, qnum_values
-
-
-def _get_qnum_values(num: QNum) -> list[float]:
-    size = num.size
-    is_signed = num.is_signed
-    fraction_digits = num.fraction_digits
-    if (
-        not isinstance(size, int)
-        or not isinstance(is_signed, bool)
-        or not isinstance(fraction_digits, int)
-    ):
-        raise ClassiqValueError(f"QNum argument {str(num)!r} has symbolic attributes")
-
-    return qnum_values(size, is_signed, fraction_digits)
-
-
-def get_lookup_table(func: RealFunction, *targets: QNum) -> list[float]:
-    """
-    Reduces a classical function into a lookup table over all the possible values
-    of the quantum numbers.
-
-    Args:
-        func: A Python function
-        *targets: One or more initialized quantum numbers
-
-    Returns:
-        The function's lookup table
-
-    Notes:
-        The QNum arguments must have generative attributes
-    """
-    target_vals = [_get_qnum_values(target) for target in targets]
-    return [func(*vals[::-1]) for vals in product(*target_vals[::-1])]
-
-
-def span_lookup_table(func: RealFunction, *targets: QNum) -> QNum:
-    """
-    Applies a classical function to quantum numbers.
-
-    Works by reducing the function into a lookup table over all the possible values
-    of the quantum numbers.
-
-    Args:
-        func: A Python function
-        *targets: One or more initialized quantum numbers
-
-    Returns:
-        The quantum result of applying func to targets
-
-    Notes:
-        The QNum arguments must have generative attributes
-    """
-    lookup_table = get_lookup_table(func, *targets)
-
-    index_size = sum(target.size for target in targets)
-    index: QNum = QNum(get_temp_var_name(), size=index_size)
-    result: QNum = QNum(get_temp_var_name("result"))
-
-    within_apply(
-        lambda: bind(list(targets), index),
-        lambda: assign(subscript(lookup_table, index), result),
-    )
-    return result