Class: HQMF2::Generator::ErbContext

Inherits:
OpenStruct
  • Object
show all
Defined in:
lib/hqmf-generator/hqmf-generator.rb

Overview

Utility class used to supply a binding to Erb. Contains utility functions used by the erb templates that are used to generate the HQMF document.

Instance Method Summary collapse

Constructor Details

#initialize(vars) ⇒ ErbContext

Returns a new instance of ErbContext.



27
28
29
30
31
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 27

def initialize(vars)
  super(vars)
  @local_var_names = {}
  @local_var_counter = {}
end

Instance Method Details

#code_for_characteristic(characteristic) ⇒ Object 



285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 285

def code_for_characteristic(characteristic)
  case characteristic
  when :birthtime
    '21112-8'
  when :age
    '424144002'
  when :gender
    '263495000'
  when :languages
    '102902016'
  when :maritalStatus
    '125680007'
  when :race
    '103579009'
  else
    raise "Unknown demographic code [#{characteristic}]"
  end
end

#data_criteria_should_be_grouper?(criteria) ⇒ Boolean

Returns:

  • (Boolean) 


233
234
235
236
237
238
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 233

def data_criteria_should_be_grouper?(criteria)
  return false unless criteria
  return false unless criteria.definition == 'derived'
  return true unless criteria.subset_operators
  criteria.subset_operators.all? {|o| o.supports_grouper_criteria?}
end

#data_criteria_template_name(data_criteria) ⇒ Object 



321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 321

def data_criteria_template_name(data_criteria)
  case data_criteria.definition
  when 'diagnosis', 'diagnosis_family_history'
    'condition_criteria'
  when 'encounter'
    'encounter_criteria'
  when 'procedure', 'risk_category_assessment', 'physical_exam', 'communication_from_patient_to_provider', 'communication_from_provider_to_provider', 'device', 'diagnostic_study', 'intervention'
    if data_criteria.value.nil?
      'procedure_criteria'
    else
      'observation_criteria'
    end
  when 'medication'
    case data_criteria.status
    when 'dispensed', 'ordered'
      'supply_criteria'
    else # active or administered
      'substance_criteria'
    end
  when 'patient_characteristic', 'patient_characteristic_birthdate', 'patient_characteristic_clinical_trial_participant', 'patient_characteristic_expired', 'patient_characteristic_gender', 'patient_characteristic_age', 'patient_characteristic_languages', 'patient_characteristic_marital_status', 'patient_characteristic_race'
    'characteristic_criteria'
  when 'variable'
    'variable_criteria'
  when 'derived'
    if data_criteria_should_be_grouper?(data_criteria)
      'grouper_criteria'
    else
      'observation_criteria'
    end
  else
    'observation_criteria'
  end
end

#element_name_prefix(data_criteria) ⇒ Object 



359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 359

def element_name_prefix(data_criteria)
  type = data_criteria ? data_criteria.type : :observation
  case type
  when :encounters
    'encounter'
  when :procedures
    'procedure'
  when :medications, :allMedications
    'substanceAdministration'
  when :medication_supply
    'supply'
  else
    if data_criteria_should_be_grouper?(data_criteria)
      'grouper'
    else
      'observation'
    end
  end
end

#expression_for_observation(doc, observation) ⇒ Object 



222
223
224
225
226
227
228
229
230
231
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 222

def expression_for_observation(doc,observation)
  pre = observation.preconditions[0]
  if pre && pre.reference
    dc = doc.data_criteria(pre.reference.id)
    children = dc.children_criteria
    if children && children.length == 2
      return "#{children[0]} - #{children[1]}"
    end
  end
end

#get_binding ⇒ Binding

Get a binding that contains all the instance variables

Returns:

  • (Binding) 


35
36
37
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 35

def get_binding
  binding
end

#is_transfer(code) ⇒ Object 



304
305
306
307
308
309
310
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 304

def is_transfer(code)
  if code == "TRANSFER_TO" || code == "TRANSFER_FROM"
    true
  else
    false
  end
end

#oid_for_characteristic(characteristic) ⇒ Object 



312
313
314
315
316
317
318
319
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 312

def oid_for_characteristic(characteristic)
  case characteristic
  when :birthtime
    '2.16.840.1.113883.6.1'
  else
    '2.16.840.1.113883.6.96'
  end
end

#oid_for_name(code_system_name) ⇒ Object 



245
246
247
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 245

def oid_for_name(code_system_name)
  HealthDataStandards::Util::CodeSystemHelper.oid_for_code_system(code_system_name)
end

#percision_unit_for_range(relationship) ⇒ Object 



240
241
242
243
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 240

def percision_unit_for_range(relationship)
  percision_map = {'a'=>'d', 'mo'=>'d', 'wk'=>'d', 'd'=>'d', 'h'=>'min', 'min'=>'min', 's'=>'s'}
  percision_map[relationship.try(:range).try(:high).try(:unit) || relationship.try(:range).try(:low).try(:unit) || "min"]
end

#population_element_prefix(population_criteria_code) ⇒ Object 



379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 379

def population_element_prefix(population_criteria_code)
  case population_criteria_code
  when HQMF::PopulationCriteria::IPP
    'initialPopulation'
  when HQMF::PopulationCriteria::DENOM
    'denominator'
  when HQMF::PopulationCriteria::NUMER
    'numerator'
  when HQMF::PopulationCriteria::NUMEX
    'numeratorExclusion'
  when HQMF::PopulationCriteria::DENEXCEP
    'denominatorException'
  when HQMF::PopulationCriteria::DENEX
    'denominatorExclusion'
  when HQMF::PopulationCriteria::MSRPOPL
    'measurePopulation'
  when HQMF::PopulationCriteria::MSRPOPLEX
    'measurePopulationExclusion'
  when HQMF::PopulationCriteria::OBSERV
     'measureObservation'
  when HQMF::PopulationCriteria::STRAT
     'stratifier'
  else
    raise "Unknown population criteria type #{population_criteria_code}"
  end
end

#reference_element_name(id) ⇒ Object 



249
250
251
252
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 249

def reference_element_name(id)
  referenced_criteria = doc.data_criteria(id)
  element_name_prefix(referenced_criteria)
end

#reference_type_name(id) ⇒ Object 



254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 254

def reference_type_name(id)
  referenced_criteria = doc.data_criteria(id)
  type = nil
  if referenced_criteria
    type = referenced_criteria.type
  elsif id=="MeasurePeriod"
    type = :observation
  end
  if !type
    raise "No data criteria with ID: #{id}"
  end
  case type
  when :encounters
    'ENC'
  when :procedures
    'PROC'
  when :medications, :allMedications
    'SBADM'
  when :medication_supply
    'SPLY'
  when :observation
     'OBS'
  else
    if data_criteria_should_be_grouper?(referenced_criteria)
      'GROUPER'
    else
      'OBS'
    end
  end
end

#section_name(data_criteria) ⇒ Object 



355
356
357
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 355

def section_name(data_criteria)
  data_criteria.definition.to_s
end

#temporal_relationship_attribute_effective_time(field) ⇒ Object 



205
206
207
208
209
210
211
212
213
214
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 205

def temporal_relationship_attribute_effective_time(field)
  {facility_arrival: 'low',
  facility_departure: 'high',
  discharge_time: 'high',
  admit_time: 'low',
  start_date: 'low',
  end_date: 'high',
  incision_time: 'low',
  removal_time: 'high'}[HQMF::DataCriteria::FIELDS[field][:coded_entry_method]]
end

#xml_for_attribute(attribute) ⇒ Object 



61
62
63
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 61

def xml_for_attribute(attribute)
  HQMF2::Generator.render_template('attribute', {'attribute' => attribute})
end

#xml_for_code(criteria, element_name = 'code', include_type = true) ⇒ Object 



91
92
93
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 91

def xml_for_code(criteria, element_name='code', include_type=true)
  HQMF2::Generator.render_template('code', {'doc' => doc, 'criteria' => criteria, 'name' => element_name, 'include_type' => include_type})
end

#xml_for_data_criteria(data_criteria, is_source_data_criteria) ⇒ Object 



165
166
167
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 165

def xml_for_data_criteria(data_criteria, is_source_data_criteria)
  HQMF2::Generator.render_template(data_criteria_template_name(data_criteria), {'doc' => doc, 'criteria' => data_criteria, 'is_source_data_criteria' => is_source_data_criteria})
end

#xml_for_derivation(data_criteria) ⇒ Object 



95
96
97
98
99
100
101
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 95

def xml_for_derivation(data_criteria)
  xml = ''
  if data_criteria.derivation_operator
    xml = HQMF2::Generator.render_template('derivation', {'doc' => doc, 'criteria' => data_criteria})
  end
  xml
end

#xml_for_description(data_criteria) ⇒ Object 



139
140
141
142
143
144
145
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 139

def xml_for_description(data_criteria)
  xml = ''
  if data_criteria.description
    xml = HQMF2::Generator.render_template('description', {'text' => data_criteria.description})
  end
  xml
end

#xml_for_effective_time(data_criteria) ⇒ Object 



103
104
105
106
107
108
109
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 103

def xml_for_effective_time(data_criteria)
  xml = ''
  if data_criteria.effective_time
    xml = HQMF2::Generator.render_template('effective_time', {'doc' => doc, 'effective_time' => data_criteria.effective_time})
  end
  xml
end

#xml_for_fields(criteria) ⇒ Object 



65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 65

def xml_for_fields(criteria)
  fields = []
  if criteria.field_values
    criteria.field_values.each_pair do |key, value|
      if key == "FLFS"
        fields << HQMF2::Generator.render_template('fulfills', {'value' => value})
      else
        details = HQMF::DataCriteria::FIELDS[key]
        details[:code_system_name] = HealthDataStandards::Util::CodeSystemHelper.code_system_for(details[:code_system])
        details[:id] = "#{criteria.id}_#{key}"
        fields << HQMF2::Generator.render_template('field', {'details' => details, 'value' => value})
      end
    end
  end
  if criteria.specific_occurrence
    fields << HQMF2::Generator.render_template('specific_occurrence', {'source_criteria_id' => criteria.source_data_criteria, 'type' => criteria.specific_occurrence_const, 'id' => criteria.specific_occurrence})
  elsif criteria.source_data_criteria
    fields << HQMF2::Generator.render_template('source', {'source_criteria_id' => criteria.source_data_criteria})
  end
  fields.join
end

#xml_for_local_variable(criteria) ⇒ Object 



39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 39

def xml_for_local_variable(criteria)
  name = @local_var_names[criteria.id]
  unless name
    if criteria.specific_occurrence && !criteria.id.starts_with?("Occurrence#{criteria.specific_occurrence}")
      name = "Occurrence#{criteria.specific_occurrence}#{criteria.id}"
    else
      name = criteria.id
    end
    @local_var_names[criteria.id] = name
  end
  HQMF2::Generator.render_template('local_variable', {'name' => name})
end

#xml_for_measure_observation_definition(doc) ⇒ Object 



216
217
218
219
220
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 216

def xml_for_measure_observation_definition(doc)
  observation = doc.find_population_by_type(HQMF::PopulationCriteria::OBSERV)
  msrpopl = doc.find_population_by_type( HQMF::PopulationCriteria::MSRPOPL)
  HQMF2::Generator.render_template('measure_observation_definition', {'doc' => doc, 'observation' => observation, "msrpopl" => msrpopl})
end

#xml_for_population_criteria(population, criteria_id) ⇒ Object 



169
170
171
172
173
174
175
176
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 169

def xml_for_population_criteria(population, criteria_id)
  xml = ''
  population_criteria = doc.population_criteria(population[criteria_id])
  if population_criteria && population_element_prefix(criteria_id) != "measureObservation"
    xml = HQMF2::Generator.render_template('population_criteria', {'doc' => doc, 'population' => population, 'criteria_id' => criteria_id, 'population_criteria' => population_criteria})
  end
  xml
end

#xml_for_precondition(precondition) ⇒ Object 



161
162
163
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 161

def xml_for_precondition(precondition)
  HQMF2::Generator.render_template('precondition', {'doc' => doc, 'precondition' => precondition})
end

#xml_for_precondition_cv(precondition) ⇒ Object 



157
158
159
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 157

def xml_for_precondition_cv(precondition)
  HQMF2::Generator.render_template('precondition_cv', {'doc' => doc, 'precondition' => precondition})
end

#xml_for_reason(data_criteria) ⇒ Object 



111
112
113
114
115
116
117
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 111

def xml_for_reason(data_criteria)
  xml = ''
  if data_criteria.negation && data_criteria.negation_code_list_id
    xml = HQMF2::Generator.render_template('reason', {'doc' => doc, 'code_list_id' => data_criteria.negation_code_list_id})
  end
  xml
end

#xml_for_reference(reference) ⇒ Object 



57
58
59
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 57

def xml_for_reference(reference)
  HQMF2::Generator.render_template('reference', {'doc' => doc, 'reference' => reference})
end

#xml_for_reference_id(id) ⇒ Object 



52
53
54
55
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 52

def xml_for_reference_id(id)
  reference = HQMF::Reference.new(id)
  xml_for_reference(reference)
end

#xml_for_subsets(data_criteria) ⇒ Object 



147
148
149
150
151
152
153
154
155
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 147

def xml_for_subsets(data_criteria)
  subsets_xml = []
  if data_criteria.subset_operators
    subsets_xml = data_criteria.subset_operators.collect do |operator|
      HQMF2::Generator.render_template('subset', {'doc' => doc, 'subset' => operator, 'criteria' => data_criteria})
    end
  end
  subsets_xml.join()
end

#xml_for_template(data_criteria, is_source_data_criteria) ⇒ Object 



119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 119

def xml_for_template(data_criteria, is_source_data_criteria)
  xml = ''
  templates = []
  # Add a template ID if one is defined for this data criteria
  template_id = HQMF::DataCriteria.template_id_for_definition(data_criteria.definition, data_criteria.status, false, "r2")
  if template_id
    templates << {:id => template_id, :title => HQMF::DataCriteria.title_for_template_id(template_id, 'r2')}
  end
  # Add our own template id if this is a source data criteria from HQMF V1. Source
  # data criteria are the 'raw' HQMF V1 data criteria before any restrictions are applied
  # they are only used for negating specific occurrences
  if is_source_data_criteria
    templates << {:id => HQMF::DataCriteria::SOURCE_DATA_CRITERIA_TEMPLATE_ID, :title => HQMF::DataCriteria::SOURCE_DATA_CRITERIA_TEMPLATE_TITLE}
  end
  if templates.length > 0
    xml = HQMF2::Generator.render_template('template_id', {'templates' => templates})
  end
  xml
end

#xml_for_temporal_references(criteria) ⇒ Object 



178
179
180
181
182
183
184
185
186
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 178

def xml_for_temporal_references(criteria)
  refs = []
  if criteria.temporal_references
    refs = criteria.temporal_references.collect do |reference|
      HQMF2::Generator.render_template('temporal_relationship', {'doc' => doc, 'relationship' => reference, 'criteria' => criteria})
    end
  end
  refs.join
end

#xml_for_temporal_relationship_attribute(criteria, relationship) ⇒ Object 



188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 188

def xml_for_temporal_relationship_attribute(criteria, relationship)
  targetCriteria = doc.data_criteria(relationship.reference.id)
  if (criteria.field_values || targetCriteria.try(:field_values))
    sourceKeys = (criteria.field_values || {}).keys.select {|key| [:timestamp, :nested_timestamp].include? HQMF::DataCriteria::FIELDS[key][:field_type]}
    targetKeys = (targetCriteria.try(:field_values) || {}).keys.select {|key| [:timestamp, :nested_timestamp].include? HQMF::DataCriteria::FIELDS[key][:field_type]}
    if (!sourceKeys.empty? || !targetKeys.empty?)
      data = {
        sourceKeys: sourceKeys,
        targetKeys: targetKeys
      }

      HQMF2::Generator.render_template('temporal_relationship_attribute', {'doc' => doc, 'criteria' => criteria, 'targetCriteria'=>targetCriteria, 'data'=> data})
    end
  end

end

#xml_for_value(value, element_name = 'value', include_type = true) ⇒ Object 



87
88
89
 
# File 'lib/hqmf-generator/hqmf-generator.rb', line 87

def xml_for_value(value, element_name='value', include_type=true)
  HQMF2::Generator.render_template('value', {'doc' => doc, 'value' => value, 'name' => element_name, 'include_type' => include_type})
end