UtiliserJupyter : Différence entre versions

De M@gistère
Sauter à la navigation Sauter à la recherche
(Page créée avec « Comment utiliser les notebooks En haut du notebook, vous avez une barre de menu (sur fond bleu clair), contenant : un titre pour le notebook, avec un numéro de vers... »)
 
 
(10 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
−
Comment utiliser les notebooks
+
=== Comment utiliser les notebooks ===
  
−
En haut du notebook, vous avez une barre de menu (sur fond bleu clair), contenant :
 
  
−
    un titre pour le notebook, avec un numéro de version ;
+
[[Fichier:Capture d’écran de 2019-03-12 16-30-30.png|nb001]]
−
    une barre de menus avec les entrées File, Insert, Cell, Kernel;
 
−
    et une barre de boutons qui sont des raccourcis vers certains menus fréquemment utilisés. Si vous laissez votre souris au dessus d'un bouton, un petit texte apparaît, indiquant à quelle fonction correspond ce bouton.
 
  
−
Nous avons vu dans la vidéo qu'un notebook est constitué d'une suite de cellules, soit textuelles, soit contenant du code. Les cellules de code sont facilement reconnaissables, elles sont précédées de In [ ]:. La cellule qui suit celle que vous êtes en train de lire est une cellule de code.
+
En haut du notebook, vous avez une barre de menu (sur fond bleu clair), contenant :
−
 
+
* un titre pour le notebook, avec un numéro de version ;
−
Pour commencer, sélectionnez cette cellule de code avec votre souris, et appuyez dans la barre de menu - en haut du notebook, donc - sur celui en forme de flèche triangulaire vers la droite (Play) :
+
* une barre de menus avec les entrées <code>File</code>, <code>Insert</code>, <code>Cell</code>, <code>Kernel</code>;
−
 
+
* et une barre de boutons qui sont des raccourcis vers certains menus  fréquemment utilisés. Si vous laissez votre souris au dessus d'un  bouton, un petit texte apparaît, indiquant à quelle fonction correspond  ce bouton.
−
def perim(r):
+
Nous avons vu dans la vidéo qu'un notebook est constitué d'une suite  
−
 
+
de cellules, soit textuelles, soit contenant du code.  
−
    P = 2*3.14159*r
 
  
−
    return P
+
Les cellules de
 +
code sont facilement reconnaissables, elles sont précédées de <code>In [ ]:</code> ou <code>Entrée [ ]:</code>. La cellule reproduite ci-dessous est une cellule de code.
  
−
perim(35)
+
Pour commencer, sélectionnez cette cellule de code avec votre souris, et appuyez dans la barre de menu - en haut du notebook, donc - sur
 +
celui en forme de flèche triangulaire vers la droite (Play) :
  
−
219.91129999999998
+
[[Fichier:Capture d’écran de 2019-03-12 16-34-01.png|nb002]]
  
 
Comme vous le voyez, la cellule est "exécutée" (on dira plus volontiers évaluée), et on passe à la cellule suivante.
 
Comme vous le voyez, la cellule est "exécutée" (on dira plus volontiers évaluée), et on passe à la cellule suivante.
 +
Alternativement, vous pouvez simplement taper au clavier <strong><em>Shift+Enter</em></strong>, ou selon les claviers <strong><em>Maj-Entrée</em></strong>,
 +
<nowiki> </nowiki>pour obtenir le même effet. D'une manière générale, il est important
 +
d'apprendre et d'utiliser les raccourcis clavier, cela vous fera gagner
 +
beaucoup de temps par la suite.
  
−
Alternativement, vous pouvez simplement taper au clavier Shift+Enter, ou selon les claviers Maj-Entrée, pour obtenir le même effet. D'une manière générale, il est important d'apprendre et d'utiliser les raccourcis clavier, cela vous fera gagner beaucoup de temps par la suite.
+
La façon habituelle d'<em>exécuter</em> l'ensemble du notebook consiste :
 +
* à sélectionner la première cellule,
 +
* et à taper <strong><em>Shift+Enter</em></strong> jusqu'à attendre la fin du notebook.
 +
Lorsqu'une cellule de code a été évaluée, Jupyter ajoute sous la cellule <code>In</code> une cellule <code>Out</code> qui donne le résultat du fragment Python, soit ci-dessus 600.
  
−
La façon habituelle d'exécuter l'ensemble du notebook consiste :
+
Jupyter ajoute également un nombre entre les crochets pour afficher, par exemple ci-dessus, <code>In [1]:</code>. Ce nombre vous permet de retrouver l'ordre dans lequel les cellules ont été évaluées.
  
−
    à sélectionner la première cellule,
+
Vous pouvez naturellement modifier ces cellules de code pour faire des
−
    et à taper Shift+Enter jusqu'à attendre la fin du notebook.
+
essais ; ainsi vous pouvez vous servir du modèle ci-dessous pour
 +
calculer la racine carrée de 3, ou essayer la fonction sur un nombre
 +
négatif et voir comment est signalée l'erreur.
  
−
Lorsqu'une cellule de code a été évaluée, Jupyter ajoute sous la cellule In une cellule Out qui donne le résultat du fragment Python, soit ci-dessus 600.
+
[[Fichier:Capture d’écran de 2019-03-12 16-40-57.png|nb005]]
  
−
Jupyter ajoute également un nombre entre les crochets pour afficher, par exemple ci-dessus, In [1]:. Ce nombre vous permet de retrouver l'ordre dans lequel les cellules ont été évaluées.
 
  
−
Vous pouvez naturellement modifier ces cellules de code pour faire des essais ; ainsi vous pouvez vous servir du modèle ci-dessous pour calculer la racine carrée de 3, ou essayer la fonction sur un nombre négatif et voir comment est signalée l'erreur.
+
On peut également évaluer tout le notebook en une seule fois en utilisant le menu <em>Cell -> Run All</em>.
  
−
# math.sqrt (pour square root) calcule la racine carrée
+
=== Attention à bien évaluer les cellules dans l'ordre ===
 +
Il est important que les cellules de code soient évaluées dans le bon
 +
ordre. Si vous ne respectez pas l'ordre dans lequel les cellules de code
 +
sont présentées, le résultat peut être inattendu.
 +
En fait, évaluer un programme sous forme de notebook revient à le
 +
découper en petits fragments, et si on exécute ces fragments dans le
 +
désordre, on obtient naturellement un programme différent.
  
−
import math
+
On le voit sur cet exemple :
  
−
math.sqrt(2)
 
  
−
On peut également évaluer tout le notebook en une seule fois en utilisant le menu Cell -> Run All.
+
[[Fichier:Capture d’écran de 2019-03-12 16-41-07.png|nb004]]
−
Attention à bien évaluer les cellules dans l'ordre
 
  
−
Il est important que les cellules de code soient évaluées dans le bon ordre. Si vous ne respectez pas l'ordre dans lequel les cellules de code sont présentées, le résultat peut être inattendu.
 
  
−
En fait, évaluer un programme sous forme de notebook revient à le découper en petits fragments, et si on exécute ces fragments dans le désordre, on obtient naturellement un programme différent.
+
Si un peu plus loin dans le notebook on fait par exemple :
−
 
 
−
On le voit sur cet exemple :
 
  
−
message = "Faites attention à l'ordre dans lequel vous évaluez les notebooks"
 
  
−
print(message)
+
[[Fichier:Capture d’écran de 2019-03-12 16-41-17.png|nb003]]
  
−
Si un peu plus loin dans le notebook on fait par exemple :
+
qui rend le symbole <code>message</code> indéfini, alors bien sûr on ne peut plus évaluer la cellule qui fait <code>print</code> puisque la variable <code>message</code> n'est plus connue de l'interpréteur.
  
−
# ceci a pour effet d'effacer la variable 'message'
+
=== Réinitialiser l'interpréteur ===
 +
Si
 +
<nowiki> </nowiki>vous faites trop de modifications, ou perdez le fil de ce que vous avez
 +
<nowiki> </nowiki>évalué, il peut être utile de redémarrer votre interpréteur. Le menu <em>Kernel → Restart</em>
 +
<nowiki> </nowiki>vous permet de faire cela, un peu à la manière de IDLE qui repart d'un
 +
interpréteur vierge lorsque vous utilisez la fonction F5.
  
−
del message
+
Le menu <em>Kernel → Interrupt</em>
 +
<nowiki> </nowiki>peut être quant à lui utilisé si votre fragment prend trop longtemps à
 +
s'exécuter (par exemple vous avez écrit une boucle dont la logique est
 +
cassée et qui ne termine pas).
  
−
qui rend le symbole message indéfini, alors bien sûr on ne peut plus évaluer la cellule qui fait print puisque la variable message n'est plus connue de l'interpréteur.
+
=== Vous travaillez sur une copie ===
−
Réinitialiser l'interpréteur
+
Un
 +
<nowiki> </nowiki>des avantages principaux des notebooks est de vous permettre de
 +
modifier le code que nous avons écrit, et de voir par vous-même comment
 +
se comporte le code modifié.
 +
Pour cette raison, chaque élève dispose de sa <strong>propre copie</strong>
 +
<nowiki> </nowiki>de chaque notebook, vous pouvez bien sûr apporter toutes les
 +
modifications que vous souhaitez à vos notebooks sans affecter les
 +
autres étudiants.
  
−
Si vous faites trop de modifications, ou perdez le fil de ce que vous avez évalué, il peut être utile de redémarrer votre interpréteur. Le menu Kernel → Restart vous permet de faire cela, un peu à la manière de IDLE qui repart d'un interpréteur vierge lorsque vous utilisez la fonction F5.
+
=== Revenir à la version du cours ===
 +
Vous pouvez toujours revenir à la version "du cours" grâce au menu
 +
<em>File → Reset to original</em>.
  
−
Le menu Kernel → Interrupt peut être quant à lui utilisé si votre fragment prend trop longtemps à s'exécuter (par exemple vous avez écrit une boucle dont la logique est cassée et qui ne termine pas).
+
Attention, avec cette fonction vous restaurez <strong>tout le notebook</strong> et donc <strong>vous perdez vos modifications sur ce notebook</strong>.
−
Vous travaillez sur une copie
 
  
−
Un des avantages principaux des notebooks est de vous permettre de modifier le code que nous avons écrit, et de voir par vous-même comment se comporte le code modifié.
+
=== Télécharger au format Python ===
 +
Vous pouvez télécharger un notebook au format Python sur votre ordinateur grâce au menu
 +
<em>File → Download as → Python</em>
  
−
Pour cette raison, chaque élève dispose de sa propre copie de chaque notebook, vous pouvez bien sûr apporter toutes les modifications que vous souhaitez à vos notebooks sans affecter les autres étudiants.
+
Les cellules de texte sont préservées dans le résultat sous forme de commentaires Python.
−
Revenir à la version du cours
 
  
−
Vous pouvez toujours revenir à la version "du cours" grâce au menu File → Reset to original.
+
=== Partager un notebook en lecture seule ===
 +
Enfin, avec le menu <em>File → Share static version</em>,
 +
<nowiki> </nowiki>vous pouvez publier une version en lecture seule de votre notebook ;
 +
vous obtenez une URL que vous pouvez publier, par exemple pour demander
 +
de l'aide sur le forum. Ainsi, les autres étudiants peuvent accéder en
 +
lecture seule à votre code.
  
−
Attention, avec cette fonction vous restaurez tout le notebook et donc vous perdez vos modifications sur ce notebook.
+
Notez
−
Télécharger au format Python
+
<nowiki> </nowiki>que lorsque vous utilisez cette fonction plusieurs fois, c'est toujours
 +
<nowiki> </nowiki>la dernière version publiée que verront vos camarades, l'URL utilisée
 +
reste toujours la même pour un étudiant et un notebook donné.
  
−
Vous pouvez télécharger un notebook au format Python sur votre ordinateur grâce au menu File → Download as → Python
+
=== Ajouter des cellules ===
 +
Vous pouvez ajouter une cellule n'importe où dans le document avec le bouton <strong>+</strong> de la barre de boutons.
 +
Aussi, lorsque vous arrivez à la fin du document, une nouvelle
 +
cellule est créée chaque fois que vous évaluez la dernière cellule ; de
 +
cette façon vous disposez d'un brouillon pour vos propres essais.
  
−
Les cellules de texte sont préservées dans le résultat sous forme de commentaires Python.
+
À vous de jouer.
−
Partager un notebook en lecture seule
 
−
 
 
−
Enfin, avec le menu File → Share static version, vous pouvez publier une version en lecture seule de votre notebook ; vous obtenez une URL que vous pouvez publier, par exemple pour demander de l'aide sur le forum. Ainsi, les autres étudiants peuvent accéder en lecture seule à votre code.
 
−
 
 
−
Notez que lorsque vous utilisez cette fonction plusieurs fois, c'est toujours la dernière version publiée que verront vos camarades, l'URL utilisée reste toujours la même pour un étudiant et un notebook donné.
 
−
Ajouter des cellules
 
  
−
Vous pouvez ajouter une cellule n'importe où dans le document avec le bouton + de la barre de boutons.
 
  
−
Aussi, lorsque vous arrivez à la fin du document, une nouvelle cellule est créée chaque fois que vous évaluez la dernière cellule ; de cette façon vous disposez d'un brouillon pour vos propres essais.
 
  
−
À vous de jouer.
+
''Licence CC BY-NC-ND Thierry Parmentelat & Arnaud Legout''

Version actuelle datée du 12 mars 2019 à 15:58

Comment utiliser les notebooks

nb001

En haut du notebook, vous avez une barre de menu (sur fond bleu clair), contenant :

  • un titre pour le notebook, avec un numéro de version ;
  • une barre de menus avec les entrées File, Insert, Cell, Kernel;
  • et une barre de boutons qui sont des raccourcis vers certains menus fréquemment utilisés. Si vous laissez votre souris au dessus d'un bouton, un petit texte apparaît, indiquant à quelle fonction correspond ce bouton.

Nous avons vu dans la vidéo qu'un notebook est constitué d'une suite de cellules, soit textuelles, soit contenant du code.

Les cellules de code sont facilement reconnaissables, elles sont précédées de In [ ]: ou Entrée [ ]:. La cellule reproduite ci-dessous est une cellule de code.

Pour commencer, sélectionnez cette cellule de code avec votre souris, et appuyez dans la barre de menu - en haut du notebook, donc - sur celui en forme de flèche triangulaire vers la droite (Play) :

nb002

Comme vous le voyez, la cellule est "exécutée" (on dira plus volontiers évaluée), et on passe à la cellule suivante. Alternativement, vous pouvez simplement taper au clavier Shift+Enter, ou selon les claviers Maj-Entrée, pour obtenir le même effet. D'une manière générale, il est important d'apprendre et d'utiliser les raccourcis clavier, cela vous fera gagner beaucoup de temps par la suite.

La façon habituelle d'exécuter l'ensemble du notebook consiste :

  • à sélectionner la première cellule,
  • et à taper Shift+Enter jusqu'à attendre la fin du notebook.

Lorsqu'une cellule de code a été évaluée, Jupyter ajoute sous la cellule In une cellule Out qui donne le résultat du fragment Python, soit ci-dessus 600.

Jupyter ajoute également un nombre entre les crochets pour afficher, par exemple ci-dessus, In [1]:. Ce nombre vous permet de retrouver l'ordre dans lequel les cellules ont été évaluées.

Vous pouvez naturellement modifier ces cellules de code pour faire des essais ; ainsi vous pouvez vous servir du modèle ci-dessous pour calculer la racine carrée de 3, ou essayer la fonction sur un nombre négatif et voir comment est signalée l'erreur.

nb005


On peut également évaluer tout le notebook en une seule fois en utilisant le menu Cell -> Run All.

Attention à bien évaluer les cellules dans l'ordre

Il est important que les cellules de code soient évaluées dans le bon ordre. Si vous ne respectez pas l'ordre dans lequel les cellules de code sont présentées, le résultat peut être inattendu. En fait, évaluer un programme sous forme de notebook revient à le découper en petits fragments, et si on exécute ces fragments dans le désordre, on obtient naturellement un programme différent.

On le voit sur cet exemple :


nb004


Si un peu plus loin dans le notebook on fait par exemple :


nb003

qui rend le symbole message indéfini, alors bien sûr on ne peut plus évaluer la cellule qui fait print puisque la variable message n'est plus connue de l'interpréteur.

Réinitialiser l'interpréteur

Si vous faites trop de modifications, ou perdez le fil de ce que vous avez évalué, il peut être utile de redémarrer votre interpréteur. Le menu Kernel → Restart vous permet de faire cela, un peu à la manière de IDLE qui repart d'un interpréteur vierge lorsque vous utilisez la fonction F5.

Le menu Kernel → Interrupt peut être quant à lui utilisé si votre fragment prend trop longtemps à s'exécuter (par exemple vous avez écrit une boucle dont la logique est cassée et qui ne termine pas).

Vous travaillez sur une copie

Un des avantages principaux des notebooks est de vous permettre de modifier le code que nous avons écrit, et de voir par vous-même comment se comporte le code modifié. Pour cette raison, chaque élève dispose de sa propre copie de chaque notebook, vous pouvez bien sûr apporter toutes les modifications que vous souhaitez à vos notebooks sans affecter les autres étudiants.

Revenir à la version du cours

Vous pouvez toujours revenir à la version "du cours" grâce au menu File → Reset to original.

Attention, avec cette fonction vous restaurez tout le notebook et donc vous perdez vos modifications sur ce notebook.

Télécharger au format Python

Vous pouvez télécharger un notebook au format Python sur votre ordinateur grâce au menu File → Download as → Python

Les cellules de texte sont préservées dans le résultat sous forme de commentaires Python.

Partager un notebook en lecture seule

Enfin, avec le menu File → Share static version, vous pouvez publier une version en lecture seule de votre notebook ; vous obtenez une URL que vous pouvez publier, par exemple pour demander de l'aide sur le forum. Ainsi, les autres étudiants peuvent accéder en lecture seule à votre code.

Notez que lorsque vous utilisez cette fonction plusieurs fois, c'est toujours la dernière version publiée que verront vos camarades, l'URL utilisée reste toujours la même pour un étudiant et un notebook donné.

Ajouter des cellules

Vous pouvez ajouter une cellule n'importe où dans le document avec le bouton + de la barre de boutons. Aussi, lorsque vous arrivez à la fin du document, une nouvelle cellule est créée chaque fois que vous évaluez la dernière cellule ; de cette façon vous disposez d'un brouillon pour vos propres essais.

À vous de jouer.


Licence CC BY-NC-ND Thierry Parmentelat & Arnaud Legout

Récupérée de « https://wiki.magistere.education.fr/index.php?title=UtiliserJupyter&oldid=2989 »