# R Projects

Using R projects as container for R content enables all features of StatET for R code and tools.

#### R Package Projects

R package projects are special R projects to host a single R package.

## Project Properties

An R project can be configured in the project properties page R Project. You can open the project properties for selected project using the Properties command accessible by the context menu, the main menu File or `Alt + Enter`.

A rebuild of the configured project is required to take into effect the changes of this property page.

### Main

The R Package Root specifies the root folder of an R package containing the `DESCRIPTION` and `NAMESPACE` file. The root folder is decorated with "(R Package Root)" in the tree view.

Pressing the button R Package Root marks the selected folder as the R package root folder. If the folder was already the root folder, the mark will be removed.

Setting the R package root folder automatically converts the project to an R package project if required; unsetting the property automatically remove the R package nature from the project. When an R package project is correctly configured, the R package name is shown at the bottom of the configuration tab.

### Source

All files in source folders and its subfolders are checked and indexed by the project builder. For R projects, the project root is unchangeably the single source folder for R files.

Each source folder can define an exclusion filter to specify which resources inside the folder should not be visible to the builder.

##### Source folder attributes:

Attribute | Description
--- | ---
Exclusion filter | Selects which resources are not visible to the builder. For details see Inclusion and exclusion patterns.