r-io suiter-io suitesupervision docs
← Supervision
Supervision / Strategy 02 · checked by default

KPIL indicators recalculation

The deduction chose the solution for its indicators: duration, cost, distance, strain, wait… as declared by the KPIL script of the project. This strategy replays the same indicators with what the field tells now and compares them with the values the deduction found. When an indicator gets worse than deduced by more than its threshold, the solution is Wrong: another solution, or another schedule, would now do better.

implemented byKpilIndicatorsRecalculationStrategy · gind-npm-strategy-supervision-kpil-indicators
01 · Indicators

Those of the KPIL script, concept Function

The default configuration of a project lists every indicator of the tasks (Function:*) the KPIL script declares, with its unit, its aggregation and its objective (minimize or maximize). On IMT Albi Crisis: cost, distance, duration, strain and wait.

A new indicator added to the script after the configuration was saved is shown below the table as “declared by the KPIL script but not configured here”, with a button to add it.

02 · Replay

What each task weighs now

Task in the To-Do ListValue used
Done (or in error)Its measured value, or its expected value when it was not measured.
Going on (accepted)Duration: max(expected, time spent since the acceptance). Cost and strain grow with the time: expected × time spent / expected duration once the task takes longer than planned.
Rejected or cancelled0.
Not reached or not acceptedIts expected value.

The tasks are then combined as the script says: CUMULATIVE (sum), MULTIPLICATIVE (product), MAXBYPATH or MINBYPATH (longest or shortest sum along the nominal flows of the process, from its first nodes to its last ones; exception and event flows are left out). The same aggregation applied to the expected values gives the deduced value.

03 · Score

The worst drift wins

drift = (now − deduced) / |deduced| (deduced − now for an indicator to maximize)
Wrong = max over the checked indicators of drift × 100 / threshold (only when it gets worse)

With the default threshold of 20 %, a duration of the solution 20 % longer than deduced gives Wrong = 1; 10 % gives half the threshold. The contribution reads, for instance, “Expected duration +25 % (1500 s now against 1200 s deduced)”.

04 · Configuration

One row per indicator

05 · Watch points

Good to know

Better than deduced is not an alert

A solution which turns out cheaper or faster than deduced is fine: only a drift for the worse counts.

Moves are measured here

The Weighted Graph Distance does not weigh positions: the distance and the duration of the moves are judged by this strategy.

Close to the earned value

This strategy compares the whole solution, done and remaining; the earned value compares the work done by now with the work planned by now.

gind-detection-engine-kpil-indicators-strategy/…/KpilIndicatorsRecalculationStrategy.javaIndicators of the script, projected value of a task, aggregations, drift.
gind-npm-strategy-supervision-kpil-indicators/src/kpil-indicators-configuration.component.*The table of the indicators and their thresholds.
Supervision / Stratégie 02 · cochée par défaut

KPIL indicators recalculation

La déduction a choisi la solution pour ses indicateurs : durée, coût, distance, fatigue, attente… tels que les déclare le script KPIL du projet. Cette stratégie recalcule les mêmes indicateurs avec ce que dit le terrain et les compare aux valeurs trouvées par la déduction. Quand un indicateur se dégrade au-delà de son seuil, la solution est Wrong : une autre solution, ou un autre ordonnancement, ferait mieux maintenant.

implémentée parKpilIndicatorsRecalculationStrategy · gind-npm-strategy-supervision-kpil-indicators
01 · Indicateurs

Ceux du script KPIL, concept Function

La configuration par défaut d’un projet liste tous les indicateurs des tâches (Function:*) que déclare le script KPIL, avec leur unité, leur agrégation et leur objectif (minimiser ou maximiser). Sur IMT Albi Crisis : coût, distance, durée, fatigue et attente.

Un indicateur ajouté au script après l’enregistrement de la configuration apparaît sous le tableau, « déclaré par le script KPIL mais pas configuré ici », avec un bouton pour l’ajouter.

02 · Recalcul

Ce que pèse chaque tâche maintenant

Tâche dans la To-Do ListValeur utilisée
Faite (ou en erreur)Sa valeur mesurée, ou sa valeur attendue si elle n’a pas été mesurée.
En cours (acceptée)Durée : max(attendue, temps passé depuis l’acceptation). Le coût et la fatigue croissent avec le temps : attendu × temps passé / durée attendue dès que la tâche dure plus que prévu.
Rejetée ou annulée0.
Pas atteinte ou pas acceptéeSa valeur attendue.

Les tâches sont ensuite combinées comme le dit le script : CUMULATIVE (somme), MULTIPLICATIVE (produit), MAXBYPATH ou MINBYPATH (plus longue ou plus courte somme le long des flux nominaux du processus, de ses premiers nœuds à ses derniers ; les flux d’exception et d’événement sont écartés). La même agrégation appliquée aux valeurs attendues donne la valeur déduite.

03 · Score

La pire dérive l’emporte

dérive = (maintenant − déduit) / |déduit| (déduit − maintenant pour un indicateur à maximiser)
Wrong = max sur les indicateurs cochés de dérive × 100 / seuil (seulement quand il se dégrade)

Avec le seuil par défaut de 20 %, une durée de la solution 20 % plus longue que déduite donne Wrong = 1 ; 10 % donne la moitié du seuil. La contribution se lit par exemple « Expected duration +25 % (1500 s now against 1200 s deduced) ».

04 · Configuration

Une ligne par indicateur

05 · Points d’attention

Bon à savoir

Mieux que déduit n’est pas une alerte

Une solution qui se révèle moins chère ou plus rapide que déduit ne pose pas de problème : seule une dérive défavorable compte.

Les déplacements sont mesurés ici

Weighted Graph Distance ne pondère pas les positions : la distance et la durée des déplacements sont jugées par cette stratégie.

Proche de la valeur acquise

Cette stratégie compare la solution entière, faite et restante ; la valeur acquise compare le travail fait à date au travail prévu à date.

gind-detection-engine-kpil-indicators-strategy/…/KpilIndicatorsRecalculationStrategy.javaIndicateurs du script, valeur projetée d’une tâche, agrégations, dérive.
gind-npm-strategy-supervision-kpil-indicators/src/kpil-indicators-configuration.component.*Le tableau des indicateurs et de leurs seuils.