test-patient-generator 1.0.2 → 1.1.0

data/lib/tpg/generation/randomizer.rb

@@ -1,11 +1,5 @@
-require 'set'
-
 module HQMF
-  # Contains functions that can be used to randomly generate fields for patients.
-  # Also includes utility functions for randomly generating numbers and dates or choosing options within a range.
   class Randomizer
-    UNIQUE_PATIENT_IDS = Set.new # Used to make sure we don't duplicate randomly generated patient IDs
-    
     # Add trivial demographics info to a Record. Trivial fields are ones that identify a patient as unique to a human eye
     # but have no impact on CQM, e.g. address. This is essentially an upsert, so any preexisting info will be wiped.
     #
@@ -21,7 +15,7 @@ module HQMF
       patient.languages << randomize_language
       patient.first = randomize_first_name(patient.gender) if patient.gender
       patient.last = randomize_last_name
-      patient.medical_record_number = randomize_patient_id
+      patient.medical_record_number = Digest::MD5.hexdigest("#{patient.first} #{patient.last}")
       
       patient
     end
@@ -34,10 +28,10 @@ module HQMF
     # Black persons 12.6%
     # Hispanic 16.3%
     # White 63.7%
-    def self.randomize_race_and_ethnicity
-      race_percent = rand(999)
+    def self.randomize_race_and_ethnicity(percent = nil)
+      percent ||= rand(999)
       
-      case race_percent
+      case percent
       when 0..1
         {race: '2076-8', ethnicity: '2186-5'} # pacific islander
       when 2..10
@@ -73,11 +67,11 @@ module HQMF
     # 00.1% persian
     # 00.1% us sign
     # 03.0% other
-    def self.randomize_language
-      language_percent = rand(999)
+    def self.randomize_language(percent = nil)
+      percent ||= rand(999)
       
-      case language_percent
-      when 0..802 
+      case percent
+      when 0..802
         'en-US' # english
       when 802..925
         'es-US' # spanish
@@ -175,26 +169,17 @@ module HQMF
         'postalCode' => zip
       }.to_json
     end
-
-    # Randomize patient IDs for a given patients. We ensure that this ID is unique.
-    #
-    # @return The same patient with a random, non-duplicate ID assigned.
-    def self.randomize_patient_id
-      # Keep trying to add a new ID to the set. Return the ID when we find one that's unique.
-      loop do
-        id = (0...10).map{ ('0'..'9').to_a[rand(10)] }.join.to_s
-        break id if UNIQUE_PATIENT_IDS.size < UNIQUE_PATIENT_IDS.add(id).size
-      end
-    end
     
     # More accurately, randomize a believable birthdate. Given a patient, find all coded entries that
     # have age-related implications and make sure the patient is at least that old. Since that is complicated,
-    # for now let's just make them 45
+    # for now let's just make them 40
     #
     # @param A patient with coded entries that dictate potential birthdates
     # @return A realistic birthdate for the given patient
     def self.randomize_birthdate(patient)
-      Time.now
+      now = Time.now
+      range = randomize_range(now.advance(years: -40), now.advance(years: -35))
+      range.low.to_time_object
     end
     
     # Randomly generate a Range object that is within a lower and upper bounds. It is guaranteed that the high of the
@@ -202,12 +187,14 @@ module HQMF
     #
     # @param [Time] earliest_time The lowest possible value for the low in this Range. nil implies unbounded.
     # @param [Time] latest_time The highest possible value for the high in this Range. nil implies unbounded.
+    # @param [Hash] maximum_length Optionally used to bound the length of a range. This is a hash that can be passed as a parameter to Time.advance.
     # @return A Range that represents a start time and end time within the acceptable bounds supplied.
-    def self.randomize_range(earliest_time, latest_time)
-      earliest_time ||= Time.now.advance(years: -18)
-      latest_time ||= Time.now.to_i
+    def self.randomize_range(earliest_time, latest_time, maximum_length = nil)
+      earliest_time ||= Time.now.advance(years: -35)
+      latest_time ||= Time.now.advance(days: -1)
       
       low = Time.at(Randomizer.between(earliest_time.to_i, latest_time.to_i))
+      latest_time = low.advance(maximum_length) if maximum_length
       high = Time.at(Randomizer.between(low, latest_time.to_i))
       
       low = Value.new("TS", nil, Value.time_to_ts(low), true, false, false)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: test-patient-generator
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,8 +9,88 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-15 00:00:00.000000000 Z
-dependencies: []
+date: 2012-12-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: health-data-standards
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: hquery-patient-api
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: hqmf-parser
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: hqmf2js
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: qrda_generator
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
 description: A utility to generate patients for unit testing clinical quality measure
   logic. The instructions for generation are guided by HQMF documents and exported
   into various health standards, e.g. C32, CCR.
@@ -21,15 +101,9 @@ extra_rdoc_files: []
 files:
 - lib/test-patient-generator.rb
 - lib/tpg/ext/coded.rb
-- lib/tpg/ext/conjunction.rb
 - lib/tpg/ext/data_criteria.rb
-- lib/tpg/ext/derivation_operator.rb
-- lib/tpg/ext/population_criteria.rb
-- lib/tpg/ext/precondition.rb
 - lib/tpg/ext/range.rb
 - lib/tpg/ext/record.rb
-- lib/tpg/ext/subset_operator.rb
-- lib/tpg/ext/temporal_reference.rb
 - lib/tpg/ext/value.rb
 - lib/tpg/generation/exporter.rb
 - lib/tpg/generation/generator.rb

data/lib/tpg/ext/conjunction.rb

@@ -1,23 +0,0 @@
-module Conjunction
-  module AllTrue
-    # 
-    #
-    # @param [Array] base_patients
-    # @return 
-    def generate(base_patients)
-      preconditions.each do |precondition|
-        precondition.generate(base_patients)
-      end
-    end
-  end
-  
-  # 
-  #
-  # @param [Array] base_patients
-  # @return 
-  module AtLeastOneTrue
-    def generate(base_patients)
-      preconditions.sample.generate(base_patients)
-    end
-  end
-end

data/lib/tpg/ext/derivation_operator.rb

@@ -1,49 +0,0 @@
-module HQMF
-  class DerivationOperator
-    # Perform an intersection between two sets of Ranges (assuming these are timestamps).
-    #
-    # @param [Array] set1 One array of Ranges to be intersected.
-    # @param [Array] set2 The other array of Ranges to be intersected.
-    # @return A new array that contains the shared Ranges between set1 and set2.
-    def self.intersection(set1, set2)
-      # Special cases to account for emptiness
-      return [] if set1.empty? && set2.empty?
-      return set1 if set2.empty?
-      return set2 if set1.empty?
-
-      # Merge each element of the two sets together
-      result = []
-      set1.each do |range1|
-        set2.each do |range2|
-          intersect = range1.intersection(range2)
-          result << intersect unless intersect.nil?
-        end
-      end
-      
-      result
-    end
-    
-    # Perform a union between two sets of Ranges (assuming these are timestamps)
-    #
-    # @param [Array] set1 One array of Ranges to be unioned.
-    # @param [Array] set2 The other array of Ranges to be unioned.
-    # @return A new array tha contains the union of Ranges between set1 and set2.
-    def self.union(set1, set2)
-      # Special cases to account for emptiness
-      return [] if set1.empty? && set2.empty?
-      return set1 if set2.empty?
-      return set2 if set1.empty?
-      
-      # Join each element of the two sets together
-      result = []
-      set1.each do |range1|
-        set2.each do |range2|
-          union = range1.union(range2)
-          result.concat!(union)
-        end
-      end
-      
-      result
-    end
-  end
-end

data/lib/tpg/ext/population_criteria.rb

@@ -1,12 +0,0 @@
-module HQMF
-  class PopulationCriteria
-    # 
-    #
-    # @param [Array] base_patients
-    # @return
-    def generate(base_patients)
-      # All population criteria begin with a single conjunction precondition
-      preconditions.first.generate(base_patients)
-    end
-  end
-end

data/lib/tpg/ext/precondition.rb

@@ -1,23 +0,0 @@
-module HQMF
-  class Precondition
-    # 
-    #
-    # @param [Array] base_patients
-    # @return 
-    def generate(base_patients)
-      # d = HQMF::Generator.hqmf.data_criteria(preconditions[2].preconditions[1].preconditions.first.reference.id)
-      
-      if conjunction?
-        # Include the matching module to override our generation functions
-        conjunction_module = "Conjunction::#{self.conjunction_code.classify}"
-        conjunction_module = conjunction_module.split('::').inject(Kernel) {|scope, name| scope.const_get(name)}
-
-        extend conjunction_module
-        generate(base_patients)
-      elsif reference
-        data_criteria = HQMF::Generator.hqmf.data_criteria(reference.id)
-        data_criteria.generate(base_patients)
-      end
-    end
-  end
-end

data/lib/tpg/ext/subset_operator.rb

@@ -1,7 +0,0 @@
-module HQMF
-  class SubsetOperator
-    def generate(base_patients)
-      
-    end
-  end
-end

data/lib/tpg/ext/temporal_reference.rb

@@ -1,66 +0,0 @@
-module HQMF
-  # Generates a Range to define the timing of a data_criteria
-  class TemporalReference
-    # 
-    #
-    # @param [Array] base_patients
-    # @return 
-    def generate(base_patients)
-      if reference.id == "MeasurePeriod"
-        matching_time = Generator::hqmf.measure_period.clone
-      else
-        # First generate patients for the data criteria that this temporal reference points to
-        data_criteria = Generator::hqmf.data_criteria(reference.id)
-        base_patients = data_criteria.generate(base_patients)
-
-        # Now that the data criteria is defined, we can set our relative time to those generated results
-        matching_time = data_criteria.generation_range.first.clone
-      end
-      
-      # TODO add nils where necessary. Ranges should be unbounded, despite the relative time's potential bounds (unless the type specifies)
-      if range
-        offset = range.try(:clone)
-        
-        case type
-        when "DURING"
-          # TODO differentiate between this and CONCURRENT
-        when "SBS" # Starts before start
-          offset.low.value.insert(0, "-")
-        when "SAS" # Starts after start
-          offset.low = offset.high
-          offset.high = nil
-        when "SBE" # Starts before end
-          offset.low = offset.high
-          offset.high = nil
-          offset.low.value.insert(0, "-")
-          matching_time.low = matching_time.high
-        when "SAE" # Starts after end
-          
-        when "EBS" # Ends before start
-
-        when "EAS" # Ends after start
-
-        when "EBE" # Ends before end
-
-        when "EAE" # Ends after end
-
-        when "SDU" # Starts during
-          matching_time.high.value = nil
-        when "EDU" # Ends during
-
-        when "ECW" # Ends concurrent with
-
-        when "SCW" # Starts concurrent with
-
-        when "CONCURRENT"
-
-        end
-        
-        matching_time = Range.merge_ranges(offset, matching_time)
-      end
-      
-      # Note we return the possible times to the calling data criteria, not patients
-      [matching_time]
-    end
-  end
-end