{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Carnet Jupyter d'exemple"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Un carnet Jupyter est composé de *cellules*. Ces cellules peuvent être de deux types :\n",
"\n",
"- Les cellules textuelles (comme celle-ci) qui contiennent des commentaires, des remarques, etc. Elles sont formatées en Markdown, un langage de balisage simplifié qui permet de mettre en forme son texte. Pour plus d'informations, se référer à \n",
"- Les cellules de code, qui contiennent du code Python que l'on peut exécuter. Ces cellules sont composées de deux parties :\n",
" - Une première partie qui contient le code Python à proprement parler.\n",
" - Une seconde partie qui contient le résultat du code Python. Cette partie n'apparaît que lorsque l'on a exécuté la cellule au moins une fois."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Cellules de code"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Voici un exemple de cellule de code :"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"message = \"Bonjour, \"\n",
"message += \"le monde !\"\n",
"print(message)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Comme vous pouvez le constater, une cellule de code peut être constituée de plusieurs lignes de codes qui sont exécutées à la suite. Le résultat s'affiche juste en dessous. Dans VSCode, pour en lancer une, cliquez sur l'icône en forme de triangle au-dessus de la cellule, ou tapez Ctrl+Enter (la touche contrôle et la touche entrée)."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Voici un autre exemple de cellule de code :"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"print(message)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Comme vous le voyez, les variables sont gardées entre deux exécutions de cellules. Vous pouvez les réutiliser quand vous créez une nouvelle cellule de code. Pour afficher les variables disponibles, cliquez sur le bouton \"Variables\" dans la barre d'outils en haut de l'écran.\n",
"\n",
"Attention ! L'ordre dans lequel vous exécutez les cellules est important. Si vous voulez utiliser une variable créée dans une autre cellule, il faut que l'autre cellule soit exécutée avant. Vous pouvez savoir dans quel ordre vos cellules ont été exécutées en regardant le nombre qui s'affiche entre crochets à gauche de la cellule. Si vous voulez repartir de zéro, cliquez sur le bouton \"Restart\" dans la barre d'outils. Le bouton \"Clear Outputs\" efface les résultats des cellules mais garde les variables en mémoire."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"# ça ne marchera pas !\n",
"print(coucou)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Comme vous le voyez, ça n'a pas marché, car `coucou` n'est pas encore défini. Regardons ce qui se passe si on définit `coucou` avant de l'utiliser :"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"coucou = \"Coucou tout le monde !\""
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"# Maintenant c'est bon !\n",
"print(coucou)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Si jamais il y a une erreur dans votre code Python, l'erreur s'affichera en-dessous de la cellule concernée, en rouge."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Manipuler les cellules"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"\n",
"Quand une cellule est sélectionnée, elle peut être dans deux modes différents :\n",
"- Dans le mode écriture, vous pouvez éditer la cellule comme une boîte de texte normale.\n",
"- Dans le mode commande, les touches que vous tapez lancent des commandes (exécuter la cellule, la déplacer, la supprimer, rajouter des cellules...).\n",
"\n",
"Pour passer du mode commande au mode écriture, tapez Enter. Inversement, pour passer du mode écriture au mode commande, tapez Escape."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Pour rajouter une cellule, plusieurs options s'offrent à vous :\n",
"- Cliquez sur le bouton \"+ Code\" ou \"+ Markdown\" en haut à gauche de l'écran pour rajouter une cellule à la fin.\n",
"- Cliquez sur le bouton \"+ Code\" ou \"+ Markdown\" qui s'affichent quand vous survolez l'espace entre deux cellules.\n",
"- Avec une cellule sélectionnée, tapez Shift+Enter pour exécuter la cellule et passer à la cellule suivante. S'il n'y a pas de cellule suivante, une nouvelle est créée.\n",
"- Avec une cellule sélectionnée en mode commande, tapez a pour ajouter une cellule au-dessus (*above*) la cellule actuelle, et b pour ajouter une cellule en-dessous (*below*) la cellule actuelle."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"\n",
"Pour vous déplacer entre les cellules, en mode commande, tapez j pour choisir la suivante, et k pour la précédente. Vous pouvez en choisir plusieurs en maintenant Shift appuyé. Vous pouvez aussi cliquer sur une cellule."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Pour déplacer les cellules elles-mêmes, faites-les glisser avec votre souris depuis la zone à gauche de la cellule. Vous pouvez aussi utiliser les raccourcis Alt+Up et Alt+Down en mode commande."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Pour supprimer une cellule, appuyez sur l'icône en forme de poubelle quand une cellule est sélectionnée, ou appuyez sur d deux fois en mode commande."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Enfin, vous pouvez convertir une cellule de code en markdown avec m et dans l'autre sens avec y (toujours en mode commande). Vous pouvez aussi bien sûr utiliser le menu qui s'affiche en effectuant un clic droit sur la cellule, ou en cliquant sur l'icône en forme de trois petits points qui s'affiche quand une cellule est sélectionnée."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Fonctionnalité avancée : code ligne par ligne"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Dans VSCode, il est possible d'exécuter le code d'une cellule *ligne par ligne*, avec un affichage en direct des variables. Pour activer cette option, cliquez sur le bouton approprié dans la barre d'outils de la cellule, ou appuyez sur F10. Testez-le sur cet exemple :"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"x = 0\n",
"while x * x < 20:\n",
" print(\"On s'occupe de : \" + str(x))\n",
" x = x + 1\n",
"print(\"Premier nombre dont le carré est supérieur à 20 : \" + str(x))"
]
}
],
"metadata": {
"interpreter": {
"hash": "677a13afa533069385e8a79d07ef56df7c2153a3576640a56a5b5ae85bdd6ee1"
},
"kernelspec": {
"display_name": "Python 3.9.6 64-bit",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.9.12"
},
"orig_nbformat": 4
},
"nbformat": 4,
"nbformat_minor": 2
}