diogo/yap-6.3
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

PFL manual: add section for horus cli

Browse Source
This commit is contained in:
Tiago Gomes 2013-01-08 15:31:52 +00:00
parent 182429252e
commit 6375d05a93
1 changed files with 39 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
packages/CLPBN/pfl.tex
View File

@ -1,8 +1,9 @@
\documentclass{article}
\usepackage{tikz}
\usepackage{hyperref}
\usepackage{setspace}
\usepackage{fancyvrb}
\usepackage{tikz}
\usetikzlibrary{arrows,shapes,positioning}
\begin{document}
@ -286,4 +287,41 @@ The key \texttt{bp\_msg\_schedule} controls the message sending order. Its possi
\end{itemize}
It defaults to \texttt{seq\_fixed}.
\section{Horus Command Line}
This package also includes an utility to perform inference over probabilistic graphical models described in other formats, namely the \href{http://cs.ru.nl/~jorism/libDAI/doc/fileformats.html}{libDAI file format}, and the \href{http://graphmod.ics.uci.edu/uai08/FileFormat}{UAI08 file format}
This utility is called \texttt{hcli} and can be found inside binary directory used for the YAP installation. Its usage is:
\begin{verbatim}
./hcli [<KEY>=<VALUE>]... <FILE> [<VAR>|<VAR>=<EVIDENCE>]...
\end{verbatim}
Let's assume that the working directory is where \texttt{hcli} is installed. We can perform inference in any supported model by passing the file name where the model is defined as argument. Next, we show the command for loading a model described in an UAI file format.
\begin{verbatim}
./hcli $EXAMPLES_DIR$/burglary-alarm.uai
\end{verbatim}
With this command, the program will load the model and print the marginal probabilities for all random variables defined in the model. We can view only the marginal probability for some variable with a identifier $X$, if we pass $X$ as an extra argument following the file name. For instance, the following command will show only the marginal probability for the variable with identifier $0$.
\begin{verbatim}
./hcli $EXAMPLES_DIR$/burglary-alarm.uai 0
\end{verbatim}
If we give more than one variable identifier as argument, the program will show the joint probability for all variables given.
Evidence can be given as pairs with a variable identifier and its observed state (index), separated by a '=`. For instance, we can introduce knowledge that some variable with identifier $0$ has evidence on its second state as follows.
\begin{verbatim}
./hcli $EXAMPLES_DIR$/burglary-alarm.uai 0=1
\end{verbatim}
By default, all probability tasks are resolved with the \texttt{hve} solver. It is possible to choose another solver using the \texttt{ground\_solver} key as follows. Note that only \texttt{hve}, \texttt{bp} and \texttt{cbp} can be used in \texttt{hcli}.
\begin{verbatim}
./hcli ground_solver=bp ../examples/burglary-alarm.uai
\end{verbatim}
The options that are available with the \texttt{set\_horus\_flag/2} predicate can be used in \texttt{hcli} too. The syntax to use are pairs $Key=Value$ before the model's file name.
\end{document}