This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "CIMI Practitioners' Guide"

From HL7Wiki
Jump to navigation Jump to search
Line 4: Line 4:
  
 
[[file: PractitionersGuide_ITObjectives.jpg|none|800px|IT Objectives]]
 
[[file: PractitionersGuide_ITObjectives.jpg|none|800px|IT Objectives]]
 +
 +
 +
==Scope==
 +
 +
 +
 +
==Plans==
 +
 +
 +
==January 2017 Comments-Only Ballot==
 +
 +
The CIMI Team focused primarily on the following areas:
 +
* The expansion and modularization of the CIMI Reference Model based on a set of core modeling principles;
 +
* The definition of top-level archetypes based on the CIMI Reference Model
 +
* The development of core modeling patterns including:
 +
** The compositional Clinical Statement Pattern
 +
** The Statement Topic/Context Patterns
 +
** The Attribution/Provenance Pattern
 +
** The Party/Participation Pattern
 +
** The Assertion and EvaluationResult Patterns
 +
** The Procedure Pattern
 +
* The alignment of the CIMI Logical Model with the SNOMED CT Concept Model;
 +
* The modeling of a number of the Skin/Wound Assessment archetypes to illustrate the use of the above patterns.
 +
* Example value set bindings ('''see attached example-spreadsheet''') was done; where, terminology alignment and terminology bindings, apart from those specifying the alignment of model attributes to SNOMED CT Concept Model attributes, are provided as examples.
 +
* In the future, CIMI intends to work with the community to define and use VSAC value sets.
 +
 +
 +
==May 2017 Informative Ballot/Standard==
 +
 +
Post January, the CIMI working group intends to
 +
* address community comments and refactor the model accordingly.
 +
* complete the CIMI Reference Model,
 +
* complete CIMI top-level archetypes including archetypes that capture US Core and QI Core requirements.
 +
 +
 +
==Sep 2017 SRU Ballot/Standard==
 +
 +
By the September 2017 HL7 Working Group Meeting, we plan to:
 +
* Complete the terminology bindings for all proposed archetypes,
 +
* Implement detailed clinical models for selected use cases, and
 +
* Specify formal declarative mappings from CIMI to FHIR using the FHIR Mapping Language.
 +
* The model will then be balloted as a Standard for Trial Use.
 +
  
 
=Principles=
 
=Principles=
Line 30: Line 73:
  
 
It is important to note that some FHIR profiles may be derived from the Foundational Archetype Layer (e.g., US Core, some QI Core profiles, some CQIF profiles on PlanDefinition, Questionnaire and ActivityDefinition, etc...) and others from the DCM Layer (e.g., bilirubin, HgA1c, etc...). In other words, the arrow for FHIR Profiles stems out of the outer box rather than the last of the inner boxes (the DCM box).
 
It is important to note that some FHIR profiles may be derived from the Foundational Archetype Layer (e.g., US Core, some QI Core profiles, some CQIF profiles on PlanDefinition, Questionnaire and ActivityDefinition, etc...) and others from the DCM Layer (e.g., bilirubin, HgA1c, etc...). In other words, the arrow for FHIR Profiles stems out of the outer box rather than the last of the inner boxes (the DCM box).
 
 
  
  
Line 44: Line 85:
 
[[file: CIMI20170202-09_CoreReferenceModel.jpg|none|700px|CIMI Core Reference Model]]
 
[[file: CIMI20170202-09_CoreReferenceModel.jpg|none|700px|CIMI Core Reference Model]]
  
 +
 +
===Primitive Types===
  
  
===Primitive Types===
+
[[file: CIMI_Primative_Types_BMM_Mind_Map.jpg|none|900px|CIMI_Primative_Types_BMM_Mind_Map.jpg]]
  
  
 
===Data Value Types===
 
===Data Value Types===
 +
 +
 +
[[file: CIMI_Data_Value_Types_BMM_Mind_Map.jpg|none|900px|CIMI_Primative_Types_BMM_Mind_Map.jpg]]
 +
  
 
==Foundation BMM==
 
==Foundation BMM==
Line 55: Line 102:
 
The CIMI '''Foundational BMM Reference Model''' is closely aligned to ISO13606 and the OpenEHR Core Reference Model. It defines foundational CIMI clinical documents and clinical record patterns. It also introduces the PARTY, ROLE, and PARTY_RELATIONSHIP patterns and defines the top-level CLUSTER class for complex CIMI type hierarchies. CQI Knowledge Artifacts may also leverage this layer.
 
The CIMI '''Foundational BMM Reference Model''' is closely aligned to ISO13606 and the OpenEHR Core Reference Model. It defines foundational CIMI clinical documents and clinical record patterns. It also introduces the PARTY, ROLE, and PARTY_RELATIONSHIP patterns and defines the top-level CLUSTER class for complex CIMI type hierarchies. CQI Knowledge Artifacts may also leverage this layer.
  
[[file: CIMI_Foundation_BMM_Mind_Map.jpg|none|900px|CIMI_Core_Foundation_BMM_Mind_Map]]
+
 
 +
 
 +
[[file: CIMI_Foundation_BMM_Mind_Map.jpg|none|700px|CIMI_Core_Foundation_BMM_Mind_Map]]
  
  

Revision as of 11:58, 12 February 2017

Introduction

IT Objectives


Scope

Plans

January 2017 Comments-Only Ballot

The CIMI Team focused primarily on the following areas:

  • The expansion and modularization of the CIMI Reference Model based on a set of core modeling principles;
  • The definition of top-level archetypes based on the CIMI Reference Model
  • The development of core modeling patterns including:
    • The compositional Clinical Statement Pattern
    • The Statement Topic/Context Patterns
    • The Attribution/Provenance Pattern
    • The Party/Participation Pattern
    • The Assertion and EvaluationResult Patterns
    • The Procedure Pattern
  • The alignment of the CIMI Logical Model with the SNOMED CT Concept Model;
  • The modeling of a number of the Skin/Wound Assessment archetypes to illustrate the use of the above patterns.
  • Example value set bindings (see attached example-spreadsheet) was done; where, terminology alignment and terminology bindings, apart from those specifying the alignment of model attributes to SNOMED CT Concept Model attributes, are provided as examples.
  • In the future, CIMI intends to work with the community to define and use VSAC value sets.


May 2017 Informative Ballot/Standard

Post January, the CIMI working group intends to

  • address community comments and refactor the model accordingly.
  • complete the CIMI Reference Model,
  • complete CIMI top-level archetypes including archetypes that capture US Core and QI Core requirements.


Sep 2017 SRU Ballot/Standard

By the September 2017 HL7 Working Group Meeting, we plan to:

  • Complete the terminology bindings for all proposed archetypes,
  • Implement detailed clinical models for selected use cases, and
  • Specify formal declarative mappings from CIMI to FHIR using the FHIR Mapping Language.
  • The model will then be balloted as a Standard for Trial Use.


Principles

Architectural Framework


CIMI BMM 5 Layers


The CIMI Reference Model is expressed using the OpenEHR Basic Metamodel (BMM) Language. The archetype layers are expressed using the OpenEHR Archetype Definition Language (ADL). While reference model modules define classes, attributes, and class hierarchies, the archetype layers only specify progressive constraints on the reference model but do not introduce new classes, attributes, and class-class relationships.

  1. The CIMI Core BMM Reference Model provides the core granularity of the CIMI model and introduces its top-level classes such as the DATA_VALUE class and the LOCATABLE class. This reference layer module defines the CIMI primitive types and core data types.
  2. The CIMI Foundational BMM Reference Model is closely aligned to ISO13606 and the OpenEHR Core Reference Model. It defines foundational CIMI clinical documents and clinical record patterns. It also introduces the PARTY, ROLE, and PARTY_RELATIONSHIP patterns and defines the top-level CLUSTER class for complex CIMI type hierarchies. CQI Knowledge Artifacts may also leverage this layer.
  3. The CIMI Clinical BMM Reference Model consists of the classes derived from existing CIMI archetypes, the FHIM, QUICK, vMR, and QDM. This layer defines the set of 'schematic anchors' (to borrow Richard Esmond's term) or core reference model patterns from which all CIMI archetype hierarchies and ultimately Detailed Clinical Models (DCMs) derive. Requirements for this layer come from FHIM, vMR, QDM, QUICK, FHIR US Core, SDC, etc...
    1. The 'goal' is to define the reference models with low FHIR transformation costs where feasible noting that we will inherently have some divergence due to the different requirements underlying both models.
    2. Galen points out that, FHIM’s expressivity will not carry over to CIMI DCMs given the models' different requirements (e.g., FHIM includes finance and accounting).
  4. The CIMI Foundational Archetype Patterns define the top-level constraints on the CIMI Reference Model. These typically consist of attribute formal documentation and high level attribute semantic and value set bindings. Archetypes at this layer will provide the foundational requirements for future US Core and QI Core profiles. Future pilots will explore the generation of US Core and QI Core archetypes from these CIMI archetypes.
  5. The CIMI Detailed Clinical Model Layer represents the set of leaf-level constraining profiles on the foundational archetypes to create families of archetypes that only vary in their finest terminology bindings and cardinality constraints. This layer is intended to support clinical interoperability through an unambiguous specification of model constraints for information exchange, information retrieval, and data processing.

From layers 1-5, we define the set of transformations (e.g., SIGG (MDHT, MDMI)) to generate the corresponding FHIR profiles including the US Core and QI Core profile sets. Note that FHIR profiles can be generated from the various levels of the archetype hierarchy depending on requirements. The lower down in the hierarchy, the more prescriptive the profile is in terms of constraints. Much like ADL Archetypes, FHIR profiles can be layered.

It is important to note that some FHIR profiles may be derived from the Foundational Archetype Layer (e.g., US Core, some QI Core profiles, some CQIF profiles on PlanDefinition, Questionnaire and ActivityDefinition, etc...) and others from the DCM Layer (e.g., bilirubin, HgA1c, etc...). In other words, the arrow for FHIR Profiles stems out of the outer box rather than the last of the inner boxes (the DCM box).


Core BMM

The CIMI Core BMM Reference Model provides the core granularity of the CIMI model and introduces its top-level classes such as the DATA_VALUE class and the LOCATABLE class. This reference layer module defines the CIMI primitive types and core data types.



CIMI Core Reference Model


Primitive Types


Data Value Types


Foundation BMM

The CIMI Foundational BMM Reference Model is closely aligned to ISO13606 and the OpenEHR Core Reference Model. It defines foundational CIMI clinical documents and clinical record patterns. It also introduces the PARTY, ROLE, and PARTY_RELATIONSHIP patterns and defines the top-level CLUSTER class for complex CIMI type hierarchies. CQI Knowledge Artifacts may also leverage this layer.



CIMI Foundation Reference Model_UML

Clinical BMM

  • The CIMI Clinical BMM Reference Model consists of the classes derived from existing CIMI archetypes, the FHIM, QUICK, vMR, and QDM. This layer defines the set of 'schematic anchors' (to borrow Richard Esmond's term) or core reference model patterns from which all CIMI archetype hierarchies and ultimately Detailed Clinical Models (DCMs) derive. Requirements for this layer come from FHIM, vMR, QDM, QUICK, FHIR US Core, SDC, etc...
    • The 'goal' is to define the reference models with low FHIR transformation costs where feasible noting that we will inherently have some divergence due to the different requirements underlying both models.
    • Galen points out that, FHIM’s expressivity will not carry over to CIMI DCMs given the models' different requirements (e.g., FHIM includes finance and accounting).


Clinical BMM Context

CIMI_Clinical_BMM_Context_Mind_Map


Clinical Statement

CIMI_Clinical_BMM_Clinical_Statement_Mind_Map.jpg


Clinical Statement Topic

CIMI_Clinical_BMM_Clinical_Statement_Topic_Mind_Map.jpg

Clinical Statement Association

CIMI_Clinical_BMM_Clinical_Statement_Association_Mind_Map.jpg

Clinical Statement Context

CIMI_Clinical_BMM_Clinical_Statement_Context_Mind_Map.jpg


Clinical Statement Data Structures

CIMI_Clinical_BMM_Clinical_Data_Structure_Packages_1_Mind_Map.jpg


CIMI_Clinical_BMM_Clinical_Data_Structure_Packages_2_Mind_Map.jpg

Foundational Archetype Patterns

  • The CIMI Foundational Archetypes Patterns define the top-level constraints on the CIMI Reference Model. These typically consist of attribute formal documentation and high level attribute semantic and value set bindings. Archetypes at this layer will provide the foundational requirements for future US Core and QI Core profiles. Future pilots will explore the generation of US Core and QI Core archetypes from these CIMI archetypes.

Detailed Clinical Models (DCMs)

  • The CIMI Detailed Clinical Model Layer represents the set of leaf-level constraining profiles on the foundational archetypes to create families of archetypes that only vary in their finest terminology bindings and cardinality constraints. This layer is intended to support clinical interoperability through an unambiguous specification of model constraints for information exchange, information retrieval, and data processing.

PC Requirements for Skin-Wound DCM

  • 2917-02-09-1000 ET Patient Care Workgroup Telecom
  • Attendees: Jay, Susan, Richard, Claude, Steve
  1. Skin Wound content & scope
    1. Braden
    2. Skin Assessment
    3. Wound Assessment, with Pressure Ulcer specialization
    4. No Skin Risk Assessment (out of scope)
  2. Schedule
    1. Feb 13: Requirements UML and Terminology spreadsheet finished
    2. Feb 13 to Mar 3 - VA verification and validation of spreadsheet
      1. Diagram
      2. Data-Element and Value-Set Spreadsheet
    3. Mar 8: Presented at LOINC conference by Susan

UML

Skin Wound UML Requirements


Mind Maps

Skin Wound Context Mind Map.jpg


Skin Wound Detail-1


Skin Wound Detail-2


Skin Wound Detail-3

Tools

References

  1. Jan 2017 CIMI Architecture, Methodology and Style Guide from Ballot
  2. CIMI Tools
  3. CIMI References