us_core_test_kit 0.6.2 → 0.6.4

data/lib/us_core_test_kit/generator/must_support_metadata_extractor_us_core_5.rb

@@ -17,7 +17,6 @@ module USCoreTestKit
 
       def handle_special_cases
         add_must_support_choices
-        remove_patient_address_period
         add_patient_uscdi_elements
         remove_survey_questionnaire_response
       end
@@ -48,10 +47,6 @@ module USCoreTestKit
         end
       end
 
-      def remove_patient_address_period
-        us_core_4_extractor.remove_patient_address_period
-      end
-
       def add_patient_uscdi_elements
         return unless profile.type == 'Patient'
 
@@ -62,16 +57,6 @@ module USCoreTestKit
           url: 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity',
           uscdi_only: true
         }
-        must_supports[:elements] << {
-          path: 'address.use',
-          fixed_value: 'old',
-          uscdi_only: true
-        }
-        must_supports[:elements] << {
-          path: 'name.use',
-          fixed_value: 'old',
-          uscdi_only: true
-        }
       end
 
       def add_value_set_expansion

data/lib/us_core_test_kit/generator/must_support_metadata_extractor_us_core_6.rb

@@ -12,6 +12,10 @@ module USCoreTestKit
         self.must_supports = must_supports
       end
 
+      def us_core_3_extractor
+        @us_core_3_extractor ||= MustSupportMetadataExtractorUsCore3.new(profile, must_supports)
+      end
+
       def us_core_4_extractor
         @us_core_4_extractor ||= MustSupportMetadataExtractorUsCore4.new(profile, must_supports)
       end
@@ -66,11 +70,10 @@ module USCoreTestKit
         return unless profile.type == 'Patient'
 
         us_core_4_extractor.add_patient_telecom_communication_uscdi
+        us_core_3_extractor.update_patient_previous_name_address
 
         must_supports[:elements].each do |element|
           case element[:path]
-          when 'address.use', 'name.use'
-            element[:fixed_value] = 'old'
           when 'deceased[x]'
             element[:original_path] = element[:path]
             element[:path] = 'deceasedDateTime'

data/lib/us_core_test_kit/generator/must_support_metadata_extractor_us_core_7.rb

@@ -0,0 +1,42 @@
+require_relative 'must_support_metadata_extractor_us_core_6'
+
+module USCoreTestKit
+  class Generator
+    class MustSupportMetadataExtractorUsCore7
+      attr_accessor :profile, :must_supports
+
+      US_CORE_CATEGORY = ['sdoh', 'functional-status', 'disability-status', 'cognitive-status']
+
+      def initialize(profile, must_supports)
+        self.profile = profile
+        self.must_supports = must_supports
+      end
+
+      def us_core_6_extractor
+        @us_core_6_extractor ||= MustSupportMetadataExtractorUsCore6.new(profile, must_supports)
+      end
+
+      def handle_special_cases
+        us_core_6_extractor.handle_special_cases
+        add_must_support_choices
+      end
+
+      def add_must_support_choices
+        more_choices = []
+
+        case profile.type
+        when 'Procedure'
+          more_choices << {
+            paths: ['reasonCode', 'reasonReference'],
+            uscdi_only: true
+          }
+        end
+
+        if more_choices.present?
+          must_supports[:choices] ||= []
+          must_supports[:choices].concat(more_choices)
+        end
+      end
+    end
+  end
+end

data/lib/us_core_test_kit/generator/search_definition_metadata_extractor.rb

@@ -3,13 +3,13 @@ require_relative 'value_extractor'
 module USCoreTestKit
   class Generator
     class SearchDefinitionMetadataExtractor
-      attr_accessor :ig_resources, :name, :resource, :profile_elements
+      attr_accessor :ig_resources, :name, :profile_elements, :group_metadata
 
-      def initialize(name, ig_resources, resource, profile_elements)
+      def initialize(name, ig_resources, profile_elements, group_metadata)
         self.name = name
         self.ig_resources = ig_resources
-        self.resource = resource
         self.profile_elements = profile_elements
+        self.group_metadata = group_metadata
       end
 
       def search_definition
@@ -26,6 +26,10 @@ module USCoreTestKit
           }.compact
       end
 
+      def resource
+        group_metadata[:resource]
+      end
+
       def param
         @param ||= ig_resources.search_param_by_resource_and_name(resource, name)
       end
@@ -162,11 +166,50 @@ module USCoreTestKit
       end
 
       def values
-          value_extractor.values_from_slicing(profile_element, type).presence ||
-          value_extractor.values_from_required_binding(profile_element).presence ||
-          value_extractor.values_from_value_set_binding(profile_element).presence ||
-          values_from_resource_metadata(paths).presence ||
-          []
+        values_from_must_supports(profile_element).presence ||
+        value_extractor.values_from_fixed_codes(profile_element, type).presence ||
+        #value_extractor.values_from_required_binding(profile_element).presence ||
+        value_extractor.values_from_value_set_binding(profile_element).presence ||
+        values_from_resource_metadata(paths).presence ||
+        []
+      end
+
+      def values_from_must_supports(profile_element)
+        return if profile_element.nil?
+
+        short_path = profile_element.path.split('.', 2)[1]
+
+        values_from_must_support_slices(profile_element, short_path, true).presence ||
+        values_from_must_support_slices(profile_element, short_path, false).presence ||
+        values_from_must_support_elements(short_path).presence ||
+        []
+      end
+
+      def values_from_must_support_slices(profile_element, short_path, mandatory_slice_only)
+        group_metadata[:must_supports][:slices]
+          .select { |slice| [short_path, "#{short_path}.coding"].include?(slice[:path]) }
+          .map do |slice|
+            slice_element = profile_elements.find { |element| slice[:slice_id] == element.id }
+            next if (profile_element.min > 0 && slice_element.min == 0 && mandatory_slice_only)
+
+            case slice[:discriminator][:type]
+            when 'patternCoding', 'patternCodeableConcept'
+              slice[:discriminator][:code]
+            when 'requiredBinding'
+              slice[:discriminator][:values]
+            when 'value'
+              slice[:discriminator][:values]
+                .select { |value| value[:path] == 'coding.code' }
+                .map { |value| value[:value] }
+            end
+          end
+          .compact.flatten
+      end
+
+      def values_from_must_support_elements(short_path)
+        group_metadata[:must_supports][:elements]
+          .select { |element| element[:path] == "#{short_path}.coding.code" }
+          .map { |element| element[:fixed_value] }
       end
 
       def values_from_resource_metadata(paths)

data/lib/us_core_test_kit/generator/search_metadata_extractor.rb

@@ -6,13 +6,13 @@ module USCoreTestKit
       COMBO_EXTENSION_URL =
         'http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination'.freeze
 
-      attr_accessor :resource_capabilities, :ig_resources, :resource, :profile_elements
+      attr_accessor :resource_capabilities, :ig_resources, :profile_elements, :group_metadata
 
-      def initialize(resource_capabilities, ig_resources, resource, profile_elements)
+      def initialize(resource_capabilities, ig_resources, profile_elements, group_metadata)
         self.resource_capabilities = resource_capabilities
         self.ig_resources = ig_resources
-        self.resource = resource
         self.profile_elements = profile_elements
+        self.group_metadata = group_metadata
       end
 
       def searches
@@ -66,7 +66,7 @@ module USCoreTestKit
       def search_definitions
         search_param_names.each_with_object({}) do |name, definitions|
           definitions[name.to_sym] =
-            SearchDefinitionMetadataExtractor.new(name, ig_resources, resource, profile_elements).search_definition
+            SearchDefinitionMetadataExtractor.new(name, ig_resources, profile_elements, group_metadata).search_definition
         end
       end
     end

data/lib/us_core_test_kit/generator/special_cases.rb

@@ -1,20 +1,65 @@
 module USCoreTestKit
   class Generator
     module SpecialCases
-      RESOURCES_TO_EXCLUDE = [
-        'Location',
-        'Medication',
-        'PractitionerRole'
-      ].freeze
+      RESOURCES_TO_EXCLUDE = {
+        'Location' => ['v311', 'v400', 'v501', 'v610'],
+        'Medication' => ['v311', 'v400', 'v501', 'v610', 'v700_ballot'],
+        'PractitionerRole' => ['v311', 'v400']
+      }.freeze
 
       PROFILES_TO_EXCLUDE = [
         'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-survey',
         'http://hl7.org/fhir/us/core/StructureDefinition/us-core-vital-signs'
       ].freeze
 
+      OPTIONAL_RESOURCES = [
+        'PractitionerRole',
+        'QuestionnaireResponse'
+      ].freeze
+
+      OPTIONAL_PROFILES = [
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-simple-observation'
+      ].freeze
+
+      NON_USCDI_RESOURCES = {
+        'Encounter' => ['v311', 'v400'],
+        'Location' => ['v311', 'v400', 'v501', 'v610'],
+        'Organization' => ['v311', 'v400', 'v501', 'v610', 'v700_ballot'],
+        'Practitioner' => ['v311', 'v400'],
+        'PractitionerRole' => ['v311', 'v400', 'v501', 'v610', 'v700_ballot'],
+        'Provenance' => ['v311', 'v400', 'v501', 'v610', 'v700_ballot'],
+        'RelatedPerson' => ['v501', 'v610', 'v700_ballot'],
+        'Specimen' => ['v610', 'v700_ballot']
+      }.freeze
+
+      SEARCHABLE_DELAYED_RESOURCES = {
+        'Location' => ['v700_ballot'],
+        'Practitioner' => ['v501', 'v610', 'v700_ballot']
+      }.freeze
+
+      ALL_VERSION_CATEGORY_FIRST_PROFILES = [
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-careplan',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-lab',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-diagnosticreport-note',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-clinical-result',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-clinical-test',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-imaging',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-sdoh-assessment',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-survey',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-simple-observation'
+      ].freeze
+
+      VERSION_SPECIFIC_CATEGORY_FIRST_PROFILES = {
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-encounter-diagnosis' => ['v610', 'v700_ballot'],
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition-problems-health-concerns' => ['v610', 'v700_ballot']
+      }.freeze
+
       class << self
         def exclude_group?(group)
-          RESOURCES_TO_EXCLUDE.include?(group.resource)
+          RESOURCES_TO_EXCLUDE.key?(group.resource) && RESOURCES_TO_EXCLUDE[group.resource].include?(group.reformatted_version)
         end
       end
     end

data/lib/us_core_test_kit/generator/suite_generator.rb

@@ -49,6 +49,10 @@ module USCoreTestKit
         "us_core_#{ig_metadata.reformatted_version}"
       end
 
+      def fhir_api_group_id
+        "us_core_#{ig_metadata.reformatted_version}_fhir_api"
+      end
+
       def title
         "US Core #{ig_metadata.ig_version}"
       end
@@ -68,6 +72,10 @@ module USCoreTestKit
         end
       end
 
+      def test_granular_scopes?
+        ig_metadata.ig_version[1].to_i > 5
+      end
+
       def generate
         File.open(output_file_name, 'w') { |f| f.write(output) }
       end
@@ -110,6 +118,14 @@ module USCoreTestKit
           'us_core_v400_clinical_notes_guidance'
         end
       end
+
+      def granular_scopes_file_name
+        "../../custom_groups/#{ig_metadata.ig_version}/smart_granular_scopes_group"
+      end
+
+      def granular_scopes_id
+        "us_core_#{ig_metadata.reformatted_version}_smart_granular_scopes"
+      end
     end
   end
 end

data/lib/us_core_test_kit/generator/value_extractor.rb

@@ -9,13 +9,6 @@ module USCoreTestKit
         self.profile_elements = profile_elements
       end
 
-      def values_from_slicing(profile_element, type)
-        (
-          values_from_fixed_codes(profile_element, type) +
-          values_from_pattern_coding(profile_element, type) +
-          values_from_pattern_codeable_concept(profile_element, type)
-        ).uniq
-      end
 
       def values_from_required_binding(profile_element)
         return [] unless profile_element&.max == '*'

data/lib/us_core_test_kit/generator.rb

@@ -3,6 +3,9 @@ require 'inferno/ext/fhir_models'
 
 require_relative 'generator/ig_loader'
 require_relative 'generator/ig_metadata_extractor'
+require_relative 'generator/granular_scope_group_generator'
+require_relative 'generator/granular_scope_resource_type_group_generator'
+require_relative 'generator/granular_scope_test_generator'
 require_relative 'generator/group_generator'
 require_relative 'generator/must_support_test_generator'
 require_relative 'generator/provenance_revinclude_search_test_generator'
@@ -41,15 +44,26 @@ module USCoreTestKit
       generate_must_support_tests
       generate_reference_resolution_tests
 
+      generate_granular_scope_tests
+
       generate_groups
 
+      generate_granular_scope_resource_type_groups
+
+      generate_granular_scope_groups
+
       generate_suites
+
+      write_metadata
     end
 
     def extract_metadata
       self.ig_metadata = IGMetadataExtractor.new(ig_resources).extract
 
       FileUtils.mkdir_p(base_output_dir)
+    end
+
+    def write_metadata
       File.open(File.join(base_output_dir, 'metadata.yml'), 'w') do |file|
         file.write(YAML.dump(ig_metadata.to_hash))
       end
@@ -88,10 +102,22 @@ module USCoreTestKit
       ProvenanceRevincludeSearchTestGenerator.generate(ig_metadata, base_output_dir)
     end
 
+    def generate_granular_scope_tests
+      GranularScopeTestGenerator.generate(ig_metadata, base_output_dir)
+    end
+
     def generate_groups
       GroupGenerator.generate(ig_metadata, base_output_dir)
     end
 
+    def generate_granular_scope_resource_type_groups
+      GranularScopeResourceTypeGroupGenerator.generate(ig_metadata, base_output_dir)
+    end
+
+    def generate_granular_scope_groups
+      GranularScopeGroupGenerator.generate(ig_metadata, base_output_dir)
+    end
+
     def generate_suites
       SuiteGenerator.generate(ig_metadata, base_output_dir)
     end

data/lib/us_core_test_kit/granular_scope_checker.rb

@@ -0,0 +1,138 @@
+module USCoreTestKit
+  module GranularScopeChecker
+    def self.included(klass)
+      klass.input(:received_scopes)
+      klass.attr_accessor :previous_requests
+    end
+
+    def run_scope_check_test
+      assert granular_scopes.present?, "No granular scopes were received for #{resource_type} resources"
+
+      load_previous_requests
+
+      skip_if previous_requests.blank?,
+              "No #{resource_type} searches with search params #{search_param_names.join(' & ')} found"
+
+      previous_request_resources.each do |previous_request, all_previous_resources|
+        search_method = previous_request.verb.to_sym
+        params = search_method == :get ? previous_request.query_parameters : Hash[URI.decode_www_form(previous_request.request_body)]
+        fhir_search(resource_type, params:, search_method:)
+
+        found_resources =
+          if request.status != 200
+            []
+          else
+            fetch_all_bundled_resources
+          end
+
+        mismatched_ids = mismatched_resource_ids(found_resources)
+
+        assert mismatched_ids.empty?,
+               'Resources with the following ids were received even though they do not match the ' \
+               "granted granular scopes: #{mismatched_ids.join(', ')}"
+
+        found_ids = found_resources.map(&:id)
+        previous_ids = expected_resource_ids(all_previous_resources)
+        missing_ids = previous_ids - found_ids
+
+        assert missing_ids.empty?,
+               'Resources with the following ids were received when using resource-level scopes, ' \
+               "but not when using granular scopes: #{missing_ids.join(', ')}"
+
+        unexpected_ids = found_ids - previous_ids
+
+        assert unexpected_ids.empty?,
+               'Resources with the following ids were received when using granular scopes, ' \
+               "but not when using resource-level scopes: #{unexpected_ids.join(', ')}"
+      end
+    end
+
+    def previous_request_resources
+      first_request = previous_requests.first
+      next_page_url = nil
+      hash = Hash.new { |hash, key| hash[key] = [] }
+      previous_requests.each_with_object(hash) do |request, request_resource_hash|
+        request_resources =
+          if request.status == 200
+            request.resource.entry.map(&:resource).select { |resource| resource.resourceType == resource_type }
+          else
+            []
+          end
+
+        first_request = request if request.url != next_page_url
+
+        request_resource_hash[first_request].concat(request_resources)
+
+        next if request.resource&.resourceType != 'Bundle'
+
+        next_page_url = request.resource&.link&.find { |link| link.relation == 'next' }&.url
+      end
+    end
+
+    def granular_scopes
+      @granular_scopes ||=
+        received_scopes
+          .split(' ')
+          .select do |scope|
+            (scope.start_with?("patient/#{resource_type}") || scope.start_with?("user/#{resource_type}")) &&
+              scope.include?('?')
+          end
+    end
+
+    def granular_scope_search_params
+      @granular_scope_search_params ||=
+        granular_scopes.map do |scope|
+          _, granular_scope = scope.split('?')
+          name, value = granular_scope.split('=')
+
+          {
+            name:,
+            value:
+          }
+        end
+    end
+
+    def load_previous_requests
+      search_params_as_hash = search_param_names.each_with_object({}) do |name, hash|
+        hash[name] = nil
+      end
+      @previous_requests ||=
+        load_tagged_requests(search_params_tag(search_params_as_hash))
+          .sort_by { |request| request.index }
+    end
+
+    def previous_resources(params)
+      previous_requests(params)
+        .flat_map do |request|
+          resource = request.resource
+          if resource.is_a?(FHIR::Bundle)
+            resource.entry&.map(&:resource)
+          else
+            resource
+          end
+        end
+        .compact
+        .select { |resource| resource.resourceType == resource_type }
+    end
+
+    def expected_resource_ids(resources)
+      resources
+        .select do |resource|
+          granular_scope_search_params.any? do |param|
+            resource_matches_param?(resource, param[:name], param[:value])
+          end
+        end
+        .map(&:id)
+    end
+
+    def mismatched_resource_ids(resources)
+      resources
+        .reject do |resource|
+          granular_scope_search_params.any? do |param|
+            resource_matches_param?(resource, param[:name], param[:value])
+          end
+        end
+        .map(&:id)
+    end
+  end
+end

data/lib/us_core_test_kit/igs/us_core_700_ballot/CodeSystem-observation-category.json

@@ -0,0 +1,83 @@
+{
+  "resourceType" : "CodeSystem",
+  "id" : "observation-category",
+  "meta" : {
+    "lastUpdated" : "2020-04-09T21:10:28.568+00:00",
+    "profile" : ["http://hl7.org/fhir/StructureDefinition/shareablecodesystem"]
+  },
+  "text" : {
+    "status" : "generated",
+    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>This code system <code>http://terminology.hl7.org/CodeSystem/observation-category</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">social-history<a name=\"observation-category-social-history\"> </a></td><td>Social History</td><td>Social History Observations define the patient's occupational, personal (e.g., lifestyle), social, familial, and environmental history and health risk factors that may impact the patient's health.</td></tr><tr><td style=\"white-space:nowrap\">vital-signs<a name=\"observation-category-vital-signs\"> </a></td><td>Vital Signs</td><td>Clinical observations measure the body's basic functions such as blood pressure, heart rate, respiratory rate, height, weight, body mass index, head circumference, pulse oximetry, temperature, and body surface area.</td></tr><tr><td style=\"white-space:nowrap\">imaging<a name=\"observation-category-imaging\"> </a></td><td>Imaging</td><td>Observations generated by imaging. The scope includes observations regarding plain x-ray, ultrasound, CT, MRI, angiography, echocardiography, and nuclear medicine.</td></tr><tr><td style=\"white-space:nowrap\">laboratory<a name=\"observation-category-laboratory\"> </a></td><td>Laboratory</td><td>The results of observations generated by laboratories.  Laboratory results are typically generated by laboratories providing analytic services in areas such as chemistry, hematology, serology, histology, cytology, anatomic pathology (including digital pathology), microbiology, and/or virology. These observations are based on analysis of specimens obtained from the patient and submitted to the laboratory.</td></tr><tr><td style=\"white-space:nowrap\">procedure<a name=\"observation-category-procedure\"> </a></td><td>Procedure</td><td>Observations generated by other procedures.  This category includes observations resulting from interventional and non-interventional procedures excluding laboratory and imaging (e.g., cardiology catheterization, endoscopy, electrodiagnostics, etc.).  Procedure results are typically generated by a clinician to provide more granular information about component observations made during a procedure.  An example would be when a gastroenterologist reports the size of a polyp observed during a colonoscopy.</td></tr><tr><td style=\"white-space:nowrap\">survey<a name=\"observation-category-survey\"> </a></td><td>Survey</td><td>Assessment tool/survey instrument observations (e.g., Apgar Scores, Montreal Cognitive Assessment (MoCA)).</td></tr><tr><td style=\"white-space:nowrap\">exam<a name=\"observation-category-exam\"> </a></td><td>Exam</td><td>Observations generated by physical exam findings including direct observations made by a clinician and use of simple instruments and the result of simple maneuvers performed directly on the patient's body.</td></tr><tr><td style=\"white-space:nowrap\">therapy<a name=\"observation-category-therapy\"> </a></td><td>Therapy</td><td>Observations generated by non-interventional treatment protocols (e.g. occupational, physical, radiation, nutritional and medication therapy)</td></tr><tr><td style=\"white-space:nowrap\">activity<a name=\"observation-category-activity\"> </a></td><td>Activity</td><td>Observations that measure or record any bodily activity that enhances or maintains physical fitness and overall health and wellness.  Not under direct supervision of practitioner such as a physical therapist. (e.g., laps swum, steps, sleep data)</td></tr></table></div>"
+  },
+  "extension" : [{
+    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
+    "valueCode" : "oo"
+  }],
+  "url" : "http://terminology.hl7.org/CodeSystem/observation-category",
+  "identifier" : [{
+    "system" : "urn:ietf:rfc:3986",
+    "value" : "urn:oid:2.16.840.1.113883.4.642.1.1125"
+  }],
+  "version" : "0.1.0",
+  "name" : "ObservationCategoryCodes",
+  "title" : "Observation Category Codes",
+  "status" : "draft",
+  "experimental" : false,
+  "date" : "2023-02-25T11:07:30-07:00",
+  "publisher" : "FHIR Project team",
+  "contact" : [{
+    "telecom" : [{
+      "system" : "url",
+      "value" : "http://hl7.org/fhir"
+    }]
+  }],
+  "description" : "Observation Category codes.",
+  "caseSensitive" : true,
+  "valueSet" : "http://terminology.hl7.org/ValueSet/observation-category",
+  "content" : "complete",
+  "concept" : [{
+    "code" : "social-history",
+    "display" : "Social History",
+    "definition" : "Social History Observations define the patient's occupational, personal (e.g., lifestyle), social, familial, and environmental history and health risk factors that may impact the patient's health."
+  },
+  {
+    "code" : "vital-signs",
+    "display" : "Vital Signs",
+    "definition" : "Clinical observations measure the body's basic functions such as blood pressure, heart rate, respiratory rate, height, weight, body mass index, head circumference, pulse oximetry, temperature, and body surface area."
+  },
+  {
+    "code" : "imaging",
+    "display" : "Imaging",
+    "definition" : "Observations generated by imaging. The scope includes observations regarding plain x-ray, ultrasound, CT, MRI, angiography, echocardiography, and nuclear medicine."
+  },
+  {
+    "code" : "laboratory",
+    "display" : "Laboratory",
+    "definition" : "The results of observations generated by laboratories.  Laboratory results are typically generated by laboratories providing analytic services in areas such as chemistry, hematology, serology, histology, cytology, anatomic pathology (including digital pathology), microbiology, and/or virology. These observations are based on analysis of specimens obtained from the patient and submitted to the laboratory."
+  },
+  {
+    "code" : "procedure",
+    "display" : "Procedure",
+    "definition" : "Observations generated by other procedures.  This category includes observations resulting from interventional and non-interventional procedures excluding laboratory and imaging (e.g., cardiology catheterization, endoscopy, electrodiagnostics, etc.).  Procedure results are typically generated by a clinician to provide more granular information about component observations made during a procedure.  An example would be when a gastroenterologist reports the size of a polyp observed during a colonoscopy."
+  },
+  {
+    "code" : "survey",
+    "display" : "Survey",
+    "definition" : "Assessment tool/survey instrument observations (e.g., Apgar Scores, Montreal Cognitive Assessment (MoCA))."
+  },
+  {
+    "code" : "exam",
+    "display" : "Exam",
+    "definition" : "Observations generated by physical exam findings including direct observations made by a clinician and use of simple instruments and the result of simple maneuvers performed directly on the patient's body."
+  },
+  {
+    "code" : "therapy",
+    "display" : "Therapy",
+    "definition" : "Observations generated by non-interventional treatment protocols (e.g. occupational, physical, radiation, nutritional and medication therapy)"
+  },
+  {
+    "code" : "activity",
+    "display" : "Activity",
+    "definition" : "Observations that measure or record any bodily activity that enhances or maintains physical fitness and overall health and wellness.  Not under direct supervision of practitioner such as a physical therapist. (e.g., laps swum, steps, sleep data)"
+  }]
+}