In this note, we give a simple example to demonstrate how to use the tool ASSA-PBN
to perform two important tasks: attractor detection and computation of steady-state 
probabilities. 

------------------------------------------------------------------------------
Start ASSA-PBN
------------------------------------------------------------------------------
For Windows users, ASSA-PBN can be launched by double clicking assa.jar. For 
other users, open a terminal and change the directory to the "bin" folder of 
ASSA-PBN. Then run the command "./xassa". The main interface of ASSA-PBN will 
be launched.


------------------------------------------------------------------------------
Loading a PBN Model into ASSA-PBN
------------------------------------------------------------------------------
An example context-sensitive PBN(CPBN) definition file can be found in the 
"examples" folder of the downloaded software package, with the name 
"example-context-sensitive-highlevel.pbn". Explanation about the grammars of 
the input file can be found in the user guide. Launch the main interface of 
ASSA-PBN after installation. Select the menu option "Model | Load", then select
the file "example-context-sensitive-highlevel.pbn" and click "Open". 
The example PBN is then loaded into ASSA-PBN. Information about this PBN will 
be displayed in the left panel of the software.

------------------------------------------------------------------------------
Attractor Detection
------------------------------------------------------------------------------
We demonstrate one major contribution of the new version  ASSA-PBN, i.e., 
attractor detection. After loading the model as mentioned above, select the menu
option "Analyse | Attractor Detection". A window will pop up asking for choices 
to perform the task. ASSA-PBN provides three methods for attractor detection.
One non-decomposition method (the default one) and two decomposition methods.
If the user do not tick any of the first two choice boxes, the default 
non-decomposition method will be used. Since ASSA-PBN supports both synchronous 
and asynchronous updating schemes, and the detection methods for different updating 
schemes are different, there are in fact six different methods implemented.

In general, for large networks, we recommend the decomposition method 2 for 
efficiency. In this example, the loaded model is a 3-node synchronous network.  
Hence, we use the default one, i.e., without ticking any of the first two choice 
boxes.  The detected result will be shown in the top right panel. Three singleton 
attractors are detected in this example.

------------------------------------------------------------------------------
Computing Steady-state Probabilities
------------------------------------------------------------------------------
One major functionality offered by ASSA-PBN is the computation of steady-state 
probabilities of a PBN. We demonstrate how to use the two-state Markov chain 
approach to compute steady-state probabilities of the example network. Select 
the menu option "Analyse | Steady State Probability | Statistical | Two State 
Markov Chain". A window then pops up. This pop-up window asks for six 
parameters. The "precision" and "confidence level" are used to define how precise 
the computed result should be. We set precision and confidence level to 0.001
and 0.95, respectively. The "GlobalAlias" and the "structure parallel" are only 
meaningful for instantaneously random PBNs (IPBNs) and hence they are disabled 
for this loaded CPBN. "Properties" defines the set of states whose steady-state
probability is to be computed. It can be assigned either by clicking the three 
dots button, which will lead to a file selection window; or by clicking the 
"Set properties" button, which will lead to a window for assigning activated and
deactivated nodes. This figure defines the set of states where node x1 is active 
and nodes x0 and x2 are inactive. We click the "Create" button and save the 
property in a file named "property_context.txt". In this demonstration, we use 
the sequential way to make the computation and hence we keep the other parameters
as the default ones and then click "Run". The main information, i.e., the extending 
times, the sample size, the probability, and the time cost of the computation, 
will be shown in the top right panel of  ASSA-PBN's main interface. More detailed 
information about this run can be obtained by clicking the "File View" tab.





