Get started with notebooks (Prise en main des notebooks)

ArcGIS Notebooks offre une interface Web polyvalente pour l’analyse des données. Grâce aux notebooks, vous pouvez réaliser des analyses, automatiser des processus et visualiser immédiatement les données et les résultats d’analyse dans un contexte géographique. Les notebooks combinent code, visualisations et cartes à la volée, et outils de données. Dans l’éditeur de notebooks, vous pouvez écrire, documenter et exécuter du code Python à partir d’un même emplacement.

Les notebooks sont créés dans l’éditeur de notebooks, accessible à partir ArcGIS Online. Cette rubrique présente les composants et menus de l’éditeur de notebooks.

Ouvrir un notebook

Pour ouvrir et mettre à jour des notebooks qui vous appartiennent, procédez comme suit :

1. Connectez-vous en tant qu’utilisateur doté de privilèges permettant de créer et de mettre à jour des notebooks.
2. Dans la barre de navigation de votre organisation, cliquez sur Notebook.

   La page d’accueil de Notebooks s’ouvre.

3. Vous pouvez également cliquer sur le bouton Options sur un élément pour réaliser l’une des opérations suivantes :
   • Afficher un Preview (Aperçu) ou View details (Afficher les détails) des notebooks qui vous appartiennent (dans My notebooks (Mes notebooks)) ou des notebooks partagés avec vous (dans Shared notebooks (Notebooks partagés) ou Esri sample notebooks (Exemples de notebooks Esri)).
   • Delete (Supprimer) des éléments de notebook qui vous appartiennent (dans My notebooks (Mes notebooks)).
4. Cliquez sur Open (Ouvrir).

   L’éditeur de notebooks s’ouvre.

5. Cliquez sur le menu déroulant Save (Enregistrer) , puis sur Save As (Enregistrer sous).

   La fenêtre Save notebook as (Enregistrer le notebook sous) apparaît.

6. Ajoutez un titre et modifiez éventuellement les options Folder (Dossier), Tags (Balises) et Summary (Résumé).
7. Cliquez sur Save notebook (Enregistrer le notebook).

   Le notebook est enregistré et ajouté dans My notebooks (Mes notebooks).

Bases de l’interface

L’éditeur de notebooks inclut les composants de base suivants :

1. Barre de navigation : permet de parcourir le site web, d’ouvrir d’autres applications à partir du lanceur d’applications, d’afficher les ressources d’aide et de vous connecter ou vous déconnecter de votre profil. La barre de navigation indique également le titre de votre notebook et précise si le notebook inclut des modifications non enregistrées.
2. Ruban supérieur : permet d’effectuer diverses tâches impliquant votre notebook. Ce ruban inclut les boutons suivants :
   • Add (Ajouter) : permet d’ajouter des couches et outils Web au notebook.
   • Analysis (Analyse) : permet d’accéder à des outils d’analyse pour les utiliser dans le notebook.
   • Code snippets (Extraits de code) : permet d’utiliser des extraits de code Python dans le notebook.
   • Files (Fichiers) : permet de parcourir les fichiers de votre espace de travail ArcGIS et les données des exemples de notebooks.
   • Tasks (Tâches) : permet de créer une ou plusieurs tâches pour automatiser l’exécution du notebook et définir la planification de la tâche.
   • Snapshots (Captures d’écran) : permet de créer une capture d’écran du notebook.
   • Share (Partager) : permet de partager le notebook.
   • Info : permet d’obtenir des informations sur le notebook. Vous pouvez mettre à jour les métadonnées du notebook (titre, balises, description, conditions d’utilisation et crédits). Vous pouvez également afficher le runtime du notebook et ses bibliothèques disponibles.
   • Save (Enregistrer) : permet d’enregistrer le notebook dans son état actuel. Lorsque vous ouvrez un notebook partagé, ce bouton devient Save As (Enregistrer sous).
3. Ruban de menu du notebook : les actions de ce ruban permettent d’utiliser directement le notebook. Vous pouvez ajouter et supprimer des cellules, modifier l’aspect du notebook, restaurer le notebook à un point de contrôle précédent et bien plus encore. Ce ruban indique également si le notebook est fiable, ainsi que la version de Python utilisée.
4. Barre d’outils : permet d’utiliser les outils pour les tâches courantes dans le notebook.
5. Espace de travail : le contenu du notebook est affiché ici et vous pouvez le modifier.

Ruban de menu des éléments dans le notebook

Les actions suivantes sont disponibles dans les listes déroulantes du ruban de menu du notebook.

Fichier

À partir du menu File (Fichier), vous pouvez choisir de télécharger ou d’exporter le notebook dans l’un des formats suivants :

• Texte (.md)
• Notebook (.ipynb)
• Diapositives Reveal.js (.slides.html)

Vous pouvez également télécharger le notebook au format .ipynb à partir de la page des éléments du notebook.

Modifier

Les éléments suivants sont disponibles dans le menu Edit (Mettre à jour) :

• Annuler
• Rétablir
• Undo Cell Operation (Annuler l’opération de cellule)
• Redo Cell Operation (Rétablir l’opération de cellule)
• Cut Cell (Couper la cellule)
• Copier une cellule
• Paste Cell Below (Coller la cellule en dessous)
• Paste Cell Above (Coller la cellule au-dessus)
• Paste Cell and Replace (Coller et remplacer la cellule existante)
• Supprimer la cellule
• Select All Cells (Sélectionner toutes les cellules)
• Deselect All Cells (Désélectionner toutes les cellules)
• Move Cell Up (Déplacer la cellule vers le haut)
• Move Cell Down (Déplacer la cellule vers le bas)
• Edit Notebook Metadata (Modifier les métadonnées du notebook)
• Split Cell (Fractionner la cellule)
• Merge Selected Cells (Fusionner les cellules sélectionnées)
• Merge Cell Above (Fusionner la cellule au-dessus)
• Fusionner la cellule en dessous
• Clear Cell Output (Effacer la sortie de la cellule)
• Clear Outputs of All Cells (Effacer les sorties de toutes les cellules)
• Rechercher
• Rechercher suivant
• Précédent

Afficher

Les éléments suivants sont disponibles dans le menu View (Afficher):

• Active Command Palette (Activer la palette de commandes)
• Table des matières
• Panneau Debugger (Débogueur)
• Afficher les numéros de ligne
• Colapse Selected Code (Réduire le code sélectionné)
• Collapse Selected Outputs (Réduire les sorties sélectionnées)
• Collapse All Code (Réduire tout le code)
• Collapse All Outputs (Réduire toutes les sorties)
• Expand Selected Code (Développer le code sélectionné)
• Expand Selected Outputs (Développer les sorties sélectionnées)
• Expand All Code (Développer tout le code)
• Expand All Outputs (Développer toutes les sorties)
• Render Side-by-Side (Afficher le code et la sortie côte à côte)

Exécuter

Les éléments suivants sont disponibles dans le menu Run (Exécuter) :

• Run Selected Cell (Exécuter la cellule sélectionnée)
• Run Selected Cell and Insert Below (Exécuter la cellule sélectionnée et insérer une nouvelle cellule en dessous)
• Run Selected Cell and do not Advance (Exécuter la cellule sélectionnée sans passer à la suivante)
• Run All Above Selected Cell (Exécuter tout au-dessus de la cellule sélectionnée)
• Run Selected Cell and All Below (Exécuter la cellule sélectionnée et toutes les suivantes)
• Render All Markdown Cells (Afficher toutes les cellules de type Markdown)
• Run All Cells (Exécuter toutes les cellules)
• Restart Kernel and Run All Cells (Redémarrer le noyau et exécuter toutes les cellules)
• Cell Type (Type de cellule) : modifier le type de la cellule actuellement sélectionnée. Les options sont Code, Markdown (Texte) et Raw (Brut).

Noyau

Les éléments suivants sont disponibles dans le menu Kernel (Noyau) :

• Mettre en pause le noyau
• Restart Kernel (Redémarrer le noyau)
• Restart Kernel and Clear Outputs of All Cells (Redémarrer le noyau et effacer les sorties de toutes les cellules)
• Restart Kernel and Run up to Selected Cell (Redémarrer le noyau et exécuter jusqu’à la cellule sélectionnée)
• Restart Kernel and Run All Cells (Redémarrer le noyau et exécuter toutes les cellules)
• Restart Kernel and Debug (Redémarrer le noyau et déboguer)
• Shut Down Kernel (Arrêter le noyau)

Paramètres

Les éléments suivants sont disponibles dans le menu Settings (Paramètres) :

• Thème
  • JupyterLab Light (JupyterLab clair)
  • JupyterLab Dark (JupyterLab sombre)
  • JupyterLab Dark High Contrast (JupyterLab sombre avec contraste élevé)
  • Barres de défilement des thèmes
  • Increase Code Font Size (Augmenter la taille de police du code)
  • Decrease Code Font Size (Diminuer la taille de police du code)
  • Increase Content Font Size (Augmenter la taille de police du contenu)
  • Decrease Content Font Size (Diminuer la taille de police du contenu)
  • Increase UI Font Size (Augmenter la taille de police de l’interface)
  • Decrease UI Font Size (Diminuer la taille de police de l’interface)
• Auto Close Brackets (Fermer automatiquement les crochets)

Aide

Cette liste donne des informations sur les raccourcis clavier, l’interface utilisateur et les divers documents d’aide associés à ArcGIS Notebooks et aux principaux modules Python.

Boutons de la barre d’outils du notebook

La barre d’outils du notebook permet un accès rapide aux actions les plus courantes du ruban de menu du notebook. Les boutons disponibles sont les suivantes, de gauche à droite :

• Add (Ajouter) - Insérer une cellule en dessous de la cellule sélectionnée.
• Cut (Couper) - Couper la cellule sélectionnée.
• Copy (Copier) - Copier la cellule sélectionnée.
• Paste (Coller) - Coller les cellules copiées sous la cellule sélectionnée.
• Run (Exécuter) - Exécuter la cellule sélectionnée.
• Stop (Arrêter) - Mettre le noyau en pause.
• Restart (Redémarrer) - Redémarrer le noyau.
• Fast-forward (Avance rapide) - Redémarrer le noyau et exécuter toutes les cellules.
• Cell type (Type de cellule) - Sélectionner ou modifier le type de la cellule sélectionnée.