Skip to content

Commit

Permalink
README typo updates
Browse files Browse the repository at this point in the history
Co-authored-by: Elsa Perelli <[email protected]>
  • Loading branch information
lmd59 and elsaperelli authored Sep 4, 2024
1 parent e11f4fd commit fde4053
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions synthea/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,22 @@ The [Synthea](https://github.com/synthetichealth/synthea) project can be used to

- Download the Synthea codebase from https://github.com/synthetichealth/synthea
- In the Synthea project, use `./run_synthea -fm {mapping file location}` to run synthea with the flexporter
- You may also use the flexporter standalone to map an existing exported file `./run_flexporter -fm {mapping_file_location} -s {source_fhir_file}`
- You may also use the flexporter standalone to map an existing exported file `./run_flexporter -fm {mapping file location} -s {source fhir file}`
- See the [flexporter documentation](https://github.com/synthetichealth/synthea/wiki/Flexporter) for additional information on the flexporter, mapping file, and limitations.

## Building the Mapping File
Quality Measurement calculation requires data conformant with qicore, and expansive IG, which would require expansive effort to fully map. As such, we can piecemeal address the IG requirements by supporting requirements for individual measures. The recommended process for creating a mapping that addresses a set of measures is:
Quality Measurement calculation requires data conformant with qicore, an expansive IG, which would require expansive effort to fully map. As such, we can piecemeal address the IG requirements by supporting requirements for individual measures. The recommended process for creating a mapping that addresses a set of measures is:

1. Use [elm-parser-for-ecqms fhir_review branch](https://github.com/projecttacoma/elm-parser-for-ecqms/tree/fhir_review) and get data requirements to build a combined list of mustSupports for all resources across the set of measures.
2. Use [fqm-execution](https://github.com/projecttacoma/fqm-execution) and get data requirements to build a full list of profiles used.
3. For all resource types, ensure resource is exported as a top level resource by Synthea or already supported by the flexporter mapping. If not, use the flexporter `create_resource` action to export the resource based on a logical existing exported resource or based on a logical Synthea module state. Resources that are only used for SDEs may be initially ignored.
3. Make sure all profiles are applied to the correct exported resource.
4. Make sure all profiles are applied to the correct exported resource.
4. For each must support:
- Check the resource's [qicore 4.1.1](https://hl7.org/fhir/us/qicore/STU4.1.1/) profile Snapshot Table to check if the mustSupport is also required by the profile (minimum cardinality 1). If not, it may be initially ignored.
- If required, check if synthea already exports it by looking in the [FhirR4.java](https://github.com/synthetichealth/synthea/blob/master/src/main/java/org/mitre/synthea/export/FhirR4.java) file. You can look for a string like `Condition()` for an example of how the Fhir object is created and what fields are set on it.
- If Synthea doesn't export it, check if the existing mapping file already adds it through a mapping.
- If not, fill from something logical that synthea does export (if something logical exists). Understanding what values are logical may involve looking at the FHIR specification and/or the measure's CQL for how the must support field is used in the measure logic.
- If a logical field doesn't exist, fill from a chosen pre-set value or choose randomly from a limited set of values
- If a logical field doesn't exist, fill from a chosen pre-set value or choose randomly from a limited set of values.

## CMS130 Mapping Example

Expand Down

0 comments on commit fde4053

Please sign in to comment.