Aller au contenu principal

TP2 đź§® Partie 1

attention

Cette partie du TP compte pour 10 % et est à remettre six jours après la séance 12.

🌳 Arbres de Québec - Questions et statistiques​

astuce

Commencez par explorer les données du fichier CSV pour comprendre leur structure et leur contenu, en utilisant des fonctions comme head(), info() et describe() de pandas.

📝 Description
  • La Ville de QuĂ©bec a rĂ©pertoriĂ© les arbres situĂ©s sur son territoire.
    L'objectif de ce projet est d'analyser ces données pour comprendre la répartition des espèces d'arbres, leur taille, etc.
🔢 Source de données
7 points 🔍 Éléments à analyser

Écrivez une fonction par question dans analyse.py. Respectez exactement le nom de chaque fonction (question1 à question6) : l'autocorrecteur s'en sert pour les retrouver.

1 point Question 1 - Quels noms latins d'espèces distincts sont présents dans le jeu de données?​

  • La fonction question1() ne prend aucun paramètre.
  • Elle retourne une liste de chaĂ®nes de caractères (str).

1 point Question 2 - Quelle est la topographie où se trouve l'arbre le plus au nord, au sud, à l'est ou à l'ouest?​

  • La fonction question2(cardinal) prend en paramètre obligatoire le point cardinal : "nord", "sud", "est" ou "ouest".
  • Elle retourne une chaĂ®ne de caractères (str).

1 point Question 3 - Quelques infos sur l'arbre le plus au nord, au sud, à l'est ou à l'ouest?​

  • La fonction question3(cardinal) prend en paramètre obligatoire le point cardinal : "nord", "sud", "est" ou "ouest".
  • Elle retourne un dictionnaire avec les paires clĂ©s:valeurs suivantes :
    • 'espece_en_français' : str
    • 'coordonnĂ©es' : tuple de deux float (latitude et longitude)
    • 'nom' : str (le nom de la topographie oĂą se trouve l'arbre)

1 point Question 4 - Combien d'espèces distinctes sont recensées dans le lieu demandé?​

  • La fonction question4(nom_lieu) prend en paramètre obligatoire le nom du lieu.
  • Elle retourne un entier (int).

1 point Question 5 - Quel lieu compte le plus d'espèces d'arbres?​

  • La fonction question5() ne prend aucun paramètre.
  • Elle retourne un dictionnaire avec les clĂ©s 'nom_lieu' : str et 'nombre_espèces' : int.
  • On veut sans doute parcourir l'ensemble des noms de lieux.
  • Indice : vous pouvez sans doute vous servir d'une question prĂ©cĂ©dente.
  • Aussi, selon votre choix de solution, le temps d'exĂ©cution de cette fonction pourrait ĂŞtre assez long (il peut ĂŞtre plus rapide si vous utilisez les bonnes fonctions de pandas).

2 points Question 6 - Quel est le diamètre moyen du tronc des feuillus et des conifères au parc Bardy ou ailleurs?​

  • La fonction question6(lieu="Parc Bardy") a un paramètre optionnel avec la valeur par dĂ©faut "Parc Bardy".
  • Elle retourne un dictionnaire avec les clĂ©s 'diametre_feuillus' : float et 'diametre_coniferes' : float.
Contraintes Ă  respecter

Chaque fonction doit :

  • pouvoir ĂŞtre appelĂ©e sans paramètre, sauf question2(cardinal), question3(cardinal) et question4(nom_lieu) qui prennent un paramètre obligatoire et question6(lieu="Parc Bardy") qui prend un paramètre optionnel ;
  • retourner le rĂ©sultat dans le format indiquĂ© ;
  • appeler pd.read_csv() ;
  • nettoyer les donnĂ©es au besoin ;
  • porter exactement le nom demandĂ© ;
  • ne pas appeler print().
2 points ✏️ Fichier sommaire.txt

Développez question_sommaire() dans analyse.py pour enregistrer les six questions et leurs réponses dans sommaire.txt.

  • La fonction appelle les six fonctions question1() Ă  question6() pour obtenir les rĂ©ponses.
  • Pas besoin d'appeler question2() puisque question3() donne la mĂŞme information et mĂŞme plus.
  • Pour question3(), utilisez les points cardinaux ("nord", "sud", "est" ou "ouest") comme argument. On veut les 4 rĂ©sultats.
  • Pour question4(), utilisez un nom de parc comme argument.
  • Le fichier prĂ©sente chaque question suivie de sa rĂ©ponse.
  • Soignez la prĂ©sentation : votre sommaire sera lu par un responsable de la Ville, pas par Python. Pas de donnĂ©es brutes « dumpĂ©es » :
    • aĂ©rez et alignez le contenu (une espèce par ligne, une ligne vide entre les questions, etc.) ;
    • mettez en forme les valeurs (unitĂ©s, dĂ©cimales arrondies, etc.) ;
    • n'affichez ni accolades, ni crochets, ni parenthèses, ni guillemets provenant des collections Python.
  • La fonction ne prend aucun paramètre et ne retourne aucune valeur.
âś… Autocorrecteur

L'autocorrecteur compare les valeurs retournées par vos fonctions question1() à question6() aux réponses attendues.
Pour que le script fonctionne correctement, il faut absolument que vos fonctions portent exactement ces noms et aient les paramètres demandés.

Limitations du script
Le script possède certaines limites et ne vérifie pas les points suivants (qui peuvent vous faire perdre des points) :

  • La cohĂ©rence de vos docstrings ainsi que la qualitĂ© du français ;
  • La prĂ©sence de code inutile ou redondant Ă  l'intĂ©rieur de vos fonctions ;
  • La fonction question_sommaire() et la crĂ©ation du fichier sommaire.txt.
1 point Évaluation des docstrings

Les docstrings doivent être rédigées dans un français sans faute. Elles doivent décrire clairement le rôle de chaque fonction et sa valeur de retour.

Fonctionnement global 2 points négatifs

Le projet fonctionne sans plantage et correctement, et le code est clair et facile à lire. Ce pointage fonctionne en négatif. Si le projet fonctionne correctement en tout temps, vous conservez votre note. Dans le cas contraire, vous perdez des points, avec un maximum de 2.

  • Plantage (un script qui plante lorsqu'on l'exĂ©cute) -1 point
  • Code illisible (ex : noms de variables incomprĂ©hensibles, difficultĂ© Ă  comprendre le code) -1 point
  • Information affichĂ©e incohĂ©rente -1 point
  • Autre cas...

➡️ TP2 Partie 2