Module servant à afficher et gérer facilement des diagrammes en console.
D'où le nom, CLI diagramme, cliagramme.
Les diagrammes disponible sont :
- Diagramme en bâton (ou à barre).
- Diagramme en boite (ou à moustache).
- Diagramme rectangulaire (équivalent de circulaire).
import cligramme
# Source : https://www.faune-france.org/
DONNEES_HIRONDELLE = {
# mois: [En 2019, En 2020]
'Jan.': [0.0, 0.0],
'Fev.': [0.08, 0.13],
'Mars': [2.49, 0.76],
'Avril': [10.13, 4.18],
'Mai': [7.04, 5.93],
'Juin': [5.07, 5.26],
'Jui.': [14.2, 10.5],
'Aout': [19.75, 0.0],
'Sep.': [14.79, 0.0],
'Oct.': [0.35, 0.0],
'Nov.': [0.05, 0.0],
'Dec.': [0.0, 0.0]
}
LISTE_MOIS = DONNEES_HIRONDELLE.keys()
cliagramme.baton(
titre="Présence Hirondelle de rivage par mois en France.",
valeurs=DONNEES_HIRONDELLE,
legende=[
"Année 2019",
"Année 2020"
],
max_valeurs_y=12,
)
INDEX_2019 = 0
INDEX_2020 = 1
cliagramme.boite(
titre="Présence Hirondelle de rivage en 2019 en France.",
valeurs=[
DONNEES_HIRONDELLE[mois][INDEX_2019]
for mois in LISTE_MOIS
],
graduation=40
)
cliagramme.boite(
titre="Présence Hirondelle de rivage en 2020 en France.",
valeurs=[
DONNEES_HIRONDELLE[mois][INDEX_2020]
for mois in LISTE_MOIS
],
graduation=40
)
cliagramme.rectangulaire(
titre="Plus grande présence Hirondelle de rivage en 2019 en France.",
valeurs={
mois: DONNEES_HIRONDELLE[mois][INDEX_2019]
for mois in LISTE_MOIS
}
)
-
Ouvrez une invite de commande.
Comment faire ?
Appuyez sur la touche
Windows
+ la toucheR
, et écrivezcmd
dans la fenêtre qui s'est ouverte. -
Assurez vous d'avoir
Python >=3.6
d'installé.Comment savoir ?
Ecrivez
python --version
dans l'invite de commande. Si Python est installé cela affichera la version qui doit être supérieur à3.6
. Si ce n'est pas le cas, installer Python dans une version égal ou supérieur à 3.6 pour éviter les soucis de compatibilité. -
Assurez vous d'avoir
pip
d'installé.Comment savoir ?
Ecrivez
pip --version
dans l'invite de commande. Sipip
est installé cela affichera la version qui doit être supérieur à10.0.0
.
Si ce n'est pas le cas, écrivezpython -m pip install --upgrade pip
pour mettre à jour. -
Ecrivez la commande suivante :
pip install cliagramme
-
L'ors de nouvelle mise à jour il suffira de rajouter
--upgrade
pour mettre le module à jour :pip install cliagramme --upgrade
-
Ensuite créez un nouveau fichier, importez le module, et amusez vous !
import cliagramme print(cliagramme.baton( valeur={ x: x for x in range(10) } ))
baton(*, titre:str = None, valeurs:dict or list, legende:list = None, max_valeurs_y:int = 10, min_y_nul:bool = True, saut_valeur_y:int = 1, couleur:bool = True, return_diagramme:bool = False) -> None or str:
Diagramme en bâton.
Titre du diagramme.
Valeurs qui constituera le diagramme.
Si l'objet est de type list
, le programme va comprendre que c'est une série.
Légende du diagramme. Utile si il y a plusieurs bâton par valeur en abscisse.
Le nombre maximum de valeur en y (ordonnée). Autrement dit, la hauteur maximum du diagramme.
Définie si la valeur minimal en y doit être zéro. Si min_y_nul=False
alors la valeur minimal en y sera la plus petite valeur.
Définie le nombre de valeur en y qu'il faut sauter à chaque affichage de valeur. La valeur maximum et minimum seront toujours affichées.
Définie si le diagramme sera en couleur ou non.
Si return_diagramme=True
, n'affiche pas le diagramme et le retourne à la place.
import cliagramme
cliagramme.baton(
titre="Nombre d'enfant par famille",
valeurs=[
2, 3, 4, 0, 2, 5, 3, 0, 2, 1, 0, 6, 0, 3, 2
],
max_valeurs_y=12,
saut_valeur_y=3, # 12/3 == 4, seulement 4 valeurs en y
# seront affichées espacées de 3 blanc.
couleur=False
)
boite(*, titre:str = None, valeurs:list, graduation:int = 30, return_diagramme:bool = False) -> str:
Diagramme en boite (ou à moustache).
Titre du diagramme.