DDD  1.9.0.20240425101308
Public Member Functions | Static Public Member Functions | Public Attributes | Private Member Functions | Private Attributes | List of all members
sns::SDomExtract Class Reference

Extractor of variable domains for invert computations. More...

Inheritance diagram for sns::SDomExtract:
Inheritance graph
Collaboration diagram for sns::SDomExtract:
Collaboration graph

Public Member Functions

 SDomExtract ()
 
 SDomExtract (int t)
 
bool skip_variable (int) const
 The skip_variable predicate indicates which variables are "don't care" with respect to this SHom. More...
 
bool is_selector () const
 The isSelector predicate indicates a homomorphism that only selects paths in the SDD (no modifications, no additions) Tagging with isSelector() allows to enable optimizations and makes the homomorphism eligible as "condition" in ITE construct. More...
 
GSDD eval (const GSDD &d) const
 The computation function responsible for evaluation over a node. More...
 
size_t hash () const
 Hash key computation. More...
 
bool operator== (const _GShom &s) const
 Comparator. More...
 
_GShomclone () const
 
void print (std::ostream &os) const
 
GSDD has_image_skip (const GSDD &) const
 
virtual const GShom::range_t get_range () const
 The range returns the dual of skip_variable, default implem considers that all variables are affected by this homomorphism. More...
 
virtual GSDD has_image (const GSDD &d) const
 
virtual GShom compose (const GShom &) const
 
virtual void mark () const
 For garbage collection. Used in first phase of garbage collection. More...
 
void mark_if_refd () const
 
void ref () const
 
void deref () const
 
unsigned long int refCounter () const
 
bool is_marked () const
 
void set_mark (bool val) const
 
virtual GShom invert (const GSDD &) const
 

Static Public Member Functions

static const _GShomget_concret (const GShom &gshom)
 TODO : this is a dirty trick to allow us to do terms rewriting in Add, Fixpoint etc... More...
 

Public Attributes

int target
 

Private Member Functions

GSDD eval_skip (const GSDD &) const
 The procedure responsible for propagating efficiently across "skipped" variable nodes. More...
 
virtual bool immediat () const
 For operation cache management. More...
 

Private Attributes

int _refCounter
 For garbage collection. More...
 

Detailed Description

Extractor of variable domains for invert computations.

Constructor & Destructor Documentation

◆ SDomExtract() [1/2]

sns::SDomExtract::SDomExtract ( )
inline

Referenced by clone().

◆ SDomExtract() [2/2]

sns::SDomExtract::SDomExtract ( int  t)
inline

Member Function Documentation

◆ clone()

_GShom* sns::SDomExtract::clone ( ) const
inlinevirtual

Implements _GShom.

References SDomExtract().

◆ compose()

GShom _GShom::compose ( const GShom r) const
virtualinherited

References GShom::id, and GSDD::null.

Referenced by GShom::compose().

◆ deref()

void _GShom::deref ( ) const
inlineinherited

References _GShom::_refCounter.

Referenced by Shom::operator=(), and Shom::~Shom().

◆ eval()

GSDD sns::SDomExtract::eval ( const GSDD ) const
inlinevirtual

The computation function responsible for evaluation over a node.

Users should not directly use this. Normal behavior is to use GShom::operator() that encapsulates this call with operation caching.

Implements _GShom.

References SDED::add(), GSDD::begin(), GSDD::end(), _GShom::GShom, GSDD::null, GSDD::one, target, GSDD::top, and GSDD::variable().

◆ eval_skip()

GSDD _GShom::eval_skip ( const GSDD d) const
privateinherited

The procedure responsible for propagating efficiently across "skipped" variable nodes.

References GSDD::begin(), GSDD::end(), _GShom::eval(), GShom::id, _GShom::immediat(), GSDD::nbsons(), GSDD::null, GSDD::one, _GShom::skip_variable(), square_union(), GSDD::top, and GSDD::variable().

Referenced by GShom::eval().

◆ get_concret()

static const _GShom* _GShom::get_concret ( const GShom gshom)
inlinestaticinherited

◆ get_range()

virtual const GShom::range_t _GShom::get_range ( ) const
inlinevirtualinherited

The range returns the dual of skip_variable, default implem considers that all variables are affected by this homomorphism.

Reimplemented in sns::Fixpoint, sns::Compose, sns::RecFireSat, sns::Add, sns::And, sns::SNotCond, sns::SLocalApply, and sns::LocalApply.

References GShom::full_range.

Referenced by GShom::get_range().

◆ has_image()

GSDD _GShom::has_image ( const GSDD d) const
virtualinherited

◆ has_image_skip()

GSDD _GShom::has_image_skip ( const GSDD d) const
inherited

◆ hash()

size_t sns::SDomExtract::hash ( ) const
inlinevirtual

Hash key computation.

It is essential for good hash table operation that the spread of the keys be as good as possible. Also, fast hash key computation is a good design goal. Note that bad hash functions will yield more collisions, thus equality comparisons which may be quite costly.

Implements _GShom.

References target.

◆ immediat()

virtual bool _GShom::immediat ( ) const
inlineprivatevirtualinherited

For operation cache management.

If immediat==true, eval is called without attempting a cache hit. Currently only the constant homomorphism has this attribute set to true. Overload and return true for immediate computations.

Reimplemented in sns::Constant, and sns::Identity.

Referenced by _GShom::eval_skip(), and GShom::operator()().

◆ invert()

virtual GShom _GShom::invert ( const GSDD ) const
inlinevirtualinherited

◆ is_marked()

bool _GShom::is_marked ( ) const
inlineinherited

References _GShom::_refCounter.

Referenced by _GShom::set_mark().

◆ is_selector()

bool sns::SDomExtract::is_selector ( ) const
inlinevirtual

The isSelector predicate indicates a homomorphism that only selects paths in the SDD (no modifications, no additions) Tagging with isSelector() allows to enable optimizations and makes the homomorphism eligible as "condition" in ITE construct.

Reimplemented from _GShom.

◆ mark()

virtual void _GShom::mark ( ) const
inlinevirtualinherited

◆ mark_if_refd()

void _GShom::mark_if_refd ( ) const
inlineinherited

◆ operator==()

bool sns::SDomExtract::operator== ( const _GShom h) const
inlinevirtual

Comparator.

Used in case of hash collision. Should be appropriately defined in derived classes, in particular in user defined homomorphisms.

Implements _GShom.

References target.

◆ print()

void sns::SDomExtract::print ( std::ostream &  os) const
inlinevirtual

Implements _GShom.

References target.

◆ ref()

void _GShom::ref ( ) const
inlineinherited

References _GShom::_refCounter.

Referenced by Shom::operator=(), and Shom::Shom().

◆ refCounter()

unsigned long int _GShom::refCounter ( ) const
inlineinherited

◆ set_mark()

void _GShom::set_mark ( bool  val) const
inlineinherited

◆ skip_variable()

bool sns::SDomExtract::skip_variable ( int  ) const
inlinevirtual

The skip_variable predicate indicates which variables are "don't care" with respect to this SHom.

This is defined as a StrongHom with : phi(var,val) { if ( skip_variable(var) ) return GShom( var, val, this ); else { real behavior } }

Reimplemented from _GShom.

Member Data Documentation

◆ _refCounter

int _GShom::_refCounter
mutableprivateinherited

For garbage collection.

Counts the number of times a _GShom is referenced from the context of an Shom. For garbage collection: lowest bit of refCounter gives marking value for mark&sweep. Used in the two phase garbage collection process. A Shom that is not marked after the first pass over the unicity table, will be sweeped in the second phase. Outside of garbage collection routine, marking should always bear the value false.

Referenced by _GShom::deref(), _GShom::is_marked(), _GShom::ref(), _GShom::refCounter(), and _GShom::set_mark().

◆ target

int sns::SDomExtract::target

Referenced by eval(), hash(), operator==(), and print().


The documentation for this class was generated from the following file:

Please comment this page and report errors about it on the RefDocComments page.
Generated on Thu Apr 25 2024 10:15:16 for DDD by doxygen 1.9.1