------------------------------------------------------------------------
SYSTEM REQUIREMENT
------------------------------------------------------------------------

1. Platform: x86 compatible 32 bit or 64 bit processor;
2. Operating system: Windows, Linux and Mac OSX (10.4 and above);
3. Required environment: Oracle Java SE Development Kit 8 or higher;
4. Required compilers (for attractor detection): flex 2.5.4 or higher, 
   GNU bison 2.3 or higher, GNU g++ 4.0.1 or higher; Cygwin 1.5.25-14 or 
   higher (Windows platform only); NVIDIA's CUDA Compiler (for GPU 
   computation only).

------------------------------------------------------------------------
INSTALLATION
------------------------------------------------------------------------

For basic usage, ASSA-PBN does not require installation operation. For 
usage in Windows, the software can be run by double clip on the assa.jar 
file after extracting the downloaded file. For usage in Mac OS of Linux, 
the software can be run with the command "./xassa" in the "bin" folder. 
Alternatively, the command line version can be run with the command 
"./assa <parameters>" in the "bin" folder. 

Installation for the attractor detection function. 

If the user wants to use the attractor detection function, an additional 
installation is required. It can be down by the following two steps.
1. (Windows platform only) Install cygwin and the packages g++, flex and 
   bison on Windows. Detailed instructions can be found from http://www.cygwin.com/.
2. In a terminal (please use the cygwin terminal for Windows), navigate to 
   the mcmas folder. Simply use the command make to the compile MCMAS. 
   We now give an example in Windows. Assume the downloaded ASSA-PBN is 
   extracted in the folder "C:nassa-pbn-3.0.1". Open the cygwin terminal, 
   run "cd C:\assa-pbn-3.0.1" and then run "make". On Windows, the directory 
   "bin" in the cygwin installation must be added to the system path. For 
   example, append "c:\cygwin64\bin" to the system path if cygwin is installed
   in "c:\cygwin64".

Installation for computation with GPUs. 

If the user wants to benefit from the parallel computation power of GPU codes, 
the NVIDIA's CUDA Compiler (NVCC) (https://developer.nvidia.com/cuda-downloads) 
are required. The parallel computation of GPU is currently only supported for Mac
OS and Linux. In addition, an additional installation step (see below) is required 
in order to enable the GPU-based parallel computation. In a terminal, navigate to 
the ASSA-PBN folder and run make.
