diff --git a/docs/README.md b/docs/README.md index a19d52025ac5dc598d6e2a867587c439238e00aa..fe6cfe4ae7e31eff98bfb1ad6875c5a5b85c3ffc 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,3 +1,8 @@ +Cet outil a été initialement développé par [Laurent Knoll](https://github.com/verdi8) dans le cadre du projet de science participative [Derrière le blob, la recherche](https://www.cnrs.fr/fr/cnrsinfo/le-blob-et-la-demarche-scientifique) du CNRS. Les sources originales sur [GitHub](https://github.com/verdi8/blob-analysis-lab-demo). + +Ce site est une ***adaptation*** de l'outil pour des séances en école élémentaire, avec la possibilité notamment d'utiliser des tablettes tactiles et d'obtenir facilement des mesures simples sur la croissance du blob (périmètre et aire). + + # Mode opératoire ## Présentation **Cet outil vous accompagne** - pas à pas - dans **l'analyse des photos de blobs**, afin de fournir les données nécessaires à l'apprentissage du _Machine Learning_. @@ -7,9 +12,9 @@ L'analyse se déroule en **5 étapes** : [1. Charger une photo](#Étape-1-charger-une-photo) <br> [2. Positionner la règle](#Étape-2-positioner-la-règle) <br> [3. Positionner la boîte de Petri](#Étape-3-positionner-la-boîte-de-petri) <br> -[4. Détourer le blob à main levée](#Étape-4-détourer-le-blob) <br> -[5. Télécharger les fichiers de mesures](#Étape-5-télécharger-les-résultats) <br> -[5'. Fusionner les .csv ](#Étape-539-fusionner-les-csv) +[4. Détourer le blob à main levée](#Étape-4-détourer-le-blob) <br> +[5. Voir les résultats de mesures](#Étape-5-voir-les-résultats) <br> +[6. Télécharger les fichiers de mesures](#Étape-6-optionnel-télécharger-les-résultats) <br> Chaque étape est décrite dans la partie droite du _lab_. Il est possible de revenir à tout moment en arrière en cliquant sur le titre de l'étape. @@ -46,16 +51,16 @@ Maintenant au travail ! ## Étape 2 : positioner la règle Cette étape permet au logiciel de déterminer l'échelle de la photo. -**Déplacer la ligne jaune à l'aide des 2 "poignées"** (petits carrés blancs) à chacune de ses extrémités afin de -**couvrir 10cm de la règle**. +**Déplacer la ligne jaune à l'aide des 2 "poignées"** (petits carrés blancs sur ordinateur *ou* des ronds sur tablette) à chacune de ses extrémités afin de +**couvrir 8cm de la règle**.  -Pour s'assurer que 10 centimètres sont bien couverts, **les petits points "détrompeurs" doivent tomber sur chaque centimètre**. +Pour s'assurer que 8 centimètres sont bien couverts, **les petits points "détrompeurs" doivent tomber sur chaque centimètre**.  -Si il y a moins de 10cm règle sur la photo, il est possible de modifier la taille à couvrir avec les boutons +/- (en bleu ci-dessous). +Si il y a moins de 8cm règle sur la photo, il est possible de modifier la taille à couvrir avec les boutons +/- (en bleu ci-dessous). Le nombre de détrompeurs sera ajusté. Pour placer la règle avec plus de précision, utiliser le bouton  (en jaune ci-dessous). @@ -94,7 +99,6 @@ Lors de cette étape, **entourer d'une ligne jaune le blob** (dessiner en mainte > > **Oh non !** Si près de la fin > ->  >  > > Il est possible de revenir en arrière sur les derniers points du tracé avec le bouton  @@ -109,40 +113,25 @@ Lorsque l'on a rejoint le point de départ marqué par un carré blanc, **le con Le bouton  s'active et permet de **passer à l'étape suivante**. --- + +## Étape 5 : voir les résultats -## Étape 5 : télécharger les résultats + - - -**Télécharger les fichiers un à un** avec . - -Les fichiers sont stockés dans le répertoire "Téléchargements" du navigateur. - -> [!NOTE|label:Attention] -> Ces fichiers ne peuvent pas être tout de suite déposés sur l'espace de dépôt des fichiers d'analyse (https://blob.cnrs.fr/). -> -> En effet, le fichier _.csv_ généré ne contient que les mesures (aire, périmètre, circualirité, etc.) que pour la photo qui vient d'être analysée. -> Le nom du fichier contient le numéro du blob (par exemple: Results_ConJ1Ex*B3*.csv). -> -> L'espace de dépôt des analyses n'attend qu'**un seul fichier** _.csv_ **pour toutes** les photos d'une séquence groupe/jour/expérience (par ex.: Results_ConJ1Ex.csv). -> -> Une étape supplémentaire permet de regrouper les fichiers. - -## Étape 5' : fusionner les .csv +Les ***mesures du périmètre et de l'aire*** du blob détouré s'affiche alors. Les élèves peuvent alors les noter. + +Le bouton ***Plus de résultats*** permet d'afficher les fichiers d'analyse à télécharger si on veut aller plus loin. + +--- -> :gift: Pour 5 étapes effectuées une étape offerte ! +## Étape 6 (optionnel): télécharger les résultats -Un bouton dans l'étape 5 permet d'ouvrir l'outil de fusion des fichiers. + - +**Télécharger les fichiers un à un** avec . -Une fenêtre comme celle-ci s'affiche : +Les fichiers sont stockés dans le répertoire "Téléchargements" du navigateur. - + -Pas à pas : -1. \[encadré en vert] Sélectionner des fichiers à fusionner. Plusieurs fichiers peuvent être sélectionnés à la fois. Ils peuvent être sélectionnés en vrac mêmes s'ils font partie de séquences (groupe/jour/expérience) d'analyse différentes. -2. \[marqué en rouge] Les fichiers sont automatiquement triés et regroupés par séquence (groupe/jour/expérience) -3. \[entouré en jaune] Les fichiers résultats sont téléchargeables avec le bouton  -Maintenant **les fichiers peuvent être transmis par [la plateforme de dépôt de données](https://blob.cnrs.fr/)**. diff --git a/docs/images/download_panel2.png b/docs/images/download_panel2.png new file mode 100644 index 0000000000000000000000000000000000000000..cf77f8896fb1fff1141a943215fde481668be723 Binary files /dev/null and b/docs/images/download_panel2.png differ diff --git a/docs/images/mesure_panel.png b/docs/images/mesure_panel.png new file mode 100644 index 0000000000000000000000000000000000000000..5d44ab78e4e9f3ce3432aa5ed0566640268795c6 Binary files /dev/null and b/docs/images/mesure_panel.png differ