HML-UnBBayes Plugin
User Guide
1) Introduction
2) Example data to follow user guide
3) How to use the HML-UnBBayes plugin
4) UnBBayes MEBN
1) Introduction
This guide gives an introduction on how to use the HML-UnBBayes plugin. With example data provided, the instructions explain how to effectively use the plugin to learn MEBN from data on a MySQL relational database and further use it on UnBBayes.
2) Example data to follow user guide
Please configure a local MySQL server and execute the scripts available at the git repository to follow the steps below.
3) How to use the HML-UnBBayes plugin
3.1) Open tool and connect to RDB
To use the HML-UnBBayes plugin, the user starts by opening UnBBayes. After that, we proceed by clicking on the HMLP tool button, highlighted in red in the image below.
After clicking on the HMLP tool button, a wizard pops up, asking for database server credentials. The plugin expects a MySQL database server on localhost. Therefore, the user has to enter username and password for the MySQL server on the correspondent area on the wizard window, highlighted in red in the following image.
After successfully connecting to the MySQL server, the user has to select which database the tool should work on, by clicking in one of the database names listed under “Database” folder. After that, the user clicks on the “Select” button, highlighted in red on the image below.
3.2) World Model and Parents
After selecting the database, the tool has a step for editing the World Model. Nevertheless, this feature is not yet implemented. So to proceed the user should click on the “Next[Add Parents]” button, highlighted in red on the following image.
On the “Select Parents” step, to add relationships the user should select a child from the left list and parent(s) from the right list. On the following image we select one child and three parents. Next we click on the “Select Parent” button, highlighted in red. In this step, we can already see a preliminary version of the MTheory on the right panel.
To provide an example with a relationship of nodes inside the same MFrag, in the following image we choose another child-parent pair and click on the “Select Button” highlighted in red. We can again see the updated MTheory on the right panel.
Next, we define a relationship with input nodes from more than one MFrag and click on the “Select Parent” button highlighted in red.
Finally, on the image below we can see the structure of our final MTheory on the right panel. After selecting the parents, the user can move on to the next step by clicking on the button “Next[Add Contexts]”, highlighted in red.
3.3) Joining Conditions
The next step is “Set joining condition”, which is not implemented yet. So the tool performs joins using the default equal names on the tables. Thus, to move forward the user can click on the button “Next[Add CLDs]” highlighted in red on the image below.
3.4) Class Local Distribution
The next step, “Class Local Distribution”, is not yet implemented, so the user is not able to add CLDs or select their types manually. Therefore, to proceed with learning the CLDs from the data on the RDB, the user has to click on the button “Next[MEBN Learning]” highlighted in red on the following image.
4) UnBBayes MEBN
When HML Core finishes learning the CLDs, as we can see in the image below the tool opens a UnBBayes MEBN’s GUI containing the MTheory with the structure defined during the wizard and LPDs obtained from the data in the RDB. This allows the user to now effectively work with the MEBN inside UnBBayes, making use of all its features.
By clicking on each MFrag we see the structure created, illustrated on the three images below.
