This page is both a manual and a help page for DictionR. I strongly encourage you to read it before diving into DictionR!

If you can't find the answer you're looking for, send me an email at aleryonscience@icloud.com. I'll be happy to help!

## Naming

In order to facilitate everything, I use the following naming conventions:

• df indicates a dataframe or a tibble (tibbles are beefed up dataframes used by the Tidyverse)
• col indicates a column
• row indicates a row

## Pipe operator

The pipe operator %>% is a convenient tool available in the Tidyverse. I encourage every R user to use it — it simplifies the code, makes it clearer and easier to debug. Unless specified otherwise, the snippets assume you use the pipe operator.

That being said, all snippets where the pipe operator is used offer at least one extra example of the main code written without the pipe operator.

## URLs

Each snippet has a unique numerical ID. For convenience and ease-of-use, the URL of a given snippet is based on this ID:

https://dictionr.aleryon.science/62

## How is DictionR organized?

Snippets in DictionR are organized by the library they rely on to work.

Each snippet has at least one tag — visible at the bottom of the page. Each tag is clickable. It indicates the library the snippets relies on.

The tag shows which library the snippet relies on to work — an important information for you to determine which library to load, see below for more details.

The hompage of DictionR lists all the tags, offering you a super convenient way to browse all snippets.

## Which library do I need to load?

Tags starting with @ are meta tags that do not reference libraries.

Many snippets require a third party library to work properly. DictionR has made easy for you to determine which library you need to load for a given snippet to work properly. Three cases:

1. the snippet doesn't need any library
2. the snippet needs the Tidyverse
3. the snippet needs something else

### 1. The snippet doesn't need any library

The snippet is tagged with base:

You don't need to load any library, the snippet works as is.

### 2. The snippet needs the Tidyverse

The snippet is tagged with tidyverse: <library>. Illutration with  dplyr:

Two cases are possible:

1. you use the Tidyverse
2. you don't use the Tidyverse

#### 2.1. You use the Tidyverse

You need to load the Tidyverse.

You only need to load it once:

library(tidyverse)
Some lesser used libraries are not automatically loaded when you load the Tidyverse. You need to load them individually. In this case, it'll specified in the snippet to load them.

#### 2.2. You don't use the Tidyverse

You only need to load the library specified in the second part of the tag (after tidyverse:).

In the example above tidyverse: dplyr, the library is dplyr. This is what you need to load:

library(dplyr)

### 3. The snippet needs something else

The snippet is tagged with neither base nor tidyverse: <library>. Illutration:

You need to load the library specified in the tag.

In this case, it's readODS. This is what you need to load:

library(readODS)

## FAQ

#### Search in the homepage seems broken

Sometimes the search index for the search forms is not always updated when a new snippet is added. Click on "Rebuild search index" on the bottom menu to rebuild it.

#### How can I suggest a new snippet?

Sure! Just send me an email at aleryonscience@icloud.com.

#### There is an issue with a snippet. What should I do?

Send me an email at aleryonscience@icloud.com with the full name (number included) and the URL of the snippet and the problem you encountered. Thanks!