python:outils:jupyter [WEBGE Wikis]

[Mise à jour le : 25/8/2022]

Sources
- Site jupyter.org
- Jupyter dans l'extension Python de l'IDE VSCode
- Introduction aux Notebooks IPython…pdf

Ressources
- Evaluer dans Jupyter
- Google Colab : Le Guide Ultime
- Real Python
  - Jupyter Notebook: An Introduction
  - How to use ipywidgets to make your Jupyter notebook interactive

Jupyter (anciennement IPython Notebook) est un projet open-source qui vous permet de combiner facilement du texte Markdown et du code source Python exécutable sur un canevas appelé notebook.

2.1 Lancer une session

Seulon l'installation réalisée, on pourra utiliser une des deux solutions suivantes :

Solution 1
- Ouvrir une invite de commandes à partir de la barre de recherche
- Entrer le texte “jupyter notebook”
- Le bureau Jupyter s'ouvre dans un navigateur

Solution 2
- Entrer “jupyter” dans la barre de recherche et sélectionner :
- Le bureau Jupyter s'ouvre dans un navigateur

2.2 Ouvrir un notebook

Un notebook est un fichier avec l'extension .ipynb

Se placer dans le répertoire où se trouve le notebook et cliquer dessus pour l'ouvrir.

Exemple : notebook PageRank situé dans Desktop/jupyter_pagerank

2.3 Evaluer une cellule de code

Une fois sélectionnée, une cellules de code est évaluée par la combinaison des touches Maj et Entrée ou en cliquant sur

.

Exemple

Si le code que l'on évalue dépend de codes situés en amont, ceux-ci doivent être évalués en respectant l'ordre d'exécution. Dans l'exemple ci-dessus, deux cellules ont été évaluées avant la boucle.

Si le code que l'on évalue dépend de codes situés en amont, ceux-ci doivent être évalués en respectant l'ordre d'exécution.
Dans l'exemple ci-dessus, deux cellules ont été évaluées avant la boucle for… .Le numéro entre crochets donne l'ordre dans lequel les cellules ont été évaluées.
Attention a bien évaluer les cellules dans l'ordre.

2.4 Réinitialiser l'interpréteur

Sélectionner Kernel → Restart & Clear Output.

2.5 Sauvegarder dans différents formats

File → Download as → (Notebook, Python etc.)

2.6 Installer des packages

Ressource
- Installing Python Packages from a Jupyter Notebook

jupyter et canvas
- Ressource : ipycanvas une bibliothèque légère, rapide et stable exposant l' API Canvas du navigateur à IPython

Sources
- Site mybinder.org
- Tutoriel From Zero to Binder in Python!
- Documentation

binder offre une solution de service en ligne gratuit de Notebook interactifs sans avoir à installer un serveur JupyterHub local et ouvert sur l’extérieur.

3.1 Mise en oeuvre

Créer un jupyter et ses dépendances
Installer l'ensemble des fichiers dans un dépôt Github
Ouvrir mybinder.org et placer le nom ou URL du référentiel GitHub.
mybinder construit le notebook dans le navigateur

3.2 Référentiel de classeur

Sources
- Mise en oeuvre d'un environnement Python avec requirements.txt. Sources sur Github.

Lorsque des bibliothèques doivent être installées par binder, il est nécessaire d'inclure un fichier requirement.txt dans le projet.

Outil
- pip-tools

Opérations à réaliser
1. Installer pip-tools dans le répertoire du notebook
2. Créer un fichier texte requirements.in dans lequel on placera la liste des bibliothèques à installer
3. Générer le fichier requirements.txt avec pip-tools

Source : Bienvenue dans Colaboratory

Colaboratory, souvent raccourci en “Colab”, permet d'écrire et d'exécuter du code Python dans un navigateur.
Il offre les avantages suivants :

Aucune configuration requise
Accès gratuit aux GPU
Partage facile

5.1 Ajouter Colab dans son compte Google Drive

Pour utiliser Google colab il suffit d'aller sur son compte google drive, de cliquer sur nouveau et sur “plus” afin de choisir “Colaboratory”.
Si l'option “Colaboratory” n'est pas présente, cliquer sur “Associer plus d'applications”, rechercher “Colaboratory” et cliquer sur connecter.