# Guide to OSF folder This work is now published at _Collabra: Psychology_ https://doi.org/10.1525/collabra.57610 ## Windows application This is an application that can be installed on a Windows machine. - The application is: `ssgc.exe`. - The installed application runs in the default web browser (Chrome/Firefox/...) of the user's computer. - `ssgc.gif` is a sample run-through the application. ### Rtools I recommend installing Rtools prior to installing the application, but this is not required. If the user does not install Rtools, the program will install Rtools automatically on its first run -- an internet connection is needed for this. Rtools is available for download here: https://cran.r-project.org/bin/windows/Rtools/rtools40.html ### First use When running the application for the first time, the user needs to click the red `first use` button in the top right corner. This button does two things: - It installs Rtools if Rtools is not already installed. - It compiles the Stan code. This is a one-time process that reduces model runtime in the future. In summary, clicking the `first use` button may take a significant amount of time. ## Demo dataset - The demo dataset is `data_4_demo.csv`. ## Running the analysis in R ### Multinomial method This is the example for any wanting to replicate the methods in the paper using R (instead of the application), and on their data. - The example is in: `example_pd_mult.html` with corresponding Rmarkdown file: `example_pd_mult.Rmd`. - This example requires the `helper_file_mult.R` file which contains helper functions. ### Ordinal method This is the example for any wanting to modify the analysis. There is no guarantee that the helper functions (for outputs and plots) will work when the code is modified. - The example is in: `example_pd_ord.html` with corresponding Rmarkdown file: `example_pd_ord.Rmd`. - This example requires the `helper_file_ord.R` file which contains helper functions. ### Model comparisons This is the example for any wanting to perform model comparisons. The helper functions (for outputs and plots) should continue work. - The example is in: `example_pd_mult_mod_comp.R`. - This example requires the `model_mod_comp.stan` Stan file. ## Miscellaneous files folder This folder contains the key files used to build the application above. These files are not needed to use the application. This folder does not contain the portable version of R deployed within the application. - `app.R`: This is a Shiny app file. - `helper_file_mult.R`: This is a helper file, different from the similarly named helper file above. - `model.stan`: This is the Stan code underlying the model in the paper. - `run_script.R`: This is a script that runs the Shiny app. It points to an R package library that I have not uploaded here for space reasons -- the user can point it to the R package library on their machine. - `run_viz.bat`: This is a batch file for execution on Windows machines that instructs R to run `run_script.R`. The user can point the R executable to the R installed on their machine. - `run_viz.vbs`: This VB script instructs the program to run with an invisible terminal window.