Mesure de gravité
Bien que la mesure de gravité soit une façon quotidienne de parler de la performance du dispositif, gardez à l'esprit que ce que le dispositif produit est un des données quantifiables sur l'intensité, le nombre et l'étendue des signes cliniques tels que l'érythème, la desquamation et l'induration, entre autres.
En effet, les professionnels de la santé et les organisations peuvent utiliser les données générées par le dispositif pour déterminer le degré d'affectation d'un patient, mais ce que le dispositif lui-même génère n'est pas la gravité. Ceci est signalé de manière appropriée dans les résultats que génère le dispositif, ce qui est conforme à la norme FHIR lorsqu'on remarque que les résultats générés constituent un DiagnosticReport
, avec un statut préliminaire
.
Table of contents
Version 2.0
Terminal
https://ai.legit.health/v2/legit_health/predict
Demande du corps
Si vous devez analyser une image dont l'affection connue est la dermatite atopique, vous pouvez envoyer une demande de suivi à l'API.
Un exemple du corps de la demande peut être le suivant :
{
"requestId": "90925097-820b-403d-a75d-4cd989903df1",
"data": {
"type": "image",
"modality": "clinical",
"operator": "Practitioner",
"bodySite": "ARM_LEFT",
"knownConditionForThisImage": {
"conclusion": "Atopic dermatitis"
},
"subject": {
"identifier": "6ec724a0-6fa3-11eb-a15f-0242ac160004",
"gender": "m",
"height": 175,
"weight": 71,
"birthdate": "1986-10-21",
"generalPractitioner": {
"identifier": "44f89a8c-6f8a-11eb-9c8a-0242ac160004"
},
"managingOrganization": {
"identifier": "b13cd636-327b-11ec-86b0-0242ac180004",
"display": "Hospital Central"
}
},
"scoringSystems": ["ASCORAD_LOCAL", "SCORAD_LOCAL", "DLQI"],
"questionnaireResponse": {
"DLQI": {
"question1": 2,
"question2": 3,
"question3": 1,
"question4": 2,
"question5": 1,
"question6": 2,
"question7": 2,
"question8": 2,
"question9": 3,
"question10": 2
},
"ASCORAD_LOCAL": {
"surfaceValue": 27,
"itchinessScorad": 2,
"sleeplessness": 2
},
"SCORAD_LOCAL": {
"surfaceValue": 27,
"itchinessScorad": 2,
"sleeplessness": 2,
"erythema": 2,
"swelling": 2,
"crusting": 1,
"excoriation": 1,
"lichenification": 1,
"dryness": 1
}
},
"content": "base64 image",
"previousMedia": [
{
"content": "base64 image",
"date": "2022-02-22T12:16:59+01:00"
}
]
}
}
Voici la description des propriétés pertinentes de la demande du corps :
bodySite
est le code de la zone du corps qui identifie la zone où l'image a été prise. Vous pouvez trouver la liste disponible avec tous les codes admis ici.knownConditionForThisImage
est défini sur le code de ladermatite atopique
, de sorte que l'API exécutera les algorithmes spécifiques liés à cette pathologie.previousMedia
n'est pas obligatoire. Il s'agit d'un tableau présentant un ensemble des images antérieures de l'affection analysée. Les algorithmes dotés de l'IA utilisent ces informations pour calculer le rapport final.scoringSystems
est un tableau présentant les systèmes de notation à calculer. Pour la dermatite atopique, nous prenons en charge :ASCORAD_LOCAL
, la version automatique du SCORAD. Vous pouvez obtenir plus d'informations ici.SCORAD_LOCAL
, le système de notation SCORAD calculé au niveau local.DLQI
.
Réponses au questionnaire
. Voir section suivante 😁
Comment remplir les réponses au questionnaire
La propriété questionnaireResponse
doit contenir toutes les réponses obligatoires à chaque système de notation spécifié dans la propriété scoringSystems
.
Par exemple, si vous souhaitez que l'API calcule le DLQI
, les réponses au questionnaire [« DLQI »]
doivent contenir les dix valeurs correspondant aux dix questions du DLQI
.
Questionnaires pour les systèmes de notation
Dans l'extrait suivant, vous trouverez les questionnaires relatifs à chaque système de notation lié à la dermatite atopique
. Si vous voulez que l'IA calcule l'un d'entre eux, vous devez obtenir cette information du patient ou du médecin.
[
{
"code": "ASCORAD_LOCAL",
"questions": [
{
"code": "surfaceValue",
"label": "Affected area",
"description": "",
"openField": true
},
{
"code": "itchinessScorad",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
},
{
"code": "sleeplessness",
"label": "Sleeplessness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
}
]
},
{
"code": "DLQI",
"questions": [
{
"code": "question1",
"label": "Over the last week, how itchy, sore, painful or stinging has your skin been?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question2",
"label": "Over the last week, how embarrassed or self conscious have you been because of your skin?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question3",
"label": "Over the last week, how much has your skin interfered with you going shopping or looking after your home or garden? ",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question4",
"label": "Over the last week, how much has your skin influenced the clothes you wear?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question5",
"label": "Over the last week, how much has your skin affected any social or leisure activities?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question6",
"label": "Over the last week, how much has your skin made it difficult for you to do any sport?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question7",
"label": "Over the last week, how much has your skin prevented you from working or studying?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question8",
"label": "Over the last week, how much has your skin created problems with your partner or any of your close friends or relatives?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question9",
"label": "Over the last week, how much has your skin caused any sexual difficulties?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question10",
"label": "Over the last week, how much of a problem has the treatment for your skin been, for example by making your home messy, or by taking up time?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
}
]
},
{
"code": "SCORAD_LOCAL",
"questions": [
{
"code": "surfaceValue",
"label": "Affected area",
"description": "",
"openField": true
},
{
"code": "erythema",
"label": "Redness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "swelling",
"label": "Swelling",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "crusting",
"label": "Crusting",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "excoriation",
"label": "Excoriation",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "lichenification",
"label": "Lichenification",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "dryness",
"label": "Dryness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "itchinessScorad",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
},
{
"code": "sleeplessness",
"label": "Sleeplessness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
}
]
}
]
Réponse
{
"category": [
{
"coding": [
{
"code": "250171008",
"display": "Clinical history and observation finding",
"system": "http://snomed.info/sct"
}
]
}
],
"code": {
"coding": [
{
"code": "10206-1",
"display": "Physical findings of Skin Narrative",
"system": "http://loinc.org"
}
]
},
"detectedModality": "Clinical",
"device": {
"deviceName": {
"name": "Legit.Health",
"type": "user-friendly-name"
},
"manufacturer": "AI LABS GROUP SL",
"resourceType": "Device",
"type": {
"code": "string",
"display": "Dermatology picture archiving and communication system application software",
"system": "http://snomed.info/sct"
}
},
"evolution": {
"domains": {
"ASCORAD_LOCAL": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": null
},
"facets": {
"crusting": {
"intensity": 0,
"value": 0
},
"dryness": {
"intensity": 0,
"value": 0
},
"erythema": {
"intensity": 0,
"value": 0
},
"excoriation": {
"intensity": 0,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": 2,
"value": 27
},
"swelling": {
"intensity": 0,
"value": 0
},
"itchinessScorad": {
"intensity": 0,
"value": 0
},
"sleeplessness": {
"intensity": 0,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
},
"DLQI": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1": {
"intensity": null,
"value": 2
},
"question2": {
"intensity": null,
"value": 2
},
"question3": {
"intensity": null,
"value": 2
},
"question4": {
"intensity": null,
"value": 2
},
"question5": {
"intensity": null,
"value": 2
},
"question6": {
"intensity": null,
"value": 2
},
"question7": {
"intensity": null,
"value": 2
},
"question8": {
"intensity": null,
"value": 2
},
"question9": {
"intensity": null,
"value": 2
},
"question10": {
"intensity": null,
"value": 2
}
},
"grade": {
"category": "Very large effect on patient's life",
"score": 20
}
},
"SCORAD_LOCAL": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"crusting": {
"intensity": null,
"value": 0
},
"dryness": {
"intensity": null,
"value": 0
},
"erythema": {
"intensity": null,
"value": 0
},
"excoriation": {
"intensity": null,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": null,
"value": 27
},
"swelling": {
"intensity": null,
"value": 0
},
"itchinessScorad": {
"intensity": null,
"value": 0
},
"sleeplessness": {
"intensity": null,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
}
}
},
"explainabilityMedia": {
"content": "base 64 image",
"modality": "Clinical",
"resourceType": "Media",
"type": "image"
},
"mediaValidity": {
"isValid": true,
"metrics": {
"hasEnoughQuality": true,
"isDermatologyDomain": true
},
"score": 66.0
},
"metrics": {
"category": "calculation",
"resourceType": "DeviceMetric",
"sensitivity": 99.56,
"specificity": 93.99
},
"preliminaryFindings": {
"hasConditionSuspicion": 99.2,
"isMalignantSuspicion": 0,
"isPreMalignantSuspicion": 0.6000000000000001,
"needsBiopsySuspicion": 0,
"needsSpecialistsAttention": 3.86
},
"resourceType": "DiagnosticReport",
"status": "preliminary",
"time": 2.5790834426879883,
"conclusions": [
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Atopic dermatits",
"probability": 98.66
},
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Nonspecific lesion",
"probability": 1.34
}
]
}
Version 2.1
Rien n'a changé en ce qui concerne la mesure de gravité. Le seul changement est que, pour la fonction d'aide au diagnostic, vous pouvez désormais envoyer plusieurs images de la même lésion.
Terminal
https://ai.legit.health/v2/legit_health/severity_assessment
Demande du corps
L'interaction avec l'API est la même que celle de la version 2.0.
Réponse
La réponse a été mise à jour, mais principalement en matière d'informations fournies. Plus précisément, la version 2.1 n'inclut pas les détails de l'aide au diagnostic dans les résultats générés.
{
"category": [
{
"coding": [
{
"code": "250171008",
"display": "Clinical history and observation finding",
"system": "http://snomed.info/sct"
}
]
}
],
"code": {
"coding": [
{
"code": "10206-1",
"display": "Physical findings of Skin Narrative",
"system": "http://loinc.org"
}
]
},
"detectedModality": "Clinical",
"device": {
"deviceName": {
"name": "Legit.Health",
"type": "user-friendly-name"
},
"manufacturer": "AI LABS GROUP SL",
"resourceType": "Device",
"type": {
"code": "string",
"display": "Dermatology picture archiving and communication system application software",
"system": "http://snomed.info/sct"
}
},
"evolution": {
"domains": {
"ASCORAD_LOCAL": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": null
},
"facets": {
"crusting": {
"intensity": 0,
"value": 0
},
"dryness": {
"intensity": 0,
"value": 0
},
"erythema": {
"intensity": 0,
"value": 0
},
"excoriation": {
"intensity": 0,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": 2,
"value": 27
},
"swelling": {
"intensity": 0,
"value": 0
},
"itchinessScorad": {
"intensity": 0,
"value": 0
},
"sleeplessness": {
"intensity": 0,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
},
"DLQI": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1": {
"intensity": null,
"value": 2
},
"question2": {
"intensity": null,
"value": 2
},
"question3": {
"intensity": null,
"value": 2
},
"question4": {
"intensity": null,
"value": 2
},
"question5": {
"intensity": null,
"value": 2
},
"question6": {
"intensity": null,
"value": 2
},
"question7": {
"intensity": null,
"value": 2
},
"question8": {
"intensity": null,
"value": 2
},
"question9": {
"intensity": null,
"value": 2
},
"question10": {
"intensity": null,
"value": 2
}
},
"grade": {
"category": "Very large effect on patient's life",
"score": 20
}
},
"SCORAD_LOCAL": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"crusting": {
"intensity": null,
"value": 0
},
"dryness": {
"intensity": null,
"value": 0
},
"erythema": {
"intensity": null,
"value": 0
},
"excoriation": {
"intensity": null,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": null,
"value": 27
},
"swelling": {
"intensity": null,
"value": 0
},
"itchinessScorad": {
"intensity": null,
"value": 0
},
"sleeplessness": {
"intensity": null,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
}
}
},
"mediaValidity": {
"isValid": true,
"metrics": {
"hasEnoughQuality": true,
"isDermatologyDomain": true
},
"score": 66.0
},
"resourceType": "DiagnosticReport",
"status": "preliminary",
"time": 2.5790834426879883
}