Aller au contenu
Data science

Mode d'emploi

  • Les encadrés 🎓 Pour aller plus loin contiennent les formules et les démonstrations. Ils sont fermés par défaut ; le bouton 🎓 Tout approfondir, en haut de chaque chapitre, les ouvre tous.
  • Les graphiques interactifs réagissent aux curseurs et aux boutons. Ils sont calculés dans le navigateur : vous pouvez les manipuler autant que vous voulez.
  • Les liens 🔬 ouvrent le simulateur déjà réglé ; revenez au cours avec le menu « Cours ».
  • Le quiz de fin de chapitre est corrigé immédiatement ; votre score est gardé dans ce navigateur.
  • 📄 PDF : enregistre le chapitre en PDF (ou l’imprime), avec tous les encadrés ouverts.
  • La recherche (en haut) parcourt tout le cours.
🎓 Pour aller plus loin : un exemple d'encadré

Voici à quoi ressemble un encadré : il peut contenir du texte, des listes et des formules, comme y^=w0+w1x\hat{y} = w_0 + w_1 x ou

MSE=1n∑i=1n(yi−y^i)2.\text{MSE} = \frac{1}{n}\sum_{i=1}^{n} (y_i - \hat{y}_i)^2 .

Chaque chapitre est un fichier .mdx du dossier cours/src/content/docs/, rangé par partie (par exemple supervise/regression/surapprentissage.mdx). On l’écrit en Markdown, avec quelques ajouts.

L’en-tête décrit le chapitre :

---
title: Sous-apprentissage et surapprentissage
description: Une phrase de résumé (affichée dans la recherche).
duree: 45 min
prerequis: [Régression linéaire, Erreur quadratique moyenne]
objectifs:
- distinguer erreur d'entraînement et erreur de test ;
- reconnaître le sous- et le surapprentissage.
---

Les formules s’écrivent en LaTeX : $…$ dans une phrase, $$…$$ sur une ligne à part.

Les encadrés de Starlight : :::note, :::tip[À retenir], :::caution, :::danger, terminés par :::.

Les composants, à importer en haut du fichier :

import Approfondir from '../../../components/Approfondir.astro';
import Simulation from '../../../components/Simulation.astro';
import Quiz from '../../../components/Quiz.astro';
<Approfondir titre="la décomposition biais-variance">
Texte, formules…
</Approfondir>
<Simulation href="/observer?jeu=lunes&modele=knn&k=1" titre="k = 1 sur les deux lunes">
Une phrase qui dit quoi observer.
</Simulation>
<Quiz id="identifiant-unique" questions={[
{ q: "La question ?", choix: ["réponse A", "réponse B"], bonne: 1, explication: "Pourquoi B." },
]} />

Les graphiques interactifs s’insèrent comme des balises HTML, par exemple <ds-ajustement degre="3" courbe-u></ds-ajustement>. Ils sont définis dans visualiseur/static/widgets/ et utilisables aussi dans les pages du simulateur.

Les liens vers le simulateur acceptent les réglages dans l’adresse : jeu, n, bruit, vue, vx, vy, etiquettes_fausses, variables_bruit, desequilibre, normaliser, puis modele et ses réglages (k, C, gamma, profondeur…).

Pour voir le résultat en direct pendant l’écriture : lancer l’application (uv run python -m visualiseur), puis dans le dossier cours/, npm run dev, et ouvrir http://localhost:4321/cours/. Pour publier : npm run build.