Messung des Schweregrads
Obwohl die Messung des Schweregrads eine gängige Bezeichnung für die Ausgabe des Produkts ist, darf man nicht vergessen, dass das Produkt Quantifizierbare Daten über die Intensität, Anzahl und das Ausmaß von klinischen Zeichen wie Erythem, Schuppung und Verhärtung, unter anderem ausgibt.
Ärzte und Einrichtungen des Gesundheitswesens können die von dem Produkt ausgegebenen Daten verwenden, um den Grad der Beeinträchtigung eines Patienten zu bestimmen, aber was das Produkt selbst ausgibt, ist nicht der Schweregrad. Dies wird in der Ausgabe des Produkts entsprechend angezeigt und es wird dem FHIR-Standard gefolgt, sobald festgestellt wird, dass es sich bei der Ausgabe um einen DiagnosticReport mit dem Status preliminary handelt.
Veranschaulichende Beispiele
Die JSON-Blöcke auf dieser Seite sind Beispielantworten, die die Struktur der vom Produkt zurückgegebenen Daten zeigen sollen. Die darin enthaltenen Werte, einschließlich der Werte im Objekt metrics, sind Beispiele. Sie sind keine Aussagen über die Leistung des Produkts und dürfen nicht als Leistungsangaben verstanden werden.
Table of contents
Version 2.0
Endpunkt
https://ai.legit.health/v2/legit_health/predict
Anfrage Körper
Wenn Sie ein Bild analysieren müssen, welches das Krankheitsbild atopische Dermatitis zeigt, können Sie eine Folgeanfrage an die API senden.
Beispielsweise kann der Körper für die Anfrage folgendermaßen aussehen:
{
"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"
}
]
}
}
Dies ist die Beschreibung der betreffenden Eigenschaften für die Anfrage Körper:
bodySiteist der Code für die Körperstelle, die mit dem Foto aufgenommen wurde. Die Liste der zugelassenen Codes stellt Legit.Health auf Anfrage über support@legit.health zur Verfügung.knownConditionForThisImageist auf den CodeAtopic dermatitiseingestellt, so dass die API die spezifischen Algorithmen für diese Pathologie ausführt.previousMediaist nicht vorgeschrieben. Es handelt sich um ein Array mit einer Reihe von vorherigen Bildern des untersuchten Krankheitsbildes. Die KI-Algorithmen verwenden diese Daten zur Berechnung des endgültigen Berichts.scoringSystemsist ein Array mit den zu berechnenden Bewertungssystemen. Bei atopischer Dermatitis unterstützen wir:ASCORAD_LOCAL, die automatische Version von SCORAD. Siehe ASCORAD.SCORAD_LOCAL, das auf lokaler Ebene berechnete SCORAD-Bewertungssystem.DLQI.
questionnaireResponse. Siehe nächster Abschnitt
So füllen Sie questionnaireResponse aus
Die Eigenschaft questionnaireResponse muss in den unter der Eigenschaft scoringSystems ausgewählten Bewertungssystemen alle obligatorischen Antworten enthalten.
Wenn Sie zum Beispiel möchten, dass die API den DLQI berechnet, muss questionnaireResponse ["DLQI"] die zehn Werte enthalten, die den zehn Fragen des DLQI entsprechen.
Fragebögen für Bewertungssysteme
Der folgende Auszug enthält die Fragebögen zu den einzelnen Bewertungssystemen, die für Atopic Dermatitis verfügbar sind. Damit das Produkt eines davon berechnen kann, müssen Sie die erforderlichen Antworten vom Patienten oder vom Arzt einholen.
[
{
"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
}
]
}
]
Antwort
Die unten dargestellte Antwort ist ein veranschaulichendes Beispiel: die darin enthaltenen Werte, einschließlich der Werte im Objekt metrics, sind Beispiele und keine Aussagen über die Leistung des Produkts.
{
"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
Was hat sich verändert?
An der Messung des Schweregrades hat sich nichts geändert. Die einzige Änderung besteht darin, dass Sie für die Funktion zur Diagnoseunterstützung jetzt mehrere Bilder derselben Hautläsion übermitteln können.
Endpunkt
https://ai.legit.health/v2/legit_health/severity_assessment
Anfrage Körper
Die Interaktion mit der API ist dieselbe wie in Version 2.0.
Antwort
Die Antwort wurde aktualisiert, allerdings hauptsächlich in Bezug auf die bereitgestellten Daten. So enthält die Version 2.1 keine Angaben zur Diagnoseunterstützung in der Ausgabe. Die unten dargestellte Antwort ist ein veranschaulichendes Beispiel: die darin enthaltenen Werte, einschließlich der Werte im Objekt metrics, sind Beispiele und keine Aussagen über die Leistung des Produkts.
{
"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
}