Un bloc-notes comprend des cellules qui contiennent du code ou des informations textuelles et divers autres éléments qui vous aident à interagir avec le code. Selon qu'un bloc-notes est en mode édition, la liste des éléments interactifs peut inclure la barre de menus, la barre d'outils principale, la barre d'action, la barre de progression, une table des matières générée automatiquement et un débogueur.
Lorsque vous ouvrez un bloc-notes en mode vue, les seuls éléments disponibles sont les cellules et la barre d'actions. Vous pouvez l'utiliser pour exécuter, planifier, partager, télécharger ou afficher des informations sur votre bloc-notes. Pour accéder à des options supplémentaires, cliquez sur l'icône Editer pour passer en mode édition.
Lorsque vous ouvrez un bloc-notes en mode édition, l'éditeur de bloc-notes inclut les éléments suivants:
- Barre de menus et d'outils
- Table des matières
- Barre d'actions de bloc-notes
- Cellules contenant du code ou des informations textuelles
- Débogueur
- Barre de progression du travail Spark (pour les blocs-notes qui s'exécutent dans un environnement Spark)
Barre de menus et d'outils
Dans la barre de menus et la barre d'outils principale, vous pouvez sélectionner des fonctions de bloc-notes qui affectent la façon dont le bloc-notes fonctionne et effectuer les opérations les plus utilisées dans le bloc-notes.
Table des matières
Vous pouvez parcourir le bloc-notes à l'aide d'une table des matières générée automatiquement et basée sur les titres de votre bloc-notes. Pour afficher la table des matières, à partir du Voir menu, sélectionnez Table des matières.
Pour ajouter des numéros de titre, cliquez sur le bouton Afficher le numéro de titre dans le document icône. Pour indiquer si un numéro est visible ou non à côté des en-têtes de premier niveau ( h1), par exemple, lorsque vous souhaitez que votre en-tête de premier niveau s'affiche comme titre du bloc-notes, cliquez sur l'icône Plus d'actions et sélectionnez Afficher le numéro de titre de premier niveau.
Pour exclure ou inclure des titres générés dans le cadre de la sortie de cellule de la table des matières, cliquez sur l'icône Plus d'actions et sélectionnez Afficher les en-têtes de sortie.
Barre d'actions de bloc-notes
Vous pouvez sélectionner des fonctions qui améliorent la collaboration à l'aide d'un bloc-notes. Dans la barre d'actions, vous pouvez :
- Publiez votre bloc-notes en tant que gist ou sur GitHub
- Créez une URL permanente pour que toute personne ayant le lien puisse afficher votre bloc-notes
- Créer des travaux dans lesquels votre bloc-notes sera exécuté. Voir Planification d'un bloc-notes
- Télécharger votre bloc-notes
- Ajouter un jeton de projet pour que le code puisse accéder aux ressources du projet. Voir Ajout de code pour définir le jeton de projet
- Générer des fragments de code pour ajouter des données à partir d'un actif de données ou d'une connexion à une cellule de bloc-notes
- Afficher les informations de votre bloc-notes et interagir avec l'environnement dans lequel il s'exécute
- Sauvegarder les versions de votre bloc-notes
- Télécharger des actifs dans votre projet
Cellules dans un bloc-notes Jupyter
Un bloc-notes Jupyter se compose d'une séquence de cellules. Le flux d'un bloc-notes est séquentiel. Vous entrez du code dans une cellule d'entrée, et lorsque vous exécutez la cellule, le bloc-notes exécute le code et imprime la sortie du calcul dans une cellule de sortie.
Vous pouvez modifier le code dans une cellule d'entrée et relancez l'exécution de la cellule aussi souvent que vous le souhaitez. Ainsi, le bloc-notes suit un paradigme de boucle de lecture-évaluation-impression.
Chaque cellule possède sa propre mini barre d'outils.
Directement depuis la barre d'outils des cellules, vous pouvez :
- Copie la cellule
- Déplacer la cellule vers le haut ou vers le bas
- Ajouter une nouvelle cellule avant et après une autre cellule
- Supprimer la cellule
Pour réduire une cellule, cliquez sur l'icône Effondrement bouton
c'est à côté de chaque cellule. Pour développer une cellule, cliquez sur le bouton Réduire ou sur le Développer icône
.
Le comportement d'une cellule est déterminé par le type de cette cellule. Les différents types de cellule sont notamment les suivants :
Cellules de code Jupyter
Dans les cellules de code Jupyter, vous pouvez éditer et écrire un nouveau code.
Pour afficher les numéros de ligne à côté de votre code, à partir du Voir sélection de menu Afficher les numéros de ligne.
Pour afficher votre cellule de code et votre cellule de sortie côte à côte, accédez à Voir dans le menu Editeur et cliquez sur Rendu côte à côte.
Cellules Jupyter Markdown
Dans les cellules de démarque Jupyter, vous pouvez documenter le processus de calcul. Vous pouvez entrer des en-têtes pour structurer votre bloc-notes de manière hiérarchique.
Vous pouvez également ajouter et éditer des fichiers image en tant que pièces jointes sur le bloc-notes. Le code et les images Markdown code sont affichés lorsque la cellule est exécutée.
Voir Markdown pour les aides-mémoires de blocs-notes de Jupyter.
Cellules Jupyter NBConvert brutes
Les cellules brutes ne sont pas évaluées par le bloc-notes. Une cellule brute est utile si vous recherchez un emplacement pour conserver du contenu que vous ne souhaitez pas exécuter, comme une sortie générée.
Débogueur
Le débogueur peut vous aider à résoudre rapidement les problèmes liés au code. Pour activer le débogueur :
- Clique sur le Activer le débogueur icône
dans la barre d'outils du bloc-notes. - Cliquez à côté de n’importe quelle ligne de code pour ajouter un point d’arrêt.
Pour déboguer votre code, depuis le Voir menu, sélectionnez Barre latérale droite, puis sélectionnez Afficher le débogueur.
Barre de progression d'un travail Spark
Lorsque vous exécutez du code dans un bloc-notes qui déclenche des travaux Spark, il est souvent difficile de déterminer pourquoi votre code ne s'exécute pas efficacement.
Pour vous aider à mieux comprendre ce que fait votre code et à vous aider dans le débogage du code, un bloc-notes peut surveiller l'exécution des travaux Spark pour une cellule de code.
Pour activer la surveillance Spark pour une cellule d'un bloc-notes :
- Sélectionnez la cellule de code à surveiller.
- Clique le Activer la surveillance des étincelles icône
dans la barre d'outils du bloc-notes.
Les barres de progression affichées affichent la progression de l'exécution en temps réel de vos travaux sur le cluster Spark. Chaque travail Spark s'exécute sur le cluster en une ou plusieurs étapes, chaque étape étant une liste de tâches pouvant être exécutées en parallèle. Le panneau de surveillance peut devenir très volumineux si le travail Spark comporte de nombreuses étapes.
Le panneau de surveillance des travaux affiche également la durée de chaque travail et l'état des étapes de travail. Les valeurs possibles pour l'état une étape sont les suivantes :
Running: l'étape est active et démarréeCompleted: l'étape est terminéeSkipped: les résultats de cette étape ont été mis en cache à partir d'une opération antérieure et la tâche n'a donc pas besoin de s'exécuter à nouveauPending: l'étape n'a pas encore démarré
Cliquez à nouveau sur l'icône pour désactiver la surveillance dans une cellule.
Rubrique parent: Jupyter Notebook