Limitations and scope

Medicare-Synth is a development and research-fixture system. It is not a replacement for restricted CMS data and it is not an inferential model of the Medicare population.

What a release can support

What a release cannot establish

Use the right evidence
Structural validity is necessary for a useful fixture, but it is not evidence that a synthetic distribution matches Medicare. Cite the source manifest, evidence snapshot, validation report, and limitations profile with any published artifact.

Current source boundary

Generated values and unknowns

Vertical synthesis, horizontal re-keying, scenario generation, and external calibration each make different claims. The provenance status and release profile must say which method produced a field. If evidence is missing or conflicting, the project should preserve the uncertainty instead of silently choosing a meaning.

Calibrated MVP boundary (Phases 0–5)

The pinned context mvp-2021-om-ffs-diabetes-ip can match selected public moments under disclosed transport and evidence-grade assumptions. That does not imply:

See interpreting results and the diabetes–hospitalization example.

License and redistribution

The code is licensed under Apache-2.0. CMS synthetic source material is acquired through manifest verification rather than redistributed in this repository. A release owner is responsible for checking the source terms and publishing the manifest, checksums, and disclosures that accompany any bundle.