luna-quantum 1.0.7__cp313-cp313-macosx_10_12_x86_64.whl → 1.0.8rc1__cp313-cp313-macosx_10_12_x86_64.whl

luna_quantum/__init__.py

@@ -48,6 +48,7 @@ from ._core import (
     Timer,
     Timing,
     Unbounded,
+    ValueSource,
     Variable,
     Vtype,
     errors,
@@ -103,6 +104,7 @@ __all__ = [
     "Timing",
     "Unbounded",
     "UseCaseFactory",
+    "ValueSource",
     "Variable",
     "Vtype",
     "__version__",

luna_quantum/_core.pyi

@@ -783,6 +783,14 @@ class Timer:
         """
         ...
 
+class ValueSource(Enum):
+    """Toggle enum for choosing the quantity for solution convenience functions."""
+
+    Obj = ...
+    """Use the `obj_values` field."""
+    Raw = ...
+    """Use the `raw_energies` field."""
+
 class Solution:
     """
     The solution object that is obtained by running an algorihtm.
@@ -926,6 +934,11 @@ class Solution:
         """
         ...
 
+    @obj_values.setter
+    def obj_values(self, other: (NDArray | None)) -> None:
+        """Set the objective values of the single samples as a ndarray."""
+        ...
+
     @property
     def raw_energies(self, /) -> NDArray | None:
         """Get the raw energies.
@@ -935,6 +948,11 @@ class Solution:
         """
         ...
 
+    @raw_energies.setter
+    def raw_energies(self, other: (NDArray | None)) -> None:
+        """Set the raw energies of the single samples as a ndarray."""
+        ...
+
     @property
     def counts(self, /) -> NDArray:
         """Return how often each sample occurred in the solution."""
@@ -960,10 +978,15 @@ class Solution:
         """Get the names of all variables in the solution."""
         ...
 
-    def cvar(self, /, alpha: float) -> float:
+    def cvar(self, /, alpha: float, value_toggle: ValueSource = ...) -> float:
         """
         Compute the Conditional Value at Rist (CVaR) of the solution.
 
+        Parameters
+        ----------
+        float : alpha
+            The confidence level.
+
         Returns
         -------
         float
@@ -976,7 +999,30 @@ class Solution:
         """
         ...
 
-    def expectation_value(self, /) -> float:
+    def temperature_weighted(
+        self, /, beta: float, value_toggle: ValueSource = ...
+    ) -> float:
+        """
+        Compute the temperature weighted expectation value of the solution.
+
+        Parameters
+        ----------
+        float : beta
+            The inverse temperature for computing Boltzmann weights.
+
+        Returns
+        -------
+        float
+            The temperature weighted expectation value.
+
+        Raises
+        ------
+        ComputationError
+            If the computation fails for any reason.
+        """
+        ...
+
+    def expectation_value(self, /, value_toggle: ValueSource = ...) -> float:
         """
         Compute the expectation value of the solution.
 
@@ -1457,6 +1503,7 @@ class Solution:
         sense: (Sense | None) = ...,
         bit_order: Literal["LTR", "RTL"] = "RTL",
         raw_energies: (list[float] | None) = ...,
+        var_order: (list[str] | None) = ...,
     ) -> Solution:
         """
         Create a `Solution` from a dict that maps measured bitstrings to counts.
@@ -2713,6 +2760,27 @@ class Expression:
         """
         ...
 
+    @overload
+    @staticmethod
+    def const(val: float, /) -> Expression: ...
+    @overload
+    @staticmethod
+    def const(val: float, /, env: Environment) -> Expression: ...
+    @staticmethod
+    def const(val: float, /, env: (Environment | None) = None) -> Expression:
+        """Create constant expression.
+
+        Parameters
+        ----------
+        val : float
+            The constant
+
+        Returns
+        -------
+        Expression
+        """
+        ...
+
     def get_offset(self, /) -> float:
         """
         Get the constant (offset) term in the expression.
@@ -2906,6 +2974,22 @@ class Expression:
         """
         ...
 
+    def separate(self, variables: list[Variable]) -> tuple[Expression, Expression]:
+        """
+        Separates expression into two expressions based on presence of variables.
+
+        Parameters
+        ----------
+        variables : list[Variable]
+            The variables of which one must at least be present in a left term.
+
+        Returns
+        -------
+        tuple[Expression, Expression]
+            Two expressions, left contains one of the variables right does not, i.e.
+            (contains, does not contain)
+        """
+
     def substitute(
         self, /, target: Variable, replacement: (Expression | Variable)
     ) -> Expression:
@@ -3034,6 +3118,22 @@ class Expression:
         """
         ...
 
+    @staticmethod
+    def deep_clone_many(exprs: list[Expression]) -> list[Expression]:
+        """Deep clones all provided expressions into new environment.
+
+        Parameters
+        ----------
+        exprs: list[Expression]
+            The expressions to move to new_environment
+
+        Returns
+        -------
+        list[Expressions]
+            The same expressions but part of a new environment
+        """
+        ...
+
     @overload
     def __add__(self, other: Expression, /) -> Expression: ...
     @overload
@@ -3388,12 +3488,15 @@ class Expression:
         ...
 
     @property
-    def _environment(self, /) -> Environment:
+    def environment(self, /) -> Environment:
         """Get this expression's environment."""
         ...
 
     def __str__(self, /) -> str: ...
     def __repr__(self, /) -> str: ...
+    def evaluate(self, solution: Solution, /) -> NDArray:
+        """Evaluate an expression based on an existing solution."""
+        ...
 
 class ExpressionIterator:
     """
@@ -3611,6 +3714,14 @@ class Environment:
     def __eq__(self, other: Environment, /) -> bool: ...
     def __str__(self, /) -> str: ...
     def __repr__(self, /) -> str: ...
+    @property
+    def num_variables(self, /) -> int:
+        """Get the number of variables in env."""
+        ...
+
+    def variables(self, /) -> list[Variable]:
+        """Get the variables in env."""
+        ...
 
 class Comparator(Enum):
     """

luna_quantum/errors.pyi

@@ -246,6 +246,11 @@ class SampleColCreationError(IndexError):
 
     def __str__(self, /) -> str: ...
 
+class EnvMismatchError(RuntimeError):
+    """Raised when environments of provided expressions mismatch."""
+
+    def __str__(self, /) -> str: ...
+
 class InternalPanicError(RuntimeError):
     """Raised when an internal and unrecoverable error occurred."""
 

{luna_quantum-1.0.7.dist-info → luna_quantum-1.0.8rc1.dist-info}/METADATA

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

{luna_quantum-1.0.7.dist-info → luna_quantum-1.0.8rc1.dist-info}/RECORD

@@ -1,11 +1,11 @@
-luna_quantum-1.0.7.dist-info/METADATA,sha256=9Cvghd3Z2Qm0G8t3edFFFsM4iwlmfxy5086_8yuTSSY,1582
-luna_quantum-1.0.7.dist-info/WHEEL,sha256=9d4LhS3OlNUu5-K3LnKO1CkfyGkzCuvxR5bAWA0Slro,106
-luna_quantum-1.0.7.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-luna_quantum-1.0.7.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
-luna_quantum/__init__.py,sha256=RV92O-Th8ktm0S9kcpfRfECkeeORP-tbDKfpa4u1CiY,3223
+luna_quantum-1.0.8rc1.dist-info/METADATA,sha256=VNgsz3c9MfEiLwTeCTS_Tkri5AaJy7RKatVfL1epL8E,1585
+luna_quantum-1.0.8rc1.dist-info/WHEEL,sha256=73R9gF1Kx45mnq358tC7C3GKhsVvyIHwOBt6LvI35MM,106
+luna_quantum-1.0.8rc1.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+luna_quantum-1.0.8rc1.dist-info/licenses/NOTICE,sha256=noPOS8eDj5XoyRO8ZrCxIOh5fSjk0RildIrrqxQlepY,588
+luna_quantum/__init__.py,sha256=8tQBzVi42I_1PuuACQW0wilcJWTt31ln5A4joNcPOSk,3259
 luna_quantum/__init__.pyi,sha256=1Joa1farT1Ey22yWYPMNPgQrGHIKL8bycrdPUgtQqw8,1661
-luna_quantum/_core.cpython-313-darwin.so,sha256=KsKZhonerlMhA0Lj_ea2pjotLkieDLAwp6zDssp8MMA,5885352
-luna_quantum/_core.pyi,sha256=Ho4qm1sII4PHY8ZpsrwF1Qd6EzcDefmKeba-8Fb_j6g,114905
+luna_quantum/_core.cpython-313-darwin.so,sha256=0Us1E_C4GIQ3KAw3MK0PoVbnspqwhr8MvrwywGQf4FE,5914604
+luna_quantum/_core.pyi,sha256=_nJmdvjPtibEZUD4FksyWR3J6ttAPoJhxrWZs_7Nz08,118028
 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
@@ -83,7 +83,7 @@ luna_quantum/client/utils/qpu_token_utils.py,sha256=xeWIKcBwXGSQ0INfUY3NMTu6H90T
 luna_quantum/config.py,sha256=xx7DnjAvOeLUMlXvbXqQ4_EBAy53bjPYU1-QQO6I2lY,217
 luna_quantum/decorators.py,sha256=x0ARypqawJh8VyrgYufaV8DX2vx843kB16_1bUXOqr0,6901
 luna_quantum/errors.py,sha256=yjeXB3i07LlTuuJ18IKgwsC5wmtJElN8cDwlg3JkcEs,1424
-luna_quantum/errors.pyi,sha256=Hev30Htt63MgcESZaVOj645PsINfTYS-XGU8gklYqFM,9297
+luna_quantum/errors.pyi,sha256=PTVWbmHLrlNBMxz3wYni0nbqeMEGlzmIukMwgnF3bMo,9443
 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
@@ -261,4 +261,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.7.dist-info/RECORD,,
+luna_quantum-1.0.8rc1.dist-info/RECORD,,

{luna_quantum-1.0.7.dist-info → luna_quantum-1.0.8rc1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.5)
+Generator: maturin (1.9.6)
 Root-Is-Purelib: false
 Tag: cp313-cp313-macosx_10_12_x86_64