IPython/Jupyter Notebook Support
Prior to working, make sure that the following prerequisite is met:
Jupyter Notebook is properly installed on your computer. To learn how to install Jupyter Notebook, refer to the official documentation.
PyCharm supports Jupyter Notebook, recognizes
*.ipynb files, and allows you to edit them.
Jupyter Notebook files are marked with icon.
A Notebook file
<file name>.ipynb shows document cells including code, text, equations etc.
Notebook support includes:
- Support for local and (in the Professional edition) remote interpreters. See section IPython/Jupyter Notebook Support for details.
- Coding assistance:
- Search and replace facilities: in a file, in path.
- Dedicated kernel view: Jupyter Notebook tab in the Run tool window.
- Ability to run cells.
Configuring an interpreter for a notebook
To configure a remote connection for a notebook, follow these steps:
- Open the Jupyter Notebook page of the Settings/Preferences dialog.
- On this page, select or clear the Markdown cells rendering enabled option, ans specify the username and password. Note that for the single-user notebooks these fields are optional - leave them blank.
- Choose the Remote radio-button:
- Fill in the username (for JupyterHub) and password.
- Click the link Configure remote interpreter. You'll find yourself at the Project Interpreter page.
- Configure the remote interpreter, as described in the section Configuring Remote Interpreters via Deployment Configuration.
Creating and opening ipynb files
To create an
- Do one of the following:
- Right-click the target directory in the Project tool window, and choose New on the context menu.
- Press Alt+Insert
- Choose the option Jupyter Notebook.
- In the dialog box that opens, type the file name.
To open the existing
.ipynb files, follow the same steps as for the files of the other types.
File *.ipynb in the editor
*.ipynb files feature a toolbar with the following buttons:
|Save and checkpoint||Click this button to forcibly save all changes to the notebook in its current state (even if the calculations not finished yet).|
|Insert cell below||Click this button to add an empty cell under the current one.|
|Cut cell||Click this button to delete the current cell and place it to the clipboard.|
|Copy cell||Click this button to create copy of the current cell in the clipboard.|
|Paste cell below||Click this button to the paste contents of the clipboard below the current cell.|
|Run cell||Click this button to execute the current cell.|
|Interrupt kernel||Click this button to stop the current kernel.|
|Restart kernel||Click this button to restart the current kernel.|
|Styles drop-down list||Select the desired presentation style from the drop-down list.|