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 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) Menu et sur Save As (Enregistrer sous).

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

  6. Ajoutez un Title (Titre) et modifiez éventuellement les valeurs 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 :
  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 le notebook dans l’un des formats suivants :

  • Texte (.md)
  • Notebook (.ipynb)
  • Python (.py)
  • 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 (Edition) :

  • Cut Cells (Couper les cellules) : coupe les cellules actuellement sélectionnées de l’espace de travail du notebook.
  • Copy Cells (Copier les cellules) : copie les cellules actuellement sélectionnées dans l’espace de travail du notebook.
  • Paste Cells Above (Coller les cellules au-dessus) : colle les cellules copiées au-dessus de la cellule actuellement sélectionnée.
  • Paste Cells Below (Coller les cellules en dessous) : colle les cellules copiées en dessous de la cellule actuellement sélectionnée.
  • Paste Cells & Replace (Coller les cellules et remplacer) : colle les cellules copiées en remplaçant la cellule actuellement sélectionnée.
  • Delete Cells (Supprimer les cellules) supprime les cellules actuellement sélectionnées.
  • Undo Delete Cells (Annuler la suppression des cellules) : annule les actions de suppression de cellules effectuées ; annule d’abord la suppression la plus récente.
  • Split Cell (Fractionner la cellule) : divise une cellule en deux en coupant le contenu de la cellule à l’emplacement actuel du curseur.
  • Merge Cell Above (Fusionner la cellule au-dessus) : fusionne la cellule actuellement sélectionnée avec celle du dessus.
  • Merge Cell Below (Fusionner la cellule en dessous) : fusionne la cellule actuellement sélectionnée avec celle en dessous.
  • Move Cell Up (Déplacer la cellule vers le haut) : déplace la cellule actuellement sélectionnée d’une position vers le haut dans l’espace de travail du notebook.
  • Move Cell Down (Déplacer la cellule vers le bas) : déplace la cellule actuellement sélectionnée d’une position vers le bas dans l’espace de travail du notebook.
  • Find and Replace (Rechercher et remplacer) : ouvre une fenêtre contextuelle dans laquelle vous pouvez saisir une requête de recherche. Cela permet de rechercher et remplacer des valeurs ou des chaînes spécifiques dans le notebook.
  • Copy Cell Attachments (Copier les pièces jointes de la cellule) copie les pièces jointes contenues dans la cellule sélectionnée.
  • Cut Cell Attachments (Couper les pièces jointes de la cellule) : coupe et copie les pièces jointes contenues dans la cellule sélectionnée.
  • Paste Cell Attachments (Coller les pièces jointes de la cellule) : colle les pièces jointes copiées dans la cellule sélectionnée.
  • Insert Image (Insérer une image) : ouvre une fenêtre contextuelle dans laquelle vous pouvez rechercher et ajouter des images, y compris des fichiers GIF, dans des cellules de texte uniquement.

Afficher

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

  • Toggle Toolbar (Afficher/Masquer la barre d’outils) : affiche ou masque la barre d’outils.
  • Toggle Line Numbers (Afficher/Masquer les numéros de ligne) : affiche ou masque les numéros de ligne dans chaque cellule de l’espace de travail du notebook.
  • Cell Toolbar (Barre d’outils des cellules) : affiche ou masque la barre d’outils de la diapositive sélectionnée pour chaque cellule de l’espace de travail du notebook. Les options sont les suivantes :
    • None (Aucun) : n’affiche pas les barres d’outils de la cellule.
    • Edit Metadata (Modifier les métadonnées) : saisir des métadonnées pour chaque cellule à l’aide de JSON.
    • Raw Cell Format (Format de cellule brute) : les cellules brutes vous permettent d’écrire directement la sortie ; le contenu de ces cellules n’est pas évalué par le notebook.
    • Slideshow (Diaporama) : définir comment chaque cellule apparaîtra dans un diaporama. Cette option est utile pour présenter le code.
    • Attachments (Pièces jointes) : gérer les pièces jointes associées au sein de chaque cellule de l’espace de travail du notebook.
    • Tags (Balises) : créer et gérer les balises pour chaque cellule dans l’espace de travail du notebook.

Insertion

Les éléments suivants sont disponibles dans le menu Insert (Insérer) :

  • Insert Cell Above (Insérer une cellule au-dessus) : insérer une cellule vide au-dessus de la cellule actuellement sélectionnée.
  • Insert Cell Below (Insérer une cellule en dessous) :—insérer une cellule vide en dessous de la cellule actuellement sélectionnée.
  • Insert Heading Above (Insérer un en-tête au-dessus) : insérer une cellule d’en-tête au-dessus de la cellule actuellement sélectionnée avec le texte par défaut New heading.
  • Insert Cell Below (Insérer un en-tête en dessous) : insérer une cellule d’en-tête en dessous de la cellule actuellement sélectionnée avec le texte par défaut New heading.

Cellule

Les éléments suivants sont disponibles dans le menu Cell (Cellule) :

  • Run Cells (Exécuter les cellules) : exécuter la cellule actuellement sélectionnée et déplacer le pointeur dans la cellule suivante.
  • Run Cells and Select Below (Exécuter les cellules et sélectionner en dessous) : exécuter la cellule actuellement sélectionnée, puis sélectionner la cellule en dessous.
  • Run Cells and Insert Below (Exécuter les cellules et insérer en dessous) : permet d’exécuter la cellule actuellement sélectionnée, puis d’insérer une cellule vide en dessous de la cellule sélectionnée.
  • Run All (Tout exécuter) : exécuter toutes les cellules du notebook dans l’ordre séquentiel.
  • Run All Above (Tout exécuter au-dessus) : permet d’exécuter toutes les cellules au-dessus de la cellule actuellement sélectionnée, à l’exception de cette dernière.
  • Run All Below (Tout exécuter en dessous) :—exécuter la cellule actuellement sélectionnée et toutes les cellules en dessous.
  • Cell Type (Type de cellule) : modifier le type de la cellule actuellement sélectionnée. Les options sont Code, Markdown (Texte) et Raw NBConvert (NBConvert brut). Veuillez noter que le type Heading (En-tête) devient Markdown (Texte)
  • Current Ouputs (Sorties actuelles) : vous permet de contrôler la sortie de la cellule actuellement sélectionnée. Voici quelques-unes des options disponibles :
    • Toggle (Activer/désactiver) : afficher ou masquer la sortie de la cellule actuellement sélectionnée.
    • Toggle Scrolling (Activer/Désactiver le défilement) : activer ou désactiver le défilement sur la cellule actuellement sélectionnée.
    • Clear (Effacer) : efface la sortie de la cellule actuellement sélectionnée.
  • All Output (Toutes les sorties) : contrôler les sorties de toutes les cellules de l’espace de travail du notebook. Voici quelques-unes des options disponibles :
    • Toggle (Activer/désactiver) : afficher ou masquer la sortie de toutes les cellules.
    • Toggle Scrolling (Activer/Désactiver le défilement) : activer ou désactiver le défilement sur toutes les cellules.
    • Clear (Effacer) : effacer la sortie de toutes les cellules.

Noyau

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

  • Interrupt (Mettre en pause) : met en pause le noyau en cours d’exécution si un calcul ou une analyse prend trop de temps.
  • Restart (Redémarrer) : redémarrer tout le processus de calcul en redémarrant le noyau.
  • Restart & Clear Output (Redémarrer et effacer la sortie) : redémarrer le processus de calcul et efface toutes les sorties affichées dans les notebooks.
  • Restart & Run All (Redémarrer et tout exécuter) : redémarrer le processus de calcul, puis exécuter toutes les cellules dans l'ordre séquentiel.
  • Reconnect (Reconnecter) : se reconnecter à un noyau s’il devient inactif.
  • Shutdown (Eteindre) : arrêter tous les processus de calcul au sein du notebook.
  • Change Kernel (Changer de noyau) : modifier le type de noyau. Dans ArcGIS Notebooks, seul le type de noyau Python 3 est pris en charge.

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.
  • Flèche vers le haut - Déplacer la cellule sélectionnée vers le haut dans la séquence du notebook.
  • Flèche vers le bas - Déplacer la cellule sélectionnée vers le bas dans la séquence du notebook.
  • 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.
  • Keyboard (Clavier) - Ouvrir la palette de commandes.
  • Chart (Diagramme) - Ouvrir ou quitter le mode diaporama.