pub struct FermionOperatorWrapper {
pub internal: FermionOperator,
}
Expand description
These are representations of systems of fermions.
FermionOperators are characterized by a FermionOperator to represent the hamiltonian of the spin system and an optional number of fermions.
Returns: self: The new FermionSystem with the input number of fermions.
§Examples
.. code-block:: python
import numpy.testing as npt
import scipy.sparse as sp
from qoqo_calculator_pyo3 import CalculatorComplex
from struqture_py.fermions import FermionOperator, FermionProduct
system = FermionOperator()
pp = FermionProduct([0], [0])
system.add_operator_product(pp, 5.0)
npt.assert_equal(system.current_number_modes(), 1)
npt.assert_equal(system.get(pp), CalculatorComplex(5))
npt.assert_equal(system.keys(), [pp])
Fields§
§internal: FermionOperator
Internal storage of struqture::fermions::FermionOperator
Implementations§
Source§impl FermionOperatorWrapper
impl FermionOperatorWrapper
Sourcepub fn from_pyany(input: &Bound<'_, PyAny>) -> PyResult<FermionOperator>
pub fn from_pyany(input: &Bound<'_, PyAny>) -> PyResult<FermionOperator>
Fallible conversion of generic python object.
Source§impl FermionOperatorWrapper
impl FermionOperatorWrapper
Sourcepub fn new() -> Self
pub fn new() -> Self
Create an empty FermionOperator.
Returns: self: The new FermionOperator with the input number of fermions.
Sourcepub fn __mul__(&self, value: &Bound<'_, PyAny>) -> PyResult<Self>
pub fn __mul__(&self, value: &Bound<'_, PyAny>) -> PyResult<Self>
Implement *
for FermionOperator and FermionOperator/CalculatorComplex/CalculatorFloat.
Args: value (Union[FermionOperator, CalculatorComplex, CalculatorFloat]): value by which to multiply the self FermionOperator
Returns: FermionOperator: The FermionOperator multiplied by the value.
Raises: ValueError: The rhs of the multiplication is neither CalculatorFloat, CalculatorComplex, nor FermionOperator.
Sourcepub fn keys(&self) -> Vec<FermionProductWrapper>
pub fn keys(&self) -> Vec<FermionProductWrapper>
Return a list of the unsorted keys in self.
Returns: List[OperatorProduct]: The sequence of keys of the self.
Sourcepub fn __len__(&self) -> usize
pub fn __len__(&self) -> usize
Return number of entries in self.
Returns: int: The length of the content of self.
Sourcepub fn empty_clone(&self, capacity: Option<usize>) -> FermionOperatorWrapper
pub fn empty_clone(&self, capacity: Option<usize>) -> FermionOperatorWrapper
Return an instance of self that has no entries but clones all other properties, with the given capacity.
Args: capacity (Optional[int]): The capacity of the new instance to create.
Returns: self: An empty clone with the same properties as self, with the given capacity.
Sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Return true if self contains no values.
Returns: bool: Whether self is empty or not.
Sourcepub fn truncate(&self, threshold: f64) -> FermionOperatorWrapper
pub fn truncate(&self, threshold: f64) -> FermionOperatorWrapper
Truncate self by returning a copy without entries under a threshold.
Args: threshold (float): The threshold for inclusion.
Returns: self: The truncated version of self.
Sourcepub fn get(&self, key: &Bound<'_, PyAny>) -> PyResult<CalculatorComplexWrapper>
pub fn get(&self, key: &Bound<'_, PyAny>) -> PyResult<CalculatorComplexWrapper>
Get the coefficient corresponding to the key.
Args: key: Product to get the value of.
Returns: CalculatorComplex: Value at key (or 0.0).
Raises: ValueError: Product could not be constructed from key.
Sourcepub fn remove(
&mut self,
key: &Bound<'_, PyAny>,
) -> PyResult<Option<CalculatorComplexWrapper>>
pub fn remove( &mut self, key: &Bound<'_, PyAny>, ) -> PyResult<Option<CalculatorComplexWrapper>>
Remove the value of the input key.
Args: key (Product type): The key of the value to remove.
Returns: Optional[Union[CalculatorComplex, CalculatorFloat]]: Key existed if this is not None, and this is the value it had before it was removed.
Raises: ValueError: Product could not be constructed.
Sourcepub fn set(
&mut self,
key: &Bound<'_, PyAny>,
value: &Bound<'_, PyAny>,
) -> PyResult<Option<CalculatorComplexWrapper>>
pub fn set( &mut self, key: &Bound<'_, PyAny>, value: &Bound<'_, PyAny>, ) -> PyResult<Option<CalculatorComplexWrapper>>
Overwrite an existing entry or set a new entry in self.
Args: key (Product type): The key to set. value (Union[CalculatorComplex, CalculatorFloat]): The value to set.
Returns: Optional[Union[CalculatorComplex, CalculatorFloat]]: Key existed if this is not None, and this is the value it had before it was overwritten.
Raises: ValueError: Product could not be constructed.
Sourcepub fn add_operator_product(
&mut self,
key: &Bound<'_, PyAny>,
value: &Bound<'_, PyAny>,
) -> PyResult<()>
pub fn add_operator_product( &mut self, key: &Bound<'_, PyAny>, value: &Bound<'_, PyAny>, ) -> PyResult<()>
Add a new (key object, value Union[CalculatorComplex, CalculatorFloat]) pair to existing entries.
Args: key (Product type): The key object value (Union[CalculatorComplex, CalculatorFloat]): The value to add.
Raises: TypeError: Value is not CalculatorComplex or CalculatorFloat. ValueError: Product could not be constructed. ValueError: Error in add_operator_product function of self.
Sourcepub fn values(&self) -> Vec<CalculatorComplexWrapper>
pub fn values(&self) -> Vec<CalculatorComplexWrapper>
Return unsorted values in self.
Returns: List[Union[CalculatorComplex, CalculatorFloat]]: The sequence of values of self.
Sourcepub fn hermitian_conjugate(&self) -> FermionOperatorWrapper
pub fn hermitian_conjugate(&self) -> FermionOperatorWrapper
Return the hermitian conjugate of self.
Returns: self: The hermitian conjugate of self.
Sourcepub fn current_number_modes(&self) -> usize
pub fn current_number_modes(&self) -> usize
Return the current_number_modes input of self.
Returns: int: The number of modes in self.
Sourcepub fn __neg__(&self) -> FermionOperatorWrapper
pub fn __neg__(&self) -> FermionOperatorWrapper
Implement -1
for self.
Returns: self: The object * -1.
Sourcepub fn __add__(
&self,
other: FermionOperatorWrapper,
) -> PyResult<FermionOperatorWrapper>
pub fn __add__( &self, other: FermionOperatorWrapper, ) -> PyResult<FermionOperatorWrapper>
Implement +
for self with self-type.
Args: other (self): value by which to add to self.
Returns: self: The two objects added.
Raises: ValueError: Objects could not be added.
Sourcepub fn __sub__(
&self,
other: FermionOperatorWrapper,
) -> PyResult<FermionOperatorWrapper>
pub fn __sub__( &self, other: FermionOperatorWrapper, ) -> PyResult<FermionOperatorWrapper>
Implement -
for self with self-type.
Args: other (self): value by which to subtract from self.
Returns: self: The two objects subtracted.
Raises: ValueError: Objects could not be subtracted.
Sourcepub fn __copy__(&self) -> FermionOperatorWrapper
pub fn __copy__(&self) -> FermionOperatorWrapper
Return a copy of self (copy here produces a deepcopy).
Returns: self: A deep copy of self.
Sourcepub fn __deepcopy__(
&self,
_memodict: &Bound<'_, PyAny>,
) -> FermionOperatorWrapper
pub fn __deepcopy__( &self, _memodict: &Bound<'_, PyAny>, ) -> FermionOperatorWrapper
Return a deep copy of self.
Returns: self: A deep copy of self.
Sourcepub fn from_bincode(
input: &Bound<'_, PyAny>,
) -> PyResult<FermionOperatorWrapper>
pub fn from_bincode( input: &Bound<'_, PyAny>, ) -> PyResult<FermionOperatorWrapper>
Sourcepub fn to_bincode(&self) -> PyResult<Py<PyByteArray>>
pub fn to_bincode(&self) -> PyResult<Py<PyByteArray>>
Sourcepub fn to_json(&self) -> PyResult<String>
pub fn to_json(&self) -> PyResult<String>
Return the json representation of self.
Returns: str: The serialized form of self.
Raises: ValueError: Cannot serialize object to json.
Sourcepub fn from_json(input: String) -> PyResult<FermionOperatorWrapper>
pub fn from_json(input: String) -> PyResult<FermionOperatorWrapper>
Convert the json representation of self to an instance.
Args: input (str): The serialized object in json form.
Returns: The deserialized object.
Raises: ValueError: Input cannot be deserialized.
Sourcepub fn __str__(&self) -> String
pub fn __str__(&self) -> String
Return a string containing a printable representation of self.
Returns: str: The printable string representation of self.
Sourcepub fn __repr__(&self) -> String
pub fn __repr__(&self) -> String
Return a string containing a printable representation of self.
Returns: str: The printable string representation of self.
Sourcepub fn __richcmp__(
&self,
other: &Bound<'_, PyAny>,
op: CompareOp,
) -> PyResult<bool>
pub fn __richcmp__( &self, other: &Bound<'_, PyAny>, op: CompareOp, ) -> PyResult<bool>
Return the richcmp magic method to perform rich comparison operations on object.
Args: other: The object to compare self to. op: Whether they should be equal or not.
Returns: Whether the two operations compared evaluated to True or False
Raises: NotImplementedError: Other comparison not implemented.
Source§impl FermionOperatorWrapper
impl FermionOperatorWrapper
Sourcepub fn jordan_wigner(&self) -> PauliOperatorWrapper
pub fn jordan_wigner(&self) -> PauliOperatorWrapper
Transform the given fermionic object into a spin object using the Jordan Wigner mapping.
Trait Implementations§
Source§impl Clone for FermionOperatorWrapper
impl Clone for FermionOperatorWrapper
Source§fn clone(&self) -> FermionOperatorWrapper
fn clone(&self) -> FermionOperatorWrapper
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for FermionOperatorWrapper
impl Debug for FermionOperatorWrapper
Source§impl Default for FermionOperatorWrapper
impl Default for FermionOperatorWrapper
Source§impl<'py> IntoPyObject<'py> for FermionOperatorWrapper
impl<'py> IntoPyObject<'py> for FermionOperatorWrapper
Source§type Target = FermionOperatorWrapper
type Target = FermionOperatorWrapper
Source§type Output = Bound<'py, <FermionOperatorWrapper as IntoPyObject<'py>>::Target>
type Output = Bound<'py, <FermionOperatorWrapper as IntoPyObject<'py>>::Target>
Source§fn into_pyobject(
self,
py: Python<'py>,
) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>
fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>
Source§impl PartialEq for FermionOperatorWrapper
impl PartialEq for FermionOperatorWrapper
Source§impl PyClass for FermionOperatorWrapper
impl PyClass for FermionOperatorWrapper
Source§impl PyClassImpl for FermionOperatorWrapper
impl PyClassImpl for FermionOperatorWrapper
Source§const IS_BASETYPE: bool = false
const IS_BASETYPE: bool = false
Source§const IS_SUBCLASS: bool = false
const IS_SUBCLASS: bool = false
Source§const IS_MAPPING: bool = false
const IS_MAPPING: bool = false
Source§const IS_SEQUENCE: bool = false
const IS_SEQUENCE: bool = false
Source§const IS_IMMUTABLE_TYPE: bool = false
const IS_IMMUTABLE_TYPE: bool = false
Source§type ThreadChecker = SendablePyClass<FermionOperatorWrapper>
type ThreadChecker = SendablePyClass<FermionOperatorWrapper>
type Inventory = Pyo3MethodsInventoryForFermionOperatorWrapper
Source§type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild
type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild
Source§type BaseNativeType = PyAny
type BaseNativeType = PyAny
PyAny
by default, and when you declare
#[pyclass(extends=PyDict)]
, it’s PyDict
.fn items_iter() -> PyClassItemsIter
fn lazy_type_object() -> &'static LazyTypeObject<Self>
fn dict_offset() -> Option<isize>
fn weaklist_offset() -> Option<isize>
Source§impl PyClassNewTextSignature<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
impl PyClassNewTextSignature<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
fn new_text_signature(self) -> Option<&'static str>
Source§impl PyClass__add__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
impl PyClass__add__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
Source§impl PyClass__mul__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
impl PyClass__mul__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
Source§impl PyClass__sub__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
impl PyClass__sub__SlotFragment<FermionOperatorWrapper> for PyClassImplCollector<FermionOperatorWrapper>
Source§impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a FermionOperatorWrapper
impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a FermionOperatorWrapper
Source§impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a mut FermionOperatorWrapper
impl<'a, 'py> PyFunctionArgument<'a, 'py, false> for &'a mut FermionOperatorWrapper
Source§impl PyTypeInfo for FermionOperatorWrapper
impl PyTypeInfo for FermionOperatorWrapper
Source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Source§fn type_object(py: Python<'_>) -> Bound<'_, PyType>
fn type_object(py: Python<'_>) -> Bound<'_, PyType>
impl DerefToPyAny for FermionOperatorWrapper
impl StructuralPartialEq for FermionOperatorWrapper
Auto Trait Implementations§
impl Freeze for FermionOperatorWrapper
impl RefUnwindSafe for FermionOperatorWrapper
impl Send for FermionOperatorWrapper
impl Sync for FermionOperatorWrapper
impl Unpin for FermionOperatorWrapper
impl UnwindSafe for FermionOperatorWrapper
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> FromPyObject<'_> for T
impl<T> FromPyObject<'_> for T
Source§impl<'py, T> FromPyObjectBound<'_, 'py> for Twhere
T: FromPyObject<'py>,
impl<'py, T> FromPyObjectBound<'_, 'py> for Twhere
T: FromPyObject<'py>,
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<'py, T> IntoPyObjectExt<'py> for Twhere
T: IntoPyObject<'py>,
impl<'py, T> IntoPyObjectExt<'py> for Twhere
T: IntoPyObject<'py>,
Source§fn into_bound_py_any(self, py: Python<'py>) -> Result<Bound<'py, PyAny>, PyErr>
fn into_bound_py_any(self, py: Python<'py>) -> Result<Bound<'py, PyAny>, PyErr>
self
into an owned Python object, dropping type information.