Ontology services: Difference between revisions

From Endeavour Knowledge Base
No edit summary
No edit summary
Line 16: Line 16:
== Support for Value sets ==
== Support for Value sets ==


The service supports the creation of, maintenance of, distribution of, and access to value set definitions and value sets.
The service supports the creation of, maintenance of, distribution of, and access to value set definitions and value sets, sometimes referred to as reference sets or concept sets.


A value set definition is a collection of concept expressions that have been brought together for particular business purposes. They are different from standard concept definitions because the meaning of some members of a value set may not be subsumed by the implied meaning of the value set. Value set definitions are desribed in more detail in the [[Discovery_Information_model_language.|Discovery_Information_model_language.]]
A value set definition is a collection of concept expressions that have been brought together for particular business purposes. They are different from standard concept definitions because the meaning of some members of a value set may not be subsumed by the implied meaning of the value set. Value set definitions are desribed in more detail in the [[Discovery_Information_model_language.|Discovery_Information_model_language.]]
Line 24: Line 24:
Class expressions may be simple pre-cordinated concepts such as a disease term like&nbsp;<span style="color:#8e44ad;">2019 novel coronavirus detected&nbsp;</span>or may be complex classes such as&nbsp;
Class expressions may be simple pre-cordinated concepts such as a disease term like&nbsp;<span style="color:#8e44ad;">2019 novel coronavirus detected&nbsp;</span>or may be complex classes such as&nbsp;


<span style="color:#27ae60;">Concept&nbsp;:&nbsp;iri</span><span style="color:#8e44ad;">= VSET_Covid1 {</span><span style="color:#27ae60;">name</span><span style="color:#8e44ad;">= "Confirmed covid 19", </span><span style="color:#27ae60;">description</span><span style="color:#8e44ad;">= " concepts indicating conformation of covid 19 cases including diagnoses and positive test results" }</span>
<span style="color:#8e44ad;">Covid 19 {</span><span style="color:#27ae60;">EquivalentTo</span><span style="color:#8e44ad;">&nbsp;: Disease&nbsp;</span>


<span style="color:#8e44ad;">&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color:#27ae60;">&nbsp; SubClassOf&nbsp;:</span><span style="color:#8e44ad;">VSET_ValueSets</span>
<span style="color:#8e44ad;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color:#27ae60;">&nbsp;and</span><span style="color:#8e44ad;">(causative_agent&nbsp;</span><span style="color:#27ae60;">some&nbsp;</span><span style="color:#8e44ad;">coronavirus-2)</span>


<span style="color:#8e44ad;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color:#27ae60;">and </span><span style="color:#8e44ad;">(has_member,&nbsp; SN_84101006 </span><span style="color:#27ae60;">or&nbsp;</span><span style="color:#8e44ad;">SN_1240581000000104 or.......)&nbsp; &nbsp; &nbsp;</span>Which are IRIs to Snomed concepts for he disease and testing.
<span style="color:#8e44ad;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color:#27ae60;">&nbsp;&nbsp;and</span><span style="color:#8e44ad;">(has_pathological_process&nbsp;</span><span style="color:#27ae60;">some</span><span style="color:#8e44ad;">&nbsp;infectious_process)}.</span>


Within the ontology the snomed concept is also defined
&nbsp;
 
<span style="color:#27ae60;">Concept iri</span><span style="color:#8e44ad;">- SN_1240581000000104&nbsp; </span><span style="color:#27ae60;">{name</span><span style="color:#8e44ad;">= "2019 novel coronavirus detected"}</span>
 
<span style="color:#8e44ad;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color:#27ae60;">&nbsp;Equivalent to </span><span style="color:#8e44ad;">......</span>
 
Within the ontology, original proprietary codes are also defined
 
<span style="color:#27ae60;">Concept IRI </span><span style="color:#8e44ad;">= BC_687309281 </span><span style="color:#27ae60;">{name</span><span style="color:#8e44ad;">= " Corona virus 2019" }&nbsp; </span>&nbsp;&nbsp;: This is a Cerner code used in Barts
 
&nbsp; &nbsp; &nbsp;<span style="color:#27ae60;">SubclassOf&nbsp;: </span><span style="color:#8e44ad;">SN_1240751000000100&nbsp; &nbsp; &nbsp;</span> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;:Disease caused by Corona virus 2019


=== Value set editor ===
=== Value set editor ===

Revision as of 11:39, 1 May 2020

DRAFT - this article is in a very draft state and must not be relied upon as being up to date or an actual reflection of the world's true state.

The Information model service is a set of services that enables the Discovery common information model to be created, updated, distributed and accessed.

The service includes a set of web applications and a set of APIs to an information model server and an information model distribution service

All components of the service are open source and available at the Discovery Endeavour githubs https://github.com/endeavourhealth and https://github.com/endeavourhealth-discovery

The information model itself is internally defined via the Discovery_information_model_language which is a group of standards based languages with some pragmatic additions that enable the service to operate.  Externally, the Information model can be accessed via standards based APIs or by Discovery language based APIs that are supported by the Information model server.

The following lists the functional groupings of the IM Service. Some of these use web applications , some use the information model server, and some use the information model distribution service components that maintain locally owned copies of the information model.

Support for Value sets

The service supports the creation of, maintenance of, distribution of, and access to value set definitions and value sets, sometimes referred to as reference sets or concept sets.

A value set definition is a collection of concept expressions that have been brought together for particular business purposes. They are different from standard concept definitions because the meaning of some members of a value set may not be subsumed by the implied meaning of the value set. Value set definitions are desribed in more detail in the Discovery_Information_model_language.

A value set is a class whose members are class expressions i.e a Value set has members who are class concept expressions.

Class expressions may be simple pre-cordinated concepts such as a disease term like 2019 novel coronavirus detected or may be complex classes such as 

Covid 19 {EquivalentTo : Disease 

                and(causative_agent some coronavirus-2)

               and(has_pathological_process some infectious_process)}.

 

Value set editor

The value set editor enables people to create and maintain value set definitions which can then be downloaded, accessed via an API or distributed via the information model distribution service. 

Value set run time generator 

The value set generator returns a list of concepts that are defined by a value set definition for use in queries, thus supporting advanced subsumption_testing against health care records.

The value set generator API accepts the IRI of a value set either in full, or relative to a baseline IRI e.g. http://DiscoveryDataService/InformationModel#VSET_Covid1 or simple VSET_Covid1, and returns a list of concepts to be used in the query. The API supports both core concepts and original codes that have been mapped to the core concepts, depending on whether the database uses Discovery concepts or actual original codes

 

Value set distributor

The value set distributor maintains tables of value sets for databases that use local instances of the Discovery information model. 

This is part of the information model distribution service that runs on an application server,  and is designed to detect changes to the content of the information model and regenerate the value sets from the value set definitions. The value sets are regenerated whenever a value set definition changes or whenever there is an update to the concepts within the information model.