luna-quantum 1.0.8rc3__cp312-cp312-macosx_11_0_arm64.whl → 1.0.8rc4__cp312-cp312-macosx_11_0_arm64.whl

luna_quantum/__init__.py

@@ -21,6 +21,9 @@ from luna_quantum.solve.usecases import (
     SolveJobFetchUpdatesUseCase,
     SolveJobGetResultUseCase,
 )
+from luna_quantum.solve.usecases.solve_job_get_by_id_usecase import (
+    SolveJobGetByIdUseCase,
+)
 from luna_quantum.util.debug_info import debug_info
 from luna_quantum.util.log_utils import Logging
 
@@ -83,6 +86,7 @@ UseCaseFactory.set_solve_job_create_class(SolveJobCreateUseCase)
 UseCaseFactory.set_solve_job_delete_class(SolveJobDeleteUseCase)
 UseCaseFactory.set_solve_job_get_result_class(SolveJobGetResultUseCase)
 UseCaseFactory.set_solve_job_fetch_updates_class(SolveJobFetchUpdatesUseCase)
+UseCaseFactory.set_solve_job_get_id_class(SolveJobGetByIdUseCase)
 LunaSolveClientFactory.set_client_class(client_class=LunaSolve)
 __all__ = [
     "Bounds",

luna_quantum/factories/usecase_factory.py

@@ -3,6 +3,7 @@ from typing import ClassVar
 from luna_quantum.client.interfaces.services.luna_solve_i import ILunaSolve
 from luna_quantum.solve.interfaces.usecases import (
     IModelLoadMetadataByHashUseCase,
+    ISolveJobGetByIdUseCase,
 )
 from luna_quantum.solve.interfaces.usecases.model_delete_usecase_i import (
     IModelDeleteUseCase,
@@ -64,6 +65,7 @@ class UseCaseFactory:
     _solve_job_delete_class: ClassVar[type[ISolveJobDeleteUseCase]]
     _solve_job_get_result_class: ClassVar[type[ISolveJobGetResultUseCase]]
     _solve_job_fetch_updates_class: ClassVar[type[ISolveJobFetchUpdatesUseCase]]
+    _solve_job_get_by_id_class: ClassVar[type[ISolveJobGetByIdUseCase]]
 
     @classmethod
     def set_model_fetch_class(
@@ -232,6 +234,19 @@ class UseCaseFactory:
         """
         cls._solve_job_fetch_updates_class = solve_job_fetch_updates_class
 
+    @classmethod
+    def set_solve_job_get_id_class(
+        cls, solve_job_get_by_id_class: type[ISolveJobGetByIdUseCase]
+    ) -> None:
+        """Set the implementation class for fetching solve job updates.
+
+        Parameters
+        ----------
+        solve_job_get_by_id_class : Type[ISolveJobGetByIdUseCase]
+            The class implementing ISolveJobGetByIdUseCase
+        """
+        cls._solve_job_get_by_id_class = solve_job_get_by_id_class
+
     @classmethod
     def model_load_by_id(cls, client: ILunaSolve) -> IModelLoadByIdUseCase:
         """
@@ -437,6 +452,23 @@ class UseCaseFactory:
         """
         return cls._solve_job_fetch_updates_class(client=client)
 
+    @classmethod
+    def solve_job_get_by_id(cls, client: ILunaSolve) -> ISolveJobGetByIdUseCase:
+        """
+        Get the use-case to retrieve a solve-job by its id.
+
+        Parameters
+        ----------
+        client : ILunaSolve
+            The client used to retrieve a solve-job.
+
+        Returns
+        -------
+        ISolveJobGetByIdUseCase
+            An instance of the class responsible for retrieving a solve job by its id.
+        """
+        return cls._solve_job_get_by_id_class(client=client)
+
     @classmethod
     def model_load_metadata_by_hash(
         cls, client: ILunaSolve

luna_quantum/solve/domain/solve_job.py

@@ -1,18 +1,23 @@
-from logging import Logger
-from typing import Any, ClassVar, Literal
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, ClassVar, Literal
 
 from pydantic import BaseModel, PrivateAttr
 
-from luna_quantum._core import Solution
-from luna_quantum.aqm_overwrites.model import Model
-from luna_quantum.client.interfaces.services.luna_solve_i import ILunaSolve
 from luna_quantum.client.schemas.enums.call_style import CallStyle
-from luna_quantum.client.schemas.enums.model_format import ModelFormat
-from luna_quantum.client.schemas.enums.status import StatusEnum
-from luna_quantum.client.schemas.wrappers import PydanticDatetimeWrapper
+from luna_quantum.client.schemas.enums.model_format import ModelFormat  # noqa: TC001
+from luna_quantum.client.schemas.enums.status import StatusEnum  # noqa: TC001
+from luna_quantum.client.schemas.wrappers import PydanticDatetimeWrapper  # noqa: TC001
 from luna_quantum.factories.luna_solve_client_factory import LunaSolveClientFactory
 from luna_quantum.util.log_utils import Logging
 
+if TYPE_CHECKING:
+    from logging import Logger
+
+    from luna_quantum._core import Solution
+    from luna_quantum.aqm_overwrites.model import Model
+    from luna_quantum.client.interfaces.services.luna_solve_i import ILunaSolve
+
 
 class SolveJob(BaseModel):
     """A model to represent a job for solving model problems."""
@@ -194,3 +199,32 @@ class SolveJob(BaseModel):
         )
 
         UseCaseFactory.solve_job_delete(client=c).__call__(solve_job_id=self.id)
+
+    @staticmethod
+    def get_by_id(solve_job_id: str, client: ILunaSolve | None = None) -> SolveJob:
+        """
+        Retrieve a solve-job by its ID.
+
+        Para>meters
+        ----------
+        solve_job_id: str
+            Get the solve-job id for which a SolveJob should be retrieved.
+        client : Optional[ILunaSolve], optional
+            The client to be used for job deletion. If not provided, a default client
+            is retrieved using `ClientFactory`.
+
+        Returns
+        -------
+        SolveJob
+            The solve-job object.
+
+
+        """
+        c: ILunaSolve = LunaSolveClientFactory.get_client(client)
+        from luna_quantum.factories.usecase_factory import (  # noqa: PLC0415
+            UseCaseFactory,
+        )
+
+        return UseCaseFactory.solve_job_get_by_id(client=c).__call__(
+            solve_job_id=solve_job_id
+        )

luna_quantum/solve/interfaces/usecases/__init__.py

@@ -34,6 +34,9 @@ from .solve_job_delete_usecase_i import (
 from .solve_job_fetch_updates_usecase_i import (
     ISolveJobFetchUpdatesUseCase,
 )
+from .solve_job_get_by_id_usecase_i import (
+    ISolveJobGetByIdUseCase,
+)
 from .solve_job_get_result_usecase_i import (
     ISolveJobGetResultUseCase,
 )
@@ -51,5 +54,6 @@ __all__ = [
     "ISolveJobCreateUseCase",
     "ISolveJobDeleteUseCase",
     "ISolveJobFetchUpdatesUseCase",
+    "ISolveJobGetByIdUseCase",
     "ISolveJobGetResultUseCase",
 ]

luna_quantum/solve/interfaces/usecases/solve_job_get_by_id_usecase_i.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from luna_quantum.client.interfaces.services.luna_solve_i import ILunaSolve
+    from luna_quantum.solve.domain.solve_job import SolveJob
+
+
+class ISolveJobGetByIdUseCase(ABC):
+    """Represent an abstract base to retrieve a solve-job by its id."""
+
+    @abstractmethod
+    def __init__(self, client: ILunaSolve) -> None:
+        pass
+
+    @abstractmethod
+    def __call__(self, solve_job_id: str) -> SolveJob:
+        """
+        Represent an abstract base for callable objects to retrieve solve jobs.
+
+        Parameters
+        ----------
+        solve_job_id : str
+            The id of the solve-job to retrieve.
+        """

luna_quantum/solve/parameters/algorithms/quantum_gate/__init__.py

@@ -1,4 +1,4 @@
-from .flex_qaoa import FlexQAOA
+from .flexqaoa import FlexQAOA
 from .qaoa import QAOA
 from .qaoa_fo import QAOA_FO
 from .vqe import VQE

luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/__init__.py

@@ -1,26 +1,10 @@
-from .config import AdvancedConfig, XYMixer
-from .flex_qaoa import FlexQAOA
-from .optimizers import (
-    CombinedOptimizerParams,
-    InterpolateOptimizerParams,
-    LinearOptimizerParams,
-)
-from .pipeline import (
-    IndicatorFunctionParams,
-    OneHotParams,
-    PipelineParams,
-    QuadraticPenaltyParams,
-)
+import warnings
 
-__all__ = [
-    "AdvancedConfig",
-    "CombinedOptimizerParams",
-    "FlexQAOA",
-    "IndicatorFunctionParams",
-    "InterpolateOptimizerParams",
-    "LinearOptimizerParams",
-    "OneHotParams",
-    "PipelineParams",
-    "QuadraticPenaltyParams",
-    "XYMixer",
-]
+from luna_quantum.solve.parameters.algorithms.quantum_gate.flexqaoa import *  # noqa: F403
+
+warnings.warn(
+    "The module `flex_qaoa` is deprecated and will be removed in the future. "
+    "Use 'flexqaoa' instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)

luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/__init__.py

@@ -0,0 +1,29 @@
+from .config import CustomConfig
+from .flexqaoa import FlexQAOA
+from .optimizers import (
+    CombinedOptimizerParams,
+    InterpolateOptimizerParams,
+)
+from .pipeline import (
+    IndicatorFunctionConfig,
+    InequalityToEqualityConfig,
+    PenaltySetting,
+    PipelineParams,
+    QuadraticPenaltyConfig,
+    SetpackingAsOnehotConfig,
+    XYMixerConfig,
+)
+
+__all__ = [
+    "CombinedOptimizerParams",
+    "CustomConfig",
+    "FlexQAOA",
+    "IndicatorFunctionConfig",
+    "InequalityToEqualityConfig",
+    "InterpolateOptimizerParams",
+    "PenaltySetting",
+    "PipelineParams",
+    "QuadraticPenaltyConfig",
+    "SetpackingAsOnehotConfig",
+    "XYMixerConfig",
+]

luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/config.py

@@ -0,0 +1,58 @@
+from typing import Literal
+
+from pydantic import BaseModel, Field, PositiveInt
+
+
+class CustomConfig(BaseModel):
+    """Additional FlexQAOA circuit configuration.
+
+    Attributes
+    ----------
+    max_qubits : PositiveInt | None
+        Maximum number of qubits allowed for the circuit. If `None`, no limit is
+        applied. Default: `None`.
+    minimize_qubits : bool
+        Minimize the number of used qubits in the circuit if set to `True`. Otherwise,
+        minimize circuit depth. Default: `False`.
+    wstate : Literal["log", "bilinear", "linear"]
+        WState generation cricuit. Choice between:
+
+        - `"log"`: Logarithmic-depth binary tree circuit.
+        - `"linear"`: Linear circuit construction.
+        - `"bilinear"`: Bi-linear circuit construction, starts in the middle and
+                        linearly constructs the circuit outwards.
+
+        Default: `"log"`
+    qft_synth : Literal["line", "full"]
+        QFT synthesis method. Choice between:
+
+        - `"full"`: Shorter circuit depth implementation that requires all-to-all
+                    connectivity.
+        - `"line"`: Longer circuit depth implementation that requires linear
+                    connectivity.
+
+        Default: `"full"`
+    """
+
+    max_qubits: PositiveInt | None = Field(
+        default=None,
+        description="Maximum number of qubits allowed for the circuit. If `None`, no "
+        "limit is applied.",
+    )
+    minimize_qubits: bool = Field(
+        default=False,
+        description="Minimize the number of used qubits in the circuit "
+        "if set to `True`. Otherwise, minimize circuit depth.",
+    )
+    wstate: Literal["log", "bilinear", "linear"] = Field(
+        default="log",
+        description="WState generation cricuit. Choice between: Logarithmic-depth (log)"
+        " binary tree circuit and linear or bilinear construction. bilinear places the "
+        "start in the middle and linearly constructs the circuit outwards.",
+    )
+    qft_synth: Literal["line", "full"] = Field(
+        default="full",
+        description="QFT synthesis method. Shorter depth (full) implementation requires"
+        " all-to-all connectivity. Longer (line) implementation requires only linear "
+        "connectivity.",
+    )

luna_quantum/solve/parameters/algorithms/quantum_gate/{flex_qaoa/flex_qaoa.py → flexqaoa/flexqaoa.py}

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
+from typing import Literal
+
 from pydantic import BaseModel, Field, model_validator
 
 from luna_quantum.solve.domain.abstract.luna_algorithm import LunaAlgorithm
-from luna_quantum.solve.errors.solve_base_error import SolveBaseError
 from luna_quantum.solve.parameters.algorithms.base_params.qaoa_circuit_params import (
     BasicQAOAParams,
     LinearQAOAParams,
@@ -13,51 +14,20 @@ from luna_quantum.solve.parameters.algorithms.base_params.scipy_optimizer import
     ScipyOptimizerParams,
 )
 from luna_quantum.solve.parameters.backends.aqarios import Aqarios
-
-from .config import AdvancedConfig
-from .optimizers import (
-    CombinedOptimizerParams,
-    InterpolateOptimizerParams,
-    LinearOptimizerParams,
+from luna_quantum.solve.parameters.backends.aqarios_gpu import AqariosGpu
+from luna_quantum.solve.parameters.errors import (
+    InterpolateOptimizerError,
+    QAOAParameterOptimizerError,
+    QAOAParameterRepsMismatchError,
 )
-from .pipeline import PipelineParams
-
-
-class QAOAParameterOptimizerError(SolveBaseError):
-    """QAOA cirucit parameters mismatch with optimizer exception."""
-
-    def __init__(
-        self,
-        optimizer: ScipyOptimizerParams
-        | LinearOptimizerParams
-        | CombinedOptimizerParams
-        | InterpolateOptimizerParams
-        | None,
-        params: BasicQAOAParams | LinearQAOAParams | RandomQAOAParams,
-        extra: str = "",
-    ) -> None:
-        super().__init__(
-            f"Parameter Mismatch of {optimizer.__class__} and {params.__class__}"
-            + ((". " + extra) if extra else "")
-        )
-
-
-class InterpolateOptimizerError(SolveBaseError):
-    """Interpolate optimizer error when final number of reps is too small."""
-
-    def __init__(self, reps_end: int, reps_start: int) -> None:
-        super().__init__(f"{reps_end=} needs to be larger than {reps_start=}.")
-
-
-class QAOAParameterDepthMismatchError(SolveBaseError):
-    """QAOA circuit params mismatch the specified reps."""
 
-    def __init__(self, params_reps: int, reps: int) -> None:
-        super().__init__(f"{params_reps=} needs to match {reps=}.")
+from .config import CustomConfig
+from .optimizers import CombinedOptimizerParams, InterpolateOptimizerParams
+from .pipeline import PipelineParams
 
 
-class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
-    """The FlexQAOA Algorithm for constrained quantum optimization.
+class FlexQAOA(LunaAlgorithm[Aqarios | AqariosGpu], BaseModel):
+    """The FlexQAOA algorithm for constrained quantum optimization.
 
     The FlexQAOA is an extension to the default QAOA with the capabilities to encode
     inequality constriants with indicator functions as well as one-hot constraints
@@ -73,18 +43,11 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
     Central to this is the pipeline parameter which allows for different configurations.
 
     For instance, if one likes to explore ordinary QUBO simulation with all constraints
-    represented as quadratic penalties, the `one_hot` and `indicator_function` options
+    represented as quadratic penalties, the `xy_mixers` and `indicator_function` options
     need to be manually disabled
     ```
-    pipeline = {"one_hot": None, "indicator_function": None}
-    ```
-
-    If no indicator function is employed, but the input problem contains inequality
-    constraints, slack variables are added to the optimization problem. FlexQAOA allows
-    for a configuration that discards slack variables as their assignment is not
-    necessarily of interest. This option can be enbled by setting
-    ```
-    qaoa_config = {"discard_slack": True}
+    pipeline.xy_mixer.enable = False
+    pipeline.indicator_function.enable = False
     ```
 
     Following the standard protocol for QAOA, a classical optimizer is required that
@@ -100,24 +63,35 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
         Number of sampled shots.
     reps: int
         Number of QAOA layer repetitions
-    pipeline: PipelineParams | Dict
+    pipeline: PipelineParams
         The pipeline defines the selected features for QAOA circuit generation. By
         default, all supported features are enabled (one-hot constraints, inequality
         constraints and quadratic penalties).
-    optimizer: ScipyOptimizerParams | LinearOptimizerParams | CombinedOptimizerParams |\
-        InterpolateOptimizerParams | None | Dict
-        The classical optimizer for parameter tuning. Default: ScipyOptimizer. Setting
+    optimizer: ScipyOptimizerParams | CombinedOptimizerParams |\
+        InterpolateOptimizerParams | None
+        The classical optimizer for parameter tuning. Setting
         to `None` disables the optimization, leading to an evaluation of the initial
         parameters.
-    qaoa_config: AdvancedConfig | Dict
-        Additional options for the QAOA circuit and evalutation
     initial_params: LinearQAOAParams | BasicQAOAParams | RandomQAOAParams | Dict
         Custom QAOA variational circuit parameters. By default linear
         increasing/decreasing parameters for the selected `reps` are generated.
+    param_conversion: None | Literal["basic"] = "basic"
+        Parameter conversion after initialization. This option set to `None` means the
+        parameters, as specified are used. This parameter set to `"basic"` means the
+        parameters are converted to basic parameters before optimization. This is useful
+        if one only wants to optimize the linear schedule of parameters: Then the option
+        `None` needs to be selected alongside LinearQAOAParams. This
+        option is ignored when CombinedOptimizer is also selected.
+    custom_config: CustomConfig
+        Additional options for the FlexQAOA circuit.
     """
 
-    shots: int = Field(default=1024, ge=1, description="Number of sampled shots.")
-    reps: int = Field(default=1, ge=1, description="Number of QAOA layer repetitions")
+    shots: int = Field(
+        default=1024, ge=1, lt=1 << 16, description="Number of sampled shots."
+    )
+    reps: int = Field(
+        default=1, ge=1, lt=1000, description="Number of QAOA layer repetitions"
+    )
     pipeline: PipelineParams = Field(
         default_factory=lambda: PipelineParams(),
         description="The pipeline defines the selected features for QAOA circuit "
@@ -126,7 +100,6 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
     )
     optimizer: (
         ScipyOptimizerParams
-        | LinearOptimizerParams
         | CombinedOptimizerParams
         | InterpolateOptimizerParams
         | None
@@ -134,36 +107,25 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
         default_factory=lambda: ScipyOptimizerParams(),
         description="The classical optimizer. Default: ScipyOptimizer",
     )
-    qaoa_config: AdvancedConfig = Field(
-        default_factory=lambda: AdvancedConfig(),
-        description="Additional options for the QAOA circuit and evalutation",
-    )
     initial_params: LinearQAOAParams | BasicQAOAParams | RandomQAOAParams = Field(
         default_factory=lambda: LinearQAOAParams(delta_beta=0.5, delta_gamma=0.5),
         description="Custom QAOA circuit parameters. By default linear "
         "increasing/decreasing parameters for the selected `reps` are generated.",
     )
+    param_conversion: None | Literal["basic"] = "basic"
+    custom_config: CustomConfig = Field(
+        default_factory=lambda: CustomConfig(),
+        description="Additional configuration options for the FlexQAOA circuit.",
+    )
 
     @model_validator(mode="after")
     def _check_param_type(self) -> FlexQAOA:
-        if isinstance(self.optimizer, LinearOptimizerParams) and isinstance(
-            self.initial_params, BasicQAOAParams
-        ):
-            raise QAOAParameterOptimizerError(self.optimizer, self.initial_params)
-        if isinstance(self.optimizer, CombinedOptimizerParams) and isinstance(
-            self.initial_params, BasicQAOAParams
-        ):
-            raise QAOAParameterOptimizerError(self.optimizer, self.initial_params)
-        if (
-            isinstance(self.optimizer, InterpolateOptimizerParams)
-            and isinstance(self.optimizer.optimizer, LinearOptimizerParams)
-            and isinstance(self.initial_params, BasicQAOAParams)
-        ):
-            raise QAOAParameterOptimizerError(
-                self.optimizer,
-                self.initial_params,
-                extra="LinearOptimizer used in InterpolateOptimizer.",
-            )
+        if isinstance(self.optimizer, CombinedOptimizerParams):
+            if isinstance(self.initial_params, (BasicQAOAParams, RandomQAOAParams)):
+                optim = self.optimizer.__class__.__name__
+                params = self.initial_params.__class__.__name__
+                raise QAOAParameterOptimizerError(optim, params)
+            self.param_conversion = None
         if (
             isinstance(self.optimizer, InterpolateOptimizerParams)
             and self.optimizer.reps_end < self.reps
@@ -177,7 +139,7 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
             isinstance(self.initial_params, BasicQAOAParams)
             and self.initial_params.reps != self.reps
         ):
-            raise QAOAParameterDepthMismatchError(self.initial_params.reps, self.reps)
+            raise QAOAParameterRepsMismatchError(self.initial_params.reps, self.reps)
         return self
 
     @property
@@ -213,7 +175,7 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
         return Aqarios()
 
     @classmethod
-    def get_compatible_backends(cls) -> tuple[type[Aqarios]]:
+    def get_compatible_backends(cls) -> tuple[type[Aqarios], type[AqariosGpu]]:
         """
         Check at runtime if the used backend is compatible with the solver.
 
@@ -223,4 +185,4 @@ class FlexQAOA(LunaAlgorithm[Aqarios], BaseModel):
             True if the backend is compatible with the solver, False otherwise.
 
         """
-        return (Aqarios,)
+        return (Aqarios, AqariosGpu)

luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/optimizers.py

@@ -0,0 +1,53 @@
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from luna_quantum.solve.parameters.algorithms.base_params.scipy_optimizer import (
+    ScipyOptimizerParams,
+)
+
+
+class CombinedOptimizerParams(BaseModel):
+    """Combination of LinearOptimizer and ScipyOptimizer.
+
+    Optimizer that first performs an optimization of the linear schedule and then
+    fine tunes individual parameters. Only works in conjunction with `LinearQAOAParams`.
+
+
+    Attributes
+    ----------
+    linear: ScipyOptimizerParams
+        Parameters of the linear optimizer.
+    fine_tune: ScipyOptimizerParams | None
+        Parameters of the fine tuning optimizer. If `None`, the same optimizer is used.
+        Default: `None`.
+    """
+
+    optimizer_type: Literal["combined"] = "combined"
+    linear: ScipyOptimizerParams = Field(default_factory=lambda: ScipyOptimizerParams())
+    fine_tune: ScipyOptimizerParams | None = None
+
+
+class InterpolateOptimizerParams(BaseModel):
+    """Optimizer with sequentially increasing number of QAOA layers.
+
+    Optimizer that starts with `reps` iteration and interpolates sequentially in
+    `reps_step` steps to `reps_end`. In between it performs a full optimization routine
+    tunes individual parameters.
+
+    Attributes
+    ----------
+    optimizer: ScipyOptimizerParams
+        Parameters of the optimizer.
+    reps_step: int
+        Number of QAOA layers added for one interpolation.
+    reps_end: int
+        Final number of QAOA layers to be reached.
+    """
+
+    optimizer_type: Literal["interpolate"] = "interpolate"
+    optimizer: ScipyOptimizerParams = Field(
+        default_factory=lambda: ScipyOptimizerParams()
+    )
+    reps_step: int = Field(default=1, ge=1)
+    reps_end: int = Field(default=10, ge=1, lt=1000)

luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/pipeline.py

@@ -0,0 +1,164 @@
+from typing import Literal
+
+from pydantic import BaseModel, Field, PositiveFloat
+
+
+class _EnableMixin:
+    enable: bool = True
+
+
+class PenaltySetting(BaseModel):
+    """Penalty factor settings.
+
+    Attributes
+    ----------
+    override: PositiveFloat | None
+        Overrides the automatically evaluated penalty factor.
+    scaling: PositiveFloat
+        Scales the automatically evaluated penalty factor.
+    """
+
+    override: PositiveFloat | None = None
+    scaling: PositiveFloat = 1.0
+
+
+class IndicatorFunctionConfig(BaseModel, _EnableMixin):
+    """Configuration for indicator functions to implement inequality constraints.
+
+    Attributes
+    ----------
+    penalty: PenaltySetting
+        Custom penalty setting for indicator functions.
+    method: Literal["const", "str"]
+        Indicator function implementation method. Default: `"const"`
+        Two options are available:
+
+        - `"const"`: Applies a constant penalty for every constraint violation.
+        - `"if"`: Applies the objective function only if all constraints are satisfied.
+                  Automatically ensures objective to be negative.
+
+    enable : bool
+        Toggle to enable or disable this method. Default: True.
+    """
+
+    penalty: PenaltySetting = Field(
+        default_factory=lambda: PenaltySetting(scaling=1),
+        description="Penalty setting for indicator functions.",
+    )
+    method: Literal["if", "const"] = Field(
+        default="const",
+        description="Method of indicator function implementation. Constant Penalty "
+        "(const) or conditional application of cost function (if).",
+    )
+
+
+class XYMixerConfig(BaseModel, _EnableMixin):
+    """Configuration for XY-mixers to implement one-hot constraints.
+
+    Attributes
+    ----------
+    trotter : int
+        Number of trotter steps for XY-mixer implementation. Default: 1.
+    types: list[Literal["even", "odd", "last"]]
+        Mixer types in XY-ring-mixer. Default: `["even", "odd", "last"]`.
+    enable : bool
+        Toggle to enable or disable this method. Default: True.
+    """
+
+    trotter: int = Field(
+        default=1,
+        lt=1000,
+        ge=1,
+        description="Number of trotter steps for XY-mixer implementation.",
+    )
+    types: list[Literal["even", "odd", "last"]] = Field(
+        default=["even", "odd", "last"],
+        description='Mixer types in XY-ring-mixer. Default: `["even", "odd", "last"]`',
+    )
+
+
+class QuadraticPenaltyConfig(BaseModel, _EnableMixin):
+    """Configuration for quadratic penalties.
+
+    Adds penalty terms to the objective. Adds slack variables for inequality constraints
+    if neccessaray.
+
+    Attributes
+    ----------
+    penalty : PenaltySetting
+        Custom penalty setting for quadratic penalty terms.
+    enable : bool
+        Toggle to enable or disable this method. Default: True.
+    """
+
+    penalty: PenaltySetting = Field(
+        default_factory=lambda: PenaltySetting(scaling=2.0),
+        description="Penalty setting for quadratic penalties.",
+    )
+
+
+class SetpackingAsOnehotConfig(BaseModel, _EnableMixin):
+    """Configuration for set-packing to one-hot constraint transformation.
+
+    Attributes
+    ----------
+    enable : bool
+        Toggle to enable or disable this method. Default: True.
+    """
+
+
+class InequalityToEqualityConfig(BaseModel, _EnableMixin):
+    """Configuration for inequality to equality constraint transformation.
+
+    Attributes
+    ----------
+    max_slack : int
+        Maximum number of slack bits to add for each constraint. Default: 10.
+    enable : bool
+        Toggle to enable or disable this method. Default: True.
+    """
+
+    max_slack: int = Field(
+        default=10,
+        description="Maximum number of slack bits to add for each constraint.",
+    )
+
+
+class PipelineParams(BaseModel):
+    """Define the modular FlexQAOA Pipeline.
+
+    Attributes
+    ----------
+    penalty : PenaltySetting
+        General penalty factor settings.
+    inequality_to_equality : InequalityToEqualityConfig
+        Configuration of the "inequality to equality" transformation.
+    setpacking_as_onehot : SetpackingAsOnehotConfig
+        Configuration of the "setpacking to onehot" transformation.
+    xy_mixer : XYMixerConfig
+        Configuration of the XY-mixers.
+    indicator_function : IndicatorFunctionConfig
+        Configuration of the indicator functions.
+    sp_quadratic_penalty : QuadraticPenaltyConfig
+        Configuration of the setpacking quadratic penalty function.
+    quadratic_penalty : QuadraticPenaltyConfig
+        Configuration of the general quadratic penalty function.
+    """
+
+    penalty: PenaltySetting = Field(default_factory=lambda: PenaltySetting(scaling=2.0))
+    inequality_to_equality: InequalityToEqualityConfig = Field(
+        default_factory=InequalityToEqualityConfig
+    )
+    setpacking_as_onehot: SetpackingAsOnehotConfig = Field(
+        default_factory=SetpackingAsOnehotConfig
+    )
+    xy_mixer: XYMixerConfig = Field(default_factory=XYMixerConfig)
+    indicator_function: IndicatorFunctionConfig = Field(
+        default_factory=IndicatorFunctionConfig
+    )
+    sp_quadratic_penalty: QuadraticPenaltyConfig = Field(
+        default_factory=QuadraticPenaltyConfig
+    )
+    quadratic_penalty: QuadraticPenaltyConfig = Field(
+        default_factory=QuadraticPenaltyConfig
+    )

luna_quantum/solve/parameters/backends/__init__.py

@@ -1,4 +1,5 @@
 from .aqarios import Aqarios
+from .aqarios_gpu import AqariosGpu
 from .aws import AWS, IQM, IonQ, Rigetti
 from .dwave import DWave
 from .dwave_qpu import DWaveQpu
@@ -13,6 +14,7 @@ __all__: list[str] = [
     "IQM",
     "ZIB",
     "Aqarios",
+    "AqariosGpu",
     "DWave",
     "DWaveQpu",
     "Fujitsu",

luna_quantum/solve/parameters/backends/aqarios_gpu.py

@@ -0,0 +1,17 @@
+from luna_quantum.solve.interfaces.backend_i import IBackend
+
+
+class AqariosGpu(IBackend):
+    """Configuration class for the Aqarios GPU backend."""
+
+    @property
+    def provider(self) -> str:
+        """
+        Retrieve the name of the provider.
+
+        Returns
+        -------
+        str
+            The name of the provider.
+        """
+        return "aqarios-gpu"

luna_quantum/solve/parameters/errors.py

@@ -0,0 +1,30 @@
+from luna_quantum.solve.errors.solve_base_error import SolveBaseError
+
+
+class QAOAParameterOptimizerError(SolveBaseError):
+    """QAOA cirucit parameters mismatch with optimizer exception."""
+
+    def __init__(
+        self,
+        optimizer: str,
+        params: str,
+        extra: str = "",
+    ) -> None:
+        super().__init__(
+            f"Parameter Mismatch of '{optimizer}' and '{params}'"
+            + ((": " + extra) if extra else ".")
+        )
+
+
+class InterpolateOptimizerError(SolveBaseError):
+    """Interpolate optimizer error when final number of reps is too small."""
+
+    def __init__(self, reps_end: int, reps_start: int) -> None:
+        super().__init__(f"{reps_end=} needs to be larger than {reps_start=}.")
+
+
+class QAOAParameterRepsMismatchError(SolveBaseError):
+    """QAOA circuit params mismatch the specified reps."""
+
+    def __init__(self, params_reps: int, reps: int) -> None:
+        super().__init__(f"{params_reps=} needs to match {reps=}.")

luna_quantum/solve/usecases/solve_job_get_by_id_usecase.py

@@ -0,0 +1,44 @@
+from typing import TYPE_CHECKING
+
+from luna_quantum.client.interfaces.services.luna_solve_i import ILunaSolve
+from luna_quantum.solve.domain.solve_job import SolveJob
+from luna_quantum.solve.interfaces.usecases.solve_job_get_by_id_usecase_i import (
+    ISolveJobGetByIdUseCase,
+)
+from luna_quantum.util.log_utils import Logging, progress
+
+if TYPE_CHECKING:
+    from luna_quantum.client.schemas.solve_job import SolveJobSchema
+
+
+class SolveJobGetByIdUseCase(ISolveJobGetByIdUseCase):
+    """
+    Represent an abstract base to retrieve a solve-job by its id.
+
+    This class interacts with a backend client to retrieve a solve job by its id.
+
+    Attributes
+    ----------
+    client : ILunaSolve
+        Client used to retrieve the solve job.
+    """
+
+    client: ILunaSolve
+    logger = Logging.get_logger(__name__)
+
+    def __init__(self, client: ILunaSolve) -> None:
+        self.client = client
+
+    @progress(total=None, desc="Retrieving solve job by id...")
+    def __call__(self, solve_job_id: str) -> SolveJob:
+        """
+        Retive a solve-job by its id.
+
+        Parameters
+        ----------
+        solve_job_id : str
+            The id of the solve-job to retrieve.
+        """
+        solve_job: SolveJobSchema = self.client.solve_job.get(solve_job_id=solve_job_id)
+
+        return SolveJob.model_validate(solve_job.model_dump())

{luna_quantum-1.0.8rc3.dist-info → luna_quantum-1.0.8rc4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luna-quantum
-Version: 1.0.8rc3
+Version: 1.0.8rc4
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent

{luna_quantum-1.0.8rc3.dist-info → luna_quantum-1.0.8rc4.dist-info}/RECORD

@@ -1,10 +1,10 @@
-luna_quantum-1.0.8rc3.dist-info/METADATA,sha256=IbDGJmp8yKMgd-8RGRMCIbCguLX2Yy5uizmb8XJcSog,1585
-luna_quantum-1.0.8rc3.dist-info/WHEEL,sha256=nw13728gRokCivwI6SCanennWBgDOflh2lHvovMwAi8,104
-luna_quantum-1.0.8rc3.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-luna_quantum-1.0.8rc3.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
-luna_quantum/__init__.py,sha256=rcDpMhBOdDjteCh73EM1pKhxIBZOmDLQCzXGxXFKUGk,3614
+luna_quantum-1.0.8rc4.dist-info/METADATA,sha256=cxEL3-ylYkSr5yiFx4tzrfiQZ6AQzJCTG1QhmezVNbg,1585
+luna_quantum-1.0.8rc4.dist-info/WHEEL,sha256=nw13728gRokCivwI6SCanennWBgDOflh2lHvovMwAi8,104
+luna_quantum-1.0.8rc4.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+luna_quantum-1.0.8rc4.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
+luna_quantum/__init__.py,sha256=uvustvqwnorIgsREJjCG4O6qjzjKeZDZmwfhfotAQZ4,3780
 luna_quantum/__init__.pyi,sha256=s2RfcxcRc0antqQnZvD7kKTwpbshkOM85F4d58dDKOE,2005
-luna_quantum/_core.cpython-312-darwin.so,sha256=lN_B3lXSYCX4MrAd3t_SpBGt_M0oTbaOMh-GLIyeXDk,5515712
+luna_quantum/_core.cpython-312-darwin.so,sha256=iP42L7k1JBCt42m5sF51PXu07Retq1-JKGP2MCiy438,5515712
 luna_quantum/_core.pyi,sha256=ICnplN_bc5ScyMOSIW65YqkZzWQP_8BWLDquOGVemRY,121598
 luna_quantum/_utility.py,sha256=6BbCJ2HDA92NtcUuVhnyUcG40-_FB1m21h-M3Z06v-8,6031
 luna_quantum/_utility.pyi,sha256=DAZeMbhjaRf10adPv8QKt8GGOlaHjnfndDcbGmu-qUA,487
@@ -92,7 +92,7 @@ luna_quantum/exceptions/luna_quantum_call_type_error.py,sha256=mPXghYDBjSWGpodr8
 luna_quantum/exceptions/patch_class_field_exists_error.py,sha256=3TGKb-MNyjwntrJkbRaBKEvlsj68ROTwCltDt6Zg7Gg,398
 luna_quantum/factories/__init__.py,sha256=XT0vIcm65KVpYSLbqXdeoPd7yypSj36o1IC55CTaoj4,162
 luna_quantum/factories/luna_solve_client_factory.py,sha256=Y5vqDe8F0HMj3WluHxPl0KbB8KDWRTgWgbZ1igzt3hM,3284
-luna_quantum/factories/usecase_factory.py,sha256=vp7ZsMOOsPAvyLCdsPNMM-pqLAOnrP2_GqLiB6RP_IQ,14996
+luna_quantum/factories/usecase_factory.py,sha256=OgYie8dfV3pJh-W3dojxRJLFzjsNAcE5dAHekNiobsg,16067
 luna_quantum/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/solve/__init__.py,sha256=Qu363Ci54FhrhRvuLm6WIFAsyxMwtza8n7ImHPQfxj0,307
 luna_quantum/solve/default_token.py,sha256=JpMrRtQsczmBYFeMvDOsbabpBfUubGWNVLlwFn2O4Ew,8691
@@ -101,7 +101,7 @@ luna_quantum/solve/domain/abstract/__init__.py,sha256=My23tGRFFJYVe6vwgUM4RAFr26
 luna_quantum/solve/domain/abstract/luna_algorithm.py,sha256=f24R-c8dEkLtT_UeGAMGV6RlqeBTrR_gtCAlk_-HjaE,7045
 luna_quantum/solve/domain/abstract/qpu_token_backend.py,sha256=2vLMzDrrJsi2ejVMdNOEuhf9x1e7zGijkIn2GCH--j8,1229
 luna_quantum/solve/domain/model_metadata.py,sha256=KqbZ59cKjfl9TrIy8L3BLT0qeqiWYRYNxgLgvQxh0Xo,1686
-luna_quantum/solve/domain/solve_job.py,sha256=TR_JpZLefB5mtJPdC2UY1K-aQs8L4qWFzgd4EplDdFg,6783
+luna_quantum/solve/domain/solve_job.py,sha256=k0N6c2ZoR8PgwAeAaJDBhqv6Q89i8blf_8BoxD-qH2U,7792
 luna_quantum/solve/errors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/solve/errors/incompatible_backend_error.py,sha256=PVhyMTIUShy1IJqc_FiYxxY5SzLs791Wfey-JHu6xoA,604
 luna_quantum/solve/errors/model_metadata_missing_error.py,sha256=TBTokypD8drCFPFeMWsUn7mt7aCmKMqKweyzshqf3Bg,363
@@ -110,7 +110,7 @@ luna_quantum/solve/errors/token_missing_error.py,sha256=PK3n0fe4a57rdSm6gj0qbeh8
 luna_quantum/solve/interfaces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/solve/interfaces/algorithm_i.py,sha256=dTWDW1CoFElIbVxjnSnA9lPIcrKDV1YJlySTR_p02xI,1665
 luna_quantum/solve/interfaces/backend_i.py,sha256=dNszKrHSFjBb66ABHPjUUGiENBP3jVN9nGSHJr2R0co,602
-luna_quantum/solve/interfaces/usecases/__init__.py,sha256=B3_AztBd0sIdDfhttHiydSN2mD5EJJYDb84eZAX0q3k,1414
+luna_quantum/solve/interfaces/usecases/__init__.py,sha256=xvcPJC6mX47qZ3TyqaZh4rPx0lLn7bt3938rJ8DyMHc,1521
 luna_quantum/solve/interfaces/usecases/model_delete_usecase_i.py,sha256=wQL0nE2d5UF9_cRpC-sbeHqKrA_46j9wGtO0_FI4gX8,648
 luna_quantum/solve/interfaces/usecases/model_fetch_metadata_usecase_i.py,sha256=MYtx7GHPpSBHF9uLp04UvrguM5U0tkUIexs1Ik3pvVY,890
 luna_quantum/solve/interfaces/usecases/model_get_solutions_usecase_i.py,sha256=xuFbGUST2B3SZLWZXehaTBUu4ruIt77RS_6HFUOr3a0,840
@@ -123,6 +123,7 @@ luna_quantum/solve/interfaces/usecases/solve_job_cancel_usecase_i.py,sha256=KwF3
 luna_quantum/solve/interfaces/usecases/solve_job_create_usecase_i.py,sha256=cCthq9Qq7FezrEL71aeVR1oIMsrEdRKrFuMU-zqKsIc,1334
 luna_quantum/solve/interfaces/usecases/solve_job_delete_usecase_i.py,sha256=8JyNotccE9439GgAifyVcT1TQmAaoXEPMxFwDJFX404,783
 luna_quantum/solve/interfaces/usecases/solve_job_fetch_updates_usecase_i.py,sha256=2ldduW0f3qB74wlf-eIU5Od_jhzBPVgJSw53I49wGmM,1078
+luna_quantum/solve/interfaces/usecases/solve_job_get_by_id_usecase_i.py,sha256=pNctNaf5LT-fMAG-vakg3dHuEZnrWzJp9ihIJVKKTAM,756
 luna_quantum/solve/interfaces/usecases/solve_job_get_result_usecase_i.py,sha256=eXMTO9J7c018kam-iVmkXmBhSTyU2ER9k_oQHJ5pmm0,2040
 luna_quantum/solve/parameters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/solve/parameters/algorithms/__init__.py,sha256=a4PwA87TLkZUB0_1cwH9_evgdjiyRaAKtQVP7L1CfVw,1298
@@ -152,12 +153,13 @@ luna_quantum/solve/parameters/algorithms/quantum_annealing/population_annealing_
 luna_quantum/solve/parameters/algorithms/quantum_annealing/qbsolv_like_qpu.py,sha256=KaEePKVwjnU5Oab-Tdgl4kM500ccb_I30KdllsmcJW0,4077
 luna_quantum/solve/parameters/algorithms/quantum_annealing/quantum_annealing.py,sha256=rtrBQKi4DMzMtXS2Yy-m8rw6IxF7OxxllQK9OrVnT5c,4898
 luna_quantum/solve/parameters/algorithms/quantum_annealing/repeated_reverse_quantum_annealing.py,sha256=elQ-t4R_N9PTdZiWlMuPgtTNo3V4PA8CW0BAfZIP8s0,8440
-luna_quantum/solve/parameters/algorithms/quantum_gate/__init__.py,sha256=Wy2ChqqgEZ1T4NKzdfxi4JnpFNntkacJxaHyBOE1yxk,155
-luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/__init__.py,sha256=vSYd2jtn-HusZazb9y803mI0PFRmRnYDlcNb2Ao6DNE,578
-luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/config.py,sha256=b6lQli3GfXbeyMDSB85mtx6TXJUk66Xol-P80dfdaD4,2737
-luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/flex_qaoa.py,sha256=HXRQ6Q2XZZBw0VBYBG1mVyZ4O_FopGJsT72nwL27aP4,9144
-luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/optimizers.py,sha256=W_sfugJDchkC0-uAx89Yr4y50HvhCVWq_-pEvJSRDBg,3691
-luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/pipeline.py,sha256=BvEc9N5xlUitf9GVpRPjLSO94BA1DXN3FMMjnP5Ck_M,3088
+luna_quantum/solve/parameters/algorithms/quantum_gate/__init__.py,sha256=ts1Aiq40KaIPJZQ5J3wMHPao4bmEG4ZOrDpKyKtgG14,154
+luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/__init__.py,sha256=1xKPEUmKs14hgDKYjsFNiqcMAcCyFVjRVArI-yyaOO4,278
+luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/__init__.py,sha256=TGABcymqSfH6gKXN6bjfUg4LKbPXhObtHRfAYaol6Kc,665
+luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/config.py,sha256=TPrsao2cwmVGB7PHAsl74hq7JoPi9CeSiwCKM748DTE,2252
+luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/flexqaoa.py,sha256=bPtgnkkSbXP2kvgfFHCXOJ6qmIdDzMQhtcHYVa6Ry68,7901
+luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/optimizers.py,sha256=NsnxR4cPeZg-tyTHr5uOtNE2IKXsng7sTgKDWqmz1lU,1759
+luna_quantum/solve/parameters/algorithms/quantum_gate/flexqaoa/pipeline.py,sha256=Y9WUC1JKwpygPMI0W3pjt47avc2zeBLF2LcmQrtA2qA,5304
 luna_quantum/solve/parameters/algorithms/quantum_gate/qaoa.py,sha256=n6mRNslrN1AAKOi0wEbxhEdlpmWgxL_42oi7OD19Y4k,3843
 luna_quantum/solve/parameters/algorithms/quantum_gate/qaoa_fo.py,sha256=pBVOvxB48Y1LlMUObrm5s_mJLqp6SQNLaaGZGwFinuE,2587
 luna_quantum/solve/parameters/algorithms/quantum_gate/vqe.py,sha256=ifXcgOw4bari3tebHkuIAnZ1xONGQRp9BnMuXCTGcKI,3875
@@ -171,8 +173,9 @@ luna_quantum/solve/parameters/algorithms/simulated_annealing/population_annealin
 luna_quantum/solve/parameters/algorithms/simulated_annealing/qbsolv_like_simulated_annealing.py,sha256=roq_msa4EQrRpvFze23EnY7iQ-SDpu6ifSP9Thxn_6E,6583
 luna_quantum/solve/parameters/algorithms/simulated_annealing/repeated_reverse_simulated_annealing.py,sha256=phLC27T7vcMCi2f82LaaAObMEqoiAZJXRK38dl-3rBY,8220
 luna_quantum/solve/parameters/algorithms/simulated_annealing/simulated_annealing.py,sha256=urMh0DLN5iuj1uAoyXt7IzwMpNZWciTlq3GhApuNgFE,5660
-luna_quantum/solve/parameters/backends/__init__.py,sha256=KkWZ4Y3GtGFafyGCH1nX-s5AfNM3CowuJNfWAXpOums,388
+luna_quantum/solve/parameters/backends/__init__.py,sha256=l-rXUsdJsWv9sJwzd0w-s-Ygftnb_uaxn40qx6cT18U,442
 luna_quantum/solve/parameters/backends/aqarios.py,sha256=4qa9en_-IhFgs4NDGUDJ6XWNevuIGOWCPrp5DcSvwiw,364
+luna_quantum/solve/parameters/backends/aqarios_gpu.py,sha256=SvCZZ4bHxpo0fReaHiUkHwh1RyrWrkd8OOgUS9szJQQ,375
 luna_quantum/solve/parameters/backends/aws/__init__.py,sha256=2o6R9htZHM6mvUSi94S14Q3HdfMgyg_nMTTBzhYdwXY,158
 luna_quantum/solve/parameters/backends/aws/aws.py,sha256=snFW6vY1xJsJuM84xZCmHPrpZBr469N3hIJ-3Im9ybQ,1119
 luna_quantum/solve/parameters/backends/aws/aws_backend_base.py,sha256=XqSzblRhMNJ_tDk54xxF6emhhUVA7XjpA6VCvSH3hMc,2365
@@ -186,6 +189,7 @@ luna_quantum/solve/parameters/backends/ibm.py,sha256=pDw-0sifu_dfJS4zH2INu6txPh0
 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/errors.py,sha256=WsT0yoGMGvyJik7QWFHlCgRirCO39j4NvsWYapdctxU,980
 luna_quantum/solve/parameters/mixins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luna_quantum/solve/parameters/mixins/fujitsu_common_params_mixin.py,sha256=aAk8A9c3pUVT7XrTHjOIdXR9KpLZXHccTSm8Cj_8mvw,10859
 luna_quantum/solve/parameters/mixins/fujitsu_v2_mixin.py,sha256=isgIOQYMliM8YL1vzoK2f18IAno3LGL9pNc7VqsrKog,3482
@@ -250,6 +254,7 @@ luna_quantum/solve/usecases/solve_job_cancel_usecase.py,sha256=_FEUTfM4nq5iug3nT
 luna_quantum/solve/usecases/solve_job_create_usecase.py,sha256=IcKN2VWTGw3J3Wgnt5QolHYWjk__9tRi-KTf-pBmsT0,3934
 luna_quantum/solve/usecases/solve_job_delete_usecase.py,sha256=hUOLeFLU9NCggWMGuIJG7WYShQjP4H_iZJnPvBJgTpA,1128
 luna_quantum/solve/usecases/solve_job_fetch_updates_usecase.py,sha256=W-Z6Q7IuyodjZmFKEsJGaa9V2fnGMPWj9FRN9gEdPNc,1686
+luna_quantum/solve/usecases/solve_job_get_by_id_usecase.py,sha256=Asvz8PCUtNsJHsFHwAV9nRp2AZ8tec9LmaaBjc0MNjQ,1349
 luna_quantum/solve/usecases/solve_job_get_result_usecase.py,sha256=OeujfR_SgYnO0lvgk1oqoGjsZfLN85ooSXZ9DazCQ74,3907
 luna_quantum/transformations.py,sha256=AZtGBaJ0PTWsr4mpONoJq5BpNOXPcM85CnWDhPgXx_I,902
 luna_quantum/transformations.pyi,sha256=wajxfV6QiD6R_7lUfk5kjAXp-ZHhOvLjtPqZCCX3UuU,10963
@@ -264,4 +269,4 @@ luna_quantum/util/pretty_base.py,sha256=QUNFiyz5MPsMCZB-wv622oeZ1uLkZ-_0xepNbuzQ
 luna_quantum/util/pydantic_utils.py,sha256=nhl_SdLJVAizrtLVHvnbco84g8CdBVdVxN_jlXiv82w,1263
 luna_quantum/utils.py,sha256=pBOkGXNJXlOzxAwTJv8nCj32Q6WNeh3t6Ka3lmTgy9c,134
 luna_quantum/utils.pyi,sha256=yHHPluEJArUltZ2jJ9bPtTugj59E9TOTmYdyH35EHtU,1934
-luna_quantum-1.0.8rc3.dist-info/RECORD,,
+luna_quantum-1.0.8rc4.dist-info/RECORD,,

luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/config.py

@@ -1,80 +0,0 @@
-from typing import Literal
-
-from pydantic import BaseModel, Field, field_validator
-
-from luna_quantum.solve.errors.solve_base_error import SolveBaseError
-
-
-class MixerTypeError(SolveBaseError):
-    """Custom Mixer type exception."""
-
-    def __init__(self) -> None:
-        super().__init__("XY-mixer type can only occur once.")
-
-
-class XYMixer(BaseModel):
-    """XY-mixer configuration.
-
-    Attributes
-    ----------
-    types: list[Literal["even", "odd", "last"]]
-        XY-ring-mixer pipeline
-    """
-
-    types: list[Literal["even", "odd", "last"]] = Field(
-        default=["even", "odd", "last"],
-        description="XY-ring-mixer types and order.",
-    )
-
-    @field_validator("types")
-    @classmethod
-    def _validate_type_once(
-        cls, v: list[Literal["even", "odd", "last"]]
-    ) -> list[Literal["even", "odd", "last"]]:
-        if len(set(v)) < len(v):
-            raise MixerTypeError
-        return v
-
-
-class AdvancedConfig(BaseModel):
-    """Additional FlexQAOA algorithm configuration.
-
-    Attributes
-    ----------
-    mixer: XYMixer | Dict
-        Mixer types in XY-ring-mixer. Default: `["even", "odd", "last"]`
-    parallel_indicators: bool
-        Toggle to apply indicator functions in parallel. Does not affect sampling
-        performance of QAOA, but only circuit metrics, like number of qubits and
-        circuit depth.
-    discard_slack: bool
-        Discard slack qubits in evaluation, i.e. only measure on the binary variables of
-        the initial problem. This requires an auxilary cost function that penalizes
-        infeasible solutions.
-    infeas_penalty: float | None
-        Penalty for infeasible solutions if `discard_slack` is activated. By defalt,
-        10 times the max absolute intial bias is chosen.
-    """
-
-    mixer: XYMixer = Field(
-        default_factory=lambda: XYMixer(),
-        description='Mixer types in XY-ring-mixer. Default: `["even", "odd", "last"]`',
-    )
-    parallel_indicators: bool = Field(
-        default=True,
-        description="Toggle to apply indicator functions in parallel. Does not affect "
-        "sampling performance of QAOA, but only circuit metrics, "
-        "like number of qubits and circuit depth.",
-    )
-    discard_slack: bool = Field(
-        default=False,
-        description="Discard slack qubits in evaluation, i.e. only measure on the "
-        "binary variables of the initial problem. This requires an auxilary cost "
-        "function that penalizes infeasible solutions.",
-    )
-    infeas_penalty: float | None = Field(
-        default=None,
-        ge=0,
-        description="Penalty for infeasible solutions if `discard_slack` is activated."
-        "By defalt, 10 times the max absolute intial bias is chosen.",
-    )

luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/optimizers.py

@@ -1,99 +0,0 @@
-from typing import Literal
-
-from pydantic import BaseModel, Field
-
-from luna_quantum.solve.parameters.algorithms.base_params.scipy_optimizer import (
-    ScipyOptimizerParams,
-)
-
-
-class LinearOptimizerParams(ScipyOptimizerParams):
-    """Optimizer for tuning a linear schedule of QAOA parameters.
-
-    Optimizes onyl two parameters: `delta_beta` and `delta_gamma` with the default
-    ScipyOptimizer.
-
-    Wrapper for scipy.optimize.minimize. See
-    [SciPy minimize documentation](
-    https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
-    for more information of the available methods and parameters.
-
-    Attributes
-    ----------
-    method: ScipyOptimizerMethod
-        Type of solver. See
-        [SciPy minimize documentation](
-        https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
-        for supported methods.
-    tol: float | None
-        Tolerance for termination.
-    bounds: None | tuple[float, float] | list[tuple[float, float]]
-        Bounds on variables for Nelder-Mead, L-BFGS-B, TNC, SLSQP, Powell,
-        trust-constr, COBYLA, and COBYQA methods. None is used to specify no bounds,
-        `(min, max)` is used to specify bounds for all variables. A sequence of
-        `(min, max)` can be used to specify bounds for each parameter individually.
-    jac: None | Literal["2-point", "3-point", "cs"]
-        Method for computing the gradient vector. Only for CG, BFGS, Newton-CG,
-        L-BFGS-B, TNC, SLSQP, dogleg, trust-ncg, trust-krylov, trust-exact and
-        trust-constr.
-    hess: None | Literal["2-point", "3-point", "cs"]
-        Method for computing the Hessian matrix. Only for Newton-CG, dogleg, trust-ncg,
-        trust-krylov, trust-exact and trust-constr.
-    maxiter: int
-        Maximum number of iterations to perform. Depending on the method
-        each iteration may use several function evaluations. Will be ignored for TNC
-        optimizer. Default: 100
-    options: dict[str, float]
-        A dictionary of solver options.
-    """
-
-    optimizer_type: Literal["linear"] = "linear"
-
-
-class CombinedOptimizerParams(BaseModel):
-    """Combination of LinearOptimizer and ScipyOptimizer.
-
-    Optimizer that first performs an optimization of the linear schedule and then
-    fine tunes individual parameters.
-
-
-    Attributes
-    ----------
-    linear: LinearOptimizerParams | Dict
-        Parameters of the linear optimizer.
-    fine_tune: ScipyOptimizerParams | Dict
-        Parameters of the fine tuning optimizer.
-    """
-
-    optimizer_type: Literal["combined"] = "combined"
-    linear: LinearOptimizerParams = Field(
-        default_factory=lambda: LinearOptimizerParams()
-    )
-    fine_tune: ScipyOptimizerParams = Field(
-        default_factory=lambda: ScipyOptimizerParams()
-    )
-
-
-class InterpolateOptimizerParams(BaseModel):
-    """Optimizer with sequentially increasing number of QAOA layers.
-
-    Optimizer that starts with `reps` iteration and interpolates sequentially in
-    `reps_step` steps to `reps_end`. In between it performs a full optimization routine
-    tunes individual parameters.
-
-    Attributes
-    ----------
-    optimiezr: LinearOptimizerParams | ScipyOptimizerParams | Dict
-        Parameters of the optimizer.
-    reps_step: int
-        Number of QAOA layers added for one interpolation.
-    reps_end: int
-        Final number of QAOA layers to be reached.
-    """
-
-    optimizer_type: Literal["interpolate"] = "interpolate"
-    optimizer: ScipyOptimizerParams | LinearOptimizerParams = Field(
-        default_factory=lambda: ScipyOptimizerParams()
-    )
-    reps_step: int = Field(default=1, ge=1)
-    reps_end: int = Field(default=10, ge=1)

luna_quantum/solve/parameters/algorithms/quantum_gate/flex_qaoa/pipeline.py

@@ -1,87 +0,0 @@
-from pydantic import BaseModel, Field
-
-
-class OneHotParams(BaseModel):
-    """Implements one-hot constraints through XY-mixers."""
-
-
-class IndicatorFunctionParams(BaseModel):
-    """Implements inequality constraints via indicator functions.
-
-    Attributes
-    ----------
-    penalty: float | None
-        Custom penalty factor for indicator functions. If none set, automatically
-        determined through upper and lower bounds.
-    penalty_scaling: float
-        Scaling of automatically determined penalty factor. Default: 2
-    """
-
-    penalty: float | None = Field(
-        default=None,
-        ge=0,
-        description="Custom penalty factor for indicator functions. If none set, "
-        "automatically determined through upper and lower bounds.",
-    )
-    penalty_scaling: float = Field(
-        default=2,
-        ge=0,
-        description="Scaling of automatically determined penalty factor. Default: 2",
-    )
-
-
-class QuadraticPenaltyParams(BaseModel):
-    """Implements all constraints through quadratic penalties.
-
-    Adds penalty terms to the objective. Adds slack variables for inequality constraints
-    if neccessaray.
-
-    Attributes
-    ----------
-    penalty: float | None
-        Custom penalty factor for quadratic penalty terms. If none is set, it is
-        automatically determined by taking 10 times the maximum absolute initial bias.
-    """
-
-    penalty: float | None = Field(
-        default=None,
-        ge=0,
-        description="Custom penalty factor for quadratic penalty terms. If none set, "
-        "automatically determined by taking 10 times the maximum absolute initial "
-        "bias.",
-    )
-
-
-class PipelineParams(BaseModel):
-    """Defines the modular Constrained QAOA Pipeline.
-
-    By default all features are enabled.
-
-    Attributes
-    ----------
-    indicator_function: IndicatorFunctionParams | Dict | None
-        Whether to implement inequality constraints with indicator functions. Disable
-        with setting to `None`.
-    one_hot: OneHotParams | Dict | None
-        Whether to implement inequality constraints with indicator functions. Disable
-        with setting to `None`.
-    quadratic_penalty: QuadraticPenaltyParams | Dict | None
-        Whether to implement inequality constraints with indicator functions. Disable
-        with setting to `None`.
-    """
-
-    indicator_function: IndicatorFunctionParams | None = Field(
-        default_factory=lambda: IndicatorFunctionParams(),
-        description="Whether to implement inequality constraints with indicator "
-        "functions. Disable with setting to `None`.",
-    )
-    one_hot: OneHotParams | None = Field(
-        default_factory=lambda: OneHotParams(),
-        description="Whether to implement inequality constraints with indicator "
-        "functions. Disable with setting to `None`.",
-    )
-    quadratic_penalty: QuadraticPenaltyParams | None = Field(
-        default_factory=lambda: QuadraticPenaltyParams(),
-        description="Whether to implement inequality constraints with indicator "
-        "functions. Disable with setting to `None`.",
-    )