# Instructions
This component contains all the files necessary for reproducing the article:
> Analytis, P. P., Stojic, H., Gelastopoulos, A., & Moussaid, M. (2017). Diversity of preferences can increase collective welfare in sequential exploration problems. In Collective Intelligence Conference (pp. 1–4).
## Organization of the files
Folder `cSimulations` contains simulations related code, and folder `cFigs` contains code that produces figures for the article. Data produced by simulations are placed in `dProcessed` folder, while figures produced by the code in `cFigs` is placed in `figs` folder. Folder `pManuscript` contains the article in PDF format together with the source code.
## Dependencies
The coding part of the project was developed and tested on Unix operating systems (Ubuntu 16.04 and Mac OS). Hence, if you are attempting to use the files on a Windows system we cannot provide any guarantees or guidance.
For simulations and producing figures we have relied exclusively on R programming language, together with several R packages. If you wish to use that part of the files in this folder, you should first visit [R website](https://www.r-project.org/) and read in more details there how to install R on your computer (I recommend [RStudio](https://www.rstudio.com/) as a nice user interface for R).
To replicate the figures and the analysis you should install the following R packages: `dplyr`, `doParallel`, `foreach`, `doRNG`, `ggplot2`, `reshape2`, `gridExtra`, `extrafont`, `scales`, `tikzDevice`, `grid`, `gtable`, `directlabels`, `ggrepel`, `xtable`. They can be installed via CRAN repository, by starting R, and in R console executing the command `install.packages("packageName")`, where you should substitute "packageName" with the name of the package you wish to install.
Here is the complete printout of `sessionInfo` command, with details of package versions
```R
R version 3.3.3 (2017-03-06)
Platform: x86_64-pc-linux-gnu (64-bit)
Running under: Ubuntu 16.04.2 LTS
locale:
[1] LC_CTYPE=en_GB.UTF-8 LC_NUMERIC=C
[3] LC_TIME=en_GB.UTF-8 LC_COLLATE=en_GB.UTF-8
[5] LC_MONETARY=en_GB.UTF-8 LC_MESSAGES=en_GB.UTF-8
[7] LC_PAPER=en_GB.UTF-8 LC_NAME=C
[9] LC_ADDRESS=C LC_TELEPHONE=C
[11] LC_MEASUREMENT=en_GB.UTF-8 LC_IDENTIFICATION=C
attached base packages:
[1] parallel grid stats graphics grDevices utils datasets
[8] methods base
other attached packages:
[1] doRNG_1.6 rngtools_1.2.4 pkgmaker_0.22
[4] registry_0.3 doParallel_1.0.10 iterators_1.0.8
[7] foreach_1.4.3 xtable_1.8-2 ggrepel_0.6.5
[10] directlabels_2015.12.16 gtable_0.2.0 tikzDevice_0.10-1
[13] scales_0.4.1 extrafont_0.17 gridExtra_2.2.1
[16] reshape2_1.4.2 dplyr_0.5.0 ggplot2_2.2.1
loaded via a namespace (and not attached):
[1] Rcpp_0.12.10 Rttf2pt1_1.3.4 magrittr_1.5 munsell_0.4.3
[5] colorspace_1.3-2 R6_2.2.0 quadprog_1.5-5 filehash_2.3
[9] stringr_1.2.0 plyr_1.8.4 tools_3.3.3 DBI_0.6
[13] extrafontdb_1.0 digest_0.6.12 lazyeval_0.2.0 assertthat_0.1
[17] tibble_1.2 codetools_0.2-15 stringi_1.1.3
```
Note that simulations require substantial amount of time to complete - several days on an ordinary personal computer, and they take significant storage space. Simulations were actually completed on more powerful multicore servers and the code is prepared in a way that the files could be easily moved to such a server and executed there to speed up computation. Because simulations can be exactly reproduced and they take too much storage space, the output is not stored here. We did store, however, data that we have preprocessed to produce figures.
The manuscript was written using LaTex and to compile it you will need a LaTeX installation on your computer. For guidance on installing required libraries on your operating system, see for example this [wikibooks](https://en.wikibooks.org/wiki/LaTeX/Installation) entry. We recommend doing a full latex installation, with all packages. More details is provided in `pManuscript` folder.
# Contact
If you have questions about the code in this folder or find some errors, do let us know.
Hrvoje Stojic - updated contact details at [ORCID profile](https://orcid.org/0000-0002-9699-9052).
