luna-quantum 1.0.3rc3__cp312-cp312-macosx_10_12_x86_64.whl → 1.0.4rc2__cp312-cp312-macosx_10_12_x86_64.whl

luna_quantum/__init__.pyi

@@ -25,9 +25,9 @@ from ._core import (
     Variable,
     Vtype,
     errors,
+    transformations,
     translator,
     utils,
-    transformations,
 )
 from .utils import quicksum
 from luna_quantum._core import __luna_quantum_version__

luna_quantum/_core.pyi

@@ -1,3 +1,4 @@
+from collections.abc import Callable, Iterator
 from datetime import datetime, timedelta
 from enum import Enum
 from types import TracebackType
@@ -205,6 +206,11 @@ class Variable:
         """
         ...
 
+    @property
+    def id(self, /) -> int:
+        """Get the id of the variable."""
+        ...
+
     @property
     def name(self, /) -> str:
         """Get the name of the variable."""
@@ -904,7 +910,7 @@ class Solution:
         ...
 
     @property
-    def obj_values(self, /) -> NDArray:
+    def obj_values(self, /) -> NDArray | None:
         """
         Get the objective values of the single samples as a ndarray.
 
@@ -913,7 +919,7 @@ class Solution:
         ...
 
     @property
-    def raw_energies(self, /) -> NDArray:
+    def raw_energies(self, /) -> NDArray | None:
         """Get the raw energies.
 
         Get the raw energy values of the single samples as returned by the solver /
@@ -978,6 +984,23 @@ class Solution:
         """
         ...
 
+    def filter(self, /, f: Callable[[ResultView], bool]) -> Solution:
+        """
+        Get a new solution with all samples for which the condition `f` is true.
+
+        Parameters
+        ----------
+        f : Callable[[ResultView], bool]
+            A filter function yielding true for all samples to be contained in the
+            new solution.
+
+        Returns
+        -------
+        Solution
+            The new solution with only samples for which the condition is true.
+        """
+        ...
+
     def filter_feasible(self, /) -> Solution:
         """
         Get a new solution with all infeasible samples removed.
@@ -1409,6 +1432,7 @@ class Solution:
         timing: (Timing | None) = ...,
         sense: (Sense | None) = ...,
         bit_order: Literal["LTR", "RTL"] = "RTL",
+        raw_energies: (list[float] | None) = ...,
     ) -> Solution:
         """
         Create a `Solution` from a dict that maps measured bitstrings to counts.
@@ -1431,6 +1455,8 @@ class Solution:
             The sense the model the solution belongs to. Default: Sense.Min
         bit_order : Literal["LTR", "RTL"]
             The order of the bits in the bitstring. Default "RTL".
+        energies: list[float], optional
+            The raw energies for each sample. Default None.
 
         Returns
         -------
@@ -1522,6 +1548,90 @@ class Solution:
         """
         ...
 
+    @overload
+    def add_var(self, var: Variable, data: list[int | float]) -> None: ...
+    @overload
+    def add_var(
+        self, var: str, data: list[int | float], vtype: (Vtype | None) = ...
+    ) -> None: ...
+    def add_var(
+        self,
+        var: (str | Variable),
+        data: list[int | float],
+        vtype: (Vtype | None) = ...,
+    ) -> None:
+        """Add a variable column to the solution.
+
+        Parameters
+        ----------
+        var : str | Variable
+            The name of the variable for which the sample column is created,
+            or the variable itself.
+        data : list[int | float]
+            The contents of the sample column to be added.
+        vtype : Vtype | None, default None
+            The vtype of the variable for which the sample column is created.
+            If the `var` parameter is a str, the vtype is defaulted to Vtype.Binary.
+            If the `var` is a Variable, the `vtype` parameter is ignored and the
+            vtype of the variable is used.
+
+        Raises
+        ------
+        SampleColumnCreationError
+        """
+
+    @overload
+    def add_vars(
+        self, variables: list[Variable], data: list[list[int | float]]
+    ) -> None: ...
+    @overload
+    def add_vars(
+        self, variables: list[str], data: list[list[int | float]], vtypes: list[Vtype]
+    ) -> None: ...
+    @overload
+    def add_vars(
+        self,
+        variables: list[Variable | str],
+        data: list[list[int | float]],
+        vtypes: list[Vtype | None],
+    ) -> None: ...
+    def add_vars(
+        self,
+        variables: list[Variable | str],
+        data: list[list[int | float]],
+        vtypes: (list[Vtype | None] | None) = ...,
+    ) -> None:
+        """Add multiple variable columns to the solution.
+
+        Parameters
+        ----------
+        vars : list[str | Variable]
+            The names of the variable for which the sample columns are created,
+            or a list of the variables itself.
+        data : list[list[int | float]]
+            A list of the contents of the sample columns to be added.
+        vtypes : list[Vtype] | None
+            The vtypes of the variables for which the sample columns are created.
+            If the `vars` parameter is a `list[str], the vtypes are defaulted to
+            Vtype.Binary.
+            If the `vars` is a list[Variable], the `vtypes` parameter is ignored and the
+            vtypes of the variable is used.
+            For mixed `vars`, the vtype is chosen dynamically following the
+            two rules above.
+
+        Raises
+        ------
+        SampleColumnCreationError
+        """
+
+    def remove_var(self, var: (str | Variable)) -> None:
+        """Remove the sample column for the given variable."""
+        ...
+
+    def remove_vars(self, variables: list[str | Variable]) -> None:
+        """Remove the sample columns for the given variables."""
+        ...
+
 class SamplesIterator:
     """
     An iterator over a solution's samples.
@@ -2047,6 +2157,63 @@ class Model:
         """
         ...
 
+    @overload
+    def add_variable_with_fallback(self, name: str, /) -> Variable: ...
+    @overload
+    def add_variable_with_fallback(
+        self, name: str, /, vtype: (Vtype | None) = ...
+    ) -> Variable: ...
+    @overload
+    def add_variable_with_fallback(
+        self, name: str, /, vtype: Vtype, *, lower: (float | type[Unbounded] | None)
+    ) -> Variable: ...
+    @overload
+    def add_variable_with_fallback(
+        self, name: str, /, vtype: Vtype, *, upper: (float | type[Unbounded] | None)
+    ) -> Variable: ...
+    @overload
+    def add_variable_with_fallback(
+        self,
+        name: str,
+        /,
+        vtype: Vtype,
+        *,
+        lower: (float | type[Unbounded] | None),
+        upper: (float | type[Unbounded] | None),
+    ) -> Variable: ...
+    def add_variable_with_fallback(
+        self,
+        name: str,
+        /,
+        vtype: (Vtype | None) = ...,
+        *,
+        lower: (float | type[Unbounded] | None) = ...,
+        upper: (float | type[Unbounded] | None) = ...,
+    ) -> Variable:
+        """
+        Add a new variable to the model with fallback renaming.
+
+        Parameters
+        ----------
+        name : str
+            The name of the variable.
+        vtype : Vtype, optional
+            The variable type (e.g., `Vtype.Real`, `Vtype.Integer`, etc.).
+            Defaults to `Vtype.Binary`.
+        lower: float, optional
+            The lower bound restricts the range of the variable. Only applicable for
+            `Real` and `Integer` variables.
+        upper: float, optional
+            The upper bound restricts the range of the variable. Only applicable for
+            `Real` and `Integer` variables.
+
+        Returns
+        -------
+        Variable
+            The variable added to the model.
+        """
+        ...
+
     def get_variable(self, name: str, /) -> Variable:
         """Get a variable by its label (name).
 
@@ -2167,6 +2334,18 @@ class Model:
         """
         ...
 
+    @property
+    def num_variables(self, /) -> int:
+        """
+        Return the number of variables defined in the model.
+
+        Returns
+        -------
+        int
+            Total number of variables.
+        """
+        ...
+
     @property
     def num_constraints(self, /) -> int:
         """
@@ -2376,6 +2555,9 @@ class Model:
     def __str__(self, /) -> str: ...
     def __repr__(self, /) -> str: ...
     def __hash__(self, /) -> int: ...
+    def deep_clone(self) -> Model:
+        """Make a deep clone of the model."""
+        ...
     metadata: ModelMetadata | None = ...
 
     @staticmethod
@@ -2613,6 +2795,72 @@ class Expression:
         """
         ...
 
+    def linear_items(self, /) -> list[tuple[Variable, float]]:
+        """
+        Get all linear components.
+
+        Returns
+        -------
+        list[tuple[Variable, float]]
+            The linear components.
+        """
+        ...
+
+    def quadratic_items(self, /) -> list[tuple[Variable, Variable, float]]:
+        """
+        Get all quadratic components.
+
+        Returns
+        -------
+        list[tuple[Variable, Variable, float]]
+            The quadratic components.
+        """
+        ...
+
+    def higher_order_items(self, /) -> list[tuple[list[Variable], float]]:
+        """
+        Get all higher-order components.
+
+        Returns
+        -------
+        list[tuple[list[Variable], float]]
+            The higher-order components.
+        """
+        ...
+
+    def is_constant(self, /) -> bool:
+        """
+        Check if expression is constant.
+
+        Returns
+        -------
+        bool
+            If the expression is constant
+        """
+        ...
+
+    def has_quadratic(self, /) -> bool:
+        """
+        Check if expression has quadratic.
+
+        Returns
+        -------
+        bool
+            If the expression has quadratic
+        """
+        ...
+
+    def has_higher_order(self, /) -> bool:
+        """
+        Check if expression has higher-order.
+
+        Returns
+        -------
+        bool
+            If the expression has higher-order
+        """
+        ...
+
     def is_equal(self, /, other: Expression) -> bool:
         """
         Compare two expressions for equality.
@@ -3698,6 +3946,11 @@ class Constraints:
     @overload
     def __getitem__(self, item: int, /) -> Constraint: ...
     def __getitem__(self, item: (int | str), /) -> Constraint: ...
+    @overload
+    def __setitem__(self, item: str, content: Constraint, /) -> None: ...
+    @overload
+    def __setitem__(self, item: int, content: Constraint, /) -> None: ...
+    def __setitem__(self, item: (int | str), content: Constraint, /) -> None: ...
     def __len__(self, /) -> int:
         """
         Get the number of constraints.
@@ -3709,6 +3962,7 @@ class Constraints:
         """
         ...
 
+    def __iter__(self, /) -> Iterator[Constraint]: ...
     def equal_contents(self, other: Constraints, /) -> bool:
         """
         Check whether this constraints has equal contents as `other`.

luna_quantum/decorators.py

@@ -0,0 +1,247 @@
+"""Decorators."""
+
+from collections.abc import Callable
+from typing import Any, Generic, TypeVar, override
+
+from . import Model, Solution
+from .transformations import (
+    ActionType,
+    AnalysisCache,
+    AnalysisPass,
+    BasePass,
+    MetaAnalysisPass,
+    TransformationOutcome,
+    TransformationPass,
+)
+
+T = TypeVar("T")
+
+
+type AnalysisSignature[T] = Callable[[Model, AnalysisCache], T]
+
+type MetaAnalysisSignature[T] = Callable[[list[BasePass], AnalysisCache], T]
+
+type Outcome = (
+    TransformationOutcome | tuple[Model, ActionType] | tuple[Model, ActionType, Any]
+)
+type TransformationSignature = Callable[
+    [Model, AnalysisCache],
+    Outcome,
+]
+type BackwardsSignature = Callable[[Solution, AnalysisCache], Solution]
+
+
+def __identity_backwards(solution: Solution, _: AnalysisCache) -> Solution:
+    return solution
+
+
+class DynamicAnalysisPass(AnalysisPass, Generic[T]):
+    def __init__(
+        self,
+        name: str,
+        requires: list[str],
+        func: AnalysisSignature[T],
+    ) -> None:
+        self._name = name
+        self._requires = requires
+        self._func = func
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def requires(self) -> list[str]:
+        return self._requires
+
+    def __repr__(self) -> str:
+        return f'FunctionAnalysis(name="{self.name}")'
+
+    @override
+    def run(self, model: Model, cache: AnalysisCache) -> T:
+        return self._func(model, cache)
+
+    def __call__(self, model: Model, cache: AnalysisCache) -> T:
+        return self._func(model, cache)
+
+
+class DynamicMetaAnalysisPass(MetaAnalysisPass, Generic[T]):
+    def __init__(
+        self,
+        name: str,
+        requires: list[str],
+        func: MetaAnalysisSignature[T],
+    ) -> None:
+        self._name = name
+        self._requires = requires
+        self._func = func
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def requires(self) -> list[str]:
+        return self._requires
+
+    def __repr__(self) -> str:
+        return f'FunctionMetaAnalysis(name="{self.name}")'
+
+    @override
+    def run(self, passes: list[BasePass], cache: AnalysisCache) -> T:
+        return self._func(passes, cache)
+
+    def __call__(self, passes: list[BasePass], cache: AnalysisCache) -> T:
+        return self._func(passes, cache)
+
+
+class DynamicTransformationPass(TransformationPass):
+    def __init__(
+        self,
+        name: str,
+        requires: list[str],
+        invalidates: list[str],
+        func: TransformationSignature,
+        backwards: BackwardsSignature,
+    ) -> None:
+        self._name = name
+        self._requires = requires
+        self._invalidates = invalidates
+        self._func = func
+        self._backwards = backwards
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def requires(self) -> list[str]:
+        return self._requires
+
+    @override
+    def run(self, model: Model, cache: AnalysisCache) -> Outcome:
+        return self._func(model, cache)
+
+    @override
+    def backwards(self, solution: Solution, cache: AnalysisCache) -> Solution:
+        return self._backwards(solution, cache)
+
+    def __call__(self, model: Model, cache: AnalysisCache) -> Outcome:
+        return self._func(model, cache)
+
+    def __repr__(self) -> str:
+        return f'FunctionTransformation(name="{self.name}")'
+
+
+def analyse(
+    name: str | None = None, requires: list[str] | None = None
+) -> Callable[[AnalysisSignature[T]], DynamicAnalysisPass[T]]:
+    """Create an AnalysisPass instance from a function.
+
+    Parameters
+    ----------
+    name: str | None
+        The name of the analysis pass. If no name provided, uses the function name.
+    requires: list[str] | None
+        List of required analysis passes (defaults to empty list)
+
+    Returns
+    -------
+    Callable[[Callable[[Model, AnalysisCache], Any]], AnalysisPass]
+        An instance of a dynamically created AnalysisPass subclass
+    """
+    if requires is None:
+        requires = []
+
+    _T = TypeVar("_T")
+
+    def _decorator(
+        func: AnalysisSignature[_T],
+    ) -> DynamicAnalysisPass[_T]:
+        loc_name = name or func.__name__.replace("_", "-")
+
+        return DynamicAnalysisPass(name=loc_name, requires=requires, func=func)
+
+    return _decorator
+
+
+def meta_analyse(
+    name: str | None = None, requires: list[str] | None = None
+) -> Callable[[MetaAnalysisSignature[T]], DynamicMetaAnalysisPass[T]]:
+    """Create an MetaAnalysisPass instance from a function.
+
+    Parameters
+    ----------
+    name: str | None
+        The name of the analysis pass. If no name provided, uses the function name.
+    requires: list[str] | None
+        List of required analysis passes (defaults to empty list)
+
+    Returns
+    -------
+    Callable[[Callable[[list[BasePass], AnalysisCache], Any]], MetaAnalysisPass]
+        An instance of a dynamically created AnalysisPass subclass
+    """
+    if requires is None:
+        requires = []
+
+    _T = TypeVar("_T")
+
+    def _decorator(
+        func: MetaAnalysisSignature[_T],
+    ) -> DynamicMetaAnalysisPass[_T]:
+        loc_name = name or func.__name__.replace("_", "-")
+
+        return DynamicMetaAnalysisPass(name=loc_name, requires=requires, func=func)
+
+    return _decorator
+
+
+def transform(
+    name: str | None = None,
+    requires: list[str] | None = None,
+    invalidates: list[str] | None = None,
+    backwards: BackwardsSignature | None = None,
+) -> Callable[[TransformationSignature], DynamicTransformationPass]:
+    """Create an TransformationPass instance from a function.
+
+    Parameters
+    ----------
+    name: str | None = None
+        The name of the analysis pass. If no name provided, uses the function name.
+    requires: list[str] | None = None
+        List of required analysis passes (defaults to empty list)
+    invalidates: list[str] | None = None
+        List of analysis results to invalidate (defaults to empty list)
+    backwards: BackwardsSignature | None = None,
+        Solution backwards mapping function. If none provided, pass solution upstream
+        without modification.
+
+    Returns
+    -------
+    Callable[[TransformationSignature], DynamicTransformationPass]
+        An instance of a dynamically created TransformationPass subclass
+    """
+    if requires is None:
+        requires = []
+    if invalidates is None:
+        invalidates = []
+
+    if backwards is None:
+        backwards = __identity_backwards
+
+    def _decorator(func: TransformationSignature) -> DynamicTransformationPass:
+        loc_name = name or func.__name__.replace("_", "-")
+
+        return DynamicTransformationPass(
+            name=loc_name,
+            requires=requires,
+            invalidates=invalidates,
+            func=func,
+            backwards=backwards,
+        )
+
+    return _decorator
+
+
+__all__ = ["analyse", "transform"]

luna_quantum/errors.pyi

@@ -241,6 +241,11 @@ class NoConstraintForKeyError(IndexError):
 
     def __str__(self, /) -> str: ...
 
+class SampleColCreationError(IndexError):
+    """Raised when an error occured during creation of a sample column."""
+
+    def __str__(self, /) -> str: ...
+
 class InternalPanicError(RuntimeError):
     """Raised when an internal and unrecoverable error occurred."""
 
@@ -262,6 +267,7 @@ __all__ = [
     "MultipleActiveEnvironmentsError",
     "NoActiveEnvironmentFoundError",
     "NoConstraintForKeyError",
+    "SampleColCreationError",
     "SampleIncompatibleVtypeError",
     "SampleIncorrectLengthError",
     "SampleUnexpectedVariableError",

luna_quantum/solve/parameters/backends/qctrl.py

@@ -49,34 +49,6 @@ class Qctrl(QpuTokenBackend):
     https://docs.q-ctrl.com/fire-opal/topics/fire-opals-qaoa-solver)
     """
 
-    class IBMQ(BaseModel):
-        """
-        Configuration parameters for the IBM Quantum backend.
-
-        Attributes
-        ----------
-        hub: str, default="ibm-q"
-            The IBM Quantum hub to use for accessing quantum resources.
-            This defines your access level and available systems.
-
-        group: str, default="open"
-            The IBM Quantum group within your hub.
-            Groups help organize users and projects within a hub.
-
-        project: str, default="main"
-            The IBM Quantum project within your group.
-            Projects help organize work and resource allocation.
-
-        token: Union[str, None, QpuToken], default=None
-            The IBM API token.
-        """
-
-        hub: str = "ibm-q"
-        group: str = "open"
-        project: str = "main"
-
-        token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
-
     class IBMCloud(BaseModel):
         """
         Configuration parameters for the IBM Cloud backend.
@@ -90,14 +62,14 @@ class Qctrl(QpuTokenBackend):
             The IBM API token.
         """
 
-        instance: str
+        instance: str = ""
 
         token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
 
     organization_slug: Any = None
     backend_name: str | None = None
 
-    ibm_credentials: IBMQ | IBMCloud = Field(default=IBMQ())
+    ibm_credentials: IBMCloud = Field(default=IBMCloud())
 
     token: str | QpuToken | None = Field(repr=False, exclude=True, default=None)
 

luna_quantum/transformations.pyi

@@ -1,8 +1,9 @@
 from abc import abstractmethod
+from collections.abc import Callable
 from enum import Enum
 from typing import Any, Literal, overload
 
-from aqmodels import Model, Sense, Solution, Timing, Vtype
+from . import Model, Sense, Solution, Timing, Vtype
 
 class BasePass:
     @property
@@ -14,6 +15,76 @@ class BasePass:
         """Get a list of required passes that need to be run before this pass."""
         ...
 
+class Pipeline(BasePass):
+    @overload
+    def __init__(self, passes: list[BasePass]) -> None: ...
+    @overload
+    def __init__(self, passes: list[BasePass], name: str) -> None: ...
+    def __init__(self, passes: list[BasePass], name: str | None = ...) -> None: ...
+    @property
+    def name(self) -> str:
+        """Get the name of this pass."""
+        ...
+    @property
+    def requires(self) -> list[str]:
+        """Get a list of required passes that need to be run before this pass."""
+        ...
+
+    @property
+    def satisfies(self) -> set[str]:
+        """Get a list of required passes that need to be run before this pass."""
+        ...
+
+    def add(self, new_pass: BasePass) -> None:
+        """Add new pass to pipeline."""
+        ...
+
+    def clear(self) -> None:
+        """Clear pipeline."""
+        ...
+
+    @property
+    def passes(self) -> list[BasePass]:
+        """Get all passes that are part of the pipeline."""
+        ...
+
+    def __len__(self) -> int: ...
+
+class IfElsePass(BasePass):
+    @overload
+    def __init__(
+        self,
+        requires: list[str],
+        condition: Callable[[AnalysisCache], bool],
+        then: Pipeline,
+        otherwise: Pipeline,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        requires: list[str],
+        condition: Callable[[AnalysisCache], bool],
+        then: Pipeline,
+        otherwise: Pipeline,
+        name: str,
+    ) -> None: ...
+    def __init__(
+        self,
+        requires: list[str],
+        condition: Callable[[AnalysisCache], bool],
+        then: Pipeline,
+        otherwise: Pipeline,
+        name: str | None = ...,
+    ) -> None: ...
+    @property
+    def name(self) -> str:
+        """Get the name of this pass."""
+        ...
+    @property
+    def requires(self) -> list[str]:
+        """Get a list of required passes that need to be run before this pass."""
+        ...
+
 class TransformationPass(BasePass):
     @property
     @abstractmethod
@@ -29,7 +100,11 @@ class TransformationPass(BasePass):
         """Get a list of passes that are invalidated by this pass."""
         ...
     @abstractmethod
-    def run(self, model: Model, cache: AnalysisCache) -> tuple[Model, ActionType]:
+    def run(
+        self, model: Model, cache: AnalysisCache
+    ) -> (
+        TransformationOutcome | tuple[Model, ActionType] | tuple[Model, ActionType, Any]
+    ):
         """Run/Execute this transformation pass."""
         ...
     @abstractmethod
@@ -41,13 +116,28 @@ class TransformationPass(BasePass):
         """
         ...
 
+class TransformationOutcome:
+    """Output object for transformation pass."""
+
+    model: Model
+    action: ActionType
+    analysis: ...
+
+    def __init__(
+        self, model: Model, action: ActionType, analysis: ... = None
+    ) -> None: ...
+    @staticmethod
+    def nothing(model: Model) -> TransformationOutcome:
+        """Easy nothing action return."""
+        ...
+
 class AnalysisCache:
     @overload
     def __getitem__(  # type: ignore[reportOverlappingOverload]
         self, key: Literal["max-bias"]
     ) -> MaxBias: ...
     @overload
-    def __getitem__(self, key: str) -> dict[Any, Any]: ...
+    def __getitem__(self, key: str) -> ...: ...
     def __getitem__(self, key: str) -> Any:
         """Get the analysis result for a specific analysis pass."""
         ...
@@ -63,7 +153,22 @@ class AnalysisPass(BasePass):
         """Get a list of required passes that need to be run before this pass."""
         ...
     @abstractmethod
-    def run(self, model: Model, cache: AnalysisCache) -> float:
+    def run(self, model: Model, cache: AnalysisCache) -> ...:
+        """Run/Execute this analysis pass."""
+        ...
+
+class MetaAnalysisPass(BasePass):
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        """Get the name of this pass."""
+        ...
+    @property
+    def requires(self) -> list[str]:
+        """Get a list of required passes that need to be run before this pass."""
+        ...
+    @abstractmethod
+    def run(self, passes: list[BasePass], cache: AnalysisCache) -> ...:
         """Run/Execute this analysis pass."""
         ...
 
@@ -72,7 +177,9 @@ class ActionType(Enum):
     """Indicate that the pass did transform the model."""
     DidAnalysis = ...
     """Indicate that the pass did analyse the model."""
-    Nothing = ...
+    DidAnalysisTransform = ...
+    """Indicate that the pass did analyse and transfrom the model."""
+    DidNothing = ...
     """Indicate that the pass did NOT do anything."""
 
 class ChangeSensePass(BasePass):
@@ -105,15 +212,22 @@ class MaxBiasAnalysis(BasePass):
 
     def __init__(self) -> None: ...
 
-class BinarySpinAnalysis(BasePass):
-    """An analysis pass noting down which variables need to be transformed."""
+class BinarySpinPass(BasePass):
+    """An transformation pass changing the binary/spin variables to spin/binary."""
 
-    def __init__(self, vtype: Literal[Vtype.Binary, Vtype.Spin]) -> None: ...
+    def __init__(
+        self, vtype: Literal[Vtype.Binary, Vtype.Spin], prefix: str | None
+    ) -> None: ...
     @property
     def vtype(self) -> Vtype:
         """Get the target vtype."""
         ...
 
+    @property
+    def prefix(self) -> str | None:
+        """Get the naming prefix."""
+        ...
+
 class BinarySpinInfo:
     @property
     def old_vtype(self) -> Vtype:
@@ -122,19 +236,9 @@ class BinarySpinInfo:
 
     @property
     def new_vtype(self) -> Vtype:
-        """Get the target vtype."""
-        ...
-
-    @property
-    def map(self) -> dict[str, str]:
         """Get the variable name mapping."""
         ...
 
-class BinarySpinPass(BasePass):
-    """An transformation pass changing the denoted variables to target."""
-
-    def __init__(self) -> None: ...
-
 class LogElement:
     """An element of the execution log of an intermediate representation (IR)."""
 
@@ -153,6 +257,11 @@ class LogElement:
         """Transformation type information for this log element, if available."""
         ...
 
+    # @property
+    # def components(self) -> list[LogElement] | None:
+    #     """Components of this log-element."""
+    #     ...
+
 class IR:
     """The intermediate representation (IR) of a model after transformation.
 
@@ -187,7 +296,7 @@ class PassManager:
     """
 
     def __init__(
-        self, passes: list[BasePass | TransformationPass | AnalysisPass]
+        self, passes: list[BasePass | TransformationPass | AnalysisPass] | None = ...
     ) -> None:
         """Manage and execute a sequence of passes on a model.
 
@@ -200,9 +309,9 @@ class PassManager:
 
         Parameters
         ----------
-        passes : list[TransformationPass | AnalysisPass]
+        passes : list[TransformationPass | AnalysisPass] | None
             An ordered sequence of Pass instances to apply. Each Pass must conform to
-            the `TransformationPass` or `AnalysisPass` interface.
+            the `TransformationPass` or `AnalysisPass` interface, default None.
         """
         ...
 

luna_quantum/utils.pyi

@@ -1,7 +1,7 @@
 from collections.abc import Generator, Iterable
 from typing import overload
 
-from aqmodels import Expression, Variable
+from . import Expression, Variable
 
 @overload
 def quicksum(iterable: Generator[Expression], /) -> Expression: ...

{luna_quantum-1.0.3rc3.dist-info → luna_quantum-1.0.4rc2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luna-quantum
-Version: 1.0.3rc3
+Version: 1.0.4rc2
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
@@ -16,7 +16,7 @@ License-File: NOTICE
 Summary: Python SDK for Aqarios' Luna Platform
 Keywords: aqarios,luna,quantum computing,quantum optimization,optimization,sdk
 Author-email: Aqarios <pypi@aqarios.com>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Requires-Python: >=3.11.0, <3.14
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://aqarios.com/

{luna_quantum-1.0.3rc3.dist-info → luna_quantum-1.0.4rc2.dist-info}/RECORD

@@ -1,11 +1,11 @@
-luna_quantum-1.0.3rc3.dist-info/METADATA,sha256=1TbSzuciN5vaguhRzvuOPRByA5JstwjrHtqPFoCh0Pc,1574
-luna_quantum-1.0.3rc3.dist-info/WHEEL,sha256=KVbmEBK8XTzklTUWbxeuu65d5JTBhtdzc5NXYKGXnwg,106
-luna_quantum-1.0.3rc3.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-luna_quantum-1.0.3rc3.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
+luna_quantum-1.0.4rc2.dist-info/METADATA,sha256=3nElJ8QpDP4nLJF4-sBuorJN5c5BSV3G5g26CdauZGI,1585
+luna_quantum-1.0.4rc2.dist-info/WHEEL,sha256=vOxQgEJOLLbJ-XpfttO2_O8fNiBfK7Khn1PQTYnkd8c,106
+luna_quantum-1.0.4rc2.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+luna_quantum-1.0.4rc2.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
 luna_quantum/__init__.py,sha256=RV92O-Th8ktm0S9kcpfRfECkeeORP-tbDKfpa4u1CiY,3223
-luna_quantum/__init__.pyi,sha256=tcM9H4ZAKxgt8KYnFmKH5OHSJZ0zv7J8dMdYMZp6m3s,1661
-luna_quantum/_core.cpython-312-darwin.so,sha256=X4ckN2VT3Dxudy8d20SpucJkyxd4fSdIQjcB9b_j8pk,4972444
-luna_quantum/_core.pyi,sha256=TfOBrBZrY2yb5rSW5ZGwbbvHZV2giEjCaCvDvbquupQ,106084
+luna_quantum/__init__.pyi,sha256=1Joa1farT1Ey22yWYPMNPgQrGHIKL8bycrdPUgtQqw8,1661
+luna_quantum/_core.cpython-312-darwin.so,sha256=xL9UY1DuK_cCZInNph7CwNXBimipDlI92rP1xZDtD60,5560184
+luna_quantum/_core.pyi,sha256=JnKcoRh_ZUjeWZRZl_K9usnPYHSaIzbYPuXnevjtoYY,113649
 luna_quantum/algorithms/__init__.py,sha256=IX9ZpzY3Do3mTgKqto5vAWwdYrZrM-RemYSf64yxefg,69
 luna_quantum/aqm_overwrites/__init__.py,sha256=rteObr5JHDnTnRime0Euq9Qy2iDIp6VMpFNHTGVNBe0,46
 luna_quantum/aqm_overwrites/model.py,sha256=La5mh-aS2LNLaQFp_B1EnhrKUXVRRmIqGnIvX66uc8Y,6099
@@ -81,8 +81,9 @@ luna_quantum/client/schemas/wrappers/datetime_wrapper.py,sha256=8K2jexTarxGCgD1u
 luna_quantum/client/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/client/utils/qpu_token_utils.py,sha256=xeWIKcBwXGSQ0INfUY3NMTu6H90T03jkT85yHs2QXmk,4768
 luna_quantum/config.py,sha256=xx7DnjAvOeLUMlXvbXqQ4_EBAy53bjPYU1-QQO6I2lY,217
+luna_quantum/decorators.py,sha256=g4qVoWW_xkHM7QchbDDwPKmZkATKRA_7iJNzps8W1Eo,6837
 luna_quantum/errors.py,sha256=yjeXB3i07LlTuuJ18IKgwsC5wmtJElN8cDwlg3JkcEs,1424
-luna_quantum/errors.pyi,sha256=qrGBpkd_eOpgjHuNBAoIYJOk7s64jvVO4Bcipue4P3k,9111
+luna_quantum/errors.pyi,sha256=Hev30Htt63MgcESZaVOj645PsINfTYS-XGU8gklYqFM,9297
 luna_quantum/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/exceptions/base_luna_quantum_error.py,sha256=qC712QkF04FiY_qwQ5HlIYVhg5P6WzXJ_chJDVTpWXI,89
 luna_quantum/exceptions/patch_class_field_exists_error.py,sha256=3TGKb-MNyjwntrJkbRaBKEvlsj68ROTwCltDt6Zg7Gg,398
@@ -175,7 +176,7 @@ luna_quantum/solve/parameters/backends/aws/rigetti.py,sha256=04Rg7CEz_70Aqd1f28O
 luna_quantum/solve/parameters/backends/dwave.py,sha256=ZIbZa0lY4TN1jYl5ddlAxhb5_lK4Zuuf1gyQ1fncf8w,358
 luna_quantum/solve/parameters/backends/dwave_qpu.py,sha256=8RJ4zPqLvplPsTmN3D8pNU5-XjwwAEYEvlIgTUPc5Ag,7314
 luna_quantum/solve/parameters/backends/ibm.py,sha256=pDw-0sifu_dfJS4zH2INu6txPh0NgaYDNxPQHEhaF7o,4231
-luna_quantum/solve/parameters/backends/qctrl.py,sha256=FEFd-FjLwS7QfrELs25-w_8L_9Ye5KLSZSN4xWFE0IE,4397
+luna_quantum/solve/parameters/backends/qctrl.py,sha256=BADuXCvZzFNS9d6MNQIKdPixeQM_2q-dBoRVwEglG7c,3503
 luna_quantum/solve/parameters/backends/zib.py,sha256=SqlLFYWCBHiPkxiCJGb1MH5JNtdKApllpd2f8lzn_D8,352
 luna_quantum/solve/parameters/constants.py,sha256=N1_p4zBN_a_rbdnNPxyinN5FygO8Sd7iVPN3vCTwtYA,510
 luna_quantum/solve/parameters/mixins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -244,7 +245,7 @@ luna_quantum/solve/usecases/solve_job_delete_usecase.py,sha256=hUOLeFLU9NCggWMGu
 luna_quantum/solve/usecases/solve_job_fetch_updates_usecase.py,sha256=W-Z6Q7IuyodjZmFKEsJGaa9V2fnGMPWj9FRN9gEdPNc,1686
 luna_quantum/solve/usecases/solve_job_get_result_usecase.py,sha256=dk6LSjInOfH5d7LlbUmawnqytKig_vFTCKTDK5KlDlI,3541
 luna_quantum/transformations.py,sha256=AZtGBaJ0PTWsr4mpONoJq5BpNOXPcM85CnWDhPgXx_I,902
-luna_quantum/transformations.pyi,sha256=D71bSXST8vfib-jSez0s5sg8NJpN5obja4Y0BXoqUjA,7795
+luna_quantum/transformations.pyi,sha256=vqx3I1hxKpQivG0WQ_60-Isocme_DD0veVAUO7xycuk,10768
 luna_quantum/translator.py,sha256=xi5eiIRNv8ATz69GYpUY5kbEIUmQEtK6_dF5t2Mwpec,1134
 luna_quantum/translator.pyi,sha256=edLGrIFl6do9LaCH4znjnOD8Zb3va-9nBGq-H3XQHso,26478
 luna_quantum/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -255,5 +256,5 @@ luna_quantum/util/log_utils.py,sha256=8WK0ivN3Dq3QntIYu-eGRBrGyiBoFnZkRiX_GCc-IH
 luna_quantum/util/pretty_base.py,sha256=Vv3dYpMsydOPYFOm-0lCCuJIe-62oYkI64Zy_bahl3s,2115
 luna_quantum/util/pydantic_utils.py,sha256=nhl_SdLJVAizrtLVHvnbco84g8CdBVdVxN_jlXiv82w,1263
 luna_quantum/utils.py,sha256=pBOkGXNJXlOzxAwTJv8nCj32Q6WNeh3t6Ka3lmTgy9c,134
-luna_quantum/utils.pyi,sha256=afjDJhGiM9KmN2zqVkd6agP8JAsbwUxJBW9tEyiFrdY,1941
-luna_quantum-1.0.3rc3.dist-info/RECORD,,
+luna_quantum/utils.pyi,sha256=yHHPluEJArUltZ2jJ9bPtTugj59E9TOTmYdyH35EHtU,1934
+luna_quantum-1.0.4rc2.dist-info/RECORD,,

{luna_quantum-1.0.3rc3.dist-info → luna_quantum-1.0.4rc2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.1)
+Generator: maturin (1.9.3)
 Root-Is-Purelib: false
 Tag: cp312-cp312-macosx_10_12_x86_64