GradesCalculator est un package Python qui permet de calculer une note globale à partir de notes pondérées. Il inclut un script exécutable en ligne de commande pour effectuer ce calcul facilement.
Pour installer le package, vous pouvez utiliser pip après avoir construit le package localement. Suivez ces étapes :
- Clonez le dépôt ou téléchargez les fichiers nécessaires.
git clone https://github.com/BERTHETquentin/GradesCalculator.git- Assurez-vous d'être dans le répertoire contenant
setup.py. - Exécutez les commandes suivantes :
python setup.py sdist bdist_wheel
pip install dist/gradescalculator-0.2-py3-none-any.whl
pip install -e .Vous pouvez aussi le télécharger directement via le gestionnaire de paquets pip
pip install gradescalculatorle lien du package PyPi se trouve ici
Une fois installé, vous pouvez utiliser le script en ligne de commande pour calculer les notes. Voici comment l'utiliser :
Pour calculer une moyenne pondérée à partir de notes et de leurs poids, utilisez la commande suivante :
average note1 poids1 note2 poids2 note3 poids3 ...Supposons que vous avez les notes et poids suivants :
- Note 1 : 3.6 avec un poids de 10
- Note 2 : 4.6 avec un poids de 15
- Note 3 : 5.3 avec un poids de 25
- Note 4 : 4.0 avec un poids de 5
- Note 5 : 4.9 avec un poids de 45
Pour calculer la note globale, exécutez la commande suivante :
average 3.6 10 4.6 15 5.3 25 4.0 5 4.9 45Vous pouvez également importer les notes et leurs poids depuis un fichier CSV. Le fichier CSV doit contenir deux colonnes : la première pour les notes et la deuxième pour les poids.
average --csv chemin/vers/fichier.csvLe script supporte plusieurs méthodes de calcul pour la moyenne :
- weighted : Moyenne pondérée (par défaut)
- arithmetic : Moyenne arithmétique simple
- geometric : Moyenne géométrique Pour spécifier la méthode de calcul, utilisez l'option --method :
average --method [weighted|arithmetic|geometric] note1 poids1 note2 poids2 ...Le script affichera la note globale précise arrondie à 0.01 près et arrondie à 0.5 près :
Precise Overall Grade (rounded to the nearest 0.01): X.X
Rounded Overall Grade (rounded to the nearest 0.5): Y.YLa structure du répertoire pour votre package gradescalculator doit ressembler à ceci :
gradescalculator/
│
├── gradescalculator/
│ ├── __init__.py
│ └── main.py
│
├── tests/
│ ├── __init__.py
│ └── test_calculations.py
│
├── dist/
│ └── gradescalculator-0.2-py3-none-any.whl
│
├── build/
├── gradescalculator.egg-info/
├── setup.py
└── README.mdLa moyenne arithmétique est la somme de toutes les valeurs divisée par le nombre de valeurs. C'est la méthode de calcul de la moyenne la plus couramment utilisée.
Moyenne arithmétique = 
Si vous avez les valeurs 3, 5 et 7 :
Moyenne arithmétique = 
La moyenne géométrique est la n-ième racine du produit des n valeurs. Elle est souvent utilisée pour des ensembles de nombres positifs où l'on souhaite prendre en compte les proportions ou les taux de croissance.
Moyenne géométrique = 
Si vous avez les valeurs 3, 5 et 7 :
Moyenne géométrique = 
La moyenne pondérée est similaire à la moyenne arithmétique, mais chaque valeur est multipliée par un poids. La somme des produits des valeurs par leurs poids est ensuite divisée par la somme des poids.
Moyenne pondérée = 
où 
est le poids associé à la valeur 
Si vous avez les valeurs 3, 5 et 7 avec des poids 1, 2 et 3 respectivement :
Moyenne pondérée = 
- Quentin Berthet - github