====== Keywey ======


===== Fields Types =====
==== ID ====
An identification composed of the [[#object types|object type]] and a unique (for this object type) identifier.
The object type is case insensitive. 
Examples :
  * ''Vo'' 123
  * ''COMB'' 2abdf
  * ''room'' first-floor

==== Name ====
The name under which the object will be shown.

Examples :
  * AHU4
  * Cold Water System


==== Global ID ====
A [[suppliers:hvac.io:vigilia|Vigilia]] object ID.
Usually a string composed of the project ID, device ID, object type and object instance.

Example :
  * 5371147be4b0222b740851a2.10122.0.1

==== Value or ID ====
A numerical value or an ID.
Examples :
  * 12
  * 55.3
  * vo 1
  * room first-floor

==== Range or [Value or ID] ====
A single [[#value or id|Value or ID]], or two separated by a comma (min, max).

Examples :
  * 10, 12
  * vo 1, vo 2
  * 15
  * vo 12




===== Object Types =====

==== Vigilia ====
Object code : ''vo''

fields:
  * [[#ID]]
  * [[#Range or [Value or ID]|Range]] (opt)
  * [[#Global ID]]

The optional range field will limit the possible value taken by the object.
For example, given a range ''10, 15'', a recorded present value of 18 on the BACnet network would still return 15.

==== Combination ====
to be done
==== Room ====
to be done
==== Show ====
to be done




====== Need English Translation. ======

Use https://www.dokuwiki.org/plugin:translation ?

__DESCRIPTION__

KeyWey est le nom donné au logiciel d'analyse de données des systèmes de régulation de température, humidité, pression ... présent dans les bâtiments et processus industriels.
Dans un premier temps, l’ensemble des objets (données) du réseau  des automates ou contrôleurs présents sur le réseau est stocké à intervalles réguliers créant un système de mégadonnées (« Big Data »).
Dans un second temps, KeyWey tire parti de mégadonnées pour les restituer de manière synthétiques et pragmatiques pour l’utilisateur.

__DÉFINITIONS__

Automate : composant physique ou virtuel assurant un processus ou non qui contient des objets de données.
Objet : composant informatique/virtuel contenant des valeurs digitales, analogiques discrètes ou non, enregistré dans la base de données en provenance du réseau d’automate ou étant le résultat de « Test ».
Test : objet virtuel assurant un ou plusieurs tests sur les « Objets » ou « Groupe »
Groupe : Composant virtuel qui regroupe un nombre d’objet et/ou de résultats de « Test ». Le « Groupe » est un objet de synthèse qui peut être utilisé comme « Objet ».

__FONCTIONNALITÉS__

Le logiciel permet entre autres : 
-	De réaliser des tests sur les « Objets » ;
-	De visualiser de manière globale et individuelle les conditions de conforts (ou de performances) de l'ensemble des locaux sur des périodes déterminées en permettant de regrouper les zones ou processus en combinaison libres (exemple : l’ensemble des locaux data sont repris dans un ensemble quelle que soit la localisation des locaux ou, les locaux d’un même locataire peuvent être repris dans un « Groupe ». Les « Groupes » peuvent utiliser des « Objets » ou « Groupes » communs à plusieurs autres « Groupes ») ;
  * De résumer les tests à tous niveaux (groupe, sous-groupe…, local ou processus individuel) ;
  * De mettre en évidence les dysfonctionnements des systèmes de régulation (instabilités, destruction d’énergie, déviations…) à tous niveaux (groupe, sous-groupe…, local ou processus individuel) par l’utilisation de « Tests » spécifiques;
  * De faire des corrélations entre situations observées et consommation d’énergie par l’utilisation de « Tests » spécifiques ;
  * De permettre au gestionnaire de se focaliser sur les résultats et non sur les moyens mis en œuvre pour assurer le confort ou la performance de ces biens ;

  * La création libre de relations pour réaliser les « Tests » et analyses ;
  * L’analyse en temps réel de plusieurs milliers de données sur plusieurs centaines d’échantillons  ;
  * De donner la possibilité :

- De choisir la plage temporelle et le nombre d’échantillon à analyser ;

- D’utiliser des filtres temporels (heures, jours, mois…) ;

- D’utiliser des filtres sur base des résultats des tests, sur les valeurs relevées…

  * De générer des rapports : 
- En définissant la base temporelle (début, fin de l’analyse) ;

- En définissant l’intervalle (par exemple par mois)

- En délimitant le périmètre d’analyse (en choisissant parmi les groupe, sous-groupe, locaux (processus) ;

- En déterminant le niveau de détails.