Gravitate Health FHIR Implementation Guide
0.1.0 - CI Build

Gravitate Health FHIR Implementation Guide, published by Gravitate Health Project. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/gravitate-health/ and changes regularly. See the Directory of published versions

ePI Processing

General overview of the processing steps

Adapting information to the context and preferences of the end user for effective and optimal understanding of the information.

The definition of the several steps in the processing pipeline:

  1. Raw ePI: The ePI as is, without changes
  2. p(ePI): the preprocessed ePI, with semmnantic annotation
  3. f(ePI): the focused ePI format, rendered with personalized data
Raw ePIp(ePI)f(ePI)Raw ePIRaw ePIp(ePI)p(ePI)f(ePI)f(ePI)AnnotationFocusingAnnotation of contentw/ standard terminologiesAutomatic (NLP)Semi-automaticManual (ePI editor tool)EngineJavaScriptCQLOther


The focusing mechanism is complex and can be understood as a multistep process:

  1. first the lenses are attached - x(ePI)
  2. the persona vector and IPS and consulted/consumed - x'(ePI)
  3. the necessary data elements are attached (CSS classes to certain DIVs) - f(ePI)

This will create a focused ePI that can be used to show personalized information to the user.

Diagram:

p(ePI)x(ePI)x'(ePI)f(ePI)p(ePI)p(ePI)x(ePI)x(ePI)x'(ePI)x'(ePI)f(ePI)f(ePI)adding lensesdata consumed and attached focusing elementsLenses executedKnow and standard TermsKnow and standard Profile + IPSProduce Standard operationsLanguage independentUser ProfileIPSOr combination


Preprocessing

The transformation of the raw epi to the annotated ePI (preprocessed).

Considerations:

  1. What should be annotated
  2. Is there only one way of annotating?
  3. how to name the classes
  4. CUD vs terminology
  5. This represents this or/and this is related to this..
  6. …

Handling classes

The most common type of lens is about adding special categories to the text. Its about creating a class for a specific purpose. Whether for highlight or collapsing.

But more than that, we need to have traceability for the lens that applied the class. So we also need to add an identification of the lens.

Focusing

The focusing is an important part - arguably the most important one in the whole pipeline. Its where the logic is applied to the preprocessed data and creates personalized content.

Traceability

The idea of a lens also adding its own id to the classes, is a way of securing traceability of the change that was made. Then, the composition refers to them by extension to provide the possibility of getting more information from them. see here for the spec.

Adding more information

In Gravitate-Health, we may also want to add more information. This can be a wide variety of information, like text, images, video, sound. The possibilities are virtually infinite. The idea is to add this information as an extension to the section they are referenced. We could also check the type of information. Whether is a pictogram, a image, a explanation of something… There should be a logic for adding content, trying to harmonize information types. Check the here

ePI, persona and Additional Support Material (or Risk Minimization Material)

Check ASMnoASM for the ePI?do nothingnoASM relates to a particular condition patient has?do nothingyesePi is tagged for that conditionnoadd link to ASM in the proper sectionadd the link in generic section


FHIR Considerations

  1. The raw ePI: This artifact composed of several FHIR resources, being the composition the central piece. It can already have additional data in it from the get go such as multimedia in the format of binary or HtmlElementLink extension.

  2. The preprocessed ePI: The annotation is done through the linkage of sentences, paragraphs or words to concepts, through the HtmlElementLink.

  3. The focused ePI: After the focusing, the focused version should contain the information from the previous two, personalized for the patient. The applied lenses that made any change will be mentioned in the extension https://build.fhir.org/ig/hl7-eu/gravitate-health/StructureDefinition-LensesApplied.html The lens that made any change will be added to the tag as well.

Current developments

The current definition for the FOSPS is here:

https://fosps.gravitatehealth.eu/swagger-fosps/?urls.primaryName=Focusing%20Manager#/Lenses/post_focusing_focus__epiId

Example requests in the github.