🖥️ Diapositives du cours — Séance 02 (ven. 2 oct.)
Cette page est le devoir 1 (HW1). Elle vous guide dans l’installation des outils que vous utiliserez tout le trimestre : pixi pour les environnements, git et GitHub pour le contrôle de version, JupyterLab pour les carnets. Chaque étape se termine sur un état vérifiable, pour toujours savoir si elle a réussi avant de continuer. Comptez une à deux heures ; demandez de l’aide tôt si une étape échoue.
À la fin vous aurez : pixi et git installés, un compte GitHub, votre dépôt de cours personnel MLGEO2026_UWNETID (remplacez UWNETID par votre identifiant UW), le livre du cours fonctionnant localement, et un commit poussé vers votre propre dépôt.
Étape 1 — Installer pixi¶
macOS / Linux / WSL2, dans un terminal :
curl -fsSL https://pixi.sh/install.sh | shSur macOS avec Homebrew, brew install pixi fonctionne aussi. Après l’installation, fermez et rouvrez le terminal pour que votre shell prenne en compte le nouveau PATH.
Vérifier :
pixi --versionLa réussite ressemble à ceci : un numéro de version s’affiche, p. ex. pixi 0.48.0. Si la commande est introuvable, redémarrez le terminal ; si elle reste introuvable, l’installateur affiche la ligne à ajouter à votre profil de shell — ajoutez-la et redémarrez encore.
Étape 2 — Installer git et créer un compte GitHub¶
Vérifiez si git est déjà installé :
git --versionSinon : sur macOS, cette commande déclenche l’installateur des Xcode Command Line Tools (acceptez) ; sur Ubuntu/WSL2, sudo apt install git.
Puis :
Créez un compte sur github.com et configurez l’authentification à deux facteurs (voir 1.5).
Dites à git qui vous êtes, avec les mêmes nom d’utilisateur et adresse que le compte GitHub :
git config --global user.name "superseismo" git config --global user.email "superseismo@uw.edu"Installez le GitHub CLI et authentifiez-vous :
gh auth loginAcceptez les valeurs par défaut (GitHub.com, HTTPS, connexion via le navigateur) et suivez les invites du navigateur.
Vérifier :
git --version
gh auth statusLa réussite ressemble à ceci : git affiche une version 2.40 ou plus récente, et gh auth status annonce Logged in to github.com avec votre nom d’utilisateur.
Étape 3 — Créer votre dépôt de cours¶
Créez votre dépôt de cours personnel, nommé MLGEO2026_UWNETID (votre identifiant en capitales, p. ex. MLGEO2026_SUPERSEISMO). Ce dépôt accueille vos devoirs et votre projet pour le trimestre. Créez-le une seule fois, avec une commande :
gh repo create MLGEO2026_UWNETID --public --add-readme --license mit --cloneCela crée le dépôt sur GitHub avec un README et une licence MIT, et le clone dans un dossier du même nom. Lancez la commande depuis le répertoire où vous rangez vos travaux de cours — hors des dossiers synchronisés au cloud comme Dropbox ou Google Drive.
(Pas de terminal ? L’équivalent navigateur est en 1.5 ; clonez ensuite.)
Vérifier : ouvrez https://github.com/YOURUSERNAME/MLGEO2026_UWNETID dans un navigateur.
La réussite ressemble à ceci : la page du dépôt se charge et montre un README et un fichier LICENSE, et ls MLGEO2026_UWNETID sur votre machine montre les mêmes fichiers.
Étape 4 — Cloner le livre du cours et installer son environnement¶
Clonez le dépôt du cours et laissez pixi construire l’environnement depuis le fichier de verrouillage :
git clone https://github.com/geo-smart/mlgeo-book.git
cd mlgeo-book
pixi installLe premier pixi install télécharge quelques gigaoctets de paquets ; comptez plusieurs minutes sur une connexion rapide. Lancez ensuite JupyterLab depuis l’environnement :
pixi run jupyter labVérifier : JupyterLab s’ouvre dans votre navigateur (ou affiche une URL http://localhost:8888/lab?token=... à ouvrir).
La réussite ressemble à ceci : l’interface JupyterLab se charge et son explorateur de fichiers montre le dossier book/. Arrêtez-la plus tard avec Ctrl-C dans le terminal.
Étape 5 — Premier test : exécuter un carnet¶
Dans JupyterLab, ouvrez n’importe quel carnet du chapitre 1 — par exemple book/Chapter1-GettingStarted/1.7_get_geodetic_gnss.ipynb — et exécutez les premières cellules (Shift-Entrée).
La réussite ressemble à ceci : les cellules d’import s’exécutent sans ModuleNotFoundError, et la première cellule de données ou de tracé produit une sortie. Si les imports échouent, vous exécutez probablement un noyau hors de l’environnement pixi : vérifiez que vous avez lancé JupyterLab avec pixi run jupyter lab depuis le répertoire mlgeo-book.
Étape 6 — Pousser une modification vers votre propre dépôt¶
Bouclez la boucle en poussant un commit vers MLGEO2026_UWNETID. Dans un terminal, allez dans votre dépôt de l’étape 3, éditez README.md (ajoutez une ligne de titre, votre nom, et une phrase sur ce que vous attendez de ce cours), puis :
git add README.md
git commit -m "Introduce myself in the README"
git pushPendant que vous y êtes, copiez les fichiers d’environnement du livre du cours dans votre dépôt, pour que votre propre travail soit reproductible dès le premier jour :
cp ../mlgeo-book/pixi.toml ../mlgeo-book/pixi.lock .
git add pixi.toml pixi.lock
git commit -m "Add course environment files"
git push(Ajustez le chemin ../mlgeo-book/ si vos dossiers sont ailleurs.)
Vérifier : rechargez la page du dépôt sur GitHub.
La réussite ressemble à ceci : votre modification du README et les deux fichiers pixi sont visibles sur GitHub, et les commits apparaissent sous Commits avec votre nom d’utilisateur.
Terminé — et quoi rendre¶
Vous avez maintenant un poste de travail fonctionnel : un environnement épinglé qui exécute les carnets du livre, et un dépôt qui enregistre votre travail. Soumettez l’URL de votre dépôt MLGEO2026_UWNETID sur Canvas ; l’historique des commits est la preuve d’achèvement.
Deux suites :