cqm-validators 0.1.0

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "cqm_validators"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/cqm_validators.gemspec

@@ -0,0 +1,28 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "cqm_validators/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "cqm-validators"
+  spec.version       = CqmValidators::VERSION
+  spec.authors       = ["Laura", "Michael O'Keefe"]
+  spec.email         = ["laclark@mitre.org", 'mokeefe@mitre.org']
+  spec.license       = 'Apache-2.0'
+
+  spec.summary       = "new cqm validator library"
+  spec.description   = "new cqm validator library"
+  spec.homepage      = "https://github.com/projecttacoma/cqm-validators"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "nokogiri", "~>1.8.2"
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/lib/base_validator.rb

@@ -0,0 +1,22 @@
+module CqmValidators
+      module BaseValidator
+  
+        def build_error(msg, loc, file_name)
+          ValidationError.new(message: msg, location: loc, file_name: file_name, validator: @name)
+        end
+  
+        def get_document(input)
+          doc = case input
+          when File
+            input.read
+          when Nokogiri::XML::Document
+            return input
+          else
+            input
+          end
+          Nokogiri::XML(doc.to_s) { |conf| conf.strict.nonet.noblanks } #grumble, grumble nokogiri java @SS 
+        end
+      end
+  
+end
+  

data/lib/cqm_validators.rb

@@ -0,0 +1,15 @@
+require "cqm_validators/version"
+require 'reported_result_extractor'
+require 'base_validator'
+require 'data_validator'
+require 'measure_validator'
+require 'performance_rate_validator'
+require 'qrda_qdm_template_validator'
+require 'schema_validator'
+require 'schematron_validator'
+require 'validators'
+require "schematron/c_processor"
+
+module CqmValidators
+  # Your code goes here...
+end

data/lib/cqm_validators/version.rb

@@ -0,0 +1,3 @@
+module CqmValidators
+  VERSION = "0.1.0"
+end

data/lib/data_validator.rb

@@ -0,0 +1,82 @@
+module CqmValidators
+      class DataValidator
+        include BaseValidator
+  
+        HL7_QRDA_OIDS = ["2.16.840.1.113883.3.221.5",
+                         "2.16.840.1.113883.3.88.12.3221.8.7",
+                         "2.16.840.1.113883.3.88.12.3221.8.9",
+                         "2.16.840.1.113883.1.11.12839",
+                         "2.16.840.1.113883.3.88.12.3221.8.11",
+                         "2.16.840.1.113883.3.88.12.3221.6.2",
+                         "2.16.840.1.113883.11.20.9.40",
+                         "2.16.840.1.113883.11.20.9.23",
+                         "2.16.840.1.113883.3.88.12.3221.7.4",
+                         "2.16.840.1.113883.11.20.9.18",
+                         "2.16.840.1.113883.11.20.9.22",
+                         "2.16.840.1.113883.1.11.16866",
+                         "2.16.840.1.113883.1.11.20275",
+                         "2.16.840.1.113883.11.20.9.34",
+                         "2.16.840.1.113883.3.88.12.3221.7.2",
+                         "2.16.840.1.113883.3.88.12.80.17",
+                         "2.16.840.1.113883.3.88.12.80.22",
+                         "2.16.840.1.113883.3.88.12.80.64",
+                         "2.16.840.1.113883.3.88.12.3221.6.8",
+                         "2.16.840.1.113883.1.11.78",
+                         "2.16.840.1.113883.11.20.9.25",
+                         "2.16.840.1.113883.11.20.9.39",
+                         "2.16.840.1.113883.3.88.12.80.32",
+                         "2.16.840.1.113883.11.20.9.21",
+                         "2.16.840.1.113883.3.88.12.80.68",
+                         "2.16.840.1.113883.1.11.20.12",
+                         "2.16.840.1.113883.11.20.9.24",
+                         "2.16.840.1.113883.11.20.9.41",
+                         "2.16.840.1.113883.1.11.16926",
+                         "2.16.840.1.113883.1.11.12212",
+                         "2.16.840.1.113883.1.11.19185",
+                         "2.16.840.1.113883.1.11.14914",
+                         "2.16.840.1.114222.4.11.837",
+                         "2.16.840.1.113883.1.11.19563",
+                         "2.16.840.1.113883.1.11.11526",
+                         "2.16.840.1.113883.11.20.9.20",
+                         "2.16.840.1.113883.3.88.12.80.2",
+                         "2.16.840.1.113883.3.88.12.80.63",
+                         "2.16.840.1.113883.1.11.12249",
+                         "2.16.840.1.113883.1.11.1",
+                         "2.16.840.1.113883.1.11.12199",
+                         "2.16.840.1.113883.11.20.9.33",
+                         "2.16.840.1.114222.4.11.1066",
+                         "2.16.840.1.113883.1.11.19579"]
+  
+        def initialize(bundle, measure_ids)
+          @bundle = bundle
+          measures = @bundle.measures.in(hqmf_id: measure_ids)
+  
+          @oids = measures.collect{|m| m.oids}.flatten.uniq + HL7_QRDA_OIDS
+        end
+  
+        def validate(file, options={})
+          doc = get_document(file)
+  
+          doc.xpath("//*[@sdtc:valueSet]").inject([]) do |errors, node|
+            oid = node.at_xpath("@sdtc:valueSet")
+            vs = @bundle.value_sets.where({"oid" => oid}).first
+            code = node.at_xpath("@code")
+            code_system = node.at_xpath("@codeSystem")
+            null_flavor = node.at_xpath("@nullFlavor")
+            if !vs
+              errors << build_error("The valueset #{oid} declared in the document cannot be found", node.path, options[:file_name])
+            elsif !@oids.include?(oid.value)
+              errors << build_error("File appears to contain data criteria outside that required by the measures. Valuesets in file not in measures tested #{oid}'",
+                          node.path, options[:file_name])
+            elsif vs.concepts.where({"code" => code, "code_system"=>code_system}).count() == 0
+              if !null_flavor
+                errors << build_error("The code #{code} in codeSystem #{code_system} cannot be found in the declared valueset #{oid}",
+                  node.path, options[:file_name])
+              end
+            end
+            errors
+          end
+        end
+  
+      end
+end

data/lib/measure_validator.rb

@@ -0,0 +1,130 @@
+module CqmValidators
+      class MeasureValidator
+        include BaseValidator
+  
+        def initialize(template_oid)
+          @template_oid = template_oid
+  
+        end
+  
+        def validate(file, data={})
+      @errors = []
+      @doc = get_document(file)
+      @doc.root.add_namespace_definition('cda', 'urn:hl7-org:v3')
+      measure_ids = HealthDataStandards::CQM::Measure.all.map(&:hqmf_id)
+      doc_measure_ids = @doc.xpath(measure_selector).map(&:value).map(&:upcase)
+      #list of all of the set ids in the QRDA
+      doc_neutral_ids = @doc.xpath(neutral_measure_selector).map(&:value).map(&:upcase).sort
+      #list of all of the setids in the QRDA that are also in the bundle, includes duplicates if code appears twice in document
+      bundle_neutral_ids = HealthDataStandards::CQM::Measure.distinct(:hqmf_set_id)
+      doc_bundle_neutral_ids = doc_neutral_ids - (doc_neutral_ids - bundle_neutral_ids)
+      validate_measure_ids(doc_measure_ids, measure_ids, data)
+      validate_set_ids(doc_neutral_ids, doc_bundle_neutral_ids, data)
+      if validate_no_repeating_measure_population_ids(data)
+          validate_measure_ids_set_ids_usage(doc_bundle_neutral_ids, doc_measure_ids, data)
+      end
+  
+      @errors
+        end
+  
+        private
+  
+          #returns true if there are no repeating measures, check to see that the measure id usage is correct
+          def validate_no_repeating_measure_population_ids(data={})
+            noDuplicateMeasures = true
+            doc_population_ids = @doc.xpath(measure_population_selector).map(&:value).map(&:upcase).sort
+            duplicates = doc_population_ids.group_by{ |e| e }.select { |k, v| v.size > 1 }.map(&:first)
+            duplicates.each do |duplicate|
+              begin
+                measureId = @doc.xpath(find_measure_node_for_population(duplicate)).at_xpath("cda:reference/cda:externalDocument/cda:id[./@root='2.16.840.1.113883.4.738']/@extension")
+                @errors << build_error("Population #{duplicate} for Measure #{measureId.value} reported more than once", "/", data[:file_name])
+              rescue
+                @errors << build_error("Population #{duplicate} for reported more than once", "/", data[:file_name])
+              end
+              noDuplicateMeasures = false
+            end
+            return noDuplicateMeasures
+        end
+  
+        def validate_measure_ids(doc_measure_ids, measure_ids, data={})
+      (doc_measure_ids - measure_ids).map do |hqmf_id|
+        @errors << build_error("Invalid HQMF ID Found: #{hqmf_id}", "/", data[:file_name])
+      end
+        end
+  
+        def validate_set_ids(doc_neutral_ids, doc_bundle_neutral_ids, data={})
+      #an error will be returned for all of the setids that are in the QRDA that aren't in the bundle
+      (doc_neutral_ids - doc_bundle_neutral_ids).map do |hqmf_set_id|
+        @errors << build_error("Invalid HQMF Set ID Found: #{hqmf_set_id}", "/", data[:file_name])
+      end
+        end
+  
+      #does not work if the same measure is reported more than once, nested under the repeating measures test
+        def validate_measure_ids_set_ids_usage(doc_bundle_neutral_ids, doc_measure_ids, data={})
+      #for each of the setIds that are in the bundle, check that they are for the correct measure id
+      entries_start_position = @doc.xpath(first_entry)
+      previous = ""
+      index = 1
+      doc_bundle_neutral_ids.each do |hqmf_set_id|
+        #selects the measure id that is in the same entry as the set id
+        #iterates through multiple instances of the same setId
+        if previous == hqmf_set_id
+          index = index + 1
+        else
+          index = 1
+        end
+        measure_id_entry = doc_measure_ids[(@doc.xpath(location_of_set_id(hqmf_set_id,index)) - entries_start_position)]
+        previous = hqmf_set_id
+        #queries database to see if there is a measure with the combindation of setId and measureId
+        if HealthDataStandards::CQM::Measure.where(hqmf_id: measure_id_entry, hqmf_set_id: hqmf_set_id).length() == 0
+          @errors << build_error("Invalid HQMF Set ID Found: #{hqmf_set_id} for HQMF ID: #{measure_id_entry}", "/", data[:file_name])
+        end
+      end
+        end
+  
+        def measure_selector
+      "/cda:ClinicalDocument/cda:component/cda:structuredBody/cda:component/cda:section/cda:entry" +
+      "/cda:organizer[./cda:templateId[@root='#{@template_oid}']]/cda:reference[@typeCode='REFR']" +
+          "/cda:externalDocument[@classCode='DOC']/cda:id[@root='2.16.840.1.113883.4.738']/@extension"
+        end
+  
+        #finds all of the setIds in the QRDA document
+        def neutral_measure_selector
+      "/cda:ClinicalDocument/cda:component/cda:structuredBody/cda:component/cda:section/cda:entry" +
+      "/cda:organizer[./cda:templateId[@root='#{@template_oid}']]/cda:reference[@typeCode='REFR']" +
+      "/cda:externalDocument[@classCode='DOC']/cda:setId/@root"
+        end
+  
+        #finds the node index of the first entry element in the measure template
+        def first_entry
+      "count(//cda:entry[cda:organizer[./cda:templateId[@root='#{@template_oid}']]" +
+      "/cda:reference[@typeCode='REFR']/cda:externalDocument[@classCode='DOC']" +
+      "/cda:id[@root='2.16.840.1.113883.4.738']][1]/preceding-sibling::*)+1"
+        end
+  
+        #finds the node index of the extry that the specified setId is in, index is used if the same setId appears twice
+        def location_of_set_id(set_id,index)
+      "count(//cda:entry[cda:organizer[./cda:templateId[@root='#{@template_oid}']]" +
+      "/cda:reference[@typeCode='REFR']/cda:externalDocument[@classCode='DOC']" +
+      "/cda:setId[@root[contains(translate(.,'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLOMNOPQRSTUVWXYZ')" +
+      ",'#{set_id}')]]][#{index}]/preceding-sibling::*)+1"
+        end
+  
+        
+        def measure_population_selector
+        "/cda:ClinicalDocument/cda:component/cda:structuredBody/cda:component/cda:section/cda:entry" +
+        "/cda:organizer[./cda:templateId[@root='2.16.840.1.113883.10.20.27.3.1']]/cda:component" +
+        "/cda:observation[./cda:templateId[@root='2.16.840.1.113883.10.20.27.3.5']]/cda:reference" + 
+        "/cda:externalObservation/cda:id/@root"
+        end
+  
+        def find_measure_node_for_population(id)
+        "/cda:ClinicalDocument/cda:component/cda:structuredBody/cda:component/cda:section/cda:entry" +
+        "/cda:organizer[ ./cda:templateId[@root='2.16.840.1.113883.10.20.27.3.1']" +
+        "and ./cda:component/cda:observation[./cda:templateId[@root='2.16.840.1.113883.10.20.27.3.5']]/cda:reference" +
+        "/cda:externalObservation/cda:id[@root[contains(translate(.,'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLOMNOPQRSTUVWXYZ')" +
+        ",'#{id.upcase}')]]]"
+        end
+      end
+end
+  

data/lib/performance_rate_validator.rb

@@ -0,0 +1,92 @@
+require_relative "reported_result_extractor"
+module CqmValidators
+  class PerformanceRateValidator
+    include ReportedResultExtractor
+    include BaseValidator
+    
+
+    def initialize()
+
+
+    
+    end
+
+    # Nothing to see here - Move along
+    def validate(file, data = {})
+      errorsList = []
+      document = get_document(file)
+      #grab measure IDs from QRDA file
+      measure_ids = document.xpath(measure_selector).map(&:value).map(&:upcase)
+      measure_ids.each do |measure_id|
+        measures = HealthDataStandards::CQM::Measure.where(id: measure_id)
+        measures.each do |measure|
+          result_key = measure["population_ids"].dup
+          reported_result, errors = extract_results_by_ids(measure['id'], result_key, document)
+          #only check performace rate when there is one
+          if reported_result['PR'] != nil
+            error = check_performance_rates(reported_result, result_key, measure['id'], data)
+            if error != nil
+              errorsList << error
+            end
+          end
+        end
+      end
+      errorsList
+    end
+
+    def calculate_performance_rates(reported_result)
+      #Just in case a measure does not report these populations
+      denex = 0
+      denexcep = 0
+      denom = 0
+      numer = 0
+      if reported_result['DENEX'] != nil
+        denex = reported_result['DENEX']
+      end
+      if reported_result['DENEXCEP'] != nil
+        denexcep = reported_result['DENEXCEP']
+      end
+      if reported_result['DENOM'] != nil
+        denom = reported_result['DENOM']
+      end
+      if reported_result['NUMER'] != nil
+        numer = reported_result['NUMER']
+      end
+      denom = denom -  denex - denexcep
+      pr = 0
+      if denom == 0
+        pr = "NA"
+      else
+        pr = numer / denom.to_f
+      end
+      return pr
+    end
+
+    def check_performance_rates(reported_result, population_ids, measure_id, data = {})
+      expected = calculate_performance_rates(reported_result)
+      _ids = population_ids
+      if expected == "NA"
+        if reported_result['PR']['nullFlavor'] != "NA"
+          return build_error("Reported Performance Rate for Numerator #{_ids['NUMER']} should be NA", "/", data[:file_name])
+        end
+      else
+        if reported_result['PR']['nullFlavor'] == "NA"
+          return build_error("Reported Performance Rate for Numerator #{_ids['NUMER']} should not be NA", "/", data[:file_name])
+        else
+          if (reported_result['PR']['value'].split('.',2).last.size > 6)
+            return build_error("Reported Performance Rate SHALL not have a precision greater than .000001 ", "/", data[:file_name])
+          elsif (reported_result['PR']['value'].to_f - expected.round(6)).abs > 0.0000001
+            return build_error("Reported Performance Rate of #{reported_result['PR']['value']} for Numerator #{_ids['NUMER']} does not match expected value of #{expected.round(6)}.", "/", data[:file_name])
+          end
+        end
+      end
+    end
+
+    def measure_selector
+  "/cda:ClinicalDocument/cda:component/cda:structuredBody/cda:component/cda:section/cda:entry" +
+  "/cda:organizer[./cda:templateId[@root='2.16.840.1.113883.10.20.27.3.1']]/cda:reference[@typeCode='REFR']" +
+        "/cda:externalDocument[@classCode='DOC']/cda:id[@root='2.16.840.1.113883.4.738']/@extension"
+    end
+
+    end
+end

data/lib/qrda_qdm_template_validator.rb

@@ -0,0 +1,320 @@
+module CqmValidators
+    class QrdaQdmTemplateValidator
+      include BaseValidator
+
+      # Hash of templateIds/extensions specified in the Patient Data Section QDM for QRDA R3
+      QRDA_CAT_1_R3_QDM_OIDS = {
+        '2.16.840.1.113883.10.20.24.3.1' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.2' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.3' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.4' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.5' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.6' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.7' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.8' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.9' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.10' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.121' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.12' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.123' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.125' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.15' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.16' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.17' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.18' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.19' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.105' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.21' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.22' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.23' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.24' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.25' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.26' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.27' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.29' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.30' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.31' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.32' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.33' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.35' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.36' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.37' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.38' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.39' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.41' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.42' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.43' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.44' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.45' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.46' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.47' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.48' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.51' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.54' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.103' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.55' => nil,
+        '2.16.840.1.113883.10.20.24.3.58' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.59' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.60' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.61' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.62' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.63' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.64' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.65' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.67' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.114' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.69' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.75' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.120' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.127' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.122' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.124' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.81' => '2014-12-01',
+        '2.16.840.1.113883.10.20.24.3.82' => '2014-12-01'
+      }
+      # Hash of templateIds/extensions specified in the Patient Data Section QDM for QRDA R3_1
+      QRDA_CAT_1_R3_1_QDM_OIDS = {
+        '2.16.840.1.113883.10.20.24.3.1' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.2' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.3' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.4' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.5' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.6' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.7' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.8' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.130' => nil,
+        '2.16.840.1.113883.10.20.24.3.131' => nil,
+        '2.16.840.1.113883.10.20.24.3.137' => nil,
+        '2.16.840.1.113883.10.20.24.3.15' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.16' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.17' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.18' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.19' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.105' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.21' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.132' => nil,
+        '2.16.840.1.113883.10.20.24.3.133' => nil,
+        '2.16.840.1.113883.10.20.24.3.134' => nil,
+        '2.16.840.1.113883.10.20.24.3.12' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.25' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.26' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.27' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.140' => nil,
+        '2.16.840.1.113883.10.20.24.3.143' => nil,
+        '2.16.840.1.113883.10.20.24.3.29' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.30' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.31' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.32' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.33' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.35' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.36' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.37' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.38' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.39' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.41' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.42' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.43' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.44' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.139' => nil,
+        '2.16.840.1.113883.10.20.24.3.46' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.47' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.48' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.51' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.54' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.103' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.58' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.59' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.55' => nil,
+        '2.16.840.1.113883.10.20.24.3.60' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.61' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.62' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.63' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.64' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.65' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.67' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.69' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.75' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.138' => nil,
+        '2.16.840.1.113883.10.20.24.3.141' => nil,
+        '2.16.840.1.113883.10.20.24.3.142' => nil
+      }
+      # Hash of templateIds/extensions specified in the Patient Data Section QDM for QRDA R4
+      QRDA_CAT_1_R4_QDM_OIDS = {
+        '2.16.840.1.113883.10.20.24.3.1' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.2' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.3' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.4' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.5' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.6' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.7' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.8' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.130' => nil,
+        '2.16.840.1.113883.10.20.24.3.131' => nil,
+        '2.16.840.1.113883.10.20.24.3.137' => '2016-08-01',
+        '2.16.840.1.113883.10.20.24.3.15' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.16' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.17' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.18' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.19' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.105' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.21' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.132' => nil,
+        '2.16.840.1.113883.10.20.24.3.133' => nil,
+        '2.16.840.1.113883.10.20.24.3.134' => nil,
+        '2.16.840.1.113883.10.20.24.3.12' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.140' => nil,
+        '2.16.840.1.113883.10.20.24.3.143' => nil,
+        '2.16.840.1.113883.10.20.24.3.29' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.30' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.31' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.32' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.33' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.35' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.36' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.37' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.38' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.39' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.41' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.42' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.43' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.44' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.139' => nil,
+        '2.16.840.1.113883.10.20.24.3.46' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.47' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.48' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.51' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.54' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.103' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.58' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.59' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.55' => nil,
+        '2.16.840.1.113883.10.20.24.3.60' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.61' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.62' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.63' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.64' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.65' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.67' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.75' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.138' => '2016-08-01',
+        '2.16.840.1.113883.10.20.24.3.141' => nil,
+        '2.16.840.1.113883.10.20.24.3.142' => nil,
+        '2.16.840.1.113883.10.20.24.3.144' => '2016-08-01',
+        '2.16.840.1.113883.10.20.24.3.145' => '2016-08-01'
+      }
+    # Hash of templateIds/extensions specified in the Patient Data Section QDM for QRDA R4
+      QRDA_CAT_1_R5_QDM_OIDS = {
+        '2.16.840.1.113883.10.20.24.3.1' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.2' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.3' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.4' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.5' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.6' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.7' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.8' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.130' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.131' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.137' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.15' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.16' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.17' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.18' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.19' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.105' => '2016-02-01',
+        # '2.16.840.1.113883.10.20.24.3.21' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.132' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.133' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.134' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.12' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.140' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.143' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.29' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.30' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.31' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.32' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.33' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.35' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.36' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.37' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.38' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.39' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.41' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.42' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.43' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.44' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.139' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.46' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.47' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.48' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.51' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.54' => '2016-02-01',
+        '2.16.840.1.113883.10.20.24.3.103' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.58' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.59' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.55' => nil,
+        '2.16.840.1.113883.10.20.24.3.60' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.61' => '2016-02-01', Removed
+        # '2.16.840.1.113883.10.20.24.3.62' => '2016-02-01', Removed
+        '2.16.840.1.113883.10.20.24.3.63' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.64' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.65' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.67' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.75' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.138' => '2017-08-01',
+        # '2.16.840.1.113883.10.20.24.3.141' => nil, Removed
+        # '2.16.840.1.113883.10.20.24.3.142' => nil, Removed
+        '2.16.840.1.113883.10.20.24.3.144' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.145' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.146' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.147' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.114' => '2017-08-01',
+        '2.16.840.1.113883.10.20.24.3.154' => '2017-08-01'
+      }
+      
+      def initialize(qrda_version)
+        @name = 'QRDA QDM Template Validator'
+        @templateshash = case qrda_version
+          when 'r3' then QRDA_CAT_1_R3_QDM_OIDS
+          when 'r3_1' then QRDA_CAT_1_R3_1_QDM_OIDS
+          when 'r4' then QRDA_CAT_1_R4_QDM_OIDS
+          when 'r5' then QRDA_CAT_1_R5_QDM_OIDS
+          end
+      end
+
+      # Validates that a QRDA Cat I file's Patient Data Section QDM (V3) contains entries that conform 
+      # to the QDM approach to QRDA. In contrast to a QRDA Framework Patient Data Section that requires 
+      # but does not specify the structured entries, the Patient Data Section QDM contained entry templates 
+      # have specific requirements to align the quality measure data element type with its corresponding NQF 
+      # QDM HQMF pattern, its referenced value set and potential QDM attributes. 
+      # The result will be an Array of execution errors indicating use of templates that are not valid for the
+      # specified QRDA version
+      def validate(file, data={})
+        @errors = []
+        # if validator does not support the qrda version specified, no checks are made
+        unless @templateshash.nil?
+          @doc = get_document(file)
+          @doc.root.add_namespace_definition('cda', 'urn:hl7-org:v3')
+          extract_entries.each do |entry|
+            # each entry is evaluated separetly.
+            entry_value_for_qrda_version(entry, data)
+          end
+        end
+        @errors
+      end
+
+      def entry_value_for_qrda_version(entry, data={})
+        # an entry may have multiple templateIds
+        tids = entry.xpath('./*/cda:templateId')
+        # an entry only needs one valid templateId to be acceptable
+        unless tids.map { |tid| @templateshash.has_key?(tid['root']) && @templateshash[tid['root']] == tid['extension'] }.include? true
+          msg = "#{tids.map { |tid| "#{tid['root']}:#{tid['extension']}" }} are not valid Patient Data Section QDM entries for this QRDA Version"
+          @errors << build_error(msg, entry.path, data[:file_name])
+        end
+      end
+
+      # returns a list of the patient data entries
+      def extract_entries
+        @doc.xpath('//cda:component/cda:section[cda:templateId/@root="2.16.840.1.113883.10.20.24.2.1"]/cda:entry')
+      end
+    end
+end