oracular (3) RDF::Closure::Model.3pm.gz

Provided by: librdf-closure-perl_0.001-5_all bug

NAME
       RDF::Closure::Model - RDF::Trine::Model-compatible inferface


DESCRIPTION
       This module provides a subclass of RDF::Trine::Model allowing you to dollop some reasoning into existing
       RDF::Trine code very easily. While RDF::Closure::Engine allows you to infer lots of new statements from
       an existing model, this class also allows you to add and remove statements from the reasoned model with
       new inferences calculated on-the-fly.

       Removing a statement is much slower than adding one, though adding a statement isn't what you'd call
       fast. Juditious use of "begin_bulk_ops" and "end_bulk_ops" is recomnmended.

       If a lot of statements have been added and removed from a model since it was created, then it's
       theoretically possible for the inferred data to contain statements which are no longer entailed by the
       explicit data, or for the inferred data to be missing some inferences. A "recalculate" method is provided
       which allows you to re-run the inference from scratch.

   Constructor
       •   "new($input, [, engine => $engine ] [, store => $store ])"

           Instantiates a module. $input may be undef, an existing RDF::Trine::Model or an RDF::Trine::Store.
           The input will not be modified.

           $engine is the inference engine to use; a string suitable for passing to "RDF::Closure::Engine->new";
           defaults to 'RDFS'.

           $store is an RDF::Trine::Store to use to build the inferred model in; defaults to a new, temporary
           store.

   Methods
       This package inherits from RDF::Trine::Model and provides all the methods it does. It additionally
       provides:

       •   "entailment_regime"

           Returns a URI string identifying the type of inference in use.

       •   "recalculate"

           Drops and re-infers all inferred data.


SEE ALSO
       RDF::Closure, RDF::Closure::Engine, RDF::Trine::Model.

       Take careful note of the "begin_bulk_ops" and "end_bulk_ops" methods present in RDF::Trine::Model.
       Judicious use of them can seriously speed up this module.

       <http://www.perlrdf.org/>.


AUTHOR
       Toby Inkster <tobyink@cpan.org>.


       Copyright 2011-2012 Toby Inkster

       This library is free software; you can redistribute it and/or modify it under any of the following
       licences:

       •   The Artistic License 1.0 <http://www.perlfoundation.org/artistic_license_1_0>.

       •   The GNU General Public License Version 1 <http://www.gnu.org/licenses/old-licenses/gpl-1.0.txt>, or
           (at your option) any later version.

       •   The W3C Software Notice and License
           <http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231>.

       •   The Clarified Artistic License <http://www.ncftp.com/ncftp/doc/LICENSE.txt>.


DISCLAIMER OF WARRANTIES
       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
       LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.