SyntheaTM is a Synthetic Patient Population Simulator. The goal is to output synthetic, realistic (but not real), patient data and associated health records in a variety of formats.
Read our wiki for more information.
Currently, SyntheaTM features include:
exporter.fhir.bulk_data = trueto activate)
exporter.ccda.export = trueto activate)
exporter.csv.export = trueto activate)
exporter.cpcds.export = trueto activate)
These instructions are intended for those wishing to examine the Synthea source code, extend it or build the code locally. Those just wishing to run Synthea should follow the Basic Setup and Running instructions instead.
System Requirements: SyntheaTM requires Java 1.8 or above.
To clone the SyntheaTM repo, then build and run the test suite:
git clone https://github.com/synthetichealth/synthea.git cd synthea ./gradlew build check test
The default properties file values can be found at
By default, synthea does not generate CCDA, CPCDA, CSV, or Bulk FHIR (ndjson). You'll need to
adjust this file to activate these features. See the wiki
for more details.
Generating the population one at a time...
Command-line arguments may be provided to specify a state, city, population size, or seed for randomization.
run_synthea [-s seed] [-p populationSize] [-m moduleFilter] [state [city]]
run_synthea Alaska Juneau
run_synthea -s 12345
run_synthea -p 1000
run_synthea -s 987 Washington Seattle
run_synthea -s 21 -p 100 Utah "Salt Lake City"
run_synthea -m metabolic*
Some settings can be changed in
SyntheaTM will output patient records in C-CDA and FHIR formats in
Generate graphical visualizations of SyntheaTM rules and modules.
Generate a list of concepts (used in the records) or attributes (variables on each patient).
./gradlew concepts ./gradlew attributes
Copyright 2017-2020 The MITRE Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.