Voir la source de Simscript III/ACCUMULATE/TALLY

Les énoncés <span style="color:#0000FF;">accumulate </span>et <span style="color:#0000FF;">tally </span>permettent de calculer des quantités statistiques et de préparer des histogrammes sur une variable ''x'' dépendant du temps.  Elles s<nowiki>’</nowiki>utilisent uniquement dans le <span style="color:#0000FF;">preamble</span>.

On emploie tally dans le cas où ''x'' est définie en des instants ''t''<sub>1</sub>,&nbsp;''t''<sub>2</sub>,&nbsp;...,&nbsp;''t''<sub>''n''</sub> et accumulate dans le cas où ''x'' est définie sur tout l<nowiki>’</nowiki>intervalle ''<nowiki>[</nowiki>O,T<nowiki>]</nowiki>''&nbsp;:

'''<br>ACCUMULATE&nbsp;/&nbsp;TALLY'''


La syntaxe est la même dans les deux cas&nbsp;:

<math>\begin{align}
  & \left\{ \begin{matrix}
\color{blue} \text{tally}  \\
\color{blue}  \text{accumulate}  \\
\end{matrix} \right\} \  \, Nom_{\text{1}}\text{ }\left\{ \begin{matrix}
   \text{=}  \\
\color{blue}\text{as }  \color{black}\left[  \color{blue}\text{the}  \color{black}\right]  \\
\end{matrix} \right\}\text{ }\left[ qualificatif \right]mot\_cl\acute{e}_{\text{1}}\text{, } \\ 
 & \text{          }\qquad\qquad\qquad\quad Nom_{\text{2}}\text{ }\left\{ \begin{matrix}
   \text{=}  \\
\color{blue}\text{as }  \color{black}\left[  \color{blue}\text{the}  \color{black}\right]  \\
\end{matrix} \right\}\text{ }\left[ qualificatif \right]mot\_cl\acute{e}_{\text{2}}\text{,} \\ 
 & \text{ }\qquad\qquad\qquad\quad ...\text{,} \\ 
 & \text{           }\qquad\qquad\qquad\quad Nom_{\text{n}}\text{ }\left\{ \begin{matrix}
   \text{=}  \\
\color{blue}\text{as }  \color{black}\left[  \color{blue}\text{the}  \color{black}\right]  \\
\end{matrix} \right\}\text{ }\left[ qualificatif \right]mot\_cl\acute{e}_{n}\text{,} \\ 
 & \text{          }\qquad\qquad\qquad\quad Nom_{\text{h}}\text{ (}q_{\text{1}}\text{ to }q_{\text{2}}\text{ by }q_{\text{3}}\text{) }\left\{ \begin{matrix}
   \text{=}  \\
\color{blue}\text{as }  \color{black}\left[  \color{blue}\text{the}  \color{black}\right]  \\
\end{matrix} \right\}\text{ }\left[ qualificatif \right]\color{blue}\text{ histogram of }\color{black}x \\ 
 &  \\ 
\end{align}</math>


''x'' peut être une variable globale, ou un attribut d<nowiki>’</nowiki>entité(s) permanente(s) ou encore un attribut d<nowiki>’</nowiki>entité(s) temporaire(s) (sauf pour un histogramme), un attribut d<nowiki>’</nowiki>une ressource ou d<nowiki>’</nowiki>une entité composée ou un attribut du système. La variable ''x'' doit être numérique; c<nowiki>’</nowiki>est-à-dire le mode doit être <span style="color:#0000FF;">integer</span>, <span style="color:#0000FF;">integer2</span>, <span style="color:#0000FF;">integer4</span>, <span style="color:#0000FF;">alpha</span>, <span style="color:#0000FF;">double</span>, <span style="color:#0000FF;">real</span>; la variable ne peut être une variable de mode <span style="color:#0000FF;">pointer</span>, <span style="color:#0000FF;">text</span>, <span style="color:#0000FF;">reference </span>ou <span style="color:#0000FF;">subprogram</span>. Cette variable peut avoir une dimension et peut être monitorée. Elle peut être définie explicitement ou implicitement. Ce variable ne peut être une fonction attribut, une variable aléatoire ou une statistique recueillie par un autre énoncé <span style="color:#0000FF;">accumulate</span>/<span style="color:#0000FF;">tally</span>.

Si l<nowiki>’</nowiki>énoncé <span style="color:#0000FF;">accumulate</span>/<span style="color:#0000FF;">tally</span> apparaît à l<nowiki>’</nowiki>intérieur d<nowiki>’</nowiki>un bloc <span style="color:#0000FF;">begin class … end</span>, la variable sur laquelle on recueille des statistiques est un attribut d<nowiki>’</nowiki>un objet ou d<nowiki>’</nowiki>une classe définie par la classe ou hérité d<nowiki>’</nowiki>une autre classe. Si la variable est un attribut d<nowiki>’</nowiki>objet, chaque statistique est un attribut d<nowiki>’</nowiki>objet, tandis que si la variable est un attribut de la classe, chaque statistique est un attribut de la classe. Si la variable est définie dans le préambule public, et l<nowiki>’</nowiki> énoncé <span style="color:#0000FF;">accumulate</span>/<span style="color:#0000FF;">tally</span> apparaît dans le préambule privé, la variable doit être un attribut d<nowiki>’</nowiki>objet. En d<nowiki>’</nowiki>autres mots, les statistiques privées ne peuvent être recueillies sur les attributs publics d<nowiki>’</nowiki>une classe.

''Nom''<sub>1</sub>,...,''Nom''<sub>n</sub> sont des noms de fonctions qui n<nowiki>’</nowiki>ont pas besoin d<nowiki>’</nowiki>être déclarées par ailleurs et qui calculent automatiquement les quantités demandées par les mots-clés de l<nowiki>’</nowiki>énoncé, lorsqu<nowiki>’</nowiki>on y fait référence (généralement en fin de simulation).

Voici les mots-clés et les calculs effectués par un <span style="color:#0000FF;">tally&nbsp;</span>:

{|border="0" cellspacing="0" cellpadding="4" width="80%" align="center"
|<span style="color:#0000FF;">number <nowiki>|</nowiki> num</span>
|N&nbsp;&nbsp;=&nbsp;&nbsp;nombre de mesures de ''x''<sub>i</sub>

|-
|<span style="color:#0000FF;">sum</span>
|<math>\sum\limits_{i=1}^{N}{x_{i}}</math>

|-
|<span style="color:#0000FF;">sum.of.squares <nowiki>|</nowiki> ssq</span>
|Somme des  ''x''<sup>2</sup>: <math>\sum\limits_{i=1}^{N}{x_{_{i}}^{2}}</math>

|-
|<span style="color:#0000FF;">average  <nowiki>|</nowiki> avg <nowiki>|</nowiki> mean</span>
|<math>Moy=\bar{x}=\frac{\sum\limits_{i=1}^{N}{x_{i}^{{}}}}{N}</math>

|-
|<span style="color:#0000FF;">mean.square <nowiki>|</nowiki> msq</span>
|<math>\frac{\sum\limits_{i=1}^{N}{x_{i}^{2}}}{N}</math>

|-
|<span style="color:#0000FF;">variance <nowiki>|</nowiki> var</span>
|variance de ''x'' = mean.square – mean**2

|-
|<span style="color:#0000FF;">std.dev <nowiki>|</nowiki> std</span>
|écart-type de ''x'' = sqrt.f(variance)

|-
|<span style="color:#0000FF;">maximum <nowiki>|</nowiki> max</span>
|maximum des ''x''

|-
|<span style="color:#0000FF;">minimum <nowiki>|</nowiki> min</span>
|minimum des ''x''

|}<br clear="all" />
Pour un <span style="color:#0000FF;">accumulate</span>, les mots-clés sont les mêmes, mais les calculs effectués sont évidemment différents&nbsp;:

{|border="0" cellspacing="2" width="75%"
|Notations&nbsp;:
|T(0)
|=
|colspan = "4"|instant 0

|-
|&nbsp;
|T(n)
|=
|colspan = "2"|instant du n-ème changement de valeur de ''x''

|-
|&nbsp;
|''x''
|=
|valeur de ''x'' dans l<nowiki>’</nowiki>intervalle <nowiki>[</nowiki>T(n-1),T(n)<nowiki>]</nowiki>

|-
|&nbsp;
|time
|=
|instant d<nowiki>’</nowiki>appel des fonctions calculées
|}


{|border="0" cellspacing="0" cellpadding="4" width="85%" align="center"
|<span style="color:#0000FF;">number <nowiki>|</nowiki> num</span>
|N&nbsp;=&nbsp;nombre de changements de valeurs de ''x''

|-
|<span style="color:#0000FF;">sum</span>
|Somme de (T(n)-T(n-1))*''x''

|-
|<span style="color:#0000FF;">sum.of.squares <nowiki>|</nowiki> ssq</span>
|Somme de (T(n)-T(n-1))*(''x''**2)

|-
|<span style="color:#0000FF;">average <nowiki>|</nowiki>  avg <nowiki>|</nowiki> mean</span>
|sum/(time-T(0))

|-
|<span style="color:#0000FF;">mean.square <nowiki>|</nowiki> msq</span>
|sum.of.squares/(time-T(0))

|-
|<span style="color:#0000FF;">variance <nowiki>|</nowiki> var</span>
|mean.square – mean**2

|-
|<span style="color:#0000FF;">std.dev <nowiki>|</nowiki> std</span>
|écart-type de ''x''&nbsp;=&nbsp; sqrt.f.(variance)

|-
|<span style="color:#0000FF;">maximum <nowiki>|</nowiki> max</span>
|maximum de ''x'' sur <nowiki>[</nowiki>T(0), time.v<nowiki>]</nowiki>

|-
|<span style="color:#0000FF;">minimum <nowiki>|</nowiki> min</span>
|minimum de ''x''  sur <nowiki>[</nowiki>T(0), time.v<nowiki>]</nowiki>

|}<br clear="all">

''Nom''<sub>h</sub> est un nom de tableau défini automatiquement avec une dimension de plus que la variable ''x'', tableau qui contiendra l<nowiki>’</nowiki>histogramme de ''x'' pour les valeurs comprises entre ''q''<sub>1</sub> et ''q''<sub>2</sub>, par tranches de ''q''<sub>3</sub> unités (les ''q''<sub>i</sub> doivent être des constantes numériques, ou des variables globales initialisées une fois pour toute avant la première utilisation du <span style="color:#0000FF;">tally</span>).  Par exemple, si ''x'' est un attribut de couple d<nowiki>’</nowiki>entités permanentes (E1,E2) ''Nom''<sub>h</sub> sera un tableau à 3 indices i, j, k avec i&nbsp;=&nbsp;1,&nbsp;...,&nbsp;n.E1;&nbsp;j&nbsp;=&nbsp;1,&nbsp;...,&nbsp;n.E2 et k&nbsp;=&nbsp;1,&nbsp;...,&nbsp;n avec n&nbsp;=&nbsp;(''q''<sub>2</sub> – ''q''<sub>1</sub>) / ''q''<sub>3</sub> <nowiki>+</nowiki> 1.

<span style="color:#0000FF;">tally</span> compte le nombre de fois où (<span style="color:#0000FF;">accumulate</span> cumule la durée pendant laquelle) la variable ''x''(i, j) est tombée dans l<nowiki>’</nowiki>intervalle&nbsp;:  <nowiki>[</nowiki>''q''<sub>1</sub><nowiki>+</nowiki>(k-1)''q''<sub>3</sub> , ''q''<sub>1</sub><nowiki>+</nowiki>k''q''<sub>3</sub><nowiki>[</nowiki> pour k&nbsp;=&nbsp;1,...,n et met ce nombre (cette durée) dans ''Nom''<sub>h</sub>(i, j, k).

N.B.&nbsp;:  les valeurs ''x''&nbsp;<nowiki><</nowiki>&nbsp;''q''<sub>1</sub> vont aussi dans la case 1 et les valeurs ''x''&nbsp;≥&nbsp;''q''<sub>2</sub> vont dans la case n.



Exemples&nbsp;:

Soit Occupé une variable globale qui manque l<nowiki>’</nowiki>occupation d<nowiki>’</nowiki>un serveur (Occupé =&nbsp;0 quand il est libre et Occupé =&nbsp;1 quand il est occupé).  Alors:

::<span style="color:#0000FF;">accumulate </span>R0&nbsp;&nbsp;<span style="color:#0000FF;">as the mean of </span>Occupé

donnera le taux d<nowiki>’</nowiki>occupation du serveur durant la simulation.


Si Bac est un ensemble et si on place dans le <span style="color:#0000FF;">preamble&nbsp;</span>:
{|border="0" cellspacing="2" width="35%"
|-
|<span style="color:#0000FF;">accumulate </span>
|L_Bac&nbsp;&nbsp;<span style="color:#0000FF;">as the mean</span>,

|-
|
|p (<span style="color:#FF0000;">0</span> to <span style="color:#FF0000;">100</span> by <span style="color:#FF0000;">1</span>)&nbsp;&nbsp;as the histogram of N.Bac
|}
on aura en fin de simulation L_Bac&nbsp;&nbsp;=&nbsp;&nbsp;longueur moyenne de la file Bac et p(k) / '''time.v'''&nbsp;&nbsp;=&nbsp;&nbsp;probabilité d<nowiki>’</nowiki>avoir k 1 clients dans la file Bac pour k&nbsp;&nbsp;=&nbsp;&nbsp;1,...,101.

Remarque: si Bac est indicée par une entité permanente Canal, on aura avec ce même énoncé les quantités demandées pour toutes les files en faisant référence à L_Bac(i) et p(i,k) pour i = 1,...,N.Canal.


3. Si w est une variable globale qui mesure le temps passé par chaque client dans la file Bac (on a donc "w&nbsp;&nbsp;=&nbsp;&nbsp;'''time.v'''&nbsp; &nbsp;Heure_Arrivee(Client)" derrière "remove first Client from Bac" dans un routine), alors:


{|border="0" cellspacing="2" width="35%" 
|-
|tally
|Nw&nbsp;&nbsp;=&nbsp;&nbsp;number,

|-
|
|Ew&nbsp;&nbsp;=&nbsp;&nbsp;mean,

|-
|
|Sw&nbsp;&nbsp;=&nbsp;&nbsp;std.dev,

|-
|
|Hw (<span style="color:#FF0000;">0</span> to <span style="color:#FF0000;">20</span> by <span style="color:#FF0000;">0.1</span>) = histogram of w
|}

{|border="0" cellspacing="2" width="35%"
|-
|donnera:
|Ew&nbsp;&nbsp;=&nbsp;&nbsp;temps moyen d<nowiki>’</nowiki>attente des paquets

|-
|
|Sw&nbsp;&nbsp;=&nbsp;&nbsp;écart type du temps d<nowiki>’</nowiki>attente

|-
|
|Nw&nbsp;&nbsp;=&nbsp;&nbsp;nombre de mesure de w effectuées
|}


{|border="0" cellspacing="2" width="50%" 
|-
|et
|HW(1) / Nw&nbsp;&nbsp;=&nbsp;&nbsp;probabilité que w&nbsp;<nowiki><</nowiki>&nbsp;0.1 unités de temps

|-
|
|HW(2) / Nw&nbsp;&nbsp;=&nbsp;&nbsp;0.1&nbsp;&nbsp;<nowiki><</nowiki>&nbsp;w&nbsp;<nowiki><</nowiki>&nbsp;0.2

|-
|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;....
     
|-
|
|HW(200) / Nw&nbsp;&nbsp;=&nbsp;&nbsp;19.1&nbsp;<nowiki><</nowiki>&nbsp;w&nbsp;<nowiki><</nowiki>&nbsp;20

|-
|
|HW(201) / Nw&nbsp;&nbsp;=&nbsp;&nbsp;20.0&nbsp;<nowiki><</nowiki>&nbsp;w
|}

[[Catégorie:Simscript III (livre)]]