Outils pour utilisateurs

Outils du site


dev:python:jupyter-notebook:start

Ceci est une ancienne révision du document !


Jupyter notebook

Le nom Jupyter vient de la contraction des 3 principaux langages utilisés dans le domaine de la data science: Julia, Python et R. L'extension d'un fichier notebook produit par Jupyter est .pynb pour IPython NoteBook, ancien nom du projet Jupyter.

Jupyter est à la fois:

  • Une application Web interactive dans laquelle on peut développer, documenter, exécuter et partager du code.
  • Un document qui intègre du code et des parties dynamiques ainsi que de la documentation formatée en Markdown ou Latex, des médias audio ou vidéo.

Installation

L'installation de jupyter notebook est détaillée dans le wiki installer jupyter notebook.

Structure d'une note jupyter

Les notes (notebook) sont des fichiers texte au format JSON portant l'estension .pynb. Elles sont interprétées par le serveur Jupyter.

Une note est une séquence de cellules. Une cellule est une entrée texte multi-ligne pouvant être exécutée/interprétée via le bouton Play/Exécuter de la barre d'outil ou la combinaison ⇧ Shift+↵ Enter.

3 types de cellules existent:

  • Code: Permettant d'éditer/exécuter du code dans le langage correspondant au noyau actif. La sortie produite n'est pas limitée au texte (tableau HTML, images et graphiques matplotlib, insertion de fichiers audio ou vidéo et génération de liens etc)
  • Markdown: Texte formaté en Markdown pouvant inclure des formules mathématiques en utilisant la syntaxe en ligne $..$ LaTeX ou l'insertion d'une zone dédiée $$..$$.
  • Cellule brute offre un espace de sortie directe non interprétée par le serveur notebook.

Un exemple de notebook exploitant quelques éléments de la sortie enrichie est disponible à l'url https://nbviewer.jupyter.org/github/ipython/ipython/blob/master/examples/IPython%20Kernel/Rich%20Output.ipynb

Workflow

Le workflow est similaire à celui appliqué lors d'une session d'IPython à la différence qu'il est possible d’éditer une cellule autant de fois que nécessaire.

On décompose la problématique via les cellules en passant à la suivante lorsque la précédente s’exécute correctement.

Modes et raccourcis

Pour chaque action il existe un raccourcis clavier.

Deux modes existent: commande et édition

Presser Esc pour basculer en mode commande. Dans ce mode, on peut naviguer dans le document et lancer des commandes.

Presser ↵ Enter pour passer en mode édition. C'est dans ce mode que le contenu d'une cellule peut être édité.

Références

dev/python/jupyter-notebook/start.1598185463.txt.gz · Dernière modification : 2021/02/01 21:51 (modification externe)