> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).

# Exemples de calcul

Exemples pratiques pour écrire des calculs d'attributs dans le langage d'expression IoT Logic. Inclut des conseils sur le nommage des attributs et la gestion sûre des valeurs nulles.

Le nœud Initialiser un Attribut dans IoT Logic prend en charge un large éventail de calculs grâce à [langage d'expressions Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Ce guide fournit des exemples pratiques de calculs courants pour vous aider à extraire un maximum de valeur de vos données IoT.

## Considérations importantes

Lorsque vous créez des calculs, gardez ces points à l’esprit�a0:

* **Validité des noms d’attributs**�a0: Assurez-vous d’utiliser les noms d’attributs corrects dans les calculs. Vous pouvez rechercher les noms d’attributs existants à l’aide de [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md), ou les insérer à l’aide de [Gestion des attributs](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#short-syntax) en utilisant [l’autocomplétion](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* **Validité des données**: Une formule qui lit une valeur que le paquet ne contient pas ne produit rien, et l’attribut n’a alors aucune valeur pour ce paquet. Protégez le calcul avec `!= null`, ou substituez une valeur de repli avec `??`. Voir [Valeurs manquantes dans les expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
* **Impact sur les performances**: Les calculs complexes comportant de nombreuses fonctions imbriquées peuvent affecter la vitesse de traitement des données à haute fréquence
* **Contraintes mathématiques**: Les fonctions comme le logarithme et la racine carrée nécessitent des valeurs d’entrée positives
* **Références historiques**: Lorsque vous utilisez des valeurs indexées (par ex., `value('param', 1, 'valid')`), assurez-vous de disposer de suffisamment de données historiques et utilisez [la syntaxe complète des expressions](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax)

{% hint style="info" %}
Les fonctions mathématiques peuvent être appliquées à tout paramètre numérique ou attribut précédemment calculé. Validez toujours vos calculs avec des données de test avant de les déployer dans des flux de production.
{% endhint %}

{% hint style="info" %}
Pour renseigner un attribut avec le nom de la Zone géographique dans laquelle se trouve un appareil, plutôt qu'avec un calcul, utilisez `geofenceName()`. Il s'agit d'une option payante, désactivée par défaut. Voir [Fonctions de zone géographique](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/geofence-functions.md).
{% endhint %}

## Calculs de base

### Conversions d'unités

La conversion de mesures entre différentes unités est l'une des opérations les plus courantes dans le traitement des données IoT.

#### **Conversion de vitesse (km/h en mph)**

```jexl
can_speed/1.609
```

**Application pratique :** Cette conversion standardise les données de vitesse des véhicules pour les régions utilisant le système impérial. En effectuant ce calcul dans IoT Logic plutôt que dans les applications en aval, vous garantissez une cohérence sur l’ensemble des systèmes qui consomment les données.

**Conversion de la température (Celsius vers Fahrenheit)**

```jexl
temperature * 1.8 + 32
```

**Application pratique :** Cette conversion rend les relevés de température compréhensibles pour les utilisateurs plus familiers des mesures en Fahrenheit. Elle est particulièrement utile pour les organisations multinationales qui opèrent dans des régions utilisant des systèmes de mesure différents.

### Calcul des différences

Comparer les relevés actuels avec les valeurs précédentes aide à identifier les changements et les tendances dans vos données.

#### **Détection des variations de température**

```jexl
temperature - value('temperature', 1, 'valid')
```

**Application pratique :** Ce calcul aide à détecter de სწრაფes fluctuations de température susceptibles d’indiquer des problèmes d’équipement ou des changements environnementaux. En créant un attribut dédié à cette différence, vous pouvez configurer des Règles d’alertes pour des changements soudains sans traitement complexe en aval.

{% hint style="info" %}
**Exemple :** Pour une Flotte de camions frigorifiques, ce calcul peut identifier immédiatement lorsque la température de la cargaison commence à augmenter trop rapidement, permettant aux répartiteurs de contacter les conducteurs avant que les marchandises périssables ne soient compromises. L’attribut peut déclencher des Règles d’alertes lorsque la variation de température dépasse 3 degrés en peu de temps, ce qui peut indiquer une panne du système de refroidissement ou une porte laissée ouverte.
{% endhint %}

## Calculs basés sur le temps

Les calculs temporels vous aident à comprendre le comportement de l’appareil au fil du temps et à mesurer les schémas opérationnels.

### **Calcul du temps écoulé entre les dernières mesures valides**

```jexl
srvTime('avl_25', 0, 'valid') - srvTime('avl_25', 1, 'valid')
```

**Application pratique :** Ce calcul mesure l’intervalle entre les transmissions de données consécutives, ce qui peut aider à identifier des problèmes de communication ou à valider que les appareils transmettent aux fréquences attendues. Cet exemple présente le calcul entre les deux dernières mesures valides, mais il peut être adapté pour traiter n’importe quelles deux valeurs historiques.

{% hint style="info" %}
**Exemple :** Pour une flotte de taxis, ce calcul peut aider à identifier des problèmes de connectivité avec les trackers GPS. Si l’intervalle entre les relevés augmente soudainement, passant de la norme de 30 secondes à plusieurs minutes, cela peut indiquer des zones de couverture cellulaire insuffisante ou des dysfonctionnements de l’appareil, permettant aux équipes d’entretien de traiter les problèmes avant qu’ils n’affectent la qualité du service.
{% endhint %}

### **Conversion de l'horodatage au format lisible par l'humain**

```jexl
dtFormat(genTime('can_fuel_1', 0, 'all'))
```

**Application pratique :** La conversion des horodatages Unix au format ISO 8601 rend les données plus lisibles dans les journaux et les Rapports. Ce format est largement pris en charge par les outils d'analyse et les bases de données, ce qui simplifie l'intégration avec d'autres systèmes.

## Fonctions mathématiques avancées

IoT Logic prend en charge des opérations mathématiques sophistiquées grâce à ses fonctions mathématiques intégrées.

### Arrondi des valeurs

**Arrondir la température à l’entier le plus proche**

```jexl
math:round(value('temperature_2', 0, 'valid'))
```

**Application pratique :** L'arrondi est utile lorsqu'une précision exacte n'est pas nécessaire ou lorsque vous souhaitez réduire le bruit dans les relevés de capteurs. Par exemple, l'arrondi des Données du capteur environnementales peut suffire pour la surveillance climatique générale tout en réduisant les besoins de stockage. Cette fonction est également utile lors de la création de catégories ou de bandes de valeurs (par exemple, regrouper des relevés de température par incréments de 5 degrés).

{% hint style="info" %}
**Exemple :** Dans la Gestion de Flotte, les relevés de température du moteur comportent souvent des décimales qui n'ont aucune signification pour les Règles d’alertes du Conducteur ou l’ordonnancement de l’Entretien. Arrondir ces valeurs simplifie l'affichage des tableaux de bord et facilite la définition des seuils de température. Par exemple, des Règles d’alertes d’Entretien peuvent être déclenchées lorsque la température arrondie du moteur dépasse 90 °C plutôt que lorsque l’on traite des valeurs précises comme 89,7 °C.
{% endhint %}

### Calculs logarithmiques

**Logarithme naturel d’une valeur**

```jexl
math:log(value('temperature_2', 0, 'valid'))
```

**Application pratique :** Les transformations logarithmiques sont particulièrement utiles pour :

* Compresser des données qui couvrent plusieurs ordres de grandeur en une plage plus facile à gérer
* Convertir des relations exponentielles en relations linéaires pour faciliter l'analyse
* Travailler avec certains types de capteurs dont les caractéristiques de réponse sont logarithmiques
* Calculs de niveau sonore, où les décibels sont des unités logarithmiques
* Mesures de pH dans la surveillance environnementale

{% hint style="info" %}
**Exemple :** Lors de l'analyse du comportement du Conducteur à l'aide d'un Accéléromètre, la fonction logarithmique peut aider à normaliser des données d'accélération allant de légers mouvements à des freinages brusques. Cela facilite la création d'un score de Sécurité du Conducteur pertinent, qui ne soit pas trop faussé par des événements extrêmes occasionnels. Un autre exemple pratique consiste à travailler avec des capteurs de Carburant qui ne fournissent pas de relevés linéaires. Certains capteurs de niveau de Carburant présentent des valeurs de résistance non linéaires correspondant au niveau réel de Carburant. L'utilisation de calculs logarithmiques peut aider à convertir ces relevés en pourcentages de niveau de Carburant plus précis.
{% endhint %}

### Opérations de racine carrée

**Calculer la racine carrée d’un relevé**

```jexl
math:sqrt(value('temperature_2', 0, 'valid'))
```

**Application pratique :** Les fonctions de racine carrée sont utiles pour :

* Convertir entre puissance et amplitude dans les mesures électriques
* Calculer les écarts types dans l'analyse statistique des Données du capteur
* Déterminer des valeurs quadratiques moyennes (RMS) pour des paramètres électriques
* Calculs de distance dans un espace multidimensionnel (par exemple, la trilatération pour le positionnement)
* Normaliser certains types de Données du capteur

{% hint style="info" %}
**Exemple :** Lors du calcul de la distance réelle entre deux points GPS (latitude et longitude), vous devez utiliser la fonction racine carrée dans le cadre de la formule de distance. Par exemple, si vous calculez la distance parcourue par un véhicule entre deux relevés GPS à l'aide de la formule de distance euclidienne, la fonction racine carrée est essentielle. Une autre application courante consiste à calculer l'amplitude des vibrations ou des chocs à partir de plusieurs axes d’Accéléromètre (X, Y, Z). La racine carrée de la somme des valeurs au carré de chaque axe vous donne l'amplitude globale des vibrations, ce qui est utile pour détecter les impacts sur le véhicule ou les mauvaises conditions routières.
{% endhint %}

## Opérations combinées

Vous pouvez créer des calculs encore plus complexes en combinant plusieurs fonctions et opérations.

### **Moyenne géométrique avec arrondi**

{% code overflow="wrap" %}

```jexl
math:round(math:sqrt(value('temperature_1', 0, 'valid') * value('temperature_2', 0, 'valid')))
```

{% endcode %}

**Application pratique :** Ce calcul calcule la moyenne géométrique des relevés de deux capteurs de température et arrondit le résultat afin de fournir une valeur plus propre. La moyenne géométrique est souvent plus appropriée qu'une moyenne arithmétique lorsqu'il s'agit de taux, de rapports ou de mesures pour lesquelles la multiplication est la manière naturelle de combiner les valeurs.

{% hint style="info" %}
**Exemple :** Dans un scénario de transport réfrigéré, vous pouvez avoir plusieurs capteurs de température placés dans toute la zone de chargement. Ce calcul fournit un relevé de température équilibré qui tient compte des deux valeurs tout en minimisant l'influence des valeurs aberrantes extrêmes. Plutôt que de déclencher des Règles d’alertes en se basant sur un seul capteur (qui peut être affecté par les ouvertures des portes), ce calcul combiné fournit une condition de température globale plus représentative pour la cargaison sensible.
{% endhint %}

### **Calcul de valeur standardisée**

{% code overflow="wrap" %}

```jexl
(value('sensor_reading', 0, 'valid') - value('sensor_min', 0, 'valid')) / (value('sensor_max', 0, 'valid') - value('sensor_min', 0, 'valid')) * 100
```

{% endcode %}

**Application pratique :** Cela normalise un relevé de capteur sur une échelle de pourcentage de 0 à 100 %, ce qui permet des comparaisons standardisées entre différents capteurs aux plages variées. C'est particulièrement utile pour créer des tableaux de bord uniformes ou déclencher des Règles d’alertes basées sur des valeurs relatives plutôt que sur des mesures absolues.

{% hint style="info" %}
**Exemple :** Un gestionnaire de flotte supervise des Véhicules de plusieurs constructeurs, chacun avec des relevés différents de capteurs de Carburant (ohms, volts, valeurs numériques brutes). En normalisant ces relevés variés sur une échelle de pourcentage cohérente, le gestionnaire peut appliquer les mêmes Règles d’alertes de faible Carburant sur l'ensemble de la Flotte et générer des Rapports de Consommation de carburant standardisés sans avoir à tenir compte des caractéristiques spécifiques du capteur de chaque modèle de Véhicule.
{% endhint %}

## Opérations sur les chaînes

Les opérations sur les chaînes vous permettent de combiner plusieurs valeurs d'attributs en une seule sortie de chaîne.

### Concaténation des valeurs d'attributs

La combinaison de valeurs provenant de plusieurs attributs est utile lorsque vous devez consolider des données provenant de plusieurs sources dans un seul champ pour l'affichage ou la transmission.

```jexl
util:joinNonNull(', ', ble_name_1, ble_name_2, ble_name_3, ble_name_4, ble_name_5, ble_name_6, ble_name_7, ble_name_8)
```

**Application pratique :** Les appareils dotés de capacités de balayage BLE peuvent détecter simultanément plusieurs capteurs périphériques, mais tous les emplacements de capteurs ne sont pas toujours occupés. Ce calcul produit une liste propre, séparée par des virgules, des capteurs actifs, en ignorant automatiquement les emplacements non appairés. Le résultat est prêt à être affiché ou transmis à des systèmes externes sans nettoyage supplémentaire.

{% hint style="info" %}
**Exemple**: Un camion frigorifique prend en charge jusqu'à huit capteurs de température BLE placés dans toute la zone de chargement, mais seulement trois sont actuellement installés. Au lieu de produire « Sensor A, Sensor B, Sensor C, , , , , » avec des entrées vides pour les emplacements inutilisés, `util:joinNonNull` produit « Sensor A, Sensor B, Sensor C », une liste propre qui se met automatiquement à jour au fur et à mesure que des capteurs sont ajoutés ou retirés. Si vous avez besoin de conserver des emplacements vides dans la sortie, utilisez `util:join` à la place, qui traite les valeurs nulles comme des chaînes vides au lieu de les ignorer.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
