== Jupyter 
[[PageOutline]]

[[span(style=color: #FF0000, '''Jupyter for JSC is in alpha phase''')]]

[[Image(jupyterpreview.png, 400px, align=right, margin=10, link=wiki:vnc3d)]]

[[Image(jupyter-logo.png,200px, align=left, margin=15, link:vnc3d)]]
\\
The Jupyter Notebook is an open-source web application that allows you to create and share documents that contain live code, equations, visualizations and explanatory text. Uses include: data cleaning and transformation, numerical simulation, statistical modeling, machine learning and much more.

\\
\\

[[Image(jupyterhub-logo.png, 200px, align=left, margin=15, link:vnc3d)]] 
\\
Project Jupyter created !JupyterHub to support many users.
The Hub can offer notebook servers to a class of students, a corporate data science workgroup, a scientific research project, or a high performance computing group.
With !JupyterHub a multi-user Hub which spawns, manages, and proxies multiple instances of the single-user Jupyter notebook (IPython notebook) server can be created.

\\
\\
\\
\\
=== Where are the sources?

* Jupyter: [https://github.com/jupyter/jupyter]
  * Jupyter Notebook: [https://github.com/jupyter/notebook]
    * Jupyter Console: [https://github.com/jupyter/jupyter_console]
    * Jupyter NBViewer: [https://github.com/jupyter/nbviewer]
  * Jupyter Kernel
    * Jupyter IPyKernel: [https://github.com/ipython/ipykernel]
    * Jupyter IPyWidgets: [https://github.com/jupyter-widgets/ipywidgets]
  * other
    * Tornado Web Server: [https://github.com/tornadoweb/tornado]

* !JupyterLab: [https://github.com/jupyterlab/jupyterlab]

* !JupyterHub: [https://github.com/jupyterhub/jupyterhub]
  * Jupyter Http Proxy: [https://github.com/jupyterhub/configurable-http-proxy]


=== How does it work?

==== !JupyterHub
!JupyterHub is a multi-user server that manages and proxies multiple instances of the single-user Jupyter notebook server.

There are three basic processes involved:
* multi-user Hub (!Python/Tornado)
* configurable http proxy (node-http-proxy)
* multiple single-user IPython notebook servers (Python/IPython/Tornado)

The proxy is the only process that listens on a public interface. The Hub sits behind the proxy at /hub. Single-user servers sit behind the proxy at /user/[username].

more: https://jupyterhub.readthedocs.io/en/0.7.2/howitworks.html

===== Callpath
* start the Tornado event loop [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1638 app.py:1638]
* initialize !JupyterHub and all its services [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L365 app.py:365]
  * init webserver   [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1284 app.py:1284]
    * init Jinja2 template engine [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1291 app.py:1291]
    * static_path points to HTML/JS/JINJA2 files [https://github.com/jupyterhub/jupyterhub/tree/master/share/jupyter/hub/ webfiles]
* start !JupyterHub and all its services  [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1517 app.py:1517]
  * start webserver  [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1532 app.py:1532]
  * start http proxy [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1542 app.py:1542]
  * start services   [https://github.com/jupyterhub/jupyterhub/blob/master/jupyterhub/app.py#L1551 app.py:1551]

===== Websites
The websites of !JupyterHub are stored in [https://github.com/jupyterhub/jupyterhub/tree/master/share/jupyter/hub/ share/jupyter/hub] \\
They are build with the template engine [http://jinja.pocoo.org/ Jinja2] for Python . A detailed description of the API can be found [http://jinja.pocoo.org/docs/2.9/api/ here].


----
any feedback welcomed - [mailto:h.zilken@fz.juelich.de], [mailto:j.goebbert@fz-juelich.de]