== Jupyter Notebook ==
The ​[https://jupyter.org/ Jupyter Notebook] is a web application that allows you to create and share documents that contain live code, equations, visualizations, and explanatory text.

1. Login to Cypress with port-forwarding
{{{
[user@local ~]$ ssh -L 8888:127.0.0.1:12345 userID@cypress.tulane.edu
}}}
 '''Replace '12345' with a big number you like'''.

2. On Cypress, move to your desired directory (see the [[BasicLinuxComands#cd|cd]] command) for containing either existing or future notebook files - usually with file extension '''.ipynb'''.
3. Start an interactive session with port-forwarding. '''Replace '12345' with the same big number you specified above'''. If you need Centos 7 with glibc 2.17, then include in your idev command the idev parameter '''--partition=centos7'''. (See [[using#Requestingpartitioncentos7withglibc2.17|Centos 7/glibc 2.17]] and [[using#Options|idev options]].)
{{{
[userID@cypress2 Python]$ idev --port=12345:8888 -t 8 -c 1
Requesting 1 node(s)  task(s) to normal queue of defq partition
1 task(s)/node, 1 cpu(s)/task, 2 MIC device(s)/node
Time: 08 (hr) 00 (min).
Submitted batch job 282455
JOBID=282455 begin on cypress01-093
--> Creating interactive terminal session (login) on node cypress01-093.
--> You have 08 (hr) 00 (min).
--> Assigned Host List : /tmp/idev_nodes_file_fuji
Last login: Wed Aug 24 11:46:09 2016 from cypress2.cm.cluster

}}}

4. Load the module and start jupyter notebook server.
{{{
[userID@cypress01-093 Python]$ module load anaconda3
[userID@cypress01-093 Python]$ jupyter notebook --port=8888 --no-browser
}}}

5. Examine the resulting output in your terminal window and locate any occurrence of a string starting with '''http:^^/^^/''' and including a parameter named '''token''' assigned to a string of hexadecimal digits (0-9,a-f). The former string is a URL for your own personal use to authenticate the current notebook session.
{{{
http://localhost:8888/?token=9a84272b92849f6d560e0068de58a4b2a4ab0cb00387bf36 (example only)
}}}
{{{
http://127.0.0.1:8888/?token=9a84272b92849f6d560e0068de58a4b2a4ab0cb00387bf36 (example only)
}}}

6. Using your own personal URL from above from your terminal window (not the example above), copy and paste that URL to the address field in your local web browser, and press <Enter> and observe the notebook web page in your browser.

'''Note: your ''jupyter notebook'' session will be killed when the idev-session time exceeds the walltime limit (that is 8 hours in the example above).'''

Ctrl+c to shutdown ''jupyter notebook''.