1048 lines
		
	
	
		
			48 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			1048 lines
		
	
	
		
			48 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  
 | ||
|   "http://www.w3.org/TR/html4/loose.dtd">  
 | ||
| <html > 
 | ||
| <head><title>cplint Version beta2.0 Manual</title> 
 | ||
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 
 | ||
| <meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> 
 | ||
| <meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)"> 
 | ||
| <!-- html --> 
 | ||
| <meta name="src" content="manual.tex"> 
 | ||
| <meta name="date" content="2008-06-19 23:25:00"> 
 | ||
| <link rel="stylesheet" type="text/css" href="manual.css"> 
 | ||
| </head><body 
 | ||
| >
 | ||
|    <div class="maketitle">
 | ||
| 
 | ||
| 
 | ||
| 
 | ||
| <h2 class="titleHead">cplint Version beta2.0 Manual</h2>
 | ||
|     <div class="author" ><span 
 | ||
| class="cmr-12">Fabrizio Riguzzi</span>
 | ||
| <br /><span 
 | ||
| class="cmr-12">fabrizio.riguzzi@unife.it</span></div>
 | ||
| <br />
 | ||
| <div class="date" ><span 
 | ||
| class="cmr-12">June 19, 2008</span></div>
 | ||
|    </div>
 | ||
|    <h3 class="sectionHead"><span class="titlemark">1   </span> <a 
 | ||
|  id="x1-10001"></a>Introduction</h3>
 | ||
| <!--l. 30--><p class="noindent"><span 
 | ||
| class="cmtt-10">cplint </span>is a suite of programs for reasoning with LPADs <span class="cite">[<a 
 | ||
| href="#XVenVer03-TR">11</a>, <a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span> and CP-logic
 | ||
| programs <span class="cite">[<a 
 | ||
| href="#XVenDenBru-JELIA06">10</a>, <a 
 | ||
| href="#XCP-logic-unp">13</a>]</span>.
 | ||
| <!--l. 32--><p class="indent">   It consists of three Prolog modules for answering queries using goal-oriented
 | ||
| procedures plus three Prolog modules for answering queries using the definition of the
 | ||
| semantics of LPADs and CP-logic.
 | ||
| <!--l. 36--><p class="indent">   The modules for answering queries using using goal-oriented procedures are
 | ||
| <span 
 | ||
| class="cmtt-10">lpadsld.pl</span>, <span 
 | ||
| class="cmtt-10">lpad.pl </span>and <span 
 | ||
| class="cmtt-10">cpl.pl</span>:
 | ||
|      <ul class="itemize1">
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">lpadsld.pl</span>:  computes  the  probability  of  a  query  using  the  top-down
 | ||
|      procedure described in in <span class="cite">[<a 
 | ||
| href="#XRig-AIIA07-IC">7</a>]</span> and <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span>. It is based on SLDNF resolution and
 | ||
|      is an adaptation of the interpreter for ProbLog <span class="cite">[<a 
 | ||
| href="#XDBLP:conf/ijcai/RaedtKT07">4</a>]</span>.
 | ||
|      <!--l. 42--><p class="noindent">It was proved correct <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span> with respect to the semantics of LPADs for range
 | ||
|      restricted acyclic programs <span class="cite">[<a 
 | ||
| href="#XDBLP:journals/ngc/AptB91">1</a>]</span> without function symbols.
 | ||
|      <!--l. 44--><p class="noindent">It is also able to deal with extensions of LPADs and CP-logic: the clause
 | ||
|      bodies can contain <span 
 | ||
| class="cmtt-10">setof </span>and <span 
 | ||
| class="cmtt-10">bagof</span>, the probabilities in the head may
 | ||
|      be depend on variables in the body and it is possible to specify a uniform
 | ||
|      distribution in the head with reference to a <span 
 | ||
| class="cmtt-10">setof </span>or <span 
 | ||
| class="cmtt-10">bagof </span>operator.
 | ||
|      These  extended  features  have  been  introduced  in  order  to  represent
 | ||
|      CLP(BN) <span class="cite">[<a 
 | ||
| href="#XSanPagQaz03-UAI-IC">9</a>]</span> programs and PRM models <span class="cite">[<a 
 | ||
| href="#XGetoor+al:JMLR02">6</a>]</span>: <span 
 | ||
| class="cmtt-10">setof </span>and <span 
 | ||
| class="cmtt-10">bagof </span>allow to
 | ||
|      express dependency of an attribute from an aggregate function of another
 | ||
|      attribute, as in CLP(BN) and PRM, while the possibility of specifying a
 | ||
|      uniform distribution allows the use of the reference uncertainty feature of
 | ||
|      PRM.
 | ||
| 
 | ||
|      </li>
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">lpad.pl</span>: computes the probability of a query using a top-down procedure
 | ||
|      based on SLG resolution <span class="cite">[<a 
 | ||
| href="#XDBLP:journals/jacm/ChenW96">3</a>]</span>. As a consequence, it works for any sound
 | ||
|      LPADs, i.e., any LPAD such that each of its instances has a two valued
 | ||
|      well founded model.
 | ||
|      </li>
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">cpl.pl</span>: computes the probability of a query using a top-down procedure
 | ||
|      based on SLG resolution and moreover checks that the CP-logic program
 | ||
|      is valid, i.e., that it has at least an execution model.</li></ul>
 | ||
| <!--l. 50--><p class="indent">   The modules for answering queries using the definition of the semantics of LPADs
 | ||
| and CP-logic are <span 
 | ||
| class="cmtt-10">semlpadsld.pl</span>, <span 
 | ||
| class="cmtt-10">semlpad.pl </span>and <span 
 | ||
| class="cmtt-10">semcpl.pl</span>:
 | ||
|      <ul class="itemize1">
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">semlpadsld.pl</span>: given an LPAD <span 
 | ||
| class="cmmi-10">P</span>, it generates all the instances of <span 
 | ||
| class="cmmi-10">P</span>.
 | ||
|      The probability of a query <span 
 | ||
| class="cmmi-10">Q </span>is computed by identifying all the instances
 | ||
|      where <span 
 | ||
| class="cmmi-10">Q </span>is derivable by SLDNF resolution.
 | ||
|      </li>
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">semlpad.pl</span>: given an LPAD <span 
 | ||
| class="cmmi-10">P</span>, it generates all the instances of <span 
 | ||
| class="cmmi-10">P</span>. The
 | ||
|      probability of a query <span 
 | ||
| class="cmmi-10">Q </span>is computed by identifying all the instances where
 | ||
|      <span 
 | ||
| class="cmmi-10">Q </span>is derivable by SLG resolution.
 | ||
|      </li>
 | ||
|      <li class="itemize"><span 
 | ||
| class="cmtt-10">semlcpl.pl</span>: given an LPAD <span 
 | ||
| class="cmmi-10">P</span>, it builds an execution model of <span 
 | ||
| class="cmmi-10">P</span>, i.e.,
 | ||
|      a probabilistic process that satisfy the principles of universal causation,
 | ||
|      sufficient causation, independent causation, no deus ex machina events
 | ||
|      and temporal precedence. It uses the definition of the semantics given in
 | ||
|      <span class="cite">[<a 
 | ||
| href="#XCP-logic-unp">13</a>]</span>.</li></ul>
 | ||
| <!--l. 59--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">2   </span> <a 
 | ||
|  id="x1-20002"></a>Installation</h3>
 | ||
| <!--l. 60--><p class="noindent"><span 
 | ||
| class="cmtt-10">cplint </span>is distributed in source code in the CVS version of Yap. It
 | ||
| includes Prolog and C files. Download it by following the instruction in <a 
 | ||
| href="http://www.ncc.up.pt/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}vsc/Yap/downloads.html" >
 | ||
| http://www.ncc.up.pt/<span 
 | ||
| class="cmsy-10">~</span>vsc/Yap/downloads.html </a>.
 | ||
| <!--l. 62--><p class="indent">   <span 
 | ||
| class="cmtt-10">cplint </span>requires glu (a subpackage of vis) and glib-2.0. You can download glu
 | ||
| from <a 
 | ||
| href="http://vlsi.colorado.edu/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}vis/getting_VIS_2.1.html" > http://vlsi.colorado.edu/<span 
 | ||
| class="cmsy-10">~</span>vis/getting_VIS_2.1.html </a> You can download
 | ||
| glib-2.0 (version <span 
 | ||
| class="cmsy-10">≥ </span>2<span 
 | ||
| class="cmmi-10">.</span>0) from <a 
 | ||
| href="http://www.gtk.org/" > http://www.gtk.org/ </a>. This is a standard GNU package
 | ||
| so it is easy to install it using the package management software of your Linux or
 | ||
| Cygwin distribution.
 | ||
| <!--l. 68--><p class="indent">   Install glu:
 | ||
|      <ol  class="enumerate1" >
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2002x1"></a>downlad <span 
 | ||
| class="cmtt-10">glu-2.1.tar.gz</span>
 | ||
| 
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2004x2"></a>decompress it
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2006x3"></a><span 
 | ||
| class="cmtt-10">cd glu-2.1</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2008x4"></a><span 
 | ||
| class="cmtt-10">mkdir arch</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2010x5"></a><span 
 | ||
| class="cmtt-10">cd arch</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2012x6"></a><span 
 | ||
| class="cmtt-10">../configure</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2014x7"></a><span 
 | ||
| class="cmtt-10">make</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2016x8"></a><span 
 | ||
| class="cmtt-10">su</span>
 | ||
|      </li>
 | ||
|      <li class="enumerate"><a 
 | ||
|  id="x1-2018x9"></a><span 
 | ||
| class="cmtt-10">make install</span></li></ol>
 | ||
| <!--l. 80--><p class="noindent">This will install glu into <span 
 | ||
| class="cmtt-10">/usr/local</span>, if you want to install to a different <span 
 | ||
| class="cmtt-10">DIR </span>use
 | ||
| <span 
 | ||
| class="cmtt-10">../configure --prefix DIR</span>
 | ||
| <!--l. 83--><p class="indent">   Install Yap together with <span 
 | ||
| class="cmtt-10">cplint</span>: when compiling Yap following the instuction of
 | ||
| the <span 
 | ||
| class="cmtt-10">INSTALL </span>file in the root of the Yap folder, use
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| configure --enable-cplint
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 87--><p class="nopar"> Under Windows, you have to use Cygwin (glu does not compile under MinGW),
 | ||
| so
 | ||
| <br class="newline" />
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| configure --enable-cplint --enable-cygwin
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 91--><p class="nopar"> If you installed glu in <span 
 | ||
| class="cmtt-10">DIR</span>, use <span 
 | ||
| class="cmtt-10">--enable-cplint=DIR</span>
 | ||
| <!--l. 94--><p class="indent">   After having performed <span 
 | ||
| class="cmtt-10">make install </span>you can do <span 
 | ||
| class="cmtt-10">make installcheck </span>that will
 | ||
| execute a suite of tests of the various programs. If no error is reported you have a
 | ||
| working installation of <span 
 | ||
| class="cmtt-10">cplint</span>.
 | ||
| <!--l. 97--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">3   </span> <a 
 | ||
|  id="x1-30003"></a>Syntax</h3>
 | ||
| <!--l. 99--><p class="noindent">Disjunction in the head is represented with a semicolon and atoms in the head are
 | ||
| separated from probabilities by a colon. For the rest, the usual syntax of Prolog is
 | ||
| used. For example, the CP-logic clause
 | ||
|    <center class="math-display" >
 | ||
| <img 
 | ||
| src="manual0x.png" alt="h1 : p1 ∨...∨ hn : pn ← b1,...,bm,<2C>c1,...,<2C>cl  " class="math-display" ></center> is
 | ||
| represented by
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| h1:p1 ; ... ; hn:pn :- b1,...,bm,\+ c1,....,\+ cl
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 105--><p class="nopar"> No parentheses are necessary. The <span 
 | ||
| class="cmtt-10">pi </span>are numeric expressions. It is up to the user to
 | ||
| ensure that the numeric expressions are legal, i.e. that they sum up to less than
 | ||
| one.
 | ||
| <!--l. 108--><p class="indent">   If the clause has an empty body, it can be represented like this
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| h1:p1 ; ... ;hn:pn.
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 111--><p class="nopar"> If the clause has a single head with probability 1, the annotation can be omitted and
 | ||
| the clause takes the form of a normal prolog clause, i.e.
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| h1:- b1,...,bm,\+ c1,...,\+ cl.
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 115--><p class="nopar"> stands for
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| h1:1 :- b1,...,bm,\+ c1,...,\+ cl.
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 119--><p class="nopar">
 | ||
| <!--l. 121--><p class="indent">   The coin example of <span class="cite">[<a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span> is represented as (see file <span 
 | ||
| class="cmtt-10">coin.cpl</span>)
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| heads(Coin):1/2 ; tails(Coin):1/2:-
 | ||
|  <br />     toss(Coin),\+biased(Coin).
 | ||
|  <br />
 | ||
|  <br />heads(Coin):0.6 ; tails(Coin):0.4:-
 | ||
|  <br />     toss(Coin),biased(Coin).
 | ||
|  <br />
 | ||
|  <br />fair(Coin):0.9 ; biased(Coin):0.1.
 | ||
|  <br />
 | ||
|  <br />toss(coin).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 132--><p class="nopar"> The first clause states that if we toss a coin that is not biased it has equal
 | ||
| probability of landing heads and tails. The second states that if the coin is biased it
 | ||
| has a slightly higher probability of landing heads. The third states that the coin is
 | ||
| fair with probability 0.9 and biased with probability 0.1 and the last clause states
 | ||
| that we toss a coin with certainty.
 | ||
| <!--l. 137--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">4   </span> <a 
 | ||
|  id="x1-40004"></a>Commands</h3>
 | ||
| <!--l. 138--><p class="noindent">All six modules accept the same commands for reading in files and answering queries.
 | ||
| The LPAD or CP-logic program must be stored in a text file with extension <span 
 | ||
| class="cmtt-10">.cpl</span>.
 | ||
| Suppose you have stored the example above in file <span 
 | ||
| class="cmtt-10">coin.cpl</span>. In order to answer
 | ||
| queries from this program, you have to run Yap, load one of the modules (such as for
 | ||
| example <span 
 | ||
| class="cmtt-10">lpad.pl</span>) by issuing the command
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| use_module(library(lpad)).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 144--><p class="nopar"> at the command prompt. Then you must parse the source file <span 
 | ||
| class="cmtt-10">coin.cpl </span>with the
 | ||
| command
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| p(coin).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 149--><p class="nopar"> if <span 
 | ||
| class="cmtt-10">coin.cpl </span>is in the current directory, or
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| p(’path_to_coin/coin’).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 153--><p class="nopar"> if <span 
 | ||
| class="cmtt-10">coin.cpl </span>is in a different directory. At this point you can pose query to the
 | ||
| program by using the predicate <span 
 | ||
| class="cmtt-10">s/2 </span>(for solve) that takes as its first argument a
 | ||
| conjunction of goals in the form of a list and returns the computed probability
 | ||
| as its second argument. For example, the probability of the conjunction
 | ||
| <span 
 | ||
| class="cmtt-10">head(coin),biased(coin) </span>can be asked with the query
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| s([head(coin),biased(coin)],P).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 158--><p class="nopar"> For computing the probability of a conjunction given another conjunction you can
 | ||
| use the predicate <span 
 | ||
| class="cmtt-10">sc/3 </span>(for solve conditional) that take takes as input the query
 | ||
| conjunction as its first argument, the evidence conjunction as its second argument
 | ||
| and returns the probability in its third argument. For example, the probability of the
 | ||
| query <span 
 | ||
| class="cmtt-10">heads(coin) </span>given the evidence <span 
 | ||
| class="cmtt-10">biased(coin) </span>can be asked with the
 | ||
| query
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| sc([heads(coin)],[biased(coin)],P).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 163--><p class="nopar"> After having parsed a program, in order to read in a new program you must restart
 | ||
| Yap when using <span 
 | ||
| class="cmtt-10">semlpadsld.pl </span>and <span 
 | ||
| class="cmtt-10">semlpad.pl</span>. With the other modules, you can
 | ||
| directly parse a new program.
 | ||
| <!--l. 167--><p class="indent">   When using <span 
 | ||
| class="cmtt-10">lpad.pl</span>, the system can print the message “Uunsound program” in
 | ||
| the case in which an instance with a three valued well founded model is found.
 | ||
| Moreover, it can print the message “It requires the choice of a head atom from a non
 | ||
| ground head”: in this case, in order to answer the query, all the groundings of the
 | ||
| culprit clause must be generated, which may be impossible for programs with
 | ||
| function symbols.
 | ||
| <!--l. 169--><p class="indent">   When using <span 
 | ||
| class="cmtt-10">semcpl.pl</span>, you can print the execution process by using the
 | ||
| command <span 
 | ||
| class="cmtt-10">print. </span>after <span 
 | ||
| class="cmtt-10">p(file). </span>Moreover, you can build an execution
 | ||
| process given a context by issuing the command <span 
 | ||
| class="cmtt-10">parse(file)</span>. and then
 | ||
| <span 
 | ||
| class="cmtt-10">build(context). </span>where <span 
 | ||
| class="cmtt-10">context </span>is a list of atoms that are true in the context.
 | ||
| <span 
 | ||
| class="cmtt-10">semcpl.pl </span>can print “Invalid program” in the case in which no execution process
 | ||
| exists.
 | ||
| <!--l. 174--><p class="indent">   When using <span 
 | ||
| class="cmtt-10">cpl.pl </span>you can print a partial execution model including all the
 | ||
| clauses involved in the query issued with <span 
 | ||
| class="cmtt-10">print. cpl.pl </span>can print the messages
 | ||
| “Uunsound program”, “It requires the choice of a head atom from a non ground
 | ||
| head” and “Invalid program”.
 | ||
| <!--l. 177--><p class="indent">   The modules make use of a number of parameters in order to control their
 | ||
| behavior. They that can be set with the command
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| set(parameter,value).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 180--><p class="nopar"> from the Yap prompt after having loaded the module. The current value can be read
 | ||
| with
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| setting(parameter,Value).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 185--><p class="nopar"> from the Yap prompt. The available parameters are:
 | ||
|      <ul class="itemize1">
 | ||
|      <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">epsilon_parsing</span></span></span> (valid  for  all  six  modules):  if  (1  -  the  sum  of  the
 | ||
|      probabilities of all the head atoms) is smaller than <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">epsilon_parsing</span></span></span> then
 | ||
|      <span 
 | ||
| class="cmtt-10">cplint </span>adds the null events to the head. Default value 0.00001
 | ||
|      </li>
 | ||
|      <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">save_dot</span></span></span> (valid for all goal-oriented modules): if <span 
 | ||
| class="cmtt-10">true </span>a graph representing the
 | ||
|      BDD is saved in the file <span 
 | ||
| class="cmtt-10">cpl.dot </span>in the current directory in dot format. The
 | ||
|      variables names are of the form <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">Xn_m</span></span></span> where <span 
 | ||
| class="cmtt-10">n </span>is the number of the multivalued
 | ||
|      variable and <span 
 | ||
| class="cmtt-10">m </span>is the number of the binary variable. The correspondence
 | ||
|      between variables and clauses can be evinced from the message printed on the
 | ||
|      screen, such as
 | ||
| 
 | ||
|      <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
|      Variables: [(2,[X=2,X1=1]),(2,[X=1,X1=0]),(1,[])]
 | ||
| </div>
 | ||
|      </td></tr></table>
 | ||
|      <!--l. 199--><p class="nopar"> where the first element of each couple is the clause number of the input file
 | ||
|      (starting from 1). In the example above variable <span 
 | ||
| class="cmtt-10">X0 </span>corresponds to clause <span 
 | ||
| class="cmtt-10">2</span>
 | ||
|      with the substitutions <span 
 | ||
| class="cmtt-10">X=2,X1=1</span>, variable <span 
 | ||
| class="cmtt-10">X1 </span>corresponds to clause <span 
 | ||
| class="cmtt-10">2 </span>with the
 | ||
|      substitutions <span 
 | ||
| class="cmtt-10">X=1,X1=0 </span>and variable <span 
 | ||
| class="cmtt-10">X2 </span>corresponds to clause <span 
 | ||
| class="cmtt-10">1 </span>with the empty
 | ||
|      substitution. You can view the graph with <span 
 | ||
| class="cmtt-10">graphviz </span>(<a 
 | ||
| href="www.graphviz.org" > www.graphviz.org </a>)
 | ||
|      using the command
 | ||
| 
 | ||
|      <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
|      dotty cpl.dot &
 | ||
| </div>
 | ||
|      </td></tr></table>
 | ||
|      <!--l. 208--><p class="nopar">
 | ||
|      </li>
 | ||
|      <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">ground_body</span></span></span> (valid for <span 
 | ||
| class="cmtt-10">lpadsld.pl </span>and all semantic modules): determines how
 | ||
|      non ground clauses are treated: if <span 
 | ||
| class="cmtt-10">true</span>, ground clauses are obtained from a non
 | ||
|      ground clause by replacing each variable with a constant, if <span 
 | ||
| class="cmtt-10">false</span>, ground
 | ||
|      clauses are obtained by replacing only variables in the head with a
 | ||
|      constant. In the case where the body contains variables not in the
 | ||
|      head, setting it to false means that the body represents an existential
 | ||
|      event.</li></ul>
 | ||
| <!--l. 212--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">5   </span> <a 
 | ||
|  id="x1-50005"></a>Semantic Modules</h3>
 | ||
| <!--l. 213--><p class="noindent">The three semantic modules need to produce a grounding of the program in order to
 | ||
| compute the semantics. They require an extra file with extension <span 
 | ||
| class="cmtt-10">.uni </span>(for universe)
 | ||
| in the same directory where the <span 
 | ||
| class="cmtt-10">.cpl </span>file is.
 | ||
| <!--l. 216--><p class="indent">   There are two ways to specify how to ground a program. The first consists in
 | ||
| providing the list of constants to which each variable can be instantiated. For
 | ||
| example, in our case the current directory will contain a file <span 
 | ||
| class="cmtt-10">coin.uni </span>that is a
 | ||
| Prolog file containing facts of the form
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| universe(var_list,const_list).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 219--><p class="nopar"> where <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">var_list</span></span></span> is a list of variables names (each must be included in single quotes)
 | ||
| and <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">const_list</span></span></span> is a list of constants. The semantic modules generate the grounding
 | ||
| by instantiating in all possible ways the variables of <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">var_list</span></span></span> with the constants of
 | ||
| <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">const_list</span></span></span>. Note that the variables are identified by name, so a variable with
 | ||
| the same name in two different clauses will be instantiated with the same
 | ||
| constants.
 | ||
| <!--l. 222--><p class="indent">   The other way to specify how to ground a program consists in using mode and
 | ||
| type information. For each predicate, the file <span 
 | ||
| class="cmtt-10">.uni </span>must contain a fact of the
 | ||
| form
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| mode(predicate(t1,...,tn)).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 225--><p class="nopar"> that specifies the number and types of each argument of the predicate. Then, the list
 | ||
| of constants that are in the domain of each type <span 
 | ||
| class="cmtt-10">ti </span>must be specified with a fact of
 | ||
| the form
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| type(ti,list_of_constants).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 230--><p class="nopar"> The file <span 
 | ||
| class="cmtt-10">.uni </span>can contain both universe and mode declaration, the ones to be used
 | ||
| depend on the value of the parameter <span 
 | ||
| class="cmtt-10">grounding</span>: with value <span 
 | ||
| class="cmtt-10">variables</span>, the
 | ||
| universe declarations are used, with value <span 
 | ||
| class="cmtt-10">modes </span>the mode declarations are
 | ||
| used.
 | ||
| <!--l. 233--><p class="indent">   With <span 
 | ||
| class="cmtt-10">semcpl.pl </span>only mode declarations can be used.
 | ||
| <!--l. 237--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">6   </span> <a 
 | ||
|  id="x1-60006"></a>Extensions</h3>
 | ||
| <!--l. 238--><p class="noindent">In this section we will present the extensions to the syntax of LPADs and CP-logic
 | ||
| programs that <span 
 | ||
| class="cmtt-10">cplint </span>can handle.
 | ||
| <!--l. 240--><p class="indent">   The first is the use of some standard Prolog predicates. The bodies can contain
 | ||
| the built-in predicates:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| is/2
 | ||
|  <br />>/2
 | ||
|  <br /></2
 | ||
|  <br />>=/2
 | ||
|  <br />=</2
 | ||
|  <br />=:=/2
 | ||
|  <br />=\=/2
 | ||
|  <br />true/0
 | ||
|  <br />false/0
 | ||
|  <br />=/2
 | ||
|  <br />==/2
 | ||
|  <br />\=/2
 | ||
|  <br />\==/2
 | ||
|  <br />length/2
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 257--><p class="nopar"> The bodies can also contain the following library predicates:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| member/2
 | ||
|  <br />max_list/2
 | ||
|  <br />min_list/2
 | ||
|  <br />nth0/3
 | ||
|  <br />nth/3
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 266--><p class="nopar"> plus the predicate
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| average/2
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 270--><p class="nopar"> that, given a list of numbers, computes its arithmetic mean.
 | ||
| <!--l. 273--><p class="indent">   When using <span 
 | ||
| class="cmtt-10">lpadsld.pl</span>, the bodies can contain the predicates <span 
 | ||
| class="cmtt-10">setof/3 </span>and
 | ||
| <span 
 | ||
| class="cmtt-10">bagof/3 </span>with the same meaning as in Prolog. Existential quantifiers are allowed in
 | ||
| both, so for example the query
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| setof(Z, (term(X,Y))^foo(X,Y,Z), L).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 276--><p class="nopar"> returns all the instantiations of <span 
 | ||
| class="cmtt-10">Z </span>such that there exists an instantiation of <span 
 | ||
| class="cmtt-10">X </span>and <span 
 | ||
| class="cmtt-10">Y</span>
 | ||
| for which <span 
 | ||
| class="cmtt-10">foo(X,Y,Z) </span>is true.
 | ||
| <!--l. 279--><p class="indent">   An example of the use of <span 
 | ||
| class="cmtt-10">setof </span>and <span 
 | ||
| class="cmtt-10">bagof </span>is in the file <span 
 | ||
| class="cmtt-10">female.cpl</span>:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| male(C):M/P ; female(C):F/P:-
 | ||
|  <br />    person(C),
 | ||
|  <br />    setof(Male,known_male(Male),LM),
 | ||
|  <br />    length(LM,M),
 | ||
|  <br />    setof(Female,known_female(Female),LF),
 | ||
|  <br />    length(LF,F),
 | ||
|  <br />    P is F+M.
 | ||
|  <br />
 | ||
|  <br />person(f).
 | ||
|  <br />
 | ||
|  <br />known_female(a).
 | ||
|  <br />
 | ||
|  <br />known_female(b).
 | ||
|  <br />
 | ||
|  <br />known_female(c).
 | ||
|  <br />
 | ||
|  <br />known_male(d).
 | ||
|  <br />
 | ||
|  <br />known_male(e).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 300--><p class="nopar"> The disjunctive rule expresses the probability of a person of unknown sex of being
 | ||
| male or female depending on the number of males and females that are known. This
 | ||
| is an example of the use of expressions in the probabilities in the head that depend
 | ||
| on variables in the body. The probabilities are well defined because they always sum
 | ||
| to 1 (unless <span 
 | ||
| class="cmtt-10">P </span>is 0).
 | ||
| <!--l. 304--><p class="indent">   Another use of <span 
 | ||
| class="cmtt-10">setof </span>and <span 
 | ||
| class="cmtt-10">bagof </span>is to have an attribute depend on an
 | ||
| aggregate function of another attribute, similarly to what is done in PRM and
 | ||
| CLP(BN).
 | ||
| <!--l. 306--><p class="indent">   So, in the classical school example (available in <span 
 | ||
| class="cmtt-10">student.cpl</span>) you can find the
 | ||
| following clauses:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| student_rank(S,h):0.6 ; student_rank(S,l):0.4:-
 | ||
|  <br />    bagof(G,R^(registr_stu(R,S),registr_gr(R,G)),L),
 | ||
|  <br />    average(L,Av),Av>1.5.
 | ||
|  <br />
 | ||
|  <br />student_rank(S,h):0.4 ; student_rank(S,l):0.6:-
 | ||
|  <br />    bagof(G,R^(registr_stu(R,S),registr_gr(R,G)),L),
 | ||
|  <br />    average(L,Av),Av =< 1.5.
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 316--><p class="nopar"> where <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">registr_stu(R,S)</span></span></span> expresses that registration <span 
 | ||
| class="cmtt-10">R </span>refers to student <span 
 | ||
| class="cmtt-10">S </span>and
 | ||
| <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">registr_gr(R,G)</span></span></span> expresses that registration <span 
 | ||
| class="cmtt-10">R </span>reports grade <span 
 | ||
| class="cmtt-10">G </span>which is a natural
 | ||
| number. The two clauses express a dependency of the rank of the student from the
 | ||
| average of her grades.
 | ||
| <!--l. 319--><p class="indent">   Another extension can be used with <span 
 | ||
| class="cmtt-10">lpadsld.pl </span>in order to be able to represent
 | ||
| reference uncertainty of PRMs. Reference uncertainty means that the link structure
 | ||
| of a relational model is not fixed but is uncertain: this is represented by having the
 | ||
| instance referenced in a relationship be chosen uniformly from a set. For example,
 | ||
| consider a domain modeling scientific papers: you have a single entity, paper, and a
 | ||
| relationship, cites, between paper and itself that connects the citing paper to the
 | ||
| cited paper. To represent the fact that the cited paper and the citing paper are
 | ||
| selected uniformly from certain sets, the following clauses can be used (see file
 | ||
| <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">paper_ref_simple.cpl</span></span></span>):
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| uniform(cites_cited(C,P),P,L):-
 | ||
|  <br />    bagof(Pap,paper_topic(Pap,theory),L).
 | ||
|  <br />
 | ||
|  <br />uniform(cites_citing(C,P),P,L):-
 | ||
|  <br />    bagof(Pap,paper_topic(Pap,ai),L).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 326--><p class="nopar"> The first clauses states that the paper <span 
 | ||
| class="cmtt-10">P </span>cited in a citation <span 
 | ||
| class="cmtt-10">C </span>is selected
 | ||
| uniformly from the set of all papers with topic theory. The second clauses
 | ||
| expresses that the citing paper is selected uniformly from the papers with topic
 | ||
| ai.
 | ||
| <!--l. 331--><p class="indent">   These clauses make use of the predicate
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| uniform(Atom,Variable,List)
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 334--><p class="nopar"> in the head, where <span 
 | ||
| class="cmtt-10">Atom </span>must contain <span 
 | ||
| class="cmtt-10">Variable</span>. The meaning is the following:
 | ||
| the set of all the atoms obtained by instantiating <span 
 | ||
| class="cmtt-10">Variable </span>of <span 
 | ||
| class="cmtt-10">Atom </span>with a
 | ||
| term taken from <span 
 | ||
| class="cmtt-10">List </span>is generated and the head is obtained by having a
 | ||
| disjunct for each instantiation with probability 1<span 
 | ||
| class="cmmi-10">∕N </span>where <span 
 | ||
| class="cmmi-10">N </span>is the length of
 | ||
| <span 
 | ||
| class="cmtt-10">List</span>.
 | ||
| <!--l. 338--><p class="indent">   A more elaborate example is present in file <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">paper_ref.cpl</span></span></span>:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| uniform(cites_citing(C,P),P,L):-
 | ||
|  <br />    setof(Pap,paper(Pap),L).
 | ||
|  <br />
 | ||
|  <br />cites_cited_group(C,theory):0.9 ; cites_cited_group(C,ai):0.1:-
 | ||
|  <br />    cites_citing(C,P),paper_topic(P,theory).
 | ||
|  <br />
 | ||
|  <br />cites_cited_group(C,theory):0.01;cites_cited_group(C,ai):0.99:-
 | ||
|  <br />    cites_citing(C,P),paper_topic(P,ai).
 | ||
|  <br />
 | ||
|  <br />uniform(cites_cited(C,P),P,L):-
 | ||
|  <br />    cites_cited_group(C,T),bagof(Pap,paper_topic(Pap,T),L).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 351--><p class="nopar"> where the cited paper depends on the topic of the citing paper. In particular, if the
 | ||
| topic is theory, the cited paper is selected uniformly from the papers about theory
 | ||
| with probability 0.9 and from the papers about ai with probability 0.1. if
 | ||
| the topic is ai, the cited paper is selected uniformly from the papers about
 | ||
| theory with probability 0.01 and from the papers about ai with probability
 | ||
| 0.99.
 | ||
| <!--l. 354--><p class="indent">   PRMs take into account as well existence uncertainty, where the existence of
 | ||
| instances is also probabilistic. For example, in the paper domain, the total number of
 | ||
| citations may be unknown and a citation between any two paper may have a
 | ||
| probability of existing. For example, a citation between two paper may be more
 | ||
| probable if they are about the same topic:
 | ||
| 
 | ||
|    <table 
 | ||
| class="verbatim"><tr class="verbatim"><td 
 | ||
| class="verbatim"><div class="verbatim">
 | ||
| cites(X,Y):0.005 :-
 | ||
|  <br />    paper_topic(X,theory),paper_topic(Y,theory).
 | ||
|  <br />
 | ||
|  <br />cites(X,Y):0.001 :-
 | ||
|  <br />    paper_topic(X,theory),paper_topic(Y,ai).
 | ||
|  <br />
 | ||
|  <br />cites(X,Y):0.003 :-
 | ||
|  <br />    paper_topic(X,ai),paper_topic(Y,theory).
 | ||
|  <br />
 | ||
|  <br />cites(X,Y):0.008 :-
 | ||
|  <br />    paper_topic(X,ai),paper_topic(Y,ai).
 | ||
| </div>
 | ||
| </td></tr></table>
 | ||
| <!--l. 367--><p class="nopar"> This is an example where the probabilities in the head do not sum up to one so the
 | ||
| null event is automatically added to the head. The first clause states that, if the topic
 | ||
| of a paper <span 
 | ||
| class="cmtt-10">X </span>is theory and of paper <span 
 | ||
| class="cmtt-10">Y </span>is theory, there is a probability of 0.005 that
 | ||
| there is a citation from <span 
 | ||
| class="cmtt-10">X </span>to <span 
 | ||
| class="cmtt-10">Y</span>. The other clauses consider the remaining cases for the
 | ||
| topics.
 | ||
| <!--l. 372--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">7   </span> <a 
 | ||
|  id="x1-70007"></a>Additional Files</h3>
 | ||
| <!--l. 373--><p class="noindent">In the directory where Yap keeps the library files (usually <span 
 | ||
| class="cmtt-10">/usr/local/share/ Yap</span>)
 | ||
| you can find the directory <span 
 | ||
| class="cmtt-10">cplint </span>that contains the files:
 | ||
|      <ul class="itemize1">
 | ||
|      <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">testlpadsld_gbtrue.pl,</span><span 
 | ||
| class="cmtt-10"> testlpadsld_gbfalse.pl,</span><span 
 | ||
| class="cmtt-10"> testlpad.pl,</span></span></span>
 | ||
|      <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">testcpl.pl,</span><span 
 | ||
| class="cmtt-10"> testsemlpadsld.pl,</span><span 
 | ||
| class="cmtt-10"> testsemlpad.pl</span><span 
 | ||
| class="cmtt-10"> testsemcpl.pl</span></span></span>:
 | ||
|      Prolog programs for testing the modules. They are executed when issuing
 | ||
|      the  command  <span 
 | ||
| class="cmtt-10">make installcheck </span>during  the  installation.  To  execute
 | ||
|      them afterwords, load the file and issue the command <span 
 | ||
| class="cmtt-10">t.</span>
 | ||
|      </li>
 | ||
|      <li class="itemize">Subdirectory <span 
 | ||
| class="cmtt-10">examples</span>:
 | ||
|          <ul class="itemize2">
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">alarm.cpl</span>: representation of the Bayesian network in Figure 2 of
 | ||
|          <span class="cite">[<a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">coin.cpl</span>: coin example from <span class="cite">[<a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">coin2.cpl</span>: coin example with two coins.
 | ||
| 
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">dice.cpl</span>: dice example from <span class="cite">[<a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">twosideddice.cpl,</span><span 
 | ||
| class="cmtt-10"> threesideddice.cpl</span></span></span> game with idealized dice
 | ||
|          with two or three sides. Used in the experiments in <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">ex.cpl</span>: first example in <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">exapprox.cpl</span>:  example  showing  the  problems  of  approximate
 | ||
|          inference (see <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span>).
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">exrange.cpl</span>:  example  showing  the  problems  with  non  range
 | ||
|          restricted programs (see <span class="cite">[<a 
 | ||
| href="#XRig-RCRA07-IC">8</a>]</span>).
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">female.cpl</span>: example showing the dependence of probabilities in the
 | ||
|          head from variables in the body (from <span class="cite">[<a 
 | ||
| href="#XVenVer04-ICLP04-IC">12</a>]</span>).
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">mendel.cpl, mendels.cpl</span>:  programs  describing  the  Mendelian
 | ||
|          rules of inheritance, taken from <span class="cite">[<a 
 | ||
| href="#XBlo04-ILP04WIP-IC">2</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">paper_ref.cpl,</span><span 
 | ||
| class="cmtt-10"> paper_ref_simple.cpl</span></span></span>: paper citations examples,
 | ||
|          showing reference uncertainty, inspired by <span class="cite">[<a 
 | ||
| href="#XGetoor+al:JMLR02">6</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">paper_ref_not.cpl</span></span></span>: paper citations example showing that negation
 | ||
|          can be used also for predicates defined by clauses with <span 
 | ||
| class="cmtt-10">uniform </span>in
 | ||
|          the head.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">school.cpl</span>: example inspired by the example <span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">school_32.yap</span></span></span> from
 | ||
|          the source distribution of Yap in the <span 
 | ||
| class="cmtt-10">CLPBN </span>directory.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">school_simple.cpl</span></span></span>: simplified version of <span 
 | ||
| class="cmtt-10">school.cpl</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span class="obeylines-h"><span class="verb"><span 
 | ||
| class="cmtt-10">student.cpl</span></span></span>: student example from Figure 1.3 of <span class="cite">[<a 
 | ||
| href="#XGetFri01-BC">5</a>]</span>.
 | ||
|          </li>
 | ||
|          <li class="itemize"><span 
 | ||
| class="cmtt-10">win.cpl, light.cpl, trigger.cpl, throws.cpl, hiv.cpl,</span>
 | ||
|          <br class="newline" /> <span 
 | ||
| class="cmtt-10">invalid.cpl</span>: programs taken from <span class="cite">[<a 
 | ||
| href="#XCP-logic-unp">13</a>]</span>. <span 
 | ||
| class="cmtt-10">invalid.cpl </span>is an example
 | ||
|          of a program that is invalid but sound.</li></ul>
 | ||
|      <!--l. 398--><p class="noindent">The files <span 
 | ||
| class="cmtt-10">*.uni </span>that are present for some of the examples are used by the
 | ||
|      semantical modules. Some of the example files contain in an initial comment
 | ||
|      some queries together with their result.
 | ||
|      </li>
 | ||
|      <li class="itemize">Subdirectory <span 
 | ||
| class="cmtt-10">doc</span>: contains this manual in latex, html and pdf.</li></ul>
 | ||
| 
 | ||
| <!--l. 401--><p class="noindent">
 | ||
|    <h3 class="sectionHead"><span class="titlemark">8   </span> <a 
 | ||
|  id="x1-80008"></a>License</h3>
 | ||
| <!--l. 406--><p class="noindent"><span 
 | ||
| class="cmtt-10">cplint</span>, as Yap, follows the Artistic License 2.0 that you can find in Yap CVS root
 | ||
| dir. The copyright is by Fabrizio Riguzzi.
 | ||
| <!--l. 411--><p class="indent">   The program uses the library <a 
 | ||
| href="http://vlsi.colorado.edu/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}fabio/" > CUDD </a> for manipulating BDDs that is included in
 | ||
| glu. For the use of CUDD, the following license must be accepted:
 | ||
| <!--l. 416--><p class="indent">   Copyright (c) 1995-2004, Regents of the University of Colorado
 | ||
| <!--l. 418--><p class="indent">   All rights reserved.
 | ||
| <!--l. 420--><p class="indent">   Redistribution and use in source and binary forms, with or without modification,
 | ||
| are permitted provided that the following conditions are met:
 | ||
|      <ul class="itemize1">
 | ||
|      <li class="itemize">Redistributions of source code must retain the above copyright notice, this
 | ||
|      list of conditions and the following disclaimer.
 | ||
|      </li>
 | ||
|      <li class="itemize">Redistributions in binary form must reproduce the above copyright notice,
 | ||
|      this list of conditions and the following disclaimer in the documentation
 | ||
|      and/or other materials provided with the distribution.
 | ||
|      </li>
 | ||
|      <li class="itemize">Neither  the  name  of  the  University  of  Colorado  nor  the  names  of  its
 | ||
|      contributors may be used to endorse or promote products derived from
 | ||
|      this software without specific prior written permission.</li></ul>
 | ||
| <!--l. 437--><p class="noindent">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
 | ||
| <br class="newline" />AND CONTRIBUTORS ”AS IS” AND ANY EXPRESS OR IMPLIED
 | ||
| WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 | ||
| WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 | ||
| PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 | ||
| OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 | ||
| INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 | ||
| (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
 | ||
| GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 | ||
| INTERRUPTION) HOWEVER CAU-SED
 | ||
| <br class="newline" />AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 | ||
| LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 | ||
| ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 | ||
| ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 | ||
| <!--l. 451--><p class="indent">   <span 
 | ||
| class="cmtt-10">lpad.pl</span>, <span 
 | ||
| class="cmtt-10">semlpad.pl </span>and <span 
 | ||
| class="cmtt-10">cpl.pl </span>are based on the SLG system by <a 
 | ||
| href="http://engr.smu.edu/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}wchen/" > Weidong
 | ||
| Chen </a> and <a 
 | ||
| href="http://www.cs.sunysb.edu/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}warren/" > David Scott Warren </a>, Copyright (C) 1993 Southern Methodist University,
 | ||
| 1993 SUNY at Stony Brook, see the file COYPRIGHT_SLG for detailed information
 | ||
| on this copyright.
 | ||
| 
 | ||
| <!--l. 1--><p class="noindent">
 | ||
|    <h3 class="likesectionHead"><a 
 | ||
|  id="x1-90008"></a>References</h3>
 | ||
| <!--l. 1--><p class="noindent">
 | ||
|     <div class="thebibliography">
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [1]<span class="bibsp">   </span></span><a 
 | ||
|  id="XDBLP:journals/ngc/AptB91"></a>K. R.  Apt  and  M. Bezem.    Acyclic  programs.    <span 
 | ||
| class="cmti-10">New  Generation</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Comput.</span>, 9(3/4):335–364, 1991.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [2]<span class="bibsp">   </span></span><a 
 | ||
|  id="XBlo04-ILP04WIP-IC"></a>H. Blockeel. Probabilistic logical models for mendel’s experiments: An
 | ||
|     exercise.  In <span 
 | ||
| class="cmti-10">Inductive Logic Programming (ILP 2004), Work in Progress</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Track</span>, 2004.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [3]<span class="bibsp">   </span></span><a 
 | ||
|  id="XDBLP:journals/jacm/ChenW96"></a>Weidong  Chen  and  David Scott  Warren.    Tabled  evaluation  with
 | ||
|     delaying for general logic programs. <span 
 | ||
| class="cmti-10">J. ACM</span>, 43(1):20–74, 1996.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [4]<span class="bibsp">   </span></span><a 
 | ||
|  id="XDBLP:conf/ijcai/RaedtKT07"></a>L. De Raedt, A. Kimmig, and H. Toivonen. Problog: A probabilistic
 | ||
|     prolog and its application in link discovery.   In <span 
 | ||
| class="cmti-10">Proceedings of the 20th</span>
 | ||
|     <span 
 | ||
| class="cmti-10">International Joint Conference on Artificial Intelligence</span>, pages 2462–2467,
 | ||
|     2007.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [5]<span class="bibsp">   </span></span><a 
 | ||
|  id="XGetFri01-BC"></a>L. Getoor,   N. Friedman,   D. Koller,   and   A. Pfeffer.      Learning
 | ||
|     probabilistic relational models. In Saso Dzeroski and Nada Lavrac, editors,
 | ||
|     <span 
 | ||
| class="cmti-10">Relational Data Mining</span>. Springer-Verlag, Berlin, 2001.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [6]<span class="bibsp">   </span></span><a 
 | ||
|  id="XGetoor+al:JMLR02"></a>L. Getoor,   N. Friedman,   D. Koller,   and   B. Taskar.      Learning
 | ||
|     probabilistic models of relational structure.  <span 
 | ||
| class="cmti-10">Journal of Machine Learning</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Research</span>, 3:679–707, December 2002.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [7]<span class="bibsp">   </span></span><a 
 | ||
|  id="XRig-AIIA07-IC"></a>Fabrizio Riguzzi.   A top down interpreter for lpad and cp-logic.   In
 | ||
|     <span 
 | ||
| class="cmti-10">10th Congress of the Italian Association for Artificial Intelligence</span>. Springer,
 | ||
|     2007.
 | ||
|     <a 
 | ||
| href="http://www.ing.unife.it/docenti/FabrizioRiguzzi/Papers/Rig-AIIA07.pdf" > http://www.ing.unife.it/docenti/FabrizioRiguzzi/Papers/Rig-AIIA07.pdf
 | ||
|     </a>.
 | ||
| 
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [8]<span class="bibsp">   </span></span><a 
 | ||
|  id="XRig-RCRA07-IC"></a>Fabrizio   Riguzzi.        A   top   down   interpreter   for   lpad   and
 | ||
|     cp-logic.    In  <span 
 | ||
| class="cmti-10">The  14th  RCRA  workshop  Experimental  Evaluation  of</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Algorithms for Solving Problems with Combinatorial Explosion</span>,  2007.   <a 
 | ||
| href="http://pst.istc.cnr.it/RCRA07/articoli/P19-riguzzi-RCRA07.pdf" >
 | ||
|     http://pst.istc.cnr.it/RCRA07/articoli/P19-riguzzi-RCRA07.pdf </a>.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|   [9]<span class="bibsp">   </span></span><a 
 | ||
|  id="XSanPagQaz03-UAI-IC"></a>V. Santos Costa,  D. Page,  M. Qazi,  and  J. Cussens.    CLP(BN):
 | ||
|     Constraint logic programming for probabilistic knowledge. In <span 
 | ||
| class="cmti-10">Uncertainty</span>
 | ||
|     <span 
 | ||
| class="cmti-10">in Artificial Intelligence (UAI 2003)</span>, 2003.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|  [10]<span class="bibsp">   </span></span><a 
 | ||
|  id="XVenDenBru-JELIA06"></a>J. Vennekens, M. Denecker, and M. Bruynooghe. Representing causal
 | ||
|     information about a probabilistic process. In <span 
 | ||
| class="cmti-10">10th European Conference on</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Logics in Artificial Intelligence, JELIA 2006</span>, LNAI. Springer, September
 | ||
|     2006.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|  [11]<span class="bibsp">   </span></span><a 
 | ||
|  id="XVenVer03-TR"></a>J. Vennekens  and  S. Verbaeten.    Logic  programs  with  annotated
 | ||
|     disjunctions.      Technical  Report  CW386,  K.  U.  Leuven,  2003.      <a 
 | ||
| href="http://www.cs.kuleuven.ac.be/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}joost/techrep.ps" >
 | ||
|     http://www.cs.kuleuven.ac.be/<span 
 | ||
| class="cmsy-10">~</span>joost/techrep.ps </a>.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|  [12]<span class="bibsp">   </span></span><a 
 | ||
|  id="XVenVer04-ICLP04-IC"></a>J. Vennekens, S. Verbaeten, and M. Bruynooghe. Logic programs with
 | ||
|     annotated disjunctions.   In <span 
 | ||
| class="cmti-10">The 20th International Conference on Logic</span>
 | ||
|     <span 
 | ||
| class="cmti-10">Programming (ICLP 2004)</span>, 2004. <a 
 | ||
| href="http://www.cs.kuleuven.ac.be/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}joost/" > http://www.cs.kuleuven.ac.be/<span 
 | ||
| class="cmsy-10">~</span>joost/
 | ||
|     </a>.
 | ||
|     </p>
 | ||
|     <p class="bibitem"><span class="biblabel">
 | ||
|  [13]<span class="bibsp">   </span></span><a 
 | ||
|  id="XCP-logic-unp"></a>Joost Vennekens, Marc Denecker, and Maurice Bruynooge. Extending
 | ||
|     the                  role                  of                  causality                  in
 | ||
|     probabilistic modeling. <a 
 | ||
| href="http://www.cs.kuleuven.ac.be/\protect \unhbox \voidb@x \penalty \@M \relax \unhbox \voidb@x \special {t4ht@+&{35}x00A0{59}}x{}joost/cplogic.pdf" > http://www.cs.kuleuven.ac.be/<span 
 | ||
| class="cmsy-10">~</span>joost/cplogic.pdf
 | ||
|     </a>, 2006.
 | ||
| </p>
 | ||
|     </div>
 | ||
|     
 | ||
| </body></html> 
 | ||
| 
 | ||
| 
 | ||
| 
 |