SDOH Clinical Care
2.2.0 - STU 2.2 United States of America flag

This page is part of the SDOH Clinical Care for Multiple Domains (v2.2.0: STU 2.2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

Gravity Project Value Sets

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.

Additional Bindings for SDOH Domain-specific Value Sets

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).

Additional Binding Example for the SDOHCC Condition Profile

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 :

SDOHConditionExample.png

Gravity Project Value Set Development Process

Gravity Project Value Set Naming

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

Steps for Gravity Project Value Set Creation in VSAC

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:

  • SDOH domain (category) – e.g., Food insecurity, Transportation Insecurity.
  • Profile – e.g., Condition (Diagnoses), Procedure
  • Code system – e.g., ICD-10-CM, SNOMED CT, LOINC, CPT, HCPCS

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:

  • SDOH domain (category) – e.g., Food insecurity, Transportation Insecurity
  • Profile – e.g., Condition (Diagnoses), Procedure

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:

  • Profile – e.g., Condition (Diagnoses), Procedure

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: “These grouped value sets are narrower subsets of the value sets allowed in the respective US Core Profiles. However, when recording SDOH data US Core Profiles, servers **SHOULD** use them.

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.
Table - Gravity VSAC Value Set Development Process for SDOHCC Condition

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.

VSACValueSets-ConditionExample.png


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”.