![]() |
ProvSQL C/C++ API
Adding support for provenance and uncertainty management to PostgreSQL databases
|
The min-cost-paths semiring over tropical_paths_t.
More...
#include "TropicalPaths.h"


Public Member Functions | |
| virtual value_type | zero () const override |
| Return the additive identity \(\mathbb{0}\). | |
| virtual value_type | one () const override |
| Return the multiplicative identity \(\mathbb{1}\). | |
| virtual value_type | plus (const std::vector< value_type > &v) const override |
| Apply the additive operation to a list of values. | |
| virtual value_type | times (const std::vector< value_type > &v) const override |
| Apply the multiplicative operation to a list of values. | |
| virtual value_type | monus (value_type, value_type) const override |
| Apply the monus (m-semiring difference) operation. | |
| virtual value_type | delta (value_type x) const override |
| Apply the \(\delta\) operator. | |
| virtual bool | idempotent () const override |
| A tie keeps the union of the derivations, itself idempotent. | |
| virtual bool | commutative () const override |
| Concatenation does not commute. | |
| virtual bool | has_star () const override |
| Every value of nonnegative cost has a star. | |
| virtual value_type | star (const value_type &a) const override |
\(a^*\), the sum of the powers of a. | |
| virtual bool | exact_equality () const override |
| Equality of the derivations is syntactic. | |
| Public Member Functions inherited from semiring::Semiring< tropical_paths_t > | |
| virtual value_type | plus_of (const std::vector< const value_type * > &v) const |
plus over the values v points to, read in place. | |
| virtual value_type | times_of (const std::vector< const value_type * > &v) const |
times over the values v points to, read in place (see plus_of). | |
| virtual value_type | cmp (value_type s1, ComparisonOperator op, value_type s2) const |
| Evaluate a comparison gate. | |
| virtual value_type | semimod (value_type x, value_type s) const |
| Apply a semimodule scalar multiplication. | |
| virtual value_type | agg (AggregationOperator op, const std::vector< value_type > &s) |
| Evaluate an aggregation gate. | |
| virtual value_type | value (const std::string &s) const |
| Interpret a literal string as a semiring value. | |
| virtual value_type | unmapped_input (const std::string &uuid) const |
Value of a variable leaf (gate_input / gate_mulinput) that the provenance mapping does not name. | |
| virtual value_type | rv (const std::string &spec, const std::vector< value_type > ¶ms) const |
Evaluate a continuous random-variable leaf (gate_rv). | |
| virtual value_type | arith (ArithmeticOperator op, const std::vector< value_type > &children, const std::string &extra) const |
Evaluate an arithmetic gate over scalar children (gate_arith). | |
| virtual value_type | mixture (value_type p, value_type x, value_type y) const |
Evaluate a Bernoulli mixture (gate_mixture, three wires). | |
| virtual value_type | categorical (value_type key, const std::vector< double > &probs, const std::vector< std::string > &outcomes) const |
Evaluate a categorical mixture (gate_mixture over gate_mulinput outcomes). | |
| virtual value_type | guarded_case (const std::vector< value_type > &children) const |
Evaluate a guarded selection (gate_case). | |
| virtual value_type | observe (value_type child, const std::string &datum) const |
Evaluate a latent-variable observation (gate_observe). | |
| virtual value_type | conditioned (const std::vector< value_type > &children) const |
Evaluate a conditioning marker (gate_conditioned). | |
| virtual | ~Semiring ()=default |
| virtual bool | absorptive () const |
Return true if this semiring is absorptive ( \(\mathbb{1} \oplus a = \mathbb{1}\) for all \(a\)). | |
| virtual bool | selective () const |
Return true if \(\oplus\) is selective (for all \(a, b\), \(a \oplus b \in \{a, b\}\)). | |
| virtual bool | symbolic () const |
Return true if the semiring can name an unknown and record an equation over it (symbolic_unknown, define). | |
| virtual value_type | symbolic_unknown (std::size_t position) const |
| A fresh unknown, as a value. | |
| virtual void | define (const value_type &unknown, const value_type &rhs) const |
Record the equation unknown = rhs. | |
| virtual bool | equal (const value_type &a, const value_type &b) const |
| Equality of the semiring elements two values denote. | |
| virtual bool | exclusive () const |
Return true if the semiring is exclusive: \(a \otimes (\mathbb{1} \ominus a) = \mathbb{0}\). | |
| virtual bool | mul_idempotent () const |
Return true if \(\otimes\) is idempotent: \(a \otimes a = a\). | |
| bool | product_is_joint () const |
| Whether the product of the predicate provenances of two conditions over one family of occurrences is the provenance of their conjunction (and their sum that of their disjunction). | |
| virtual bool | mul_sub_left_distributive () const |
Return true if \(\otimes\) distributes over the monus on the left: \(a \otimes (b \ominus c) = (a \otimes b) \ominus
(a \otimes c)\) for all \(a, b, c\). | |
| virtual bool | compatibleWithBooleanRewrite () const |
Return true if a semiring homomorphism BoolFunc(X) →+* S exists, so the safe-query (Boolean-rewrite) optimisation produces circuits that are semantically faithful when evaluated under this semiring. | |
| virtual bool | certifying () const |
| Whether this semiring builds certified exclusive enumerations (see the three hooks below). | |
| virtual bool | independent_literal (const value_type &) const |
Whether v is an independent literal for certification purposes: a base Bernoulli variable (or a constant), so that distinct literals have disjoint supports and an AND over them is decomposable. | |
| virtual value_type | certified_world_term (const std::vector< value_type > &, const std::vector< value_type > &) const |
Build one complete world term: the conjunction of the present literals and the negations of the missing literals, certified decomposable. | |
| virtual value_type | certified_exclusive_plus (const std::vector< value_type > &) const |
Build the disjunction of pairwise-exclusive disjuncts, certified deterministic. | |
Additional Inherited Members | |
| Public Types inherited from semiring::Semiring< tropical_paths_t > | |
| typedef tropical_paths_t | value_type |
| The carrier type of this semiring. | |
The min-cost-paths semiring over tropical_paths_t.
Its leaves combine two mappings, costs and labels (see sr_tropical_paths), so they are built by the caller rather than parsed from one mapping value.
Definition at line 67 of file TropicalPaths.h.
|
inlineoverridevirtual |
Concatenation does not commute.
Reimplemented from semiring::Semiring< tropical_paths_t >.
Definition at line 119 of file TropicalPaths.h.
|
inlineoverridevirtual |
Apply the \(\delta\) operator.
| x | Input value. |
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 111 of file TropicalPaths.h.

|
inlineoverridevirtual |
Equality of the derivations is syntactic.
Reimplemented from semiring::Semiring< tropical_paths_t >.
Definition at line 137 of file TropicalPaths.h.
|
inlineoverridevirtual |
Every value of nonnegative cost has a star.
Reimplemented from semiring::Semiring< tropical_paths_t >.
Definition at line 123 of file TropicalPaths.h.
|
inlineoverridevirtual |
A tie keeps the union of the derivations, itself idempotent.
Reimplemented from semiring::Semiring< tropical_paths_t >.
Definition at line 115 of file TropicalPaths.h.
|
inlineoverridevirtual |
Apply the monus (m-semiring difference) operation.
| x | Minuend. |
| y | Subtrahend. |
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 102 of file TropicalPaths.h.
|
inlineoverridevirtual |
Return the multiplicative identity \(\mathbb{1}\).
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 73 of file TropicalPaths.h.


|
inlineoverridevirtual |
Apply the additive operation to a list of values.
| v | Ordered list of operands (empty list should return zero()). |
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 76 of file TropicalPaths.h.

|
inlineoverridevirtual |
\(a^*\), the sum of the powers of a.
By default, iterates \(s \leftarrow \mathbb{1} \oplus a \otimes s\) from \(\mathbb{1}\) until it stops changing, which an idempotent semiring with finitely many partial sums ensures.
Reimplemented from semiring::Semiring< tropical_paths_t >.
Definition at line 126 of file TropicalPaths.h.

|
inlineoverridevirtual |
Apply the multiplicative operation to a list of values.
| v | Ordered list of operands (empty list should return one()). |
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 90 of file TropicalPaths.h.

|
inlineoverridevirtual |
Return the additive identity \(\mathbb{0}\).
Implements semiring::Semiring< tropical_paths_t >.
Definition at line 70 of file TropicalPaths.h.
