# Instructions This project repository contains all the files related to the project "Linear integration and lexicographic models of choice: A cue weight learning perspective" by Hrvoje Stojić, Henrik Olsson and Pantelis P. Analytis. Public version can be found at Open Science Framework, at the following [link](https://osf.io/7yxrz/). Licences for using the code, data and other materials in this repository: see `license.txt` file. ## Corresponding author If you have questions about the files in this repository or find some errors, please get in touch with Hrvoje Stojić the main author of the documentation. You can find my updated contact details at [ORCID profile](https://orcid.org/0000-0002-9699-9052). ## Organization of the files Directories with **c** prefix contain code for running various types of analyses. There is a designated directory `cModeling` with the code related to fitting and simulating the models, a directory `cCleaning` with the code that process the raw behavioral data and modeling results, a directory `cFigs` with the code that produces figures, and a directory `cAnalysis` with the code that analyses the behavioral data, performs tests etc. Directories with **d** prefix contain data. Raw behavioral data from the experiment is in `dRaw` directory, while in `dProcessed` directory we save the output from simulations, model fits and processed raw behavioral data. Note that we provide data from model simulations and fitting even though it can be reproduced, as it takes a bit of time. Directory `pManuscript` contains the article, together with the source LaTeX and Bibtex files. There are few other specific directorys: `rFigs` contains all the figures produced by code in `cFigs` while `rFisgOthers` contains figures not generated by code. `rTables` contains all the output from the analysis code in `cAnalysis`, these are largely results from the statistical tests reported in the artice. Each directory contains additional README file if additional details are needed on using the files contained in it. In README files in **c** directories you can find detailed information about the software dependencies, in case you wish to execute the code, but see also the section below on this topic. ## Dependencies The project was completed using Linux operating system and some tools rely on Unix environment. More specifically, I have used Ubuntu 18.04 Linux operating system. For example, `GNU make` that I mention below is a program that comes on most Linux distributions by default. Note that Mac OS is Unix based and it should have them as well, or they are easily installed. Hence, if you are attempting to use the files on a Windows system or follow the instructions, I cannot provide much guidance. For simulations, model fitting, all the analyses and producing figures we have relied on R, together with several R packages. If you wish to execute the code, 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). In README files in **c** directories you can find detailed information about the packages used to execute the code contained within the directory. Note that exact package versions are listed for which you should get the same results. If you will have newer/older versions installed, some code might not run at all. For compiling the manuscript, you will need a (full) 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. Operating System on which the code was developed and tested: ```{bash} Linux hfunk 4.16.0-041600rc4-generic #201803041930 SMP Mon Mar 5 00:32:34 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux ``` ## Usage We rely on `GNU make` files to automatize certain things. For example, to produce all the figures required for the article, one can simply open terminal in `cFigs` folder and execute `make` command. I tried documenting how to use each folder, if it was necessary, with README files. Finally, there is a makefile at the top level, where this README file resides, that you can use to clean the behavioral data, perform the analyses, produce the figures and compile the article with a single `make` call. Whether this will succeed depends on your operating system and whether all dependencies are satisfied.