Setup an R project
Before you start
Ensure that you have downloaded and installed R.
Install the R plugin as described in Managing plugins.
Whatever you do with your R scripts in PyCharm, you do it the context of a project. So, to start coding in R, you need to create an R project and setup a working environment.
Create an R project
-
Do one of the following:
From the main menu, choose
On the Welcome screen, click Create New Project
The New Project dialog opens.
-
In the New Project window, select the R Project type from the list of the available project types. Then specify the project name and its location.
-
You should also create a project interpreter that allows you to work with the specific set of R packages. Expand the Project interpreter area and click next to the Base interpreter field. In the file system, select the R executable file. A sample path to the R executable can be /usr/local/bin/R on macOS or C:\Program Files\R\R-3.6.1\bin\R.exe on Windows.
Click Create to complete the task.
To create another R interpreter for your project, press Ctrl+Alt+S, go to the Add, and specify a new R executable for the project interpreter.
dialog, click , selectOnce you've created a new R project, PyCharm generates the main.R file with some project-related information based on the R file template.
At this point, you are all set to start coding in R, still you might want to modify some project settings to tailor them for your needs.
Manage R packages
To configure R packages for the project, select the R Packages tab in the R Tools window.
Click to add a new package. In the Available Packages dialog, type the name of the target package in the Search field, then select a package, and click Install.
If needed, you can update packages to a newer versions. Click to preview the latest available versions of the installed packages, then click .
When upgrading all packages to the available latest versions, PyCharm shows you the list of the packages to upgrade and asks to confirm the action. Click OK to proceed with the update.
-
Click next to a particular package to uninstall it for the current project. Mind checkboxes in the leftmost column: they show the packages loaded into the current execution session.
-
At any time you can open the package source by clicking for the target package.
-
To preview documentation for a particular package, click its name in the Package column. The package reference will be shown in the Documentation tab.
Configure R templates
-
File templates specify default contents to be generated when creating a new file. To establish the unified style and initial code for all .R files, press Ctrl+Alt+S to open project Settings/Preferences, go to , select R Script in the list of languages, and alter the default template. In the following example, we modified the default settings and added the
${TIME}
variable to include the time when the file was created. Similarly, setup a file template for R Markdown files. Refer to File and code templates for more details.
-
By using live templates, you can insert frequently-used constructions into your code, for example, loops, conditions, various declarations, or print statements. To preview the R constructs, press Ctrl+Alt+S to open project Settings/Preferences, go to , select R Script in the list of languages
When you work with R plugin in PyCharm, all scope of your R data is considered an R workspace.
Manage your R workspace
To tune the way you want to operate with R data, press Ctrl+Alt+S and go to the
dialog.Select Load workspace on R startup to ensure all your R content becomes available when you start PyCharm with the R plugin.
Select Save R workspace on exit if you want to save all R data generated during the current session in your workspace.