scodoc-cohortes/README.md

# scodoc-cohortes

Visualisation des cohortes de BUT depuis scodoc

Ce programme utilise l'API pour générer des graphes de Sankey permettant
de visualiser le devenir d'une cohorte.

La notion de cohorte devient difficile à traiter lorsqu'on considère
l'existence de passerelles permettant d'entrer à n'importe quel année
d'étude.

La vision proposée est de regarder tous les semestres consécutifs en
partant d'une année de référence, et tous les élèves qui touchent ces
semestres.

On peut alors dégager divers indicateurs de sortie :

  * Sortie en BUT3 avec le diplôme
  * Sortie en BUT2 avec décision de jury positive (ADM/ADJ) qui implique
    normalement la possibilité de poursuivre ses études ailleurs
  * Autorisation de redoublement et l'élève revient
  * Sortie en BUT1 ou BUT2 avec la possibilité de continuer, mais l'élève
    ne revient pas
  * Autorisation de redoublement et l'élève ne revient pas
  * Toute autre sortie du flot de la cohorte

Le premier type de sortie est assurément un succès, et c'est discutable pour
le deuxième. Le taux de réussite est fourni par une fourchette.

Le troisième type n'est ni une réussite ni un échec, et comptera
plus tard comme une réussite ou un échec dans une cohorte ultérieure.

Les trois derniers types, à des niveaux divers, sont des échecs. Le taux
d'échec est donc fourni comme une fourchette entre le dernier type et la
somme des trois derniers.

Il existe un dernier type (qui tombe dans le 5 ou le 6 actuellement), c'est
le cas d'un élève en BUT3 qui ne valide pas le BUT3, a validé le BUT2, et
partirait dans une autre filière après. Le cas paraît beaucoup plus douteux que le deuxième type et est pour le moment classé en échec.

## FICHIERS

### redirect.csv 

Certains élèves ne reçoivent jamais de décision de jury lorsqu'ils quittent la cohorte, tout en n'étant pas démissionnaires. Ce sont des erreurs administratives, mais il est possible d'indiquer un *résultat de jury* fictif pour ces élèves. La plupart du temps, ce sont des élèves qui abandonnent la formation, et il suffit de leur donner le résultat NAR ou DEM. Dans d'autres cas, ça peut être des élèves en attente de décision parce que le jury n'a pas encore eu lieu, mais on sait déjà quel sera l'issue du jury (par exemple des notes élevés et un stage qui se déroule bien, ou au contraire pas de stage trouvé au mois de septembre).

**Format :** format CSV avec virgule comme séparateur. Les lignes vides ou commençant par # sont ignorées.

    #etudid,BUCKET
    
    12345,NAR
    67890,ADM

### theme.csv

Possibilité de choisir les couleurs pour chacune des catégories.

**Format :** format CSV avec virgule comme séparateur. Les couleurs sont au format de sankeymatic.com, soit le format hexadécimal d'HTML sauf la catégorie TRANSPARENT qui vaut #FFFFFF.0 (blanc transparent). Les catégories sont `+DUT`, `QUIT`, `SUCCESS`, `NORMAL`, `FAIL`, `OLD`, `NEW`, `TRANSPARENT`, `RED`.

    +DUT,#0040C0
    QUIT,#00FF00
    SUCCESS,#0000FF
    NORMAL,#C0C0C0
    FAIL,#FF4040
    OLD,#FF8000
    NEW,#FFFF00
    TRANSPARENT,#FFFFFF.0
    RED,#000000
Initial commit 2024-10-10 20:59:41 +02:00			`# scodoc-cohortes`

Describe project 2024-10-10 21:46:57 +02:00			`Visualisation des cohortes de BUT depuis scodoc`

			`Ce programme utilise l'API pour générer des graphes de Sankey permettant`
			`de visualiser le devenir d'une cohorte.`

			`La notion de cohorte devient difficile à traiter lorsqu'on considère`
			`l'existence de passerelles permettant d'entrer à n'importe quel année`
			`d'étude.`

			`La vision proposée est de regarder tous les semestres consécutifs en`
			`partant d'une année de référence, et tous les élèves qui touchent ces`
			`semestres.`

			`On peut alors dégager divers indicateurs de sortie :`

			`* Sortie en BUT3 avec le diplôme`
			`* Sortie en BUT2 avec décision de jury positive (ADM/ADJ) qui implique`
			`normalement la possibilité de poursuivre ses études ailleurs`
			`* Autorisation de redoublement et l'élève revient`
			`* Sortie en BUT1 ou BUT2 avec la possibilité de continuer, mais l'élève`
			`ne revient pas`
			`* Autorisation de redoublement et l'élève ne revient pas`
			`* Toute autre sortie du flot de la cohorte`

			`Le premier type de sortie est assurément un succès, et c'est discutable pour`
			`le deuxième. Le taux de réussite est fourni par une fourchette.`

			`Le troisième type n'est ni une réussite ni un échec, et comptera`
			`plus tard comme une réussite ou un échec dans une cohorte ultérieure.`

			`Les trois derniers types, à des niveaux divers, sont des échecs. Le taux`
			`d'échec est donc fourni comme une fourchette entre le dernier type et la`
			`somme des trois derniers.`

			`Il existe un dernier type (qui tombe dans le 5 ou le 6 actuellement), c'est`
			`le cas d'un élève en BUT3 qui ne valide pas le BUT3, a validé le BUT2, et`
			`partirait dans une autre filière après. Le cas paraît beaucoup plus douteux que le deuxième type et est pour le moment classé en échec.`

Document some files and ignore some others 2024-10-12 21:06:13 +02:00			`## FICHIERS`

			`### redirect.csv`

			Certains élèves ne reçoivent jamais de décision de jury lorsqu'ils quittent la cohorte, tout en n'étant pas démissionnaires. Ce sont des erreurs administratives, mais il est possible d'indiquer un résultat de jury fictif pour ces élèves. La plupart du temps, ce sont des élèves qui abandonnent la formation, et il suffit de leur donner le résultat NAR ou DEM. Dans d'autres cas, ça peut être des élèves en attente de décision parce que le jury n'a pas encore eu lieu, mais on sait déjà quel sera l'issue du jury (par exemple des notes élevés et un stage qui se déroule bien, ou au contraire pas de stage trouvé au mois de septembre).

			`Format : format CSV avec virgule comme séparateur. Les lignes vides ou commençant par # sont ignorées.`

			`#etudid,BUCKET`

			`12345,NAR`
			`67890,ADM`

			`### theme.csv`

			`Possibilité de choisir les couleurs pour chacune des catégories.`

			Format : format CSV avec virgule comme séparateur. Les couleurs sont au format de sankeymatic.com, soit le format hexadécimal d'HTML sauf la catégorie TRANSPARENT qui vaut #FFFFFF.0 (blanc transparent). Les catégories sont `+DUT`, `QUIT`, `SUCCESS`, `NORMAL`, `FAIL`, `OLD`, `NEW`, `TRANSPARENT`, `RED`.

			`+DUT,#0040C0`
			`QUIT,#00FF00`
			`SUCCESS,#0000FF`
			`NORMAL,#C0C0C0`
			`FAIL,#FF4040`
			`OLD,#FF8000`
			`NEW,#FFFF00`
			`TRANSPARENT,#FFFFFF.0`
			`RED,#000000`