====== Jupyter NoteBook ======
===== Introduction =====
{{ :jupyter_logo.png?300|}}
[[https://jupyter.org/|Jupyter]] Notebooks are executable documents containing: **formatted text**, **formatted maths**, chunks of **code** plus **figures**, **tables** and textual output generated by that code.
Notebooks can be used:
  * to develop and execute linear data analysis workflows
  * to present [[http://nbviewer.jupyter.org/github/machinalis/satimg/blob/master/Searching%20for%20aliens.ipynb|linear workflows]] to others;
  * to share presentation or [[http://nbviewer.jupyter.org/github/cossatot/lanf_earthquake_likelihood/blob/master/notebooks/lanf_manuscript_notebook.ipynb|research results]] 
  * as [[http://bitsandchips.me/BAD_days/|teaching materials]]

Jupyter itself is **web application** that interprets, runs and renders Notebooks. User just connect to the web interface and interact with it.

==== Components ====

The Jupyter Notebook combines three components:

  - **The notebook web application**: An interactive web application for writing and running code interactively and authoring notebook documents.
  - **Kernels**: Separate processes started by the notebook web application that runs users’ code in a given language and returns output back to the notebook web application. The kernel also handles things like computations for interactive widgets, tab completion and introspection.
  - **Notebook documents**: Self-contained documents that contain a representation of all content visible in the notebook web application, including inputs and outputs of the computations, narrative text, equations, images, and rich media representations of objects. Each notebook document has its own kernel.

{{ :jupyterpreview.png?600 |}}


/**
On the university’s MesoFC cluster a JupyterHub service allows a user to:

  - Log in to the JupyterHub web inteface,
  - Specify what resources (memory, CPU cores, GPUs) they want for a Jupyter session,
  - Start and run a Jupyter Notebook server on a worker node in the cluster using these resources.
*/

===== Using Jupyter on MesoFC =====
<note tip> 
    * Jupyter ''version 4.4'' is installed with ''Intel Python 3.5''. A lot of populars python modules are available (panda, fftw, matplotlib, ...)   
    * availabe kernels :
         * Python3
         * Bash
         * Tensorflow with Python2 under Singularity container 
</note>


/**
On the university’s MesoFC cluster a JupyterHub service allows a user to:

  - Log in to the JupyterHub web inteface,
  - Specify what resources (memory, CPU cores, GPUs) they want for a Jupyter session,
  - Start and run a Jupyter Notebook server on a worker node in the cluster using these resources.
*/
 
  -[[jupyterhub:start| Connecting to JupyterHub, requesting resources (RAM, processors, GPUs) for your Jupyter session, and starting your session]]
  - [[jupyterhub:file_browser|Jupyter file browser]]
  - [[jupyterhub:terminal|Terminal in your browser]]
  - [[jupyterhub:notebooks|Creating, editing and running Jupyter Notebooks]]
  - [[jupyterhub:monitoring|Monitoring and controlling your Jupyter session]]
  - [[jupyterhub:custom_conda|Custom conda environment within a notebook]]
  /**- [[jupyterhub:troubleshooting|Errors and troubleshooting]]*/

===== Links =====
  * http://jupyter.org/ official site
  * http://jupyter-notebook.readthedocs.io official documentation 
  * https://nbviewer.jupyter.org/ collection of notebooks 
  * https://github.com/jupyter/jupyter/wiki/A-gallery-of-interesting-Jupyter-Notebooks