Skip to content
Snippets Groups Projects
README.md 3.34 KiB
Newer Older
# Cellule_GEE

elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
L'objectif de ce dépôt est de partager les connaissances sur Google Earth Engine au sein de HSM.
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Les utilisateurs de GEE sont encouragés à contribuer en déposant ici les codes qu'ils ont développés, afin d'inspirer d'autres utilisateurs potentiels. 
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
## Introduction à Google Earth Engine
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Google Earth Engine est un portail de données disponibles gratuitement sur un cloud. La liste des produits est disponible ici https://developers.google.com/earth-engine/datasets/ .
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
C'est également une plateforme de calcul qui permet d'effectuer des analyses directement sur les données du catalogue, sans télécharger de données en local.
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
L'accès à ces services est gratuit pour un usage académique ou de recherche. Il faut simplement créer un compte sur le
site. La procédure à suivre est disponible ici https://code.earthengine.google.com/register. 
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
## Utilisations de GEE à HSM
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
GEE est utilisé à HSM à la fois pour son catalogue de données et pour sa capacité de calcul.
Des utilisateurs utilisent l'interface Javascript en ligne, d'autres utilisent l'API Python.
Des exemples d'utilisation sont disponibles dans le répertoire `codes_utilisateurs`.
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
## Utilisation du dépôt
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Pour plus d'informations sur l'utilisation de git, voir le wiki :
 * [Introduction à GIT](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/Introduction%20git)
 * [Utilisation simple de GIT](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/git_simple)
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
### Téléchargement du dépôt
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Tout utilisateur de forge IRD, donc toute personne avec un compte Renater, peut télécharger le dépôt.
Pour cloner le dépôt localement depuis un terminal :
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
```
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
git clone  git@forge.ird.fr:hsm/atelier_amiis/cellule_gee.git
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
```
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Il est également possible de ne télécharger qu'un fichier à la fois, en utilisant directement l'interface graphique de Gitlab.
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
### Participation
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Tous les utilisateurs de GEE sont encouragés à participer en ajoutant leurs codes au dépôt. Tous les codes sont les
bienvenus, sans exigence de qualité, reproductibilité etc. La seule requête est d'avoir des codes commentés un
minimum afin que d'autres puissent comprendre ce dont il s'agit. Dans le cas de partage de Jupyter notebook, il est 
demandé de ne partager que des notebook dont les outputs ont été supprimés, donc avec uniquement les cellules de code.

Seuls les utilisateurs membres du repository ont l'autorisation de modifier le dépôt, et donc d'y ajouter des 
fichiers. Pour demander un accès au dépôt, il faut cliquer sur `Request access` sur la
[page principale du repo](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee) ou demander à un des membres du repo de 
les inviter. La liste des membres est accessible à partir de la page principale du repo : Project Information > Members.

Pour pouvoir déposer des fichiers, ie les pusher, il faut avoir préalablement déjà cloné le repository en local.

Une fois le dépôt cloné en local, il faut :
 * ajouter le fichier au dépôt local (ie commiter) :
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
``` 
git add mycode.py
git commit -m "Ajout code XXX"
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
```
 * synchroniser le dépôt local avec le dépôt distant (ie pusher) :

```
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
git push
```
elodie.fernandez_ird.fr's avatar
elodie.fernandez_ird.fr committed
Le mot de passe Forge IRD sera demandé lors du push vers le répo distant.
Pour se connecter sans mot de passe, voir 
[la page Wiki "clés SSH""](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/Cl%C3%A9s%20SSh).