This so-called R Markdown file accompanies a short Reproducible Open Coding Kit (ROCK) workshop developed by Szilvia Zörgő & Gjalt-Jorn Peters. More details are available below in section Links and resources.

Getting started

RStudio Cloud

The easiest way to get started is to copy this file to an RStudio Cloud project of your own. To do that, first visit the shared RStudio project at https://rstudio.cloud/project/2109292. Note that to view it, you will need to be logged in with an RStudio Cloud (or shinyapps.io) account, so create that first if you don’t have one yet.

Once it has loaded, click “Save a permanent copy” at the top:

Figure 1: A screenshot of RStudio Cloud

This will store the project in your account’s workspace, so you that your changes are preserved and you can always return to it. If you do not save a permanent copy, you will be ejected from the temporary project after a while and will have to start over.

Local RStudio Desktop

If you are already familiar with R, RStudio, and Git, you can also download this project and use your local RStudio Desktop installation. For the URL to the Git repository, see the Appendix.

Exercises

Exercise 1: prepend utterance identifiers (UIDs)

In this exercise you will command the rock package to read the clean sources and prepend uterrance identifiers (UIDs). The relative path to these clean sources from your project’s directory is data/05--clean-sources. This means that the sources are in the the 05--clean-sources directory (or folder) which is itself a subdirectory of the data directory, which sits in the project directory.

We use the here::here() function to conveniently locate the project directory; by passing the names of the subdirectories, it will always build a correct path that allows R (and the rock package) to find the sources on the harddisk.

If you want to have a look at the clean sources beforehand, navigate to the data directory in the file pane in the bottom-right, then open the 05--clean-sources directory, and the click the Facebook_data_cleaned.rock file to open it in RStudio.

After this function, rock::prepend_ids_to_sources(), has read the sources and prepended the UIDs, it will write the sources to the 10--sources-with-UIDs directory, which is also a subdirectory of the data directory. It will add the suffix _with_uids to each file it processed, which is convenient from a data management perspective.

In this exercise, we set the preventOverwriting argument to FALSE so that every time you run this code, new UIDs are designated, allowing you to play around a bit. Normally, you would never do this, because you want utterance identifiers to stay fixed throughout your project once they have been designated (therefore, the default value of the preventOverwriting argument is TRUE, so the rock always protects against overwriting unless your override that manually).

rock::prepend_ids_to_sources(
  input = here::here("data", "05--clean-sources"),
  output = here::here("data", "10--sources-with-UIDs"),
  outputSuffix = "_with_uids",
  preventOverwriting = FALSE
);

Exercise 2: initial coding with iROCK

Open the iROCK interface at https://i.rock.science:

Figure 2: A screenshot of a fresh instance of iROCK

Click the ‘Sources’ button at the top to load a source. It will show you a dialogue similar to that shown in Figure 3. To load the example source, copy-paste the following URL into the field as shown in Figure 3 and press [ENTER].

Note that if you run MacOS instead of Windows, you have to copy-paste the URLs into your browser, and then store the file locally and upload from there.

Then repeat that to load the example Codes and Section Breaks, this time copy-pasting these two URLs:

Figure 3: A screenshot of a fresh instance of iROCK

When you loaded all three the files into the right place, you should see something similar to what is shown in Figure 4: