- accueil CHATA 
 - exemples 
 - Documentation
   - Tranche

 - Résumé

 - PONX 
 - PLUIE
 - MClaveau

 

TRANCHE 

  

 

 Introduction

TRANCHE est une classe qui utilise :

  • Une liste de critères (les "frontières" des tranches).
  • Des valeurs.
  • Eventuellement des quantités.

Les valeurs sont envoyées de façon incrémentale.
À tout moment, TRANCHE peut retourner un résultat.
Un résultat consiste en une double liste, contenant respectivement :

  • La liste des tranches (des "frontières").
  • La liste des (NOMBRE ou SOMME ou VALEUR_SPÉCIFIQUE).

Le résultat retourne aussi le nombre d'éléments dans l'échantillon.

Comme cela est un peu abstrait, voici un exemple. Soit une liste des factures d'une année. TRANCHE permettra d'obtenir un classement du C.A. par mois (ou du nombre de factures par mois, ou du nombre d'articles par trimestres...)

 

 Initialisation / démarrage

On appelle TRANCHE en lui passant en paramètre la liste des "frontières". Exemple :

tra = chata.tranche(3,6,9,12)

Dans cet exemple, on prépare des tranches trimestrielles, d'après les numéros des mois (1er trimestre jusqu'en mars (3) ; puis 2e trimestre jusqu'en juin (6) ; etc.)

 

 Mode

Le mode est la façon de calculer le résultat, pour chaque valeur classée. Il y en a trois possibles :

  • COUNT ; qui va ajouter 1 pour chaque élément de l'échantillon.
  • SUM ; qui va additionner une valeur pour chaque élément de l'échantillon.
  • CALLBACK ; qui va appler une fonction pour chaque élément de l'échantillon, en lui passant en paramètre le critère et la valeur. La fonction doit retourner un critère et une valeur, qui seront utilisés pour le classement et le résultat.

Par défaut, le mode est "COUNT".

Il est aussi possible de définir un autre mode, soit au moment de l'initialisation, par exemples :

tra = chata.tranche(3,6,9,12, operateur='SUM')

tra = chata.tranche(3,6,9,12, operateur='CALLBACK', fonction=mois)

Pour le mode "CALLBACK"  (dernier exemple), il faut préciser quelle fonction sera appelée.

xxxx