Struct tract_tensorflow::prelude::InferenceFact

pub struct InferenceFact {
    pub datum_type: GenericFactoid<DatumType>,
    pub shape: ShapeFactoid,
    pub value: GenericFactoid<Arc<Tensor>>,
}

Partial information about a tensor.

The task of the analyser is to tag every edge in the graph with information about the tensors that flow through it - specifically their datum_type, their shape and possibly their value. During the analysis, however, we might only know some of that information (say, for instance, that an edge only carries tensors of rank 4, but without knowing their precise dimension).

This is where tensor facts come in: they hold partial information about the datum_type, shape and value of tensors that might flow through an edge of the graph. The analyser will first tag each edge with a fact, starting with the most general one and specializing it at each iteration. Eventually, it will reach a fixed point that - hopefully - holds enough information.

Fields

datum_type: GenericFactoid<DatumType>

shape: ShapeFactoid

value: GenericFactoid<Arc<Tensor>>

Implementations

impl InferenceFact

pub fn new() -> InferenceFact

Constructs the most general tensor fact possible.

pub fn any() -> InferenceFact

pub fn dt(dt: DatumType) -> InferenceFact

pub fn dt_shape<S>(dt: DatumType, shape: S) -> InferenceFact where
    S: Into<ShapeFactoid>, 

pub fn shape<S>(shape: S) -> InferenceFact where
    S: Into<ShapeFactoid>, 

pub fn with_datum_type(self, dt: DatumType) -> InferenceFact

pub fn with_shape<S>(self, shape: S) -> InferenceFact where
    S: Into<ShapeFactoid>, 

pub fn format_dt_shape(&self) -> String

pub fn dt_shape_from_tensor(t: &Tensor) -> InferenceFact

pub fn without_value(self) -> InferenceFact

Trait Implementations

impl Clone for InferenceFact

pub fn clone(&self) -> InferenceFact

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InferenceFact

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

Formats the value using the given formatter.

impl Default for InferenceFact

pub fn default() -> InferenceFact

Returns the "default value" for a type.

impl Fact for InferenceFact

pub fn to_typed_fact(&self) -> Result<TypedFact, Error>

pub fn matches(&self, t: &Tensor) -> Result<bool, Error>

pub fn same_as(&self, other: &(dyn Fact + 'static)) -> bool

impl Factoid for InferenceFact

type Concrete = Arc<Tensor>

pub fn concretize(&self) -> Option<<InferenceFact as Factoid>::Concrete>

Tries to transform the fact into a concrete value.

pub fn unify(&self, other: &InferenceFact) -> Result<InferenceFact, Error>

Tries to unify the fact with another fact of the same type.

fn is_concrete(&self) -> bool

Returns whether the value is fully determined.

fn unify_with(&mut self, other: &Self) -> Result<bool, Error>

Tries to unify the fact with another fact of the same type and update self.

fn unify_with_mut(&mut self, other: &mut Self) -> Result<bool, Error>

Tries to unify the fact with another fact of the same type and update both of them.

fn unify_all(facts: &mut [&mut Self]) -> Result<bool, Error>

Tries to unify all facts in the list.

impl<'a> From<&'a Arc<Tensor>> for InferenceFact

pub fn from(t: &'a Arc<Tensor>) -> InferenceFact

Performs the conversion.

impl<'a> From<&'a InferenceFact> for InferenceFact

pub fn from(t: &'a InferenceFact) -> InferenceFact

Performs the conversion.

impl<'a> From<&'a Tensor> for InferenceFact

pub fn from(t: &'a Tensor) -> InferenceFact

Performs the conversion.

impl<'a> From<&'a TypedFact> for InferenceFact

pub fn from(t: &'a TypedFact) -> InferenceFact

Performs the conversion.

impl From<Arc<Tensor>> for InferenceFact

pub fn from(t: Arc<Tensor>) -> InferenceFact

Performs the conversion.

impl From<Tensor> for InferenceFact

pub fn from(t: Tensor) -> InferenceFact

Performs the conversion.

impl Hash for InferenceFact

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<InferenceFact> for InferenceFact

pub fn eq(&self, other: &InferenceFact) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &InferenceFact) -> bool

This method tests for !=.

impl SpecialOps<InferenceFact, Box<dyn InferenceOp + 'static>> for Graph<InferenceFact, Box<dyn InferenceOp + 'static>>

pub fn is_source(op: &Box<dyn InferenceOp + 'static>) -> bool

pub fn create_dummy(&self) -> Box<dyn InferenceOp + 'static>

pub fn create_source(
    &self,
    _fact: InferenceFact
) -> Box<dyn InferenceOp + 'static>

pub fn wire_node(
    &mut self,
    name: impl Into<String>,
    op: impl Into<Box<dyn InferenceOp + 'static>>,
    inputs: &[OutletId]
) -> Result<SmallVec<[OutletId; 4]>, Error>

impl StructuralPartialEq for InferenceFact

impl<'a> TryFrom<&'a InferenceFact> for TypedFact

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(fact: &InferenceFact) -> Result<TypedFact, Error>

Performs the conversion.