1) System requirements

• Mac OS X 64-bit (Software for other Unix-based machines on the way)

2) Installation

Download the required files from the BHICP Software page. From terminal, move to the BHICP folder and run the included Makefile with:

 $ make 

This should create the executable file CoxClusterProcess.

3) Running the software

Input files

The following input files are required:

• <data_name>.dat: The file containing the foci coordinates.
• newpars.txt: The file containing simulation details: prior distributions, MCMC running time, etc.
• seed.dat: The file containing the seed for random number generations.

Data format

The following guidelines must be taken into consideration when generating the data file containing the foci:

• The file consists of 5 columns.
• The first column contains the study (contrast) ID number, ranging from 1 to the total number of studies in the sample.
• Columns 3,4 and 5 contain the x,y and z coordinates of the focus, always in MNI voxel space. Since 2mm voxels are used, columns 2 and 4 should range between 1 and 91, while column 4 should range from 1 to 109.
• Column 5 contains the study type number. If no discrimination between types is done, set column 5 to one.

Overall the file should look like:

1	74.5	56	35.5	1
1	63	70	24	1
1	67	59	17.5	1
2	12.5	56	34	1
2	18.5	43.5	39	1
...	...	...	...	...
...	...	...	...	...
137	54	60	27	1
137	33	61.5	25.5	1
137	48	41.5	36	1

Execution

Once all input files are created, type the following command in terminal to execute the software:

 $ ./CoxClusterProcess <results_folder> <data_name>.dat newpars.txt

where:

• <results_folder> is the subfolder of folder simresults where posterior draws will be stored
  
• <data_name>.dat is the file containing the foci
  
• newpars.txt: is the file containing the simulation details

4) Results

All the results are stored in the directory .../BHICP/simresults/<results_folder>. A detailed description of the output files generated during execution will become available soon.