Class: RDF::N3::Algebra::Log::Implies
 Inherits:

SPARQL::Algebra::Operator::Binary
 Object
 SPARQL::Algebra::Operator
 SPARQL::Algebra::Operator::Binary
 RDF::N3::Algebra::Log::Implies
 Includes:
 Builtin, SPARQL::Algebra::Query, SPARQL::Algebra::Update
 Defined in:
 vendor/bundler/ruby/3.2.0/bundler/gems/rdfn32b45a55b147e/lib/rdf/n3/algebra/log/implies.rb
Overview
Logical implication.
This is the relation between the antecedent (subject) and conclusion (object) of a rule. The application of a rule to a knowledgebase is as follows. For every substitution which, applied to the antecedent, gives a formula which is a subset of the knowledgebase, then the result of applying that same substitution to the conclusion may be added to the knowledgebase.
related: See log:conclusion.
Constant Summary collapse
Constants included from Util::Logger
Constants inherited from SPARQL::Algebra::Operator::Binary
SPARQL::Algebra::Operator::Binary::ARITY
Constants inherited from SPARQL::Algebra::Operator
SPARQL::Algebra::Operator::ARITY, SPARQL::Algebra::Operator::IsURI
Constants included from SPARQL::Algebra::Expression
SPARQL::Algebra::Expression::PATTERN_PARENTS
Instance Attribute Summary
Attributes included from Enumerable
Attributes included from SPARQL::Algebra::Query
Attributes inherited from SPARQL::Algebra::Operator
Instance Method Summary collapse

#clear_solutions ⇒ Object
Clear out any cached solutions.

#each(solutions: RDF::Query::Solutions()) {statement ... } ⇒ Object
Yields statements from the object based on solutions determined from the subject.

#execute(queryable, solutions:, **options) ⇒ RDF::Solutions
Returns solutions from subject.

#graph_name ⇒ RDF::Resource
Graph name associated with this operation, using the name of the parent.
Methods included from Builtin
#evaluate, #hash, #input_operand, #rank, #to_uri
Methods included from Util::Logger
#log_debug, #log_depth, #log_error, #log_fatal, #log_info, #log_recover, #log_recovering?, #log_statistics, #log_warn, #logger
Methods included from Enumerable
add_entailment, #canonicalize, #canonicalize!, #dump, #each_graph, #each_object, #each_predicate, #each_quad, #each_statement, #each_subject, #each_term, #each_triple, #entail, #enum_graph, #enum_object, #enum_predicate, #enum_quad, #enum_statement, #enum_subject, #enum_term, #enum_triple, #graph?, #graph_names, #invalid?, #method_missing, #object?, #objects, #predicate?, #predicates, #project_graph, #quad?, #quads, #respond_to_missing?, #statement?, #statements, #subject?, #subjects, #supports?, #term?, #terms, #to_a, #to_h, #to_set, #triple?, #triples, #valid?, #validate!
Methods included from Util::Aliasing::LateBound
Methods included from Isomorphic
#bijection_to, #isomorphic_with?
Methods included from Countable
Methods included from SPARQL::Algebra::Update
#graph_name=, #unshift, #variables
Methods included from SPARQL::Algebra::Query
#each_solution, #empty?, #failed?, #graph_name=, #matched?, #query_yields_boolean?, #query_yields_solutions?, #query_yields_statements?, #unshift, #variables
Methods inherited from SPARQL::Algebra::Operator::Binary
Methods inherited from SPARQL::Algebra::Operator
#aggregate?, arity, base_uri, #base_uri, base_uri=, #bind, #boolean, #constant?, #deep_dup, #each_descendant, #eql?, #evaluatable?, evaluate, #executable?, #first_ancestor, for, #formulae, #initialize, #inspect, #ndvars, #node?, #operand, #optimize, #optimize!, #parent, #parent=, prefixes, #prefixes, prefixes=, #rewrite, #to_binary, #to_sparql, to_sparql, #to_sxp, #to_sxp_bin, #validate!, #variable?, #variables, #vars
Methods included from SPARQL::Algebra::Expression
cast, #constant?, #evaluate, extension, extension?, extensions, for, #invalid?, new, #node?, open, #optimize, #optimize!, parse, register_extension, #to_sxp_bin, #valid?, #validate!, #variable?
Constructor Details
This class inherits a constructor from SPARQL::Algebra::Operator::Binary
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class RDF::Enumerable
Instance Method Details
#clear_solutions ⇒ Object
Clear out any cached solutions. This principaly is for log:conclusions
63 64 65 66 
# File 'vendor/bundler/ruby/3.2.0/bundler/gems/rdfn32b45a55b147e/lib/rdf/n3/algebra/log/implies.rb', line 63 def clear_solutions super @solutions = nil end 
#each(solutions: RDF::Query::Solutions()) {statement ... } ⇒ Object
Yields statements from the object based on solutions determined from the subject. Each solution formed by querying queryable
from the subject is used to create a graph, which must be a subgraph of queryable
. If so, that solution is used to generate triples from the object formula which are yielded.
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 
# File 'vendor/bundler/ruby/3.2.0/bundler/gems/rdfn32b45a55b147e/lib/rdf/n3/algebra/log/implies.rb', line 75 def each(solutions: RDF::Query::Solutions(), &block) # Merge solutions in with those for the evaluation of this implication # Clear out solutions so they don't get remembered erroneously. solutions, @solutions = Array(@solutions), nil log_depth do super(solutions: RDF::Query::Solutions(RDF::Query::Solution.new), &block) solutions.each do solution log_info("(logImplies each) solution") {SXP::Generator.string solution.to_sxp_bin} object = operand(1).evaluate(solution.bindings, formulae: formulae) log_info("(logImplies each) object") {SXP::Generator.string object.to_sxp_bin} # Yield inferred statements log_depth do object.each(solutions: RDF::Query::Solutions(solution)) do statement log_debug(("(logImplies each) infer\s")) {statement.to_sxp} block.call(RDF::Statement.from(statement.to_quad, inferred: true)) end end end end end 
#execute(queryable, solutions:, **options) ⇒ RDF::Solutions
Returns solutions from subject. Solutions are created by evaluating subject against queryable
.
Solutions are kept within this instance, and used for conclusions. Note that the evaluated solutions do not affect that of the invoking formula, as the solution spaces are disjoint.
28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 
# File 'vendor/bundler/ruby/3.2.0/bundler/gems/rdfn32b45a55b147e/lib/rdf/n3/algebra/log/implies.rb', line 28 def execute(queryable, solutions:, **) @queryable = queryable @solutions = RDF::Query::Solutions(solutions.map do solution log_debug(NAME, "solution") {SXP::Generator.string(solution.to_sxp_bin)} subject = operand(0).evaluate(solution.bindings, formulae: formulae) object = operand(1).evaluate(solution.bindings, formulae: formulae) log_info(NAME, "subject") {SXP::Generator.string(subject.to_sxp_bin)} log_info(NAME, "object") {SXP::Generator.string(object.to_sxp_bin)} # Nothing to do if variables aren't resolved. next unless subject && object solns = log_depth {subject.execute(queryable, solutions: RDF::Query::Solutions(solution), **)} # Execute object as well (typically used for log:outputString) solns.each do soln log_depth {object.execute(queryable, solutions: RDF::Query::Solutions(soln), **)} end # filter solutions where not all variables in antecedant are bound. vars = subject.universal_vars solns = RDF::Query::Solutions(solns.to_a.select do soln vars.all? {v soln.bound?(v)} end) solns end.flatten.compact.uniq) log_info(NAME) {SXP::Generator.string(@solutions.to_sxp_bin)} # Return original solutions, without bindings solutions end 
#graph_name ⇒ RDF::Resource
Graph name associated with this operation, using the name of the parent
100 
# File 'vendor/bundler/ruby/3.2.0/bundler/gems/rdfn32b45a55b147e/lib/rdf/n3/algebra/log/implies.rb', line 100 def graph_name; parent.graph_name; end 