README.md

 # INF-TC1
 
-
 ## Installation
 
-* La distribution Anaconda offre cet avantage en étant multi-plateformes (Windows, Mac, Linux) et disposant de tous les outils dont vous aurez besoin en Informatique au cours du semestre (interpréteur Python, éditeur Spyder, divers modules).
+* La distribution Anaconda offre cet avantage en étant multi-plateformes (Windows, Mac, Linux) et disposant de tous les outils dont vous aurez besoin en Informatique au cours du semestre (interpréteur Python, éditeur Spyder, divers modules). Vous obtiendrez la dernière version sur ce site : https://www.anaconda.com/download/
 
 * Nous vous demandons donc de l’installer sur vos ordinateurs et de vérifier son fonctionnement (l’exécution d’un code simple devrait suffire) avant votre première séance de TD.
 
-* Vous obtiendrez la dernière version d’Anaconda sur ce site : https://www.anaconda.com/download/
-
-* Veillez à bien télécharger celle reposant sur Python 3.7 et adaptée à votre environnement (Windows/Mac/Linux, 32/64 bits)
-Ce n’est pas un problème si vous avez déjà une version de Python installée, Anaconda viendra en complément et ajoutera d’autres fonctionnalités.
-
-* Télécharger et installer Microsoft Code : https://code.visualstudio.com/download
+* Concerant l'éditeur de code Python, vous pouvez utiliser Spyder inclu dans Anaconda, mais vous pouvez aussi télécharger et installer Microsoft Code qui est une excellente alternative : https://code.visualstudio.com/download
 
 
 ## Aides en informatique
 
 * Des [transparents d'aide](aide-informatique.pdf)
 * Une vidéo de présentation de ces transparents https://replay.ec-lyon.fr/video/0920-aides-en-informatique/ 
+
+## Livres
+
+Les livres suivants sont disponibles sous forme de pdf et couvrent les points abordés en cours et en TD :
+
+- [Think Python](books/thinkpython2.pdf), 2nd edition, par Allen B. Downey
+- [Python for Everybody](books/pythonlearn.pdf), par Charles Severance
+- [Problem Solving with Algorithms and Data Structures using Python](books/problemsolving.pdf), par Brad Miller et David Ranum
+- [ODS Pyhon](books/ods-python.pdf), par Pat Morin ([url](https://opendatastructures.org/ods-python/))
+
+Autres ressources :
+
+- https://en.wikibooks.org/wiki/Algorithms/
+- [computer science books](https://freecomputerbooks.com/compscAlgorithmBooks.html)
\ No newline at end of file

TD02/etudiants-large100.txt

+nom;prenom;filiere;moyenne;absences
+Dickerson;Chaney;PSI;6;4
+King;Shay;PSI;2;2
+Chan;Aileen;MP;8;3
+Schwartz;Destiny;PSI;16;5
+Parrish;Prescott;MP;1;4
+Calhoun;Brenda;PSI;10;4
+Watts;Shellie;PSI;6;4
+Baird;Octavius;PC;4;2
+Graves;Vanna;MP;10;0
+Decker;Nerea;PSI;9;4
+Townsend;Naomi;PC;13;3
+Decker;Nichole;PSI;10;3
+Mcgee;Blythe;PSI;7;0
+Franco;Cyrus;PSI;12;1
+Mcdowell;Zelda;MP;6;1
+Cherry;Stone;PSI;10;5
+Mendoza;Kirsten;PC;18;0
+Mathis;Xaviera;MP;12;1
+Booker;Gretchen;MP;2;1
+Hansen;Slade;PSI;1;1
+Mason;Forrest;MP;13;3
+Wolfe;Fatima;PC;15;5
+Richards;Justine;MP;20;0
+Kelley;Abra;PC;2;4
+Lang;Ulysses;PSI;2;5
+Barker;Austin;MP;15;5
+Cannon;Kalia;MP;3;4
+Higgins;Charity;PSI;18;5
+Parker;Fritz;PC;14;2
+Chambers;Yvette;PSI;7;1
+Vinson;Denise;PSI;3;5
+Mcmillan;Chava;PSI;7;3
+Gallegos;Lee;PC;16;0
+Ferguson;Solomon;PSI;11;4
+Camacho;Zena;MP;4;4
+Sexton;Fallon;PSI;16;2
+Campbell;Preston;PC;0;0
+Greer;Lance;PC;15;5
+Oliver;Aileen;PC;10;2
+Nielsen;Timon;PC;1;2
+Perkins;Roth;PSI;1;2
+Beard;Blair;PSI;13;1
+Burgess;Keely;PSI;4;4
+Wells;Honorato;PSI;17;0
+Richardson;Cherokee;PC;20;1
+Burgess;Blair;PC;16;4
+Rice;Florence;PC;7;4
+Villarreal;Delilah;MP;9;5
+Cherry;Maite;MP;0;2
+Berry;Jermaine;MP;17;4
+Shepherd;Alfreda;PSI;20;5
+Workman;April;PC;3;1
+Carter;Herman;PC;11;1
+Carpenter;Teagan;MP;0;1
+Fowler;Leo;PSI;19;4
+Mcgee;Kristen;PSI;9;4
+Mcpherson;Channing;PC;0;0
+Diaz;Nathaniel;PC;4;5
+Klein;Maisie;PSI;16;3
+Graham;Gary;MP;12;4
+Jensen;Raja;PC;18;1
+Wilkinson;Sawyer;PSI;10;0
+Wagner;Lamar;MP;16;2
+Abbott;Sybil;MP;17;1
+Glenn;Arsenio;PSI;4;3
+Moreno;Axel;PSI;7;4
+Barrett;Dylan;PC;14;4
+Keith;Rae;PC;9;1
+Shepard;Rebecca;PC;8;5
+Meyers;Illiana;MP;3;3
+Bruce;Tatyana;MP;2;0
+Mcguire;Olivia;PC;17;4
+Merritt;Tatiana;PSI;19;3
+Berg;Dale;MP;12;1
+Matthews;Tallulah;MP;5;3
+Steele;Cain;MP;8;2
+Ellison;Britanni;PC;4;1
+Richards;Audra;MP;15;0
+Hood;Rylee;PSI;1;4
+Townsend;Paul;PC;14;4
+Cervantes;Thaddeus;MP;10;5
+Dudley;Amela;PC;2;0
+Lucas;Matthew;MP;4;1
+Parrish;Nell;PC;13;3
+Patterson;Bertha;PSI;18;0
+Knapp;Lawrence;MP;3;5
+Stanton;Keith;MP;5;2
+Hayes;Mannix;PSI;3;2
+Pearson;Ross;PC;10;4
+Kaufman;Uta;MP;10;4
+Bauer;Naida;PC;20;5
+Carrillo;Quamar;PC;15;3
+Orr;Lisandra;PSI;6;2
+Randolph;Darryl;PSI;16;4
+Boyer;Prescott;PC;20;2
+Serrano;Ashely;PSI;10;2
+Carney;Oren;PC;7;4
+Riley;Arden;PC;1;5
+Phillips;Joshua;PSI;20;3
+Soto;Colt;PC;16;3
\ No newline at end of file

TD02/etudiants.txt

+nom;prenom;filiere;note;absences
+Dupond;Pierre;MP;19;7
+Dupont;Jeanne;MP;19;5
+Clavier;Christian;PSI;14;1
+Gilles;Eric;PC;16;3
+Arthaud;Nathalie;MP;15;0
\ No newline at end of file

TD05/INF-TC1-td05.ipynb

+%% Cell type:markdown id:751c51f9 tags:
+
+NAME:
+
+%% Cell type:markdown id:b97bad7e-82ff-44a7-9779-13c139085623 tags:
+
+# INF TC1 - TD5 (2h + 2h AUTONOMIE) - Devoir à rendre #1
+
+%% Cell type:markdown id:1bb26026-8560-4a3c-90e6-2cfd7a49320a tags:
+
+---
+
+%% Cell type:markdown id:dd8d4905-55f9-4957-8008-a963cc6de061 tags:
+
+Vous serez évalué sur le rendu de ce TD qui sera à déposer sur Moodle **deux (2) semaines** après la séance d'autonomie #1. Le rendu sera à réaliser sous forme de **notebook** qui contient votre code et images.
+
+%% Cell type:markdown id:99ee8fad-7f32-4fe2-85d3-3b8da49f317f tags:
+
+<details style="border: 1px">
+<summary> MODALITES DE RENDU</summary>
+
+### Comment rendre son devoir ?
+
+Vous serez évalué sur le rendu de ce TD qui sera à déposer sur Moodle **deux (2) semaines** après les séances d'autonomie et de TD. Vous devrez créer une archive (zip, rar, etc.) nomée `nom1-nom2-inf-tc1-td5.zip` qui contiendra tous les éléments de votre rendu (rapport en notebook, code, images de test). Vous pouvez rendre ce rapport seul ou en binôme. Le rendu du TD doit contenir a minima :
+
+1. Toutes les étapes jusqu'à la 6ème doivent avoir été abordées
+2. Justifications, illustrations et tests sur plusieurs images
+
+**A garder en tête :**
+
+- Un code fonctionnel et les tests appropriés devront être fournis dans l'archive qui doit être autonome (le correcteur ne doit pas avoir à rajouter d'image ou de fichier supplémentaire)
+
+- Vous fournirez les images de test et leurs résultats; évitez cependant de prendre des tailles d'images trop importantes.
+
+- Le rapport **devra être au format Notebook Jupyter** et comprendre :
+
+  - Le détail des étapes que vous avez suivies
+
+  - La description de parties de code difficiles
+
+  - Tout souci ou point bloquant dans votre code
+
+  - Les graphiques et diagrammes nécessaires
+
+  - Des analyses et discussions en lien avec votre approche
+
+  - Des exemples simples mais aussi difficiles
+
+**Tout travail supplémentaire (méthode originale, optimisation poussée) fera l'objet de points en bonus.**
+
+
+
+*Voici une suggestion afin de se faire un ordre d'idée*
+
+
+Un groupe avec une note entre 10 et 12 :
+
+- Les étapes suivies
+- Un code fonctionnel et les méthodes basiques
+- Un rapport succint
+- Un code certes fonctionnel mais peu commenté
+- Les exemples d'images fournies
+
+Un groupe entre 12 et 14 a en plus proposé :
+
+- Des structures de données avancées (Ensembles, Files, etc)
+- Une justification de chaque étape
+- Une méthode un petit peu plus poussée
+
+Un groupe entre 14 et 16 a en plus proposé :
+
+- Une méthode originale (K-Means, etc)
+- Une démarche expérimentale très détaillée sur les optimisations
+- Des tests plutôt originaux
+
+Un groupe au-dessus de 16 comporte une ou plusieurs parties exceptionnelles :
+
+- Rapport très détaillé et exemplaire sur le fond comme sur la forme
+- Une démarche expérimentale très détaillée sur les optimisations
+- Code et tests
+
+
+
+</details>
+
+%% Cell type:markdown id:d48155b2-8db8-4557-a66b-363351712560 tags:
+
+## Objectif du devoir
+
+Le but de ce devoir est de **déterminer automatiquement une palette de couleurs optimale** pour une image donnée. Cette palette devra valider les contraintes suivantes :
+
+1. utiliser moins de couleurs que le nombre disponible dans l'image donnée;
+2. être la plus représentative possible des couleurs de l'image donnée.
+
+Comme nous l'avons vu dans le TD 4, les couleurs peuvent être encodée par composantes rouge, verte et bleue (soit 256 valeurs possibles par composante, autrement dit sur 8 bits) ainsi potentiellement utiliser $256 \times 256 \times 256 = 16 777 216$ couleurs. En réalité, beaucoup moins sont nécessaires et surtout perceptibles par l'humain. Réduire le nombre de couleurs ou réaliser une "_quantification de couleurs_" est une tâche fréquente et c'est une fonctionnalité classique des outils éditeurs d'images (Photoshop, Gimp, etc.) implémentée aussi dans le module Pillow de Python. A noter que cette réduction s'effectue avec perte de couleurs et doit être réalisée avec les bons paramètres (nombre et choix des couleurs) ce qui est votre objectif.
+
+La figure ci-dessous illustre le problème à résoudre : étant donnée une image en entrée, proposer une liste de couleurs (que l'on appellera la palette), afin de re-colorier une image en sortie.
+
+<div style="text-align:center;">
+<table>
+  <tr>
+    <td>
+      <img src="figures/color-rainbow.png" alt="Image originale" style="height:5cm;">
+      <p>Image donnée</p>
+    </td>
+    <td>
+      <img src="figures/rainbow-palette-8.png" alt="Palette de 8 couleurs représentatives" style="height:5cm;">
+      <p>Palette de 8 couleurs représentatives</p>
+    </td>
+    <td>
+      <img src="figures/rainbow-recoloriee.png" alt="Image originale recoloriée avec la palette" style="height:5cm;">
+      <p>Image donnée recoloriée avec la palette</p>
+    </td>
+  </tr>
+</table>
+</div>
+
+%% Cell type:markdown id:fd464e65-adfe-4e11-bf87-f12c513fbaea tags:
+
+## Étapes de travail
+
+Voici des étapes de travail suggérées :
+
+1. Prenez une image de votre choix (pas trop grande) en la chargeant avec PIL. Lister les couleurs présentes, identifier celles qui sont uniques et leur fréquence.
+
+2. Proposez une méthode (naïve pour commencer) de choix d'une palette de $k$ couleurs. Affichez là sous forme d'image (exemple de d'image au milieu de la figure du dessus) avec une nouvelle image PIL. Utilisez également des images simples où le résultat attendu est connu comme pour les images ci-dessous :
+
+  <div style="text-align:center;">
+    <table>
+      <tr>
+        <td>
+          <img src="figures/1-color-back.png" alt="1 couleur noir" style="width:3cm;">
+          <p>1 couleur noir</p>
+        </td>
+        <td>
+          <img src="figures/4-color.png" alt="4 couleurs" style="width:3cm;">
+          <p>4 couleurs</p>
+        </td>
+      </tr>
+    </table>
+  </div>
+
+3. Re-coloriez une image avec une palette de $k$ couleurs, et affichez le résultat sous forme d'image PIL. Pour re-colorier chaque pixel, prendre la couleur la plus proche dans la palette en utilisant une fonction de distance (Euclidienne par exemple..).
+
+4. Proposez une méthode de validation de votre approche. Par exemple affichez la différence entre l'image originale et celle re-coloriée. Calculez un score global d'erreur.
+
+5. Améliorez le choix des $k$ couleurs afin de minimiser l'erreur entre l'image originale et re-coloriée. Une piste possible est de trier les couleurs dans une liste, diviser cette liste en $k$ intervals de couleurs et prendre la couleur du milieu de chaque interval. D'autres méthodes plus avancées peuvent être explorées !
+
+6. Testez votre palette sur plusieurs images de votre choix ou générées automatiquement avec un nombre et une distribution connue de couleurs. Comparer les performances de vos techniques avec d'autres méthodes (cette fois vous pouvez utiliser un éditeur de texte ou la fonction _quantize_ de PIL [(doc)](https://pillow.readthedocs.io/en/stable/reference/Image.html).
+
+7. Utilisez un pré-traitement des images (flou gaussien, etc) afin de lisser les couleurs. Cela est une piste afin de choisir de meilleurs couleurs représentatives. Proposez une comparaison de cette amélioration (ou de déterioration éventuelle) avec les autres méthodes.
+
+8. Proposez une méthode d'amélioration de calcul de la distance entre deux couleurs, vous pouvez vous baser sur d'autres espaces de couleur [(doc)](https://fr.wikipedia.org/wiki/Espace_de_couleur). Cette partie est difficile, les espaces de couleurs possibles sont complexes à comprendre.
+
+9. Optimisez les étapes précédentes (complexité, espace nécessaire, structures de données, etc.) et justifiez vos choix.
+
+
+### Bonus
+
+10. Créez une palette représentative à partir de plusieurs images.