SDOH Clinical Care, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-sdoh-clinicalcare/ and changes regularly. See the Directory of published versions
Page standards status: Informative |
Gravity Project develops and maintains SDOH-related value sets that are published in the National Institutes of Health (NIH) Value Set Authority Center (VSAC). Hyperlinks to the Gravity Project VSAC value sets can also be found here on the Gravity Project Confluence site. This section describes how these value sets are used in the SDOHCC profiles and the process for developing the value sets in VSAC.
The SDOHCC Observation Screening Response, SDOHCC Condition, SDOHCC Service Request, SDOHCC Procedure, and SDOHCC Goal profiles have additional bindings for Observation.code, Observation.value, Condition.code, ServiceRequest.code, Procedure.code, and Goal.description respectively. The additional bindings are to SDOH domain-specific value sets (e.g., for Food Insecurity, Inadequate Housing, etc.) which are determined by the value of the profile’s .category element (selected from SDOHCC ValueSet SDOH Category).
For the SDOHCC Condition profile, Condition.code has a binding to US Core Condition Code (required). However, if Condition.category is ‘food-insecurity’, Condition.code has an additional binding to Food Insecurity Diagnoses (a Gravity-authored value set in VSAC).
Excerpt from SDOHCC Condition :
Gravity-authored VSAC value sets include a term in their name that indicate the SDOHCC profile they are used with as follows:
Gravity VSAC value set name includes: | Used with: |
---|---|
Diagnoses | SDOHCC Condition |
Procedures | SDOHCC Procedure |
Service Requests | SDOHCC Service Request |
Goals | SDOHCC Goal |
Assessments | SDOHCC Observation Screening Response |
The steps below outline Gravity’s general process for value set creation in VSAC. For each step, the examples show the process for Condition.code for the SDOHCC Condition profile.
1. Value sets are created that are specific for:
The value sets created in Step 1 do not bind to SDOHCC profile elements. In step 2, they are grouped into value sets that bind to SDOHCC profile elements.
Example 1:
VSAC Value Set Name | SDOH Domain | Bound to Profile | Code System |
---|---|---|---|
Food Insecurity Diagnoses ICD10CM | Food Insecurity | N/A | ICD-10-CM |
Food Insecurity Diagnosis SNOMED CT | Food Insecurity | N/A | SNOMED CT |
Transportation Insecurity Diagnoses ICD10CM | Transportation Insecurity | N/A | ICD-10-CM |
Transportation Insecurity Diagnoses SNOMED CT | Transportation Insecurity | N/A | SNOMED CT |
Inadequate Housing Diagnoses ICD10CM | Inadequate Housing | N/A | ICD-10-CM |
Inadequate Housing Diagnoses SNOMED CT | Inadequate Housing | N/A | SNOMED CT |
Additional SDOH domain-specific value sets… |
2. Value sets created in Step 1 are grouped into value sets that are only specific for:
These value sets bind to SDOHCC profile elements via an Additional Bindings table. For example, the value sets in the first column below are in the Additional Bindings table for Condition.code for SDOHCC Condition. (See image in Additional Bindings for SDOH Domain-specific Value Sets).
Example 2:
VSAC Value Set Name | SDOH Domain | Bound to Profile | Contains VSAC Value Sets |
---|---|---|---|
Food Insecurity Diagnoses | Food Insecurity | SDOHCC Condition | Food Insecurity Diagnoses ICD10CM Food Insecurity Diagnosis SNOMED CT |
Transportation Insecurity Diagnoses | Transportation Insecurity | SDOHCC Condition | Transportation Insecurity Diagnoses ICD10CM Transportation Insecurity Diagnoses SNOMED CT |
Inadequate Housing Diagnoses | Inadequate Housing | SDOHCC Condition | Inadequate Housing Diagnoses ICD10CM Inadequate Housing Diagnoses SNOMED CT |
Additional SDOH domain-specific value sets… |
3. Value sets created in Step 2 are grouped into SDOH grouping value sets that are only specific for:
These value sets are not used in the SDOHCC profiles. However, they are referenced in the Screening and Assessments section of the US Core Implementation Guide which provides the following guidance with respect to these Gravity SDOH grouping value sets: “
Example 3:
VSAC Value Set Name | Used with Profile | Contains VSAC Value Sets |
---|---|---|
Social Determinants of Health Conditions | US Core Condition |
Digital Access Diagnoses Digital Literacy Diagnoses Less than high school education Diagnoses Elder Abuse Diagnoses Unemployment Diagnoses Financial Insecurity Diagnoses Food Insecurity Diagnoses Health Insurance Coverage Status Diagnoses Homelessness Diagnoses Housing Instability Diagnoses Inadequate Housing Diagnoses Intimate Partner Violence Diagnoses Material Hardship Diagnoses Medical Cost Burden Diagnoses Health Literacy Diagnoses Social Connection Diagnoses Stress Diagnoses Transportation Insecurity Diagnoses Utility Insecurity Diagnoses Veteran Status Diagnoses Note: Value sets for new SDOH domains will be added as they are created in VSAC. |
This table summarizes the Gravity VSAC value set development process. Gravity-authored VSAC value sets are shown in the first three columns. Value sets in green are bound to Condition.code for the SDOHCC Condition profile.
1Gravity-authored SDOH value sets can be accessed by creating a free National Library of Medicine (NLM) account and then refining the search to “Steward: The Gravity Project”.