Patient Variation

Generate data that reflects real-world population diversity:

• AGE DISTRIBUTION: Include neonates (0–28 days), infants (1m–1y), pediatric (1–17y), adults (18–64y), and geriatric (65+). Weight age groups roughly: 5% neonates/infants, 15% pediatric, 55% adults, 25% geriatric. Adjust per clinical context.
• GENDER & SEX: Use FHIR administrative gender (male, female, other, unknown). Include transgender patients where clinically relevant — use extensions for birth sex (us-core-birthsex) and gender identity (us-core-genderIdentity).
• RACE & ETHNICITY (US Core): Populate US Core Race and Ethnicity extensions:
  • Race: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Codes from urn:oid:2.16.840.1.113883.6.238 (CDC Race & Ethnicity): 2106-3 White, 2054-5 Black or African American, 2028-9 Asian, 1002-5 American Indian or Alaska Native, 2076-8 Native Hawaiian or Other Pacific Islander, 2131-1 Other Race. Include "detailed" sub-categories and "text" extension.
  • Ethnicity: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity 2135-2 Hispanic or Latino, 2186-5 Non Hispanic or Latino
• LANGUAGE & COMMUNICATION: Set Patient.communication with language codes (en, es, zh, vi, ko, tl, ar, fr, de, ru, pt, hi, etc.) and communication.preferred = True for primary language. Include patients with limited English proficiency (LEP).
• MARITAL STATUS: Vary using http://terminology.hl7.org/CodeSystem/v3-MaritalStatus (A=Annulled, D=Divorced, M=Married, S=Single/Never Married, W=Widowed, etc.)
• MULTIPLE IDENTIFIERS: Include MRN, SSN (fake), driver's license, insurance member ID. Use proper identifier systems:
  • MRN: http://hospital.example.org/mrn
  • SSN: http://hl7.org/fhir/sid/us-ssn
  • Driver License: urn:oid:2.16.840.1.113883.4.3.{state_fips}
• CONTACT/NOK: Include Patient.contact for emergency contacts / next of kin with relationship codes (C=Emergency Contact, N=Next of Kin, E=Employer, etc.)
• DECEASED PATIENTS: Some patients should have deceasedBoolean=True or deceasedDateTime set. Approximately 2–5% of a general patient cohort.
• MULTIPLE BIRTH: Use multipleBirthBoolean or multipleBirthInteger for twins/triplets.