In this page:
Jupyter Notebook for Python, R, and Julia
The IDAS interface
- After creating an IDAS instance for research or class use, you will see your IDAS home page. If this is your first time accessing IDAS, your home page will be empty.
- You can create Jupyter notebooks, files, and folders in IDAS. (See details below.) Click any file or folder to open that file or folder.
- In order to navigate back to your IDAS home page, click the Jupyter symbol on the top left corner: .
Uploading files
- You can upload your own Jupyter notebooks and data files to IDAS. After creating an IDAS instance for research or class use, in the top right corner of your IDAS home page, click Upload.
- Select the files to upload in your local computer. Once the upload is done, you should see the uploaded files in your directory.
Creating a new Jupyter notebook
First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
In the top right corner of your IDAS home page, click New.
Under Notebook, choose Python, R, or Julia in order to create a notebook in that language. For example, if you had created an instance with Python, you can create a new Jupyter notebook with Python:
If you are creating a research instance, note that Python, R, and Julia each have their own container image. For example, in order to use Julia, please select one of the three options for Julia under IDAS Image in the Spawner Options form.
Managing Jupyter notebooks
- First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
In your IDAS home page, check the box next to a Jupyter notebook. If the notebook is not currently running, you will have the option to duplicate, rename, move, download, view, edit, or delete that notebook.
- If the notebook is currently running, you will have the options to duplicate, shutdown, view, edit, or delete that notebook.
- Below is a breakdown of these options:
- Duplicate: will make a copy of the notebook, stored in the same folder.
- Rename: will rename the notebook. Enter the new name in the pop-up box, then click Rename.
- Move: will move the notebook to a destination of your choice. In the pop-up box, enter the destination directory path, then click Move.
- Download: will download a copy of the notebook to your local computer.
- View: will open the notebook and allow editing the notebook, including adding cells and running codes.
- Edit: will allow editing the source code in the notebook.
- Shutdown: will shut down a notebook that is running.
- Delete (the red trash can icon): will permanently delete the notebook.
The path to your IDAS home directory is /home/<your_HawkID>. In the example below, the Jupyter notebook will be moved to the "demo" folder inside the IDAS home directory.
Creating new files and folders
- First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
- In the top right corner of your IDAS home page, click New.
- Choose Text File to create a new .txt file, or Folder to create a new Folder. The text file can later be renamed to another extension, such as .py.
Managing files and folders
File options
- First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
In your IDAS home page, check the box next to a file. You will be able to see the options available for that file:
- Below is a breakdown of the options for a .txt file:
- Duplicate: will make a copy of the file, stored in the same folder.
- Rename: will rename the file. Enter the new name in the pop-up box, then click Rename.
- Move: will move the file to a destination of your choice. In the pop-up box, enter the destination directory path, then click Move.
- Download: will download a copy of the file to your local computer.
- View: will open the file for viewing only. No editing.
- Edit: will allow editing the file.
Delete (the red trash can icon): will permanently delete the file.
The path to your IDAS home directory is /home/<your_HawkID>. In the example below, the .txt file will be moved to the "demo" folder inside the IDAS home directory.
Folder options
- First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
In your IDAS home page, check the box next to a folder. You will have the option to rename, move, or delete that folder.
To rename a folder, check the box next to that folder, click Rename, enter the new folder name in the pop-up box, and click Rename:
To move a folder, check the box next to that folder, click Move, enter a new directory path in the pop-up box, and click Move. In the example below, the folder will be moved to the "demo" folder inside the IDAS home directory.
The path to your IDAS home directory is /home/<your_HawkID>.
- To delete a folder, check the box next to that folder, and then click the red trash can icon. You will be asked to confirm that you want to permanently delete the folder. Click Delete to confirm the action.
Working with Terminal in IDAS
The Terminal allows you to perform more tasks in IDAS, including checking system information, managing files and folders, and installing packages. Below are a few common tasks that may be helpful in IDAS.
Creating a new Terminal session
First, create an IDAS instance with Python, R, or Julia. If you are a student in a class that uses IDAS, follow the instructions here to access your class instance.
In the top right corner of your IDAS home page, click New.
- Click Terminal in order to start a Terminal session.
Checking information using Terminal
The following commands can be typed after the prompt symbol
$
in Terminal:
pwd
: prints the current working directory. If you are in your IDAS home diretory, the directory will be/home/<your_HawkID>.
ls -a
: lists the files and directories in your current directory. The-a
option lists all files, including hidden files that start with.
, such as.bashrc.
cd <destination>
: change directory to a destination directory. For example,cd demo
: changes to thedemo
directorycd
: (with no argument) returns to your home directory
jupyter notebook --version
: prints the version of Jupyter Notebook. Similarly, you can typepython --version
orconda --version
.
Shutting down a JupyterHub instance
Once you finish your job with the IDAS instance, please shut down the instance, so that resources could be used by other IDAS users.
Your instance will be forced close after 18 hours of no activities. Please shut down your instance to release resources for other IDAS users.
Please follow the steps below to save your notebooks and shut down the IDAS instance.
- If you have any active notebook, save any changes by clicking the Save and Checkpoint button under the menu in the top left corner of the screen.
- Then stop your notebook by going to File / Close and Halt.
- Then in the IDAS home page, click Control Panel in the top right corner.
- Click the red button Stop My Server.
- Wait a few seconds for the blue button to change to Start My Server.
- Close your browser tab.
- If you want to use IDAS again, follow these instructions to access IDAS for research use or to access IDAS for class use.
RStudio for R
Experiencing and Testing
There are multiple ways for you to experience and test the RStudio:
- Create a new R script by clicking the File on the menu bar, New File, and then R Script. When a new pane for an R script pops up, try anything you would like to do in the script.
- If you would like to try any of your existing R scripts or markdown, you can upload them by clicking the Upload button in the Files pane at the bottom right corner and then selecting the files in your local computer. Once the upload is done, you should see the uploaded files in the Files pane.
Uploading Files
At this point, the only way you can upload files is to use the web interface of RStudio. Find the Files pane at the bottom right corner, click the Upload button at the top corner in the pane, and then select the file to upload. To upload multiple files or a directory, create a zip file, which will be automatically uncompressed after upload.