Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
SNOMED CT is based on relationships between concepts, structured and constrained by the Machine Readable Content Model (MRCM), and represented and distributed using the RF2 release file format. The OWL-based Description Logic (DL) supports the use of classification tools to infer relationships that are not directly stated in concepts, and hence provide additional meaning and context, however there are challenges when concept attributes need to express fixed values.
In the case of numerics - for example, the weight of a particular medicinal substance used in a drug product - it is desirable to be able to represent that amount, and then be able to ask questions like "List all drugs that contain >= 100mg of Paracetamol".
A work-around for this particular attribute was put in place in 2017, namely to create a concept to represent every number needed in the International Drug Model. This solution results in fully correct classification, and in particular has facilitated progression of the Drug Model implementation, however, it also has several drawbacks, particularly when needing to make comparisons and check for equivalencies.
The drawbacks of using concepts as numbers can be resolved by defining concrete values within SNOMED CT in a way that still fully supports classification to reveal inferred relationships, whilst enabling numeric operator comparisons and (subject to appropriate modelling) equivalences between different units to be detected.
Concrete Domains are a means for the SNOMED CT DL to express concrete objects (such as numbers) and predefined predicates on these objects (such as numerical comparisons) when defining concepts, in a way that still supports classification and inferred relationships.
The Authoring Platform (AP) supports the following concrete value data types:
Integer
Decimal
String
The can apply the following types of constraints to concrete values assigned to attributes:
List (predefined fixed values)
Range (any numeric value between predefined limits; applicable to Integer and Decimal data types)
Attributes previously using concepts as numbers have the same FSN term when represented using concrete domains, however, the target value box has a green background, and the concrete domain values don't have a semantic tag since they are no longer concepts.
Drag and drop is supported for concrete values, so the "drag handle" arrows icon is still available, however concepts dragged from other fields, search results or taxonomy entries cannot be dropped as the target for a concrete domain attribute value, and likewise a concrete value cannot be dragged and dropped onto a concept target slot. Dropping a concrete domain value onto other concrete domain attributes will also be disabled if the drop value doesn't satisfy any MRCM constraints applicable to the target attribute.
A concrete value is represented by a solid green rectangle with diagonal lines in the corners, and the value centred within the box.
Numeric values are represented in Unicode text expressions preceded by a # (hash) symbol. For example:
#0.09
#0.5
#99.99
#1
Strings are represented in Unicode text enclosed by double quotes. A backslash is used as an escape character for quotes within the string, and hence any backslashes within the string also need to be escaped by an additional backslash.
"Product Name"
"Product Name \"containing\" quotes"
"Product Name \"containing\" quotes and a backslash (\\) character"
Since concrete domains are simply a form of attribute target value, as well as the above examples from the Task - Concept - Edit Panel they can appear in any feature of the Authoring Platform that presents attributes and their values, for instance:
The Authoring Platform Terminology Server (Snowstorm) maintains SNOMED CT content in a controlled hierarchical structure of project and task branches originating from the mainline (or simply MAIN) branch.
MAIN carries controlled changes to SNOMED CT content in the current authoring cycle, which is periodically used to generate a new SNOMED CT International Release. It contains a set of project child branches, which can promote content for inclusion in the next SNOMED CT International release.
Each project branch contains any number of task child branches, which can promote content to the project level for sharing and synchronizing across the other tasks. Project branches can be synchronized (rebased from MAIN) with content updates from other projects which have promoted their changes to MAIN.
Task branches can be synchronized (rebased from project) with content updates from other tasks which have promoted their changes to the parent project.
The Machine Readable Concept Model (MRCM) represents rules in the SNOMED CT concept model in a form that can be read by a computer and applied to test that concept definitions and expressions comply with the rules. The MRCM may be used for a variety of purposes, including the authoring and validation of SNOMED CT concepts, expressions, expression constraints and queries, Natural Language Processing and terminology binding to support semantic interoperability.
The MRCM may be useful in a number of use cases, including:
Development of precoordinated terminology content.
Authoring and validation of SNOMED CT expressions, constraints and queries.
#20
#500


Up-to-date
Branch is synchronized with parent
Forward
Branch has at least one change whilst its parent branch is unchanged. This is the required state for merging a branch.
Behind
Parent branch has at least one change whilst the branch is unchanged. Branch can be safely rebased in this state, to bring in the parent changes.
Diverged
Both branch and its parent have at least one change since branch creation. Branch must be rebased before it can be safely promoted, to bring in the parent changes before promoting the branch.
Stale
Branch is no longer associated with its original parent (and should be deleted).

Natural Language Processing.
Terminology binding to information models, for purposes such as data capture and semantic interoperability.
The MRCM contains a set of domains and a set of attributes, which may be applied to one or more domains. The cardinality and valid range of each attribute is specified, and indicates whether or not the attribute should be grouped. The domain, range, cardinality and grouped indicator for each attribute is also combined into a single 'attribute rule', which is represented using a .
For each domain, the set of valid attributes and their associated rules are compiled into two SNOMED CT 'domain templates' – for precoordinated concept authoring and postcoordinated expression authoring respectively. These domain templates may be further specialized to support customized authoring of specific subdomains.
The following diagram summarizes the logical structure of the MRCM:
The MRCM is distributed as the following types of reference set in the SNOMED CT RF2 release file format:
MRCM Domain Reference Set
MRCM Attribute Domain Reference Set
MRCM Attribute Range Reference Set
MRCM Module Scope Reference Set
The following diagram summarizes these reference sets and their properties:
Description Logics (DLs) exist to enable a reduction in content maintenance costs with a concurrent increase in content quality. Processing power and reasoning algorithms have improved such that a more expressive DL is now practical to use in SNOMED CT.
The principle benefit of more DL features is the ability to represent content in a more fully systematised and thus more machine processable way, to enable the following benefits:
increased efficiency, consistency, precision and quality of authoring through reduced manual effort to organise content
lower costs to author and maintain content through reduced manual effort
a more complete and consistent product that is, as a consequence, more usable (for implementers and end users) and attractive (to drive adoption and implementation)
reduction in the cost of assessing the impact of modelling change, because changes also become systematically describable (and transformable).
simplification of content modelling by removing workarounds
close interoperability with an international standard, OWL, allowing easier application of other standards and tools
explicitly specified logic profile for Description Logic features used in SNOMED CT
Attribute concepts have the ability to declare DL property characteristics as Transitive or Reflexive.
Property characteristics are currently maintained via the Terminology Server Application Programming Interface (TS API). Changes can be made via service requests to the technical team.
Example concept JSON data structure showing a Transitive property characteristic
When saved via the TS API, the changes are written into the Owl Axiom Reference Set as shown in the following examples:
900000000000012004
733073007
116680003
TransitiveObjectProperty(sct:116680003)
900000000000012004
OWL DL Property Chains can now be used within the authoring platform to infer additional concept properties during classification.
These inferred attributes appear in classification results along with all other inferred relationships.
Property chains are currently maintained via the TS API. Changes can be made via service requests to the technical team.
Example
This feature allows |Has active ingredient| to be linked with |Is modification of| such that a medicinal product that has an active ingredient which is the modification of another substance, could classify as a child of a product containing the less modified substance.
This behaviour is critical to controlling the effect of changes to the |Substance (substance)| hierarchy on other hierarchies.
Axioms are a relatively new part of SNOMED CT concepts. Each Axiom is like another mini concept definition including definition status and a set of stated relationships. These are presented and maintained through the concept edit panel in the same way as the earlier version stated relationships, visually located below the existing stated relationships of the concept. Axioms have a named concept on the left and an expression on the right.
The relationships within each additional axiom follow MRCM rules just like the stated relationships. At least one is-a relationship is required in an Axiom. The concept editor panel supports creation, editing and removing of axiom relationships. There is no released or active state on axiom relationships - they can always be modified or deleted.
Each Axiom of a concept is necessarily true. The attributes from all Axioms are in the inferred form and are inherited by children through inference. The normal form process may reduce these attributes if a more specific attribute or group of attribute is present, in the same way that is does for attributes from the stated relationships. Attributes in an Axiom are inferred on the named concept and its descendants.
Example
Concept A has Axiom A1 (stated relationships) and A2. Concept B has Axiom B1 (stated relationships). Concept A subsumes Concept B - Concept B gets the inferred attributes of Axiom A1 AND A2.
Non-attribute concepts have the ability to declare general class Axioms in addition to the stated relationships.
General Concept Inclusions (GCIs) with Axioms provide authors with greater flexibility in how concepts are defined, and provide classifiers with a greater ability to make appropriate inferences.
For example, these features can be used to state that a subset of attributes is sufficient to define a concept, and therefore that this sufficient set can be used to classify other concepts as descendants in the hierarchy.
Each GCI is recorded as a separate Axiom expression within a separate member of the Owl Axiom Reference Set. A GCI has a definition status which is represented using a SubClassOf or EquivalentClasses axiom expression.
{
"effectiveTime": "20110131",
"moduleId": "900000000000012004",
"active": true,
"released": true,
"conceptId": "123005000",
"fsn": "Part of (attribute)",
"definitionStatus": "PRIMITIVE",
"preferredSynonym": "Is a",
"propertyCharacteristics": ["Transitive"],
"descriptions": [],
"relationships": [],
"isLeafStated": true,
"isLeafInferred": true
}

Service Acceptance Criteria (SAC) are used to assure that authored SNOMED CT content meets specific quality measures before the content can be promoted. The purpose of this is to ensure a specific level of quality is met at each promotion level. This in turn assures the quality of the content that is eventually promoted to the code system branch, with the benefit of minimising the quality checks required at that level (in general, the later the stage of the content release process, the greater the amount of work needed to correct any issues, so catching issues earlier in the process has many benefits).
SAC may be either automated or manual.
Automated SAC are checks which the system can sign off automatically without user intervention.
Manual SAC are checks that require sign-off via a particular user interaction, with that interaction governed by role-based access controls.
SAC may also be mandatory or optional.
733073007
733928003
ReflexiveObjectProperty(sct:733928003)
900000000000012004
733073007
733928003
TransitiveObjectProperty(sct:733928003)

Optional SAC do not block promotion, but best practice would be to inform the Project Manager and/or Project Lead of reasons for promoting without the check being satisfied (an example may be a task-level spelling check, which might depend on the nature of the content being changed, and the availability of related spell-checking resources).
SAC are defined at the global level by users with the ADMIN role, as are their mapping to required RBAC roles. This is currently constrained as a technical support feature.
Globally defined SAC are then available as an options list to those with relevant permissions (set by RBAC role group definitions on the branch or its parents), to decide which to include in task-level or project-level gateway controls.
SAC are presented as checklist items in either the task details (for task level SAC) or project view (for project level SAC). The ability to modify the manual items to check them off via the AP user interface is a permission granted by the role assigned to each item in the SAC list. Task level manual SAC are usually available to all authors. Some project level manual SAC may also be available to all authors, but many will require additional permissions such as those for Project Managers or Project Leads to update (specific role mappings are set in the SAC global configuration definitions).
Some aspects of acceptance gateway controls are implicit in the AP branch promotion process - for instance, diverged content branches cannot be promoted: each branch must be rebased from its immediate parent branch with all merge conflicts resolved before the branch can be promoted.
Service Acceptance Criteria are components in a technical architecture solution which includes the Authoring Acceptance Gateway (AAG) and various data stores associated with acceptance and sign-off of content changes for promotion via AP tasks and projects, and also for the generation and packaging of SNOMED CT releases.
The following schematic illustrates the subset of this architecture directly related to AP features and their inter-relationships and dependencies (components relating to release preparation and packaging are omitted here for clarity, but are essential aspects of the overall technical architecture):
Early Visibility Notice if Required Manual spell check Review complete RVF Report Clean
Project Documentation (TIG Editorial Guide) Complete Project Lead (Peer reviewer): All Release Validation Reports Checked Project Lead (Peer reviewer): Exceptions Checked and Signed off Project Lead (Peer reviewer): Final Sign-Off Project Manager: Signed Off Project as Ready to Promote Relevant MRCM Changes Implemented Report: Case Significance Clean Report: Duplicate Terms Clean Report: KPI Patterns Clean Report: New Descriptions Clean Report: Release Issues Clean Report: Template Compliance Clean Report: Validate Inactivations with Associations Clean Validation Report Clean

The SNOMED CT Reporting Platform (RP) is a gateway to reports which can run a range of queries against content created or updated in the active authoring cycle for SNOMED CT.
Queries are structured into categories for ease of definition, navigation and retrieval, such as Ad-Hoc Queries, Release Validation and Quality Improvement.
The results of these queries can support pre-release validation of issues not supported by the Authoring Platform (for instance, MRCM rules such as attribute cardinality).
They can also be used to analyze the structural quality of SNOMED CT, to identify potential issues (for instance, attribute usage for a given sub-hierarchy) which can then be addressed via content change projects in the Authoring Platform.
For content authors, it enables iterative work to define complex QA rules that are eventually used for the Release Validation Framework (RVF) assertions (such as Case Significance).
As a content release planning and tracking tool it can show the number and types of changes made during a SNOMED CT release cycle, and from one release to the next.
It can reveal trends and particular faceted searches of SNOMED CT content created through the SNOMED CT Authoring Platform that are not easily obtainable via other tools and services.
It can help with quality assurance review of promoted content prior to publication in the next SNOMED CT release.
It can help to quickly modify and adapt rules which can enable more rapid SNOMED CT content updates via Authoring Platform authoring projects/tasks.
Anytime you need to query the content within the current authoring cycle for SNOMED CT.
In particular, many of the reports are designed to help with content quality assurance reviews before creating the alpha-release version for each SNOMED CT release cycle.
RP queries run against the content which has been promoted to the mainline branch of the Authoring Platform (ie promoted project content), so some coordination with project content team leaders may be advisable if your report is influenced by or needs to include specific project content for analysis.
The Reporting Platform is linked from the SNOMED CT Authoring Platform (AP) header drop-down menu (available on all pages within the Authoring Platform).
The International AP can be bookmarked and opened with:
The RP can also be bookmarked and opened directly with:
These links will redirect you to the login page if you’re not already logged in within your current browser session. Once your login completes, your browser will be redirected on to the AP Dashboard and RP main page respectively. If already logged in, these pages will load without the login redirect.
Anyone who has a use for the results of queries run against content updates for the current authoring cycle through the SNOMED CT Authoring Platform, such as (but by no means limited to):
Content authors
Content project managers
Content team leaders
Consultant terminologists
RBAC is an access-control mechanism defined by mapping user-assignable roles to related privileges and features, governed by three core aspects: role assignment, role authorization, and permission authorization.
The Authoring Platform uses RBAC to authorize an authenticated user account with permissions to perform particular actions within the platform, defined by role-group mapping and membership.
The current roles defined on the AP can be considered in three groups:
Authoring and content promotion control
SNOMED CT release control
These roles are assigned to particular access control groups, which are mapped to global or project level content branch permissions on the Terminology Server. The technical support and platform administration, and SNOMED CT release control roles are outside the scope of this AP user guide, but mentioned here for completeness. When an account login is authenticated, it is then assigned AP feature access and permissions according to the roles defined for the groups of which the account is a member.
For quality checks that are not currently supported in the Authoring Platform by Drools Rules (concept save validation) or Release Validation Framework assertions (task and project validation against an entire release), for instance string handling.
Clinicians
SNOMED CT release teams
Technical specialists
Technical support and platform administration
AUTHOR PROJECT_MANAGER PROJECT_LEAD
RELEASE_USER RELEASE_MANAGER RELEASE_LEAD RELEASE_ADMIN
ADMIN
AUTHOR is the core permission which enables an authenticated account to work on SNOMED CT content through authoring projects and their related tasks.
PROJECT_MANAGER adds permissions to define Service Acceptance Criteria (SAC) which are used by Authoring Access Gateway (AAG) controls to grant (or deny) permissions for promotion of content at task and project level.
PROJECT_LEAD adds permissions to approve SAC items which allow project content promotion to the content mainline.
These roles also determine the visibility and presentation of access-controlled features in the AP user interface.