X-CITE Workshop 2024

Hands-on Tutorial Instructions

1. Set up CLASSE account according to instructions in notification email:
   • Set password
   • Enroll in CLASSE Duo
      
2. Log into CLASSE JupyterHub:
   • Browse to https://jupyter01.classe.cornell.edu
   • Server Options: Select a job profile: Local Process on JupyterHub Server
   • Respond to Duo prompt
      
3. Open Terminal in JupyterHub: [click for screenshot]
   • Launcher tab: Terminal
   • OR File → New → Terminal
   • To verify your current directory, type: pwd
     • The result should be your home directory: /home/<your username>
        
4. Your home directory should be reserved for administrative uses. Instead, change directory to your CHESS user directory:
   • Type: cd /nfs/chess/user/<your username>
     • If the directory does not exist, first type:
       mkdir /nfs/chess/user/<your username>
   • [Optional, for advanced users in the morning sessions]
     Follow along with the Jupyter notebooks:
     • Type: cp -R /nfs/chess/user/x-cite/X-CITE .
       • OR type: git clone git@github.com:RENCI-NRIG/X-CITE.git
     • In JupyterHub, navigate to .ipynb files in
       CLASSE_shortcuts/chess_[username]/X-CITE/theme1/PE100, PE101, or PE102
        
5. Copy tutorial examples:
   • Verify your current directory by typing: pwd
     • If the result is not /nfs/chess/user/<your username>, then go back to Step 4
   • Type: cp -R /nfs/chess/user/x-cite/X-CITE/theme4/XS101/CHAP-Training-Examples-Materials .
     • N.B.: There is a space and a period at the end of that last command!
        
6. Run CHAP examples:
   • Click on example_01 and follow the instructions
     • Type commands into the Terminal window on JupyterHub
   • Click on example_02 and follow the instructions
     • Type commands into the Terminal window on JupyterHub
   • When finished in JupyterHub, File → Logout
      
7. NSDF/CHESS data visualization dashboard:
   • Browse to https://chess-tutorial.nationalsciencedatafabric.org
      
8. If you wish to download any workshop materials to your local computer, use these instructions: https://wiki.classe.cornell.edu/CHESS/CHESSUsersDataTransfer