Setup an R project
Before you start
Ensure that you have downloaded and installed R.
Ensure that the R Language for IntelliJ plugin is installed and enabled.
Whatever you do with your R scripts in PyCharm, you do it in 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, click next to the Base interpreter field and select Add. Alternatively, you can expand the list of the available interpreters and select the command there. 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.
Once 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.
Change an R interpreter
To create an R interpreter for your project, click the R interpreter selector in the Status bar and select Local Interpreter. Then specify a path to the R executable.
Alternatively, press Ctrl+Alt+S, go to the Add, and specify a new R executable for the project interpreter.
dialog, click , select
Create a remote R interpreter
Available only in PyCharm Professional: download to try or compare editions
To create a remote interpreter, do one of the following:
Click the R interpreter selector in the Status bar and choose On SSH from the menu.
Press Ctrl+Alt+S and go to the Add remote.
. Click the and select
In the Add remote R interpreter specify the remote host. You can select it from the list of the available SSH configurations or click the ... button to create a new one:
Fill in the parameters and click Test connection to verify them. Click OK to proceed.
Specify the path to the R executable on the remote host and the working direcoty. Then, save the changes.
Once the remote interpreter is set, its remote status will be shown in the interpreter's name in list of the available R interpreters, and in the title of the R console.
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, 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 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, 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.
To execute your R scripts on the remote environment, create a remote configuration and set is as an R interpreter.