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

       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 <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
           <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.