Enum SymbolicExpression

pub enum SymbolicExpression<F> {
    Variable(SymbolicVariable<F>),
    IsFirstRow,
    IsLastRow,
    IsTransition,
    Constant(F),
    Add {
        x: Rc<Self>,
        y: Rc<Self>,
        degree_multiple: usize,
    },
    Sub {
        x: Rc<Self>,
        y: Rc<Self>,
        degree_multiple: usize,
    },
    Neg {
        x: Rc<Self>,
        degree_multiple: usize,
    },
    Mul {
        x: Rc<Self>,
        y: Rc<Self>,
        degree_multiple: usize,
    },
}

An expression over SymbolicVariables.

Variants

Variable(SymbolicVariable<F>)

IsFirstRow

IsLastRow

IsTransition

Constant(F)

Add

Fields

x: Rc<Self>

y: Rc<Self>

degree_multiple: usize

Sub

Fields

x: Rc<Self>

y: Rc<Self>

degree_multiple: usize

Neg

Fields

x: Rc<Self>

degree_multiple: usize

Mul

Fields

x: Rc<Self>

y: Rc<Self>

degree_multiple: usize

Implementations

impl<F> SymbolicExpression<F>

pub const fn degree_multiple(&self) -> usize

Returns the multiple of n (the trace length) in this expression’s degree.

Trait Implementations

impl<F: Field, T> Add<T> for SymbolicExpression<F>

where T: Into<Self>,

type Output = SymbolicExpression<F>

The resulting type after applying the + operator.

fn add(self, rhs: T) -> Self

Performs the + operation.

impl<F: Field, T> AddAssign<T> for SymbolicExpression<F>

where T: Into<Self>,

fn add_assign(&mut self, rhs: T)

Performs the += operation.

impl<F: Clone> Clone for SymbolicExpression<F>

fn clone(&self) -> SymbolicExpression<F>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<F: Debug> Debug for SymbolicExpression<F>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<F: Field> Default for SymbolicExpression<F>

fn default() -> Self

Returns the “default value” for a type.

impl<F: Field> FieldAlgebra for SymbolicExpression<F>

const ZERO: Self

The additive identity of the algebra.

const ONE: Self

The multiplicative identity of the Algebra

const TWO: Self

The element in the algebra given by ONE + ONE.

const NEG_ONE: Self

The element in the algebra given by -ONE.

type F = F

fn from_f(f: Self::F) -> Self

Interpret a field element as a commutative algebra element.

fn from_canonical_u8(n: u8) -> Self

Convert from a canonical u8.

fn from_canonical_u16(n: u16) -> Self

Convert from a canonical u16.

fn from_canonical_u32(n: u32) -> Self

Convert from a canonical u32.

fn from_canonical_u64(n: u64) -> Self

Convert from a canonical u64.

fn from_canonical_usize(n: usize) -> Self

Convert from a canonical usize.

fn from_wrapped_u32(n: u32) -> Self

fn from_wrapped_u64(n: u64) -> Self

fn from_bool(b: bool) -> Self

Convert from a bool.

fn double(&self) -> Self

The elementary function double(a) = 2*a.

fn square(&self) -> Self

The elementary function square(a) = a^2.

fn cube(&self) -> Self

The elementary function cube(a) = a^3.

fn exp_u64(&self, power: u64) -> Self

Exponentiation by a u64 power.

fn exp_const_u64<const POWER: u64>(&self) -> Self

Exponentiation by a constant power.

fn exp_power_of_2(&self, power_log: usize) -> Self

Compute self^{2^power_log} by repeated squaring.

fn mul_2exp_u64(&self, exp: u64) -> Self

self * 2^exp

fn powers(&self) -> Powers<Self>

Construct an iterator which returns powers of self: self^0, self^1, self^2, ....

fn shifted_powers(&self, start: Self) -> Powers<Self>

Construct an iterator which returns powers of self shifted by start: start, start*self^1, start*self^2, ....

fn powers_packed<P>(&self) -> Powers<P>

where P: PackedField<Scalar = Self>,

Construct an iterator which returns powers of self packed into PackedField elements.

fn shifted_powers_packed<P>(&self, start: Self) -> Powers<P>

where P: PackedField<Scalar = Self>,

Construct an iterator which returns powers of self shifted by start and packed into PackedField elements.

fn dot_product<const N: usize>(u: &[Self; N], v: &[Self; N]) -> Self

Compute the dot product of two vectors.

fn zero_vec(len: usize) -> Vec<Self>

Allocates a vector of zero elements of length len. Many operating systems zero pages before assigning them to a userspace process. In that case, our process should not need to write zeros, which would be redundant. However, the compiler may not always recognize this.

impl<F: Field> From<F> for SymbolicExpression<F>

fn from(value: F) -> Self

Converts to this type from the input type.

impl<F: Field> From<SymbolicVariable<F>> for SymbolicExpression<F>

fn from(value: SymbolicVariable<F>) -> Self

Converts to this type from the input type.

impl<F: Field, T> Mul<T> for SymbolicExpression<F>

where T: Into<Self>,

type Output = SymbolicExpression<F>

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self

Performs the * operation.

impl<F: Field, T> MulAssign<T> for SymbolicExpression<F>

where T: Into<Self>,

fn mul_assign(&mut self, rhs: T)

Performs the *= operation.

impl<F: Field> Neg for SymbolicExpression<F>

type Output = SymbolicExpression<F>

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl<F: Field, T> Product<T> for SymbolicExpression<F>

where T: Into<Self>,

fn product<I: Iterator<Item = T>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by multiplying the items.

impl<F: Field, T> Sub<T> for SymbolicExpression<F>

where T: Into<Self>,

type Output = SymbolicExpression<F>

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> Self

Performs the - operation.

impl<F: Field, T> SubAssign<T> for SymbolicExpression<F>

where T: Into<Self>,

fn sub_assign(&mut self, rhs: T)

Performs the -= operation.

impl<F: Field, T> Sum<T> for SymbolicExpression<F>

where T: Into<Self>,

fn sum<I: Iterator<Item = T>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.