_**Note:** the reference documentation, listing and describing all the PennController commands, can be found [here][1]._ This is the wiki for the June 20 Penn workshop on PennController. The scripts in this documentation use *PennController beta 0.1*, which is included in each sample trial you sync from GitHub (see the *Setup* sections in each *Sample trial* page). You can also directly download the *.js* file [here][2] and upload it under *js_includes* in your Ibex project. ## Requirements / Preparation ### Web Browswer First of all, you need to make sure that you are using a web browser that is compatible with *PennController*. Please avoid using *Internet Explorer*, *Edge* or *Safari*. Prefer **[Firefox][3]** or **[Chrome][4]**, ideally in their desktop versions (i.e., not *Android* / *iOs*). We are working on a cross-browser / cross-platform development of *PennController*, but it is still limited for the moment. Nonetheless, we have never fallen short of participants even with such requirements. ### R software We will be using the *R* software to conduct basic data analyses during the second morning session. You can download *R* [here][5]. We will make use of at least one extra package, *dplyr*. Once you have installed *R*, you can install the *dplyr* package by opening an *R* console and typing the command `install.packages("dplyr")`. ### Ibex account The second step is creating an account on [Ibex Farm][6] (alternatively, you also have the option of [downloading it][7] and setting it up on your own server). Simply follow the instructions on the page. Ibex Farm does not share your email with anyone and never send you emails other than for password retrieval. Once you have created your account, you can create a new project by clicking *Create a new experiment*. When you click the link of the experiment you have created, you arrive on a page listing folders mostly ending with *_includes* (boldface) and files ending with *.html*, *.css* and *.js*. It is a good idea to take a look at [Ibex's documentation][8] to get a better understanding of the structure of a project, but keep in mind that *PennController* trials do not follow the same conventions as built-in types of trials (what Ibex calls *controllers*). ## Tutorials Congratulations, you are all set! You are now ready to start reading the tutorials and/or attend the workshop! Take a look at the [General Intro][9], [How to build PennController Trials][10], [How to build a PennController Experiment][11], and [From Data Collection to Data Analysis][12]. More advanced topics: - [Preloading resources][13] - [Using ZIP resources][14] - [Collecting audio recording samples][15] [1]: https://osf.io/e8npk/wiki/home/ [2]: https://github.com/PennController/penncontroller/blob/master/releases/beta0.1/PennController.js [3]: https://www.mozilla.org/en-US/firefox/new/ [4]: https://www.google.com/chrome/ [5]: https://cran.rstudio.com/ [6]: http://spellout.net/ibexfarm/newaccount [7]: https://github.com/addrummond/ibex [8]: https://github.com/addrummond/ibex/blob/master/docs/manual.md [9]: https://osf.io/9trsx/wiki/General%20Intro/ [10]: https://osf.io/9trsx/wiki/How%20to%20build%20PennController%20Trials/ [11]: https://osf.io/9trsx/wiki/Sample%20experiment:%20Priming%20Design/ [12]: https://osf.io/9trsx/wiki/Recruitment%20&%20Data%20collection/ [13]: https://osf.io/9trsx/wiki/Preloading%20Resources/ [14]: https://osf.io/9trsx/wiki/ZIP%20file%20preloading%20method/ [15]: https://osf.io/9trsx/wiki/Collecting%20audio%20recordings/