Paramétrage des modèles · Timelight

Timelight détecte automatiquement les meilleurs modèles en analysant les données historiques de chaque source. Les modèles utilisés sont configurables pour vous permettre la meilleure analyse possible.

Un modèle Timelight est une représentation des données limites d'une journée type. Il est composé d'une borne haute, d'une borne basse et d'une courbe représentative. Chaque modèle est nommé et est associé à un code couleur pour permettre aux utilisateurs de le repérer rapidement dans les différents écrans et calendriers.

Le paramétrage des modèles de la plateforme s'effectue uniquement par API. Vous pouvez à tout moment écraser et remplacer les modèles Timelight ou demander à la plateforme de re-calculer les modèles automatiques.

Import de modèles personnalisés

Afin de réduire la taille des JSON échangés entre nos systèmes, nous avons opté pour une forme compacte de représentation de l'activité. Les données sont représentées sous forme d'un tableau de points de données:

4 éléments, représentant chacun une tranche de 6 heures (4 * 6h = 24h)
8 éléments, représentant chacun une tranche de 3 heures (8 * 3h = 24h)
12 éléments, représentant chacun une tranche de 2 heures (12 * 2h = 24h)
24 éléments, représentant chacun une tranche de 1 heure (24 * 3h = 24h)
48 éléments, représentant chacun une tranche de 30 minutes (48 * 30 min = 24h)
72 éléments, représentant chacun une tranche de 20 minutes (72 * 20 min = 24h)
144 éléments, représentant chacun une tranche de 10 minutes (144 * 10 min = 24h)
1440 éléments, représentant chacun une tranche de 1 minute (1440 * 1 min = 24h)

{
  "models": [
    {
      "color": "#FF0000",
      "name": "Mon modèle 1",
      "anomaly": false,
      "topTolerance": [
        44.145,
        44.0146,
        45.2,
        45.0,
        // ... 140 more entries
      ],
      "activity": [
        64.145,
        64.0146,
        65.2,
        65.0,
        // ... 140 more entries
      ],
      "bottomTolerance": [
        64.145,
        64.0146,
        65.2,
        65.0,
        // ... 140 more entries
      ]
    }
    // ... d'autres modèles personnalisés
  ]
}

Pour compatibilité avec d'autres systèmes, nous acceptons également les tableaux d'activité de 1440 éléments (tranches de 1 minute). Notez cependant que notre système d'import fera en sorte de garder les valeurs par tranche de 10 minutes.

curl

curl -X POST -H "Content-Type: application/json" \
     -H "Authorization: Bearer ${JWT}" \
     -d @mes-modeles.json \
    "${API_URL}/v1/model/bulk-replace/${SOURCE_ID}"

Attention

Cette action supprime l'intégralité des modèles en place et les remplace par les données fournies.

Réinitialisation des modèles

Après avoir configuré vos modèles personnalisés, vous pourrez revenir à tout moment au comportement initial en faisant appel au point d'entrée de réinitialisation et en fournissant le nombre de modèles que vous souhaitez voir apparaître.

curl

curl -X POST -H "Content-Type: application/json" \
     -H "Authorization: Bearer ${JWT}" \
    "${API_URL}/v1/model/reset/${SOURCE_ID}/${MODEL_COUNT}"

Attention

Cette action supprime l'intégralité des modèles en place et les remplace par les modèles automatiques Timelight.