Instructor Guide

This page contains information for teachers and instructors who use NII's online analysis system for classes and seminars.

What you can do

• You can use the analysis environment of Jupyter Notebook and RStudio in your browser.
  • There is no need to have the analysis environment installed on the student's computer.
• The analysis environment can include programs, data files, and dependent packages.
  • Students can rebuild the same analysis environment with a single click, and there is no need to install additional packages.

Account Requirements

In order to use this system, instructors and students must each log in using one of the following methods.

• (a) Log in with the account of your own institution (university, etc.) 

  • This method can be used if your institution is a member of the Academic Access Management Federation in Japan (GakuNin) and has already completed the initial settings for linking with this system. The initial setup should be done by the department in charge of information infrastructure at your institution. For details, please consult the person in charge below.

• (b) Log in with an OpenIdP account
  • This method is available for users with an email address in the ac.jp or go.jp domain. If you are an institution with a domain name other than that, please contact the person in charge below for individual support.
  • This method is for those who do not meet the requirements in (a) above to try out the system. If you want to use the system in a class, we recommend you to use the method (a). For details, please contact the person in charge below.
  • If you are using OpenIdP for the first time, please refer to How to Use OpenIdP.

Operating environment

It is assumed that both the instructor and the student have the following environment.

• One of the following browsers: Chrome, Firefox, Safari, Edge.
• Permanent Internet connection

How to create an analysis environment

In this section, we will show an example of how to use this system for a class using "Rで学ぶデータサイエンス 14 計量政治分析』(Kyoritsu Shuppan) " as the textbook.

1. Create a repository on GitHub for the class, and place the environment configuration information (see below), programs and data files (if any) that will be used as teaching materials.
   
   • In this example, we will use https://github.com/ikfj/ds-polimetrics as the repository for the class.
   • In this repository, apt.txt and environment.yml are the environment configuration information and prepare.r is the teaching program.

   • Depending on the repository you are actually using, you may need to change the following description.

2. Open https://binder.cs.rcos.nii.ac.jp/ in your browser.
   
   
   
   
3. Enter the URL of the repository in the [GitHub repository name or URL] field at the top.
   • In our example, we'll enter https://github.com/ikfj/ds-polimetrics.
4. Copy the URL that appears under [Copy the URL below and share your Binder with others:]. 
   • In this example, it is https://binder.cs.rcos.nii.ac.jp/v2/gh/ikfj/ds-polimetrics/master.
5. Press the [Launch] button.
6. Select your institution or OpenIdP in the affiliation selection and click the [Select] button.
7. Authenticate with your own institution or OpenIdP account.
8. A new analysis environment for you will be created.
   
   
   
   
9. Give the URL copied in Step 4 to the student.

The environment configuration information to be created in Step 1 is a text file describing the packages to be installed in the analysis environment. apt.txt describes the OS (Ubuntu) package, environment.yml describes the conda package, and so on. For more information on how to install other packages, please refer to https://mybinder.readthedocs.io/en/latest/using/config_files.html or contact the person below.

How to use the analysis environment

1. Open the URL given by the instructor in your browser.
   
   • In this example, it is https://binder.cs.rcos.nii.ac.jp/v2/gh/ikfj/ds-polimetrics/master.
2. Select your institution or OpenIdP in the affiliation selection, and click the [Select] button.
3. Authenticate with your institution's or OpenIdP's account.

4. A new analysis environment for you will be created.

5. Click New → RStudio on the right side of Files. RStudio will open in a new tab.
   
   
   
   
6. 講師の指示に従って RStudio を使いましょう。

手順1.で URL を開くたびに新たな分析環境が作られる点に注意してください。つまり、この URL を2回開いたら、受講者は2個の分析環境を持つことになります。ひとりの受講者が最大20個の分析環境を持つことができます。

作業を終えたら、変更したファイルを保存してブラウザを閉じます。ブラウザを閉じても分析環境は失われません。

以前に作った自分用の分析環境で作業を再開するには

1. https://jupyter.cs.rcos.nii.ac.jp/ をブラウザで開きます。
2. Named Servers の下にある URL をクリックします。複数の分析環境を作った場合、それぞれの URL が表示されます。
   
   

不要な分析環境を削除するには

1. https://jupyter.cs.rcos.nii.ac.jp/ をブラウザで開きます。
2. 右側の [stop] ボタンを押し、しばらく待ちます。
3. 右側に現れる [delete] ボタンを押します。

Contact Information

　　Research Center for Open Science, National Institute of Informatics

　　Ikki Fujiwara, Online Analysis System <cs-support@nii.ac.jp>