Documentation d’aide de Sandbox

Le bac à sable Digital Earth Africa, par défaut, chargera plusieurs dossiers contenant des blocs-notes utiles et du code source. Ils sont essentiels au fonctionnement du Sandbox, donc ne supprimez ni ne déplacez aucun des fichiers.

Les cahiers du Guide du débutant couvrent des éléments similaires aux explications et aux exercices de cette série d’ateliers. Cependant, ils fournissent également des détails plus détaillés sur la façon d’exécuter l’extraction et l’analyse des données. Les blocs-notes du Guide du débutant, ainsi que les blocs-notes «code fréquemment utilisé», sont un excellent outil de référence.

Cette section fournit un résumé de ces dossiers et de leur contenu. Elle contient également quelques activités recommandées mais non obligatoires qui vous aideront à vous familiariser avec Digital Earth Africa et le bac à sable.

Pour obtenir des conseils sur la façon d’accéder aux fichiers et aux dossiers dans le bac à sable, consultez la section sur la navigation dans le bac à sable ».

Pour un examen de la façon d’exécuter du code dans un notebook, voir cette section sur l’exécution d’un notebook.

Guide du débutant - commencez ici

Beginners Guide folder

The Beginners_guide folder contains step-by-step tutorials to help you become more familiar with the Digital Earth Africa Sandbox. The tutorials contain background information and context, as well as code and data examples and explanations. The guide covers a range of basic Sandbox functions, including how to load data and plot it.

Si vous n’êtes toujours pas clair sur la portée et l’objectif de Digital Earth Africa et du bac à sable, c’est également un endroit idéal pour en savoir plus à ce sujet et voir des démonstrations pratiques des données d’observation de la Terre au travail.

Les carnets sont numérotés dans l’ordre d’avancement ; commencez à 01_Jupyter_notebooks.ipynb. Il n’y a pas de pré-requis pour pouvoir compléter ce carnet.

Activité suggérée: Lisez et suivez les exemples dans les notebooks du Guide du débutant, en commençant par 01_Jupyter_notebooks.ipynb. Cela peut être fait de manière interactive (recommandé), comme détaillé dans l’exécution d’un notebook. Ouvrez le fichier et dans la barre de menu horizontale, sélectionnez Kernel -> Restart Kernel and Clear All Outputs, puis suivez les instructions du notebook.

Prenez votre temps - il n’est pas nécessaire de revoir tous les cahiers en une seule séance. Si vous êtes nouveau dans le codage Python, il y aura une bonne quantité de contenu. Une partie sera couverte dans les sessions ultérieures de cette série d’ateliers.

Code fréquemment utilisé

Frequently used code folder

The Frequently_used_code folder contains a series of notebooks that demonstrate code snippets doing useful and common functions. For example, want to calculate the Normalised Difference Vegetation Index (NDVI)? You could set up your own formula — but it would be faster and easier to use the NDVI function as shown in Calculating_band_indices.ipynb. How about drawing a contour line between water and land? Check out Contour_extraction.ipynb. There are many useful tips and tricks in the Frequently_used_code folder.

Il est utile de savoir ce qu’il y a dans ce dossier, afin que vous puissiez vous inspirer du code si vous devez faire quelque chose de similaire lorsque vous écrivez vos propres blocs-notes.

Activité suggérée: Lisez tous les titres des cahiers dans le dossier. Ouvrez Masking_data.ipynb et parcourez son contenu en sélectionnant Kernel -> Restart Kernel and Clear All Outputs puis en exécutant les cellules au fur et à mesure.

Exemples du monde réel

Real world examples folder

The analytical power of the Sandbox is shown in the folder Real_world_examples. This folder contains multiple notebooks which cater to “real world” use cases, from monitoring crop health to detecting water.

Le code de ces carnets est plus complexe, mais il est passionnant de voir ce que Digital Earth Africa peut faire.

Activité suggérée: Choisissez un cahier qui vous intéresse et parcourez-le.

Ensembles de données

Datasets folder

Les carnets de notes dans le bac à sable sont tous basés sur des données d’observation de la Terre disponibles à Digital Earth Africa. Ces jeux de données sont expliqués dans des carnets individuels dans le dossier Datasets. Chaque cahier contient des informations de base sur le jeu de données et des exemples d’utilisation.

Certains des ensembles de données sont directement basés sur des mesures satellitaires. Par exemple, des informations sur les jeux de données satellites Landsat et Sentinel peuvent être trouvées dans leurs carnets respectifs:

  • Landsat_collections.ipynb

  • Sentinel_1.ipynb

  • Sentinel_2.ipynb

D’autres ensembles de données font référence à des produits dérivés qui ont été créés pour montrer une caractéristique environnementale particulière. Ceux-ci inclus:

  • Soil_Humidité.ipynb

  • Couverture_fractionnelle.ipynb

  • Observations_de_l'eau_de_l'espace.ipynb

D’autres blocs-notes de jeux de données sont ajoutés à ce dossier à mesure que la collection Digital Earth Africa s’agrandit. Utilisez les blocs-notes de ce dossier pour vous familiariser avec les données et les produits disponibles.

Activité suggérée: Parcourez le carnet de notes sur les données de Sentinel 2, Sentinel_2.ipynb.

Autres dossiers

Il existe quelques autres dossiers dans le dossier d’accueil, tels que Scripts et DCAL. N’hésitez pas à les parcourir, mais il n’est pas important de les connaître lorsque vous débutez.

Activité suggérée: Ignorez ces dossiers pour le moment.

Help! I deleted a file…

Consultez la section Frequently asked questions sur la restauration des ordinateurs portables préchargés.