Ce qui est mesuré

Les dix variables qu’une mesure peut rendre, ce que chacune est, et ce dont elle a besoin pour être calculée.

Une mesure produit un signal de pouls, et tout le reste s’en déduit. Certaines variables viennent de ce seul signal. D’autres demandent une image fixe du visage. D’autres encore ont besoin de connaître l’âge, le sexe ou les mensurations de la personne.

Cette page dit laquelle est laquelle. C’est toute la différence entre une variable qui manque et une variable qui n’allait jamais arriver.

VariableCléUnitéForme de la valeur
Fréquence cardiaquehrbpmnumber
Fréquence respiratoirebrcpmnumber
Variabilité cardiaquehrvmsnumber
Niveau de stressstrs{ level, scale }
Pression artériellebpmmHg{ systole, diastole }
Risque tensionnelbpClass{ level, scale }
Âge apparentphysicalAgeyearsnumber
Indice de masse corporellebmikg/m²number
IMC estimé du visagefaceBmikg/m²number
Score de santé cardiovasculairehealthScorenumber

Ce que chacune est

La fréquence cardiaque, la fréquence respiratoire et la variabilité cardiaque viennent directement de l’onde de pouls. hr compte les battements par minute sur la capture. br compte les respirations par minute, ce qui explique que le haut du buste doive être visible. hrv mesure de combien l’écart entre deux battements varie, en millisecondes.

Le stress est un niveau sur une échelle, non un décompte. La valeur est { level, scale } : un level de 2 sur une scale de 4 désigne la deuxième bande sur quatre. Lisez toujours l’échelle plutôt que de la supposer.

La pression artérielle vient sous deux formes. bp est un couple estimé de valeurs systolique et diastolique, en mmHg. bpClass porte la même information sous forme de bande, dans la même forme { level, scale } que le stress. Un produit qui affiche une plage plutôt que deux nombres veut en général bpClass.

L’âge apparent (physicalAge) est estimé à partir du visage, en années.

L’indice de masse corporelle existe deux fois, et la différence compte. bmi est l’arithmétique, calculé depuis la taille et le poids que vous fournissez. faceBmi est estimé depuis l’image du visage. Les deux répondent à la même question par deux chemins, si bien qu’une intégration qui dispose déjà des mensurations n’a aucune raison de demander la seconde.

Le score de santé cardiovasculaire (healthScore) est un chiffre unique qui combine plusieurs des autres.

Ce dont chacune a besoin

VariableSaphere ScanAPI vidéoAPI imageDemande userData
hr — fréquence cardiaqueOuiOui
br — fréquence respiratoireOuiOui
hrv — variabilité cardiaqueOuiOui
strs — stressOuiOui
bp, bpClass — pression artérielleOuiOuiweight, height, sex, age
physicalAge — âge apparentOuiOui
faceBmi — indice de masse corporelle par le visageOuiOui
bmi — indice de masse corporelle, calculéOuiOuiweight, height
healthScore — score cardiovasculaireOuiOuiweight, height, sex, age, smokingStatus

Les trois colonnes du milieu sont trois voies vers les mêmes variables : le widget, une vidéo enregistrée envoyée à l’api, et une image fixe envoyée à l’api. faceBmi est celle qui vient d’une image plutôt que d’une vidéo, parce qu’elle est estimée depuis le visage et non depuis le pouls.

Les limites de chaque champ de userData sont énumérées sur la page des mesures. Le widget collecte les mêmes champs sur son propre formulaire.

Un champ absent coûte une variable, pas la mesure

Une variable qui n’a pas pu être calculée revient avec un code d’erreur qui nomme ce qui manquait. Tout le reste se termine normalement. Vous ne perdez pas la fréquence cardiaque parce que vous ignoriez la taille de la personne.

Votre compte décide de ce qui arrive vraiment

Les variables qu’un compte peut recevoir sont configurées sur le compte. Elles ne se demandent pas mesure par mesure. Chaque résultat énumère ce à quoi il avait droit dans returnedVariables.

Un résultat vide veut en général dire aucun droit, non un échec

Une mesure qui revient avec un signal mais aucune variable est la marque d’un compte qui n’en a reçu aucune. C’est l’état normal d’un compte de test fraîchement créé. Regardez le compte avant de regarder la capture.

Deux noms de variables sont acceptés par l’api mais ne peuvent être accordés à aucun compte : physiologicalAge et hrvs. Ils n’existent que pour que les intégrations qui les envoient déjà continuent de fonctionner. Ne construisez rien sur eux.