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.
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.
Der Auszug enthält den DLQI nicht, dessen Urheberrechte bei der Universität Cardiff liegen. Wie Sie ihn verwenden, beschreibt die DLQI-Seite.
[
{
"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": "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
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
}