RDF::Trine::Pattern(3pm)

NAME
RDF::Trine::Pattern - Class for basic graph patterns

VERSION
This document describes RDF::Trine::Pattern version 1.019

METHODS

"new ( @triples )"
    Returns a new BasicGraphPattern structure.

"construct_args"
    Returns a list of arguments that, passed to this class' constructor, will produce a clone of this algebra pattern.

"triples"
    Returns a list of triples belonging to this BGP.

"type"
"sse"
    Returns the SSE string for this algebra expression.

"referenced_variables"
    Returns a list of the variable names used in this algebra expression.

"definite_variables"
    Returns a list of the variable names that will be bound after evaluating this algebra expression.

"clone"
"bind_variables ( \%bound )"
    Returns a new pattern with variables named in %bound replaced by their corresponding bound values.

"subsumes ( $statement )"
    Returns true if the pattern will subsume the $statement when matched against a triple store.

"merge_patterns ( @patterns )"
    Given an array of patterns, this will merge them into one.

"sort_for_join_variables"
    Returns a new pattern object with the subpatterns of the referrant sorted based on heuristics that ensure firstly that patterns can be joined on the same variable and secondly on the usual selectivity (i.e. how quickly the engine can drill down to the answer) of triple patterns. Calls "subgroup", "sort_triples" and "merge_patterns" in that order.

"subgroup"
    Splits the pattern object up in an array of pattern objects where the same triple patterns occur. It will group on common variables, so that triple patterns can be joined together is in a group together. It will also group triples that have no connection to other triples in a group. It will then order the groups, first by number triples with common variables, then by number of literals, then by the total number of terms that are not variables.

"sort_triples"
    Will sort the triple patterns based on heuristics that looks at how many variables the patterns have, and where they occur, see REFERENCES for details. Returns a new sorted pattern object.

BUGS
Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.

REFERENCES
The heuristics to order triple patterns in this module is strongly influenced by The ICS-FORTH Heuristics-based SPARQL Planner (HSP) <http://www.ics.forth.gr/isl/index_main.php?l=e&c=645>.

AUTHOR
Gregory Todd Williams "<gwilliams@cpan.org>"

Kjetil Kjernsmo "<kjetilk@cpan.org>"

COPYRIGHT
Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.