hl7.fhir.us.core@6.1.0\US Core Patient

Publish Box goes here

US Core Patient

Official URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient				Version: 6.1.0
Active as of 2022-09-30				Computable Name: USCorePatientProfile
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

Example Usage Scenarios:

The following are example usage scenarios for this profile:

Query for a Patient demographic information using Medical Record Number (MRN), which is a type of identifier. The MRN is identifiable by identifier.system and may be location specific.
Query for a Patient demographic information using first name, last name, birthdate, and gender.

Mandatory and Must Support Data Elements

The following data-elements must always be present (Mandatory definition) or must be supported if the data is present in the sending system (Must Support definition). They are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Views below provides the formal summary, definitions, and terminology requirements.

Each Patient Must Have:

a patient identifier (e.g. MRN)
a patient name
a gender*

Each Patient Must Support:

a birth date
an address

Additional USCDI Requirements

For ONC's USCDI requirements, each Patient Must Support the following additional elements. These elements are included in the formal definition of the profile and the Patient examples.

contact detail (e.g. a telephone number or an email address)
a communication language
a race
an ethnicity
a tribal affiliation
sex*
gender identity*
date of death
previous address
previous name
suffix

*see guidance below

Profile Specific Implementation Guidance:

Note that Date of Death, Previous Name, Suffix,and Previous address are listed in the U.S. Core Data for Interoperability.
- Date of Death is communicated using the Patient.deceasedDateTime element.
- Suffix is represented using the Patient.name.suffix element.
- Previous name is represented by setting Patient.name.use to "old" or providing an end date in Patient.name.period or doing both.
- Previous address is represented by setting Patient.address.use to "old" or providing an end date in Patient.address.period or doing both.
- The Patient example demonstrates how these elements are represented.
*US Core has reviewed and updated value sets based on input from the HL7 Gender Harmony Project which is modeling gender and sex information which includes data elements, value sets, code systems. When their work is complete, US Core will align with their recommendations. The US Core Sex Extension meets the U.S. Core Data for Interoperability (USCDI) v3 data element "sex". The US Core Birth Sex Extension is no longer a USCDI Requirement. See the FHIR specification for additional guidance and background for representing Administrative Gender, Sex assigned at Birth, and Gender Identity.
Provenance and the FHIR Extension Target Element can be use to document how individual patient demographic data was captured. See Element Level Provenance on the Basic Provenance page for more information.
The Patient's Social Security Numbers SHOULD NOT be used as a patient identifier in Patient.identifier.value. There is increasing concern over the use of Social Security Numbers in healthcare due to the risk of identity theft and related issues. Many payers and providers have actively purged them from their systems and filter them out of incoming data.

Referenced by

USCoreAllergyIntolerance, USCoreCarePlanProfile, USCoreCareTeam, USCoreConditionEncounterDiagnosisProfile, USCoreConditionProblemsHealthConcernsProfile, USCoreCoverageProfile, USCoreDiagnosticReportProfileLaboratoryReporting, USCoreDiagnosticReportProfileNoteExchange, USCoreDocumentReferenceProfile, USCoreEncounterProfile, USCoreGoalProfile, USCoreImmunizationProfile, USCoreImplantableDeviceProfile, USCoreMedicationDispenseProfile, USCoreMedicationRequestProfile, USCoreObservationClinicalResultProfile, USCoreObservationOccupationProfile, USCoreObservationPregnancyIntentProfile, USCoreObservationPregnancyStatusProfile, USCoreObservationScreeningAssessmentProfile, USCoreObservationSexualOrientationProfile, USCoreProcedureProfile, USCoreProvenance, USCoreQuestionnaireResponseProfile, USCoreRelatedPersonProfile, USCoreServiceRequestProfile, USCoreSimpleObservationProfile, USCoreSmokingStatusProfile, USCoreSpecimenProfile, USCoreVitalSignsProfile

Examples

Id	Given_name	Family_name	Link
child-example	Child	Example	Child Example
deceased-example	Mary; A.	Shaw	Mary Shaw
example	Amy; V.; Amy; V.	Shaw; Baxter	Command 'link' could not render: There are multiple resources with 'Patient/example' identifier in this scope.
example-targeted-provenance	Amy; V.	Shaw	Amy Shaw
infant-example	Infant	Example	Infant Example

Formal Views of Profile Content

Patient	I		Patient	Element id Patient Short description Information about an individual or animal receiving health care services Alternate names SubjectOfCare Client Resident Definition - Comments - Data type Patient Constraints dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6: A resource should have narrative for robust management text.`div`.exists() dom-5: If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` Mappings rim: Entity. Role, or Act rim: Patient[classCode=PAT] cda: ClinicalDocument.recordTarget.patientRole argonaut-dq-dstu2: Patient
id	Σ	0..1	string	There are no (further) constraints on this element Element id Patient.id Short description Logical id of this artifact Definition The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. Comments The only time that a resource does not have an id is when it is being submitted to the server using a create operation. Data type string
meta	Σ	0..1	Meta	There are no (further) constraints on this element Element id Patient.meta Short description Metadata about the resource Definition The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource. Data type Meta Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
implicitRules	Σ ?!	0..1	uri	There are no (further) constraints on this element Element id Patient.implicitRules Short description A set of rules under which this content was created Definition A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc. Comments Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
language		0..1	codeBinding	There are no (further) constraints on this element Element id Patient.language Short description Language of the resource content Definition The base language in which the resource is written. Comments Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). Data type code Binding A human language. CommonLanguages (preferred) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a
text		0..1	Narrative	There are no (further) constraints on this element Element id Patient.text Short description Text summary of the resource, for human interpretation Alternate names narrative, html, xhtml, display Definition A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. Comments Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later. Data type Narrative Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A rim: Act.text?
contained		0..*	Resource	There are no (further) constraints on this element Element id Patient.contained Short description Contained, inline Resources Alternate names inline resources, anonymous resources, contained resources Definition These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. Comments This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels. Data type Resource Mappings rim: Entity. Role, or Act rim: N/A
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
race	I	0..1	Extension(Complex)	Element id Patient.extension:race Short description (USCDI) US Core Race Extension Alternate names extensions, user content Definition Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality. The race codes used to represent these concepts are based upon the CDC Race and Ethnicity Code Set Version 1.0 which includes over 900 concepts for representing race and ethnicity of which 921 reference race. The race concepts are grouped by and pre-mapped to the 5 OMB race categories: American Indian or Alaska Native Asian Black or African American Native Hawaiian or Other Pacific Islander White. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension(Complex) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-race Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A argonaut-dq-dstu2: Patient.extension
ethnicity	I	0..1	Extension(Complex)	Element id Patient.extension:ethnicity Short description (USCDI) US Core ethnicity Extension Alternate names extensions, user content Definition Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality. The ethnicity codes used to represent these concepts are based upon the CDC ethnicity and Ethnicity Code Set Version 1.0 which includes over 900 concepts for representing race and ethnicity of which 43 reference ethnicity. The ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension(Complex) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A argonaut-dq-dstu2: Patient.extension
tribalAffiliation	I	0..*	Extension(Complex)	Element id Patient.extension:tribalAffiliation Short description (USCDI) Tribal Affiliation Extension Alternate names extensions, user content Definition A tribe or band with which a person associates whether or not they are an enrolled member. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension(Complex) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
birthsex	I	0..1	Extension(code)	Element id Patient.extension:birthsex Short description Birth Sex Extension Alternate names extensions, user content Definition A code classifying the person's sex assigned at birth as specified by the Office of the National Coordinator for Health IT (ONC). Comments The codes required are intended to present birth sex (i.e., the sex recorded on the patient's birth certificate) and not gender identity or reassigned sex. Data type Extension(code) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender iso11179: .patient.administrativeGenderCode argonaut-dq-dstu2: Patient.extension
sex	I	0..1	Extension(code)	Element id Patient.extension:sex Short description (USCDI) Sex Extension Alternate names extensions, user content Definition The US Core Sex Extension is used to reflect the documentation of a person's sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0). Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension(code) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
genderIdentity	I	0..*	Extension(CodeableConcept)	Element id Patient.extension:genderIdentity Short description (USCDI) The individual's gender identity Alternate names extensions, user content Definition An individual's personal sense of being a man, woman, boy, girl, nonbinary, or something else. Comments This represents an individual's identity, ascertained by asking them what that identity is. Data type Extension(CodeableConcept) Extension URL http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	?! I	0..*	Extension	There are no (further) constraints on this element Element id Patient.modifierExtension Short description Extensions that cannot be ignored Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
identifier	S Σ	1..*	Identifier	Element id Patient.identifier Short description (USCDI) An identifier for this patient Definition An identifier for this patient. Requirements Patients are almost always assigned specific numerical identifiers. Data type Identifier Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CX / EI (occasionally, more often EI maps to a resource id or a URL) rim: II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd: Identifier w5: FiveWs.identifier v2: PID-3 rim: id cda: .id argonaut-dq-dstu2: Patient.identifier
id		0..1	string	There are no (further) constraints on this element Element id Patient.identifier.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.identifier.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
use	Σ ?!	0..1	codeBinding	There are no (further) constraints on this element Element id Patient.identifier.use Short description usual \| official \| temp \| secondary \| old (If known) Definition The purpose of this identifier. Requirements Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers. Comments Applications can assume that an identifier is permanent unless it explicitly says that it is temporary. Data type code Binding Identifies the purpose for this identifier, if known . IdentifierUse (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: N/A rim: Role.code or implied by context
type	Σ	0..1	CodeableConceptBinding	There are no (further) constraints on this element Element id Patient.identifier.type Short description Description of identifier Definition A coded type for the identifier that can be used to determine which identifier to use for a specific purpose. Requirements Allows users to make use of identifiers when the identifier system is not known. Comments This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type. Data type CodeableConcept Binding A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Identifier Type Codes (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: CX.5 rim: Role.code or implied by context
system	S Σ	1..1	uri	Element id Patient.identifier.system Short description (USCDI) The namespace for the identifier value Definition Establishes the namespace for the value - that is, a URL that describes a set values that are unique. Requirements There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers. Comments Identifier.system is always case sensitive. Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General http://www.acme.com/identifiers/patient Mappings rim: n/a v2: CX.4 / EI-2-4 rim: II.root or Role.id.root servd: ./IdentifierType argonaut-dq-dstu2: Patient.identifier.system
value	S Σ	1..1	string	Element id Patient.identifier.value Short description (USCDI) The value that is unique within the system. Definition The portion of the identifier typically relevant to the user and which is unique within the context of the system. Comments If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General 123456 Mappings rim: n/a v2: CX.1 / EI.1 rim: II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) servd: ./Value argonaut-dq-dstu2: Patient.identifier.value
period	Σ I	0..1	Period	There are no (further) constraints on this element Element id Patient.identifier.period Short description Time period when id is/was valid for use Definition Time period during which identifier is/was valid for use. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: CX.7 + CX.8 rim: Role.effectiveTime or implied by context servd: ./StartDate and ./EndDate
assigner	Σ I	0..1	Reference(Organization)	There are no (further) constraints on this element Element id Patient.identifier.assigner Short description Organization that issued id (may be just text) Definition Organization that issued/manages the identifier. Comments The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization. Data type Reference(Organization) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: CX.4 / (CX.4,CX.9,CX.10) rim: II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper servd: ./IdentifierIssuingAuthority
active	Σ ?!	0..1	boolean	There are no (further) constraints on this element Element id Patient.active Short description Whether this patient's record is in active use Definition Whether this patient record is in active use. Many systems use this property to mark as non-current patients, such as those that have not been seen for a period of time based on an organization's business rules. It is often used to filter patient lists to exclude inactive patients Deceased patients may also be marked as inactive for the same reasons, but may be active for some time after death. Requirements Need to be able to mark a patient record as not to be used because it was created in error. Comments If a record is inactive, and linked to an active record, then future patient/record updates should occur on the other patient. Meaning when missing This resource is generally assumed to be active if no value is provided for the active element Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a w5: FiveWs.status rim: statusCode cda: n/a
name	S Σ I	1..*	HumanName	Element id Patient.name Short description (USCDI) A name associated with the patient Definition A name associated with the individual. Requirements Need to be able to track the patient by multiple names. Examples are your official name and a partner name. Comments A patient may have multiple names with different uses or applicable periods. For animals, the name is a "HumanName" in the sense that is assigned and used by humans and has the same patterns. Data type HumanName Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` us-core-6: At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. `(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()` Mappings rim: n/a v2: XPN rim: EN (actually, PN) servd: ProviderName v2: PID-5, PID-9 rim: name cda: .patient.name argonaut-dq-dstu2: Patient.name
id		0..1	string	There are no (further) constraints on this element Element id Patient.name.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.name.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
use	Σ ?!	0..1	codeBinding	Element id Patient.name.use Short description (USCDI) usual \| official \| temp \| nickname \| anonymous \| old \| maiden Definition Identifies the purpose for this name. Requirements Allows the appropriate name for a particular context of use to be selected from among a set of names. Comments Applications can assume that a name is current unless it explicitly says that it is temporary or old. Data type code Binding The use of a human name. NameUse (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN.7, but often indicated by which field contains the name rim: unique(./use) servd: ./NamePurpose
text	Σ	0..1	string	There are no (further) constraints on this element Element id Patient.name.text Short description Text representation of the full name Definition Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts. Requirements A renderable, unencoded form. Comments Can provide both a text representation and parts. Applications updating a name SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: implied by XPN.11 rim: ./formatted
family	S Σ I	0..1	string	Element id Patient.name.family Short description (USCDI) Family name (often called 'Surname') Alternate names surname Definition The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father. Comments Family Name may be decomposed into specific parts using extensions (de, nl, es related cultures). Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN.1/FN.1 rim: ./part[partType = FAM] servd: ./FamilyName argonaut-dq-dstu2: Patient.name.family
given	S Σ I	0..*	string	Element id Patient.name.given Short description (USCDI) Given names (not always 'first'). Includes middle names Alternate names first name, middle name Definition Given name. Comments If only initials are recorded, they may be used in place of the full name parts. Initials may be separated into multiple given names but often aren't due to paractical limitations. This element is not called "first name" since given names do not always come first. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN.2 + XPN.3 rim: ./part[partType = GIV] servd: ./GivenNames argonaut-dq-dstu2: Patient.name.given
prefix	Σ	0..*	string	There are no (further) constraints on this element Element id Patient.name.prefix Short description Parts that come before the name Definition Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN.5 rim: ./part[partType = PFX] servd: ./TitleCode
suffix	Σ	0..*	string	Element id Patient.name.suffix Short description (USCDI) Parts that come after the name Definition Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN/4 rim: ./part[partType = SFX] argonaut-dq-dstu2: NA
period	Σ I	0..1	Period	Element id Patient.name.period Short description (USCDI) Time period when name was/is in use Definition Indicates the period of time when this name was valid for the named person. Requirements Allows names to be placed in historical context. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: XPN.13 + XPN.14 rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate argonaut-dq-dstu2: NA
telecom	Σ I	0..*	ContactPoint	Element id Patient.telecom Short description (USCDI) A contact detail for the individual Definition A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted. Requirements People have (primary) ways to contact them in some way such as phone, email. Comments A Patient may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently and also to help with identification. The address might not go directly to the individual, but may reach another party that is able to proxy for the patient (i.e. home phone, or pet owner's phone). Data type ContactPoint Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` cpt-2: A system is required if a value is provided. `value.empty() or system.exists()` Mappings rim: n/a v2: XTN rim: TEL servd: ContactPoint v2: PID-13, PID-14, PID-40 rim: telecom cda: .telecom argonaut-dq-dstu2: NA
id		0..1	string	There are no (further) constraints on this element Element id Patient.telecom.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.telecom.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
system	S Σ I	1..1	codeBinding	Element id Patient.telecom.system Short description (USCDI) phone \| fax \| email \| pager \| url \| sms \| other Definition Telecommunications form for contact point - what communications system is required to make use of the contact. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type code Binding Telecommunications form for contact point. ContactPointSystem (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XTN.3 rim: ./scheme servd: ./ContactPointType argonaut-dq-dstu2: NA
value	S Σ	1..1	string	Element id Patient.telecom.value Short description (USCDI) The actual contact point details Definition The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address). Requirements Need to support legacy numbers that are not in a tightly controlled format. Comments Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XTN.1 (or XTN.12) rim: ./url servd: ./Value argonaut-dq-dstu2: NA
use	S Σ ?!	0..1	codeBinding	Element id Patient.telecom.use Short description (USCDI) home \| work \| temp \| old \| mobile - purpose of this contact point Definition Identifies the purpose for the contact point. Requirements Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose. Comments Applications can assume that a contact is current unless it explicitly says that it is temporary or old. Data type code Binding Use of contact point. ContactPointUse (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XTN.2 - but often indicated by field rim: unique(./use) servd: ./ContactPointPurpose argonaut-dq-dstu2: NA
rank	Σ	0..1	positiveInt	There are no (further) constraints on this element Element id Patient.telecom.rank Short description Specify preferred order of use (1 = highest) Definition Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values. Comments Note that rank does not necessarily follow the order in which the contacts are represented in the instance. Data type positiveInt Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: n/a
period	Σ I	0..1	Period	There are no (further) constraints on this element Element id Patient.telecom.period Short description Time period when the contact point was/is in use Definition Time period when the contact point was/is in use. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: N/A rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate
gender	S Σ	1..1	codeBinding	Element id Patient.gender Short description (USCDI) male \| female \| other \| unknown Definition Administrative Gender - the gender that the patient is considered to have for administration and record keeping purposes. Requirements Needed for identification of the individual, in combination with (at least) name and birth date. Comments The gender might not match the biological sex as determined by genetics or the individual's preferred identification. Note that for both humans and particularly animals, there are other legitimate possibilities than male and female, though the vast majority of systems and contexts only support male and female. Systems providing decision support or enforcing business rules should ideally do this on the basis of Observations dealing with the specific sex or gender aspect of interest (anatomical, chromosomal, social, etc.) However, because these observations are infrequently recorded, defaulting to the administrative gender is common practice. Where such defaulting occurs, rule enforcement should allow for the variation between administrative and biological, chromosomal and other gender aspects. For example, an alert about a hysterectomy on a male should be handled as a warning or overridable error, not a "hard" error. See the Patient Gender and Sex section for additional information about communicating patient gender and sex. Data type code Binding The gender of a person used for administrative purposes. AdministrativeGender (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: PID-8 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender cda: .patient.administrativeGenderCode argonaut-dq-dstu2: Patient.gender
birthDate	S Σ	0..1	date	Element id Patient.birthDate Short description (USCDI) The date of birth for the individual Definition The date of birth for the individual. Requirements Age of the individual drives many clinical processes. Comments At least an estimated year should be provided as a guess if the real DOB is unknown There is a standard extension "patient-birthTime" available that should be used where Time is required (such as in maternity/infant care systems). Data type date Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: PID-7 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/birthTime cda: .patient.birthTime loinc: 21112-8 argonaut-dq-dstu2: Patient.birthDate
deceased[x]	Σ ?!	0..1		Element id Patient.deceased[x] Short description (USCDI) Indicates if the individual is deceased or not Definition Indicates if the individual is deceased or not. Requirements The fact that a patient is deceased influences the clinical process. Also, in human communication and relation management it is necessary to know whether the person is alive. Comments If there's no value in the instance, it means there is no statement on whether or not the individual is deceased. Most systems will interpret the absence of a value as a sign of the person being alive. Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: PID-30 (bool) and PID-29 (datetime) rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedTime cda: n/a
deceasedBoolean			boolean	There are no (further) constraints on this element Data type boolean
deceasedDateTime			dateTime	There are no (further) constraints on this element Data type dateTime
address	S Σ	0..*	Address	Element id Patient.address Short description (USCDI) An address for the individual Definition An address for the individual. Requirements May need to keep track of patient addresses for contacting, billing or reporting requirements and also to help with identification. Comments Patient may have multiple addresses with different uses or applicable periods. Data type Address Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XAD rim: AD servd: Address v2: PID-11 rim: addr cda: .addr argonaut-dq-dstu2: Patient.birthDate
id		0..1	string	There are no (further) constraints on this element Element id Patient.address.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.address.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
use	Σ ?!	0..1	codeBinding	Element id Patient.address.use Short description (USCDI) home \| work \| temp \| old \| billing - purpose of this address Definition The purpose of this address. Requirements Allows an appropriate address to be chosen from a list of many. Comments Applications can assume that an address is current unless it explicitly says that it is temporary or old. Data type code Binding The use of an address. AddressUse (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General home Mappings rim: n/a v2: XAD.7 rim: unique(./use) servd: ./AddressPurpose
type	Σ	0..1	codeBinding	There are no (further) constraints on this element Element id Patient.address.type Short description postal \| physical \| both Definition Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both. Comments The definition of Address states that "address is intended to describe postal addresses, not physical locations". However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the Location resource). Data type code Binding The type of an address (physical / postal). AddressType (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General both Mappings rim: n/a v2: XAD.18 rim: unique(./use) vcard: address type parameter
text	Σ	0..1	string	There are no (further) constraints on this element Element id Patient.address.text Short description Text representation of the address Definition Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts. Requirements A renderable, unencoded form. Comments Can provide both a text representation and parts. Applications updating an address SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General 137 Nowhere Street, Erewhon 9132 Mappings rim: n/a v2: XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 rim: ./formatted vcard: address label parameter
line	S Σ	0..*	string	Element id Patient.address.line Short description (USCDI) Street name, number, direction & P.O. Box etc. Definition This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General 137 Nowhere Street Mappings rim: n/a v2: XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address) rim: AD.part[parttype = AL] vcard: street servd: ./StreetAddress (newline delimitted) argonaut-dq-dstu2: NA
city	S Σ	0..1	string	Element id Patient.address.city Short description (USCDI) Name of city, town etc. Alternate names Municpality Definition The name of the city, town, suburb, village or other community or delivery center. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General Erewhon Mappings rim: n/a v2: XAD.3 rim: AD.part[parttype = CTY] vcard: locality servd: ./Jurisdiction argonaut-dq-dstu2: NA
district	Σ	0..1	string	There are no (further) constraints on this element Element id Patient.address.district Short description District name (aka county) Alternate names County Definition The name of the administrative area (county). Comments District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General Madison Mappings rim: n/a v2: XAD.9 rim: AD.part[parttype = CNT \| CPA]
state	S Σ	0..1	stringBinding	Element id Patient.address.state Short description (USCDI) Sub-unit of country (abbreviations ok) Alternate names Province, Territory Definition Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes). Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Binding Two Letter USPS alphabetic codes. UspsTwoLetterAlphabeticCodes (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XAD.4 rim: AD.part[parttype = STA] vcard: region servd: ./Region argonaut-dq-dstu2: NA
postalCode	S Σ	0..1	string	Element id Patient.address.postalCode Short description (USCDI) US Zip Codes Alternate names Zip, Zip Code Definition A postal code designating a region defined by the postal service. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Examples General 9132 Mappings rim: n/a v2: XAD.5 rim: AD.part[parttype = ZIP] vcard: code servd: ./PostalIdentificationCode argonaut-dq-dstu2: NA
country	Σ	0..1	string	There are no (further) constraints on this element Element id Patient.address.country Short description Country (e.g. can be ISO 3166 2 or 3 letter code) Definition Country - a nation as commonly understood or generally accepted. Comments ISO 3166 3 letter codes can be used in place of a human readable country name. Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XAD.6 rim: AD.part[parttype = CNT] vcard: country servd: ./Country
period	Σ I	0..1	Period	Element id Patient.address.period Short description (USCDI) Time period when address was/is in use Definition Time period when address was/is in use. Requirements Allows addresses to be placed in historical context. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Examples General { "start": "2010-03-23", "end": "2010-07-01" } Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: XAD.12 / XAD.13 + XAD.14 rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate argonaut-dq-dstu2: NA
maritalStatus		0..1	CodeableConceptBinding	There are no (further) constraints on this element Element id Patient.maritalStatus Short description Marital (civil) status of a patient Definition This field contains a patient's most recent marital (civil) status. Requirements Most, if not all systems capture it. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data type CodeableConcept Binding The domestic partnership status of a person. Marital Status Codes (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PID-16 rim: player[classCode=PSN]/maritalStatusCode cda: .patient.maritalStatusCode
multipleBirth[x]		0..1		There are no (further) constraints on this element Element id Patient.multipleBirth[x] Short description Whether patient is part of a multiple birth Definition Indicates whether the patient is part of a multiple (boolean) or indicates the actual birth order (integer). Requirements For disambiguation of multiple-birth children, especially relevant where the care provider doesn't meet the patient, such as labs. Comments Where the valueInteger is provided, the number is the birth number in the sequence. E.g. The middle birth in triplets would be valueInteger=2 and the third born would have valueInteger=3 If a boolean value was provided for this triplets example, then all 3 patient records would have valueBoolean=true (the ordering is not indicated). Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: PID-24 (bool), PID-25 (integer) rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber cda: n/a
multipleBirthBoolean			boolean	There are no (further) constraints on this element Data type boolean
multipleBirthInteger			integer	There are no (further) constraints on this element Data type integer
photo	I	0..*	Attachment	There are no (further) constraints on this element Element id Patient.photo Short description Image of the patient Definition Image of the patient. Requirements Many EHR systems have the capability to capture an image of the patient. Fits with newer social media usage too. Comments Guidelines: Use id photos, not clinical photos. Limit dimensions to thumbnail. Keep byte count low to ease resource updates. Data type Attachment Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` att-1: If the Attachment has data, it SHALL have a contentType `data.empty() or contentType.exists()` Mappings rim: n/a v2: ED/RP rim: ED v2: OBX-5 - needs a profile rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/desc cda: n/a
contact	I	0..*	BackboneElement	There are no (further) constraints on this element Element id Patient.contact Short description A contact party (e.g. guardian, partner, friend) for the patient Definition A contact party (e.g. guardian, partner, friend) for the patient. Requirements Need to track people you can contact about the patient. Comments Contact covers all kinds of contact parties: family members, business contacts, guardians, caregivers. Not applicable to register pedigree and family ties beyond use of having contact. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` pat-1: SHALL at least contain a contact's details or a reference to an organization `name.exists() or telecom.exists() or address.exists() or organization.exists()` Mappings rim: n/a rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON] cda: n/a
id		0..1	string	There are no (further) constraints on this element Element id Patient.contact.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.contact.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	Σ ?! I	0..*	Extension	There are no (further) constraints on this element Element id Patient.contact.modifierExtension Short description Extensions that cannot be ignored even if unrecognized Alternate names extensions, user content, modifiers Definition May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
relationship		0..*	CodeableConceptBinding	There are no (further) constraints on this element Element id Patient.contact.relationship Short description The kind of relationship Definition The nature of the relationship between the patient and the contact person. Requirements Used to determine which contact person is the most relevant to approach, depending on circumstances. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data type CodeableConcept Binding The nature of the relationship between a patient and a contact person for that patient. PatientContactRelationship (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: NK1-7, NK1-3 rim: code cda: n/a
name		0..1	HumanName	There are no (further) constraints on this element Element id Patient.contact.name Short description A name associated with the contact person Definition A name associated with the contact person. Requirements Contact persons need to be identified by name, but it is uncommon to need details about multiple other names for that contact person. Comments Names may be changed, or repudiated, or people may have different names in different contexts. Names may be divided into parts of different type that have variable significance depending on context, though the division into parts does not always matter. With personal names, the different parts might or might not be imbued with some implicit meaning; various cultures associate different importance with the name parts and the degree to which systems must care about name parts around the world varies widely. Data type HumanName Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XPN rim: EN (actually, PN) servd: ProviderName v2: NK1-2 rim: name cda: n/a
telecom	I	0..*	ContactPoint	There are no (further) constraints on this element Element id Patient.contact.telecom Short description A contact detail for the person Definition A contact detail for the person, e.g. a telephone number or an email address. Requirements People have (primary) ways to contact them in some way such as phone, email. Comments Contact may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently, and also to help with identification. Data type ContactPoint Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` cpt-2: A system is required if a value is provided. `value.empty() or system.exists()` Mappings rim: n/a v2: XTN rim: TEL servd: ContactPoint v2: NK1-5, NK1-6, NK1-40 rim: telecom cda: n/a
address		0..1	Address	There are no (further) constraints on this element Element id Patient.contact.address Short description Address for the contact person Definition Address for the contact person. Requirements Need to keep track where the contact person can be contacted per postal mail or visited. Comments Note: address is intended to describe postal addresses for administrative purposes, not to describe absolute geographical coordinates. Postal addresses are often used as proxies for physical locations (also see the Location resource). Data type Address Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: XAD rim: AD servd: Address v2: NK1-4 rim: addr cda: n/a
gender		0..1	codeBinding	There are no (further) constraints on this element Element id Patient.contact.gender Short description male \| female \| other \| unknown Definition Administrative Gender - the gender that the contact person is considered to have for administration and record keeping purposes. Requirements Needed to address the person correctly. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type code Binding The gender of a person used for administrative purposes. AdministrativeGender (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: NK1-15 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender cda: n/a
organization	I	0..1	Reference(Organization)	There are no (further) constraints on this element Element id Patient.contact.organization Short description Organization that is associated with the contact Definition Organization on behalf of which the contact is acting or for which the contact is working. Requirements For guardians or business related contacts, the organization is relevant. Comments References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Data type Reference(Organization) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: NK1-13, NK1-30, NK1-31, NK1-32, NK1-41 rim: scoper cda: n/a
period	I	0..1	Period	There are no (further) constraints on this element Element id Patient.contact.period Short description The period during which this contact person or organization is valid to be contacted relating to this patient Definition The period during which this contact person or organization is valid to be contacted relating to this patient. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data type Period Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] rim: effectiveTime cda: n/a
communication		0..*	BackboneElement	Element id Patient.communication Short description (USCDI) A language which may be used to communicate with the patient about his or her health Definition A language which may be used to communicate with the patient about his or her health. Requirements If a patient does not speak the local language, interpreters may be required, so languages spoken and proficiency are important things to keep track of both for patient and other persons of interest. Comments If no language is specified, this implies that the default local language is spoken. If you need to convey proficiency for multiple modes, then you need multiple Patient.Communication associations. For animals, language is not a relevant field, and should be absent from the instance. If the Patient does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: LanguageCommunication cda: patient.languageCommunication argonaut-dq-dstu2: Patient.communication
id		0..1	string	There are no (further) constraints on this element Element id Patient.communication.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.communication.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	Σ ?! I	0..*	Extension	There are no (further) constraints on this element Element id Patient.communication.modifierExtension Short description Extensions that cannot be ignored even if unrecognized Alternate names extensions, user content, modifiers Definition May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
language	S	1..1	CodeableConceptBinding	Element id Patient.communication.language Short description (USCDI) The language which can be used to communicate with the patient about his or her health Definition The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English. Requirements Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect. Comments The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type. Data type CodeableConcept Binding A human language. LanguageCodesWithLanguageAndOptionallyARegionModifier (extensible) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PID-15, LAN-2 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/languageCommunication/code cda: .languageCode argonaut-dq-dstu2: Patient.communication.language
preferred		0..1	boolean	There are no (further) constraints on this element Element id Patient.communication.preferred Short description Language preference indicator Definition Indicates whether or not the patient prefers this language (over other languages he masters up a certain level). Requirements People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method. Comments This language is specifically identified for communicating healthcare information. Data type boolean Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: PID-15 rim: preferenceInd cda: .preferenceInd
generalPractitioner	I	0..*	Reference(Organization \| Practitioner \| PractitionerRole)	There are no (further) constraints on this element Element id Patient.generalPractitioner Short description Patient's nominated primary care provider Alternate names careProvider Definition Patient's nominated care provider. Comments This may be the primary care provider (in a GP context), or it may be a patient nominated care manager in a community/disability setting, or even organization that will provide people to perform the care provider roles. It is not to be used to record Care Teams, these should be in a CareTeam resource that may be linked to the CarePlan or EpisodeOfCare resources. Multiple GPs may be recorded against the patient for various reasons, such as a student that has his home GP listed along with the GP at university during the school semesters, or a "fly-in/fly-out" worker that has the onsite GP also included with his home GP to remain aware of medical issues. Jurisdictions may decide that they can profile this down to 1 if desired, or 1 per type. Data type Reference(Organization \| Practitioner \| PractitionerRole) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: PD1-4 rim: subjectOf.CareEvent.performer.AssignedEntity cda: n/a
managingOrganization	Σ I	0..1	Reference(Organization)	There are no (further) constraints on this element Element id Patient.managingOrganization Short description Organization that is the custodian of the patient record Definition Organization that is the custodian of the patient record. Requirements Need to know who recognizes this patient record, manages and updates it. Comments There is only one managing organization for a specific patient record. Other organizations will have their own Patient record, and may use the Link property to join the records together (or a Person resource which can include confidence ratings for the association). Data type Reference(Organization) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) rim: scoper cda: .providerOrganization
link	Σ ?!	0..*	BackboneElement	There are no (further) constraints on this element Element id Patient.link Short description Link to another patient resource that concerns the same actual person Definition Link to another patient resource that concerns the same actual patient. Requirements There are multiple use cases: Duplicate patient records due to the clerical errors associated with the difficulties of identifying humans consistently, and Distribution of patient information across multiple servers. Comments There is no assumption that linked patient records have mutual links. Data type BackboneElement Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: outboundLink cda: n/a
id		0..1	string	There are no (further) constraints on this element Element id Patient.link.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Patient.link.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
modifierExtension	Σ ?! I	0..*	Extension	There are no (further) constraints on this element Element id Patient.link.modifierExtension Short description Extensions that cannot be ignored even if unrecognized Alternate names extensions, user content, modifiers Definition May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself). Requirements Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
other	Σ I	1..1	Reference(Patient \| RelatedPerson)	There are no (further) constraints on this element Element id Patient.link.other Short description The other patient or related person resource that the link refers to Definition The other patient resource that the link refers to. Comments Referencing a RelatedPerson here removes the need to use a Person record to associate a Patient and RelatedPerson as the same individual. Data type Reference(Patient \| RelatedPerson) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: PID-3, MRG-1 rim: id cda: n/a
type	Σ	1..1	codeBinding	There are no (further) constraints on this element Element id Patient.link.type Short description replaced-by \| replaces \| refer \| seealso Definition The type of link between this patient resource and another patient resource. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type code Binding The type of link between this patient resource and another patient resource. LinkType (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: typeCode cda: n/a

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Patient.telecom.system	required	http://hl7.org/fhir/ValueSet/contact-point-system
Patient.telecom.use	required	http://hl7.org/fhir/ValueSet/contact-point-use
Patient.gender	required	http://hl7.org/fhir/ValueSet/administrative-gender
Patient.address.state	extensible	http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state
Patient.communication.language	extensible	http://hl7.org/fhir/us/core/ValueSet/simple-language

Constraints

Path	Id	Grade	Details	Expression
Patient.name	us-core-6	error	At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present.	(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()

Quick Start

Below is an overview of the required Server RESTful FHIR interactions for this profile - for example, search and read operations - when supporting the US Core interactions to access this profile's information (Profile Support + Interaction Support). Note that systems that support only US Core Profiles (Profile Only Support) are not required to support these interactions. See the US Core Server CapabilityStatement for a complete list of supported RESTful interactions for this IG.

The syntax used to describe the interactions is described here.
See the General Requirements section for additional rules and expectations when a server requires status parameters.
See the General Guidance section for additional guidance on searching for multiple patients.

Mandatory Search Parameters:

The following search parameters and search parameter combinations SHALL be supported:

SHALL support both read Patient by id AND Patient search using the _id search parameter:

GET [base]/Patient/[id] or GET [base]/Patient?_id=[id]

Example:
1. GET [base]/Patient/1032702
2. GET [base]/Patient?_id=1032702
Implementation Notes: (how to search by the logical id of the resource)
SHALL support searching a patient by an identifier such as a MPI using the identifier search parameter:

GET [base]/Patient?identifier={system|}[code]

Example:
1. GET [base]/Patient?identifier=http://hospital.smarthealthit.org|1032702
Implementation Notes: Fetches a bundle containing any Patient resources matching the identifier (how to search by token)
SHALL support searching for a patient by a server defined search that matches any of the string fields in the HumanName, including family, given, prefix, suffix, and/or text using the name search parameter:

GET [base]/Patient?name=[string]

Example:
1. GET [base]/Patient?name=Shaw
Implementation Notes: Fetches a bundle of all Patient resources matching the name (how to search by string)
SHALL support searching using the combination of the birthdate and name search parameters:

GET [base]/Patient?birthdate=[date]&name=[string]

Example:
1. GET [base]/Patient?name=Shaw&birthdate=2007-03-20
Implementation Notes: Fetches a bundle of all Patient resources matching the specified birthdate and name (how to search by date and how to search by string)
SHALL support searching using the combination of the gender and name search parameters:

GET [base]/Patient?gender={system|}[code]&name=[string]

Example:
1. GET [base]/Patient?name=Shaw&gender=female
Implementation Notes: Fetches a bundle of all Patient resources matching the specified gender and name (how to search by string and how to search by token)

Optional Search Parameters:

The following search parameter combinations SHOULD be supported:

SHOULD support searching using the combination of the birthdate and family search parameters:

GET [base]/Patient?birthdate=[date]&family=[string]

Example:
1. GET [base]/Patient?family=Shaw&birthdate=2007-03-20
Implementation Notes: Fetches a bundle of all Patient resources matching the specified birthdate and family (how to search by date and how to search by string)
SHOULD support searching using the combination of the death-date and family search parameters:

GET [base]/Patient?death-date=[date]&family=[string]

Example:
1. GET [base]/Patient?family=Shaw&death-date=2022-07-22
Implementation Notes: Fetches a bundle of all Patient resources matching the specified death-date and family (how to search by date and how to search by string)
SHOULD support searching using the combination of the family and gender search parameters:

GET [base]/Patient?family=[string]&gender={system|}[code]

Example:
1. GET [base]/Patient?family=Shaw&gender=female
Implementation Notes: Fetches a bundle of all Patient resources matching the specified family and gender (how to search by string and how to search by token)

Patient
Definition	\-
Cardinality	0...*
Alias	SubjectOfCare Client Resident
Comments	-
Invariants	dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6: A resource should have narrative for robust management text.`div`.exists() dom-5: If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()`
Mappings	rim: Entity. Role, or Act rim: Patient[classCode=PAT] cda: ClinicalDocument.recordTarget.patientRole argonaut-dq-dstu2: Patient
Patient.id
Definition	The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
Cardinality	0...1
Type	string
Summary	True
Comments	The only time that a resource does not have an id is when it is being submitted to the server using a create operation.
Patient.meta
Definition	The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
Cardinality	0...1
Type	Meta
Summary	True
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: N/A
Patient.implicitRules
Definition	A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
Cardinality	0...1
Type	uri
Modifier	True
Summary	True
Comments	Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a
Patient.language
Definition	The base language in which the resource is written.
Cardinality	0...1
Type	code
Binding	A human language. CommonLanguages (preferred)
Comments	Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a
Patient.text
Definition	A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.
Cardinality	0...1
Type	Narrative
Alias	narrative, html, xhtml, display
Comments	Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: N/A rim: Act.text?
Patient.contained
Definition	These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
Cardinality	0...*
Type	Resource
Alias	inline resources, anonymous resources, contained resources
Comments	This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
Mappings	rim: Entity. Role, or Act rim: N/A
Patient.extension
Definition	May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.extension:race
Definition	Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality. The race codes used to represent these concepts are based upon the [CDC Race and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 921 reference race. The race concepts are grouped by and pre-mapped to the 5 OMB race categories: - American Indian or Alaska Native - Asian - Black or African American - Native Hawaiian or Other Pacific Islander - White.
Cardinality	0...1
Type	Extension(Complex)
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A argonaut-dq-dstu2: Patient.extension
Patient.extension:ethnicity
Definition	Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality. The ethnicity codes used to represent these concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 43 reference ethnicity. The ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino.
Cardinality	0...1
Type	Extension(Complex)
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A argonaut-dq-dstu2: Patient.extension
Patient.extension:tribalAffiliation
Definition	A tribe or band with which a person associates whether or not they are an enrolled member.
Cardinality	0...*
Type	Extension(Complex)
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.extension:birthsex
Definition	A code classifying the person's sex assigned at birth as specified by the [Office of the National Coordinator for Health IT (ONC)](https://www.healthit.gov/newsroom/about-onc).
Cardinality	0...1
Type	Extension(code)
Alias	extensions, user content
Comments	The codes required are intended to present birth sex (i.e., the sex recorded on the patient's birth certificate) and not gender identity or reassigned sex.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender iso11179: .patient.administrativeGenderCode argonaut-dq-dstu2: Patient.extension
Patient.extension:sex
Definition	The US Core Sex Extension is used to reflect the documentation of a person's sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0).
Cardinality	0...1
Type	Extension(code)
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.extension:genderIdentity
Definition	An individual's personal sense of being a man, woman, boy, girl, nonbinary, or something else.
Cardinality	0...*
Type	Extension(CodeableConcept)
Alias	extensions, user content
Comments	This represents an individual's identity, ascertained by asking them what that identity is.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.modifierExtension
Definition	May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality	0...*
Type	Extension
Modifier	True
Alias	extensions, user content
Requirements	Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.identifier
Definition	An identifier for this patient.
Cardinality	1...*
Type	Identifier
Must Support	True
Summary	True
Requirements	Patients are almost always assigned specific numerical identifiers.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: CX / EI (occasionally, more often EI maps to a resource id or a URL) rim: II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd: Identifier w5: FiveWs.identifier v2: PID-3 rim: id cda: .id argonaut-dq-dstu2: Patient.identifier
Patient.identifier.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.identifier.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.identifier.use
Definition	The purpose of this identifier.
Cardinality	0...1
Type	code
Binding	Identifies the purpose for this identifier, if known . IdentifierUse (required)
Modifier	True
Summary	True
Requirements	Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.
Comments	Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: N/A rim: Role.code or implied by context
Patient.identifier.type
Definition	A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.
Cardinality	0...1
Type	CodeableConcept
Binding	A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Identifier Type Codes (extensible)
Summary	True
Requirements	Allows users to make use of identifiers when the identifier system is not known.
Comments	This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: CX.5 rim: Role.code or implied by context
Patient.identifier.system
Definition	Establishes the namespace for the value - that is, a URL that describes a set values that are unique.
Cardinality	1...1
Type	uri
Must Support	True
Summary	True
Requirements	There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.
Comments	Identifier.system is always case sensitive.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General http://www.acme.com/identifiers/patient
Mappings	rim: n/a v2: CX.4 / EI-2-4 rim: II.root or Role.id.root servd: ./IdentifierType argonaut-dq-dstu2: Patient.identifier.system
Patient.identifier.value
Definition	The portion of the identifier typically relevant to the user and which is unique within the context of the system.
Cardinality	1...1
Type	string
Must Support	True
Summary	True
Comments	If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General 123456
Mappings	rim: n/a v2: CX.1 / EI.1 rim: II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) servd: ./Value argonaut-dq-dstu2: Patient.identifier.value
Patient.identifier.period
Definition	Time period during which identifier is/was valid for use.
Cardinality	0...1
Type	Period
Summary	True
Comments	A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)`
Mappings	rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: CX.7 + CX.8 rim: Role.effectiveTime or implied by context servd: ./StartDate and ./EndDate
Patient.identifier.assigner
Definition	Organization that issued/manages the identifier.
Cardinality	0...1
Type	Reference(Organization)
Summary	True
Comments	The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))`
Mappings	rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: CX.4 / (CX.4,CX.9,CX.10) rim: II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper servd: ./IdentifierIssuingAuthority
Patient.active
Definition	Whether this patient record is in active use. Many systems use this property to mark as non-current patients, such as those that have not been seen for a period of time based on an organization's business rules. It is often used to filter patient lists to exclude inactive patients Deceased patients may also be marked as inactive for the same reasons, but may be active for some time after death.
Cardinality	0...1
Type	boolean
Modifier	True
Summary	True
Requirements	Need to be able to mark a patient record as not to be used because it was created in error.
Comments	If a record is inactive, and linked to an active record, then future patient/record updates should occur on the other patient.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a w5: FiveWs.status rim: statusCode cda: n/a
Patient.name
Definition	A name associated with the individual.
Cardinality	1...*
Type	HumanName
Must Support	True
Summary	True
Requirements	Need to be able to track the patient by multiple names. Examples are your official name and a partner name.
Comments	A patient may have multiple names with different uses or applicable periods. For animals, the name is a "HumanName" in the sense that is assigned and used by humans and has the same patterns.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` us-core-6: At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present. `(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()`
Mappings	rim: n/a v2: XPN rim: EN (actually, PN) servd: ProviderName v2: PID-5, PID-9 rim: name cda: .patient.name argonaut-dq-dstu2: Patient.name
Patient.name.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.name.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.name.use
Definition	Identifies the purpose for this name.
Cardinality	0...1
Type	code
Binding	The use of a human name. NameUse (required)
Modifier	True
Summary	True
Requirements	Allows the appropriate name for a particular context of use to be selected from among a set of names.
Comments	Applications can assume that a name is current unless it explicitly says that it is temporary or old.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN.7, but often indicated by which field contains the name rim: unique(./use) servd: ./NamePurpose
Patient.name.text
Definition	Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts.
Cardinality	0...1
Type	string
Summary	True
Requirements	A renderable, unencoded form.
Comments	Can provide both a text representation and parts. Applications updating a name SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: implied by XPN.11 rim: ./formatted
Patient.name.family
Definition	The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father.
Cardinality	0...1
Type	string
Must Support	True
Summary	True
Alias	surname
Comments	Family Name may be decomposed into specific parts using extensions (de, nl, es related cultures).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN.1/FN.1 rim: ./part[partType = FAM] servd: ./FamilyName argonaut-dq-dstu2: Patient.name.family
Patient.name.given
Definition	Given name.
Cardinality	0...*
Type	string
Must Support	True
Summary	True
Alias	first name, middle name
Comments	If only initials are recorded, they may be used in place of the full name parts. Initials may be separated into multiple given names but often aren't due to paractical limitations. This element is not called "first name" since given names do not always come first.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN.2 + XPN.3 rim: ./part[partType = GIV] servd: ./GivenNames argonaut-dq-dstu2: Patient.name.given
Patient.name.prefix
Definition	Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name.
Cardinality	0...*
Type	string
Summary	True
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN.5 rim: ./part[partType = PFX] servd: ./TitleCode
Patient.name.suffix
Definition	Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name.
Cardinality	0...*
Type	string
Summary	True
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN/4 rim: ./part[partType = SFX] argonaut-dq-dstu2: NA
Patient.name.period
Definition	Indicates the period of time when this name was valid for the named person.
Cardinality	0...1
Type	Period
Summary	True
Requirements	Allows names to be placed in historical context.
Comments	A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)`
Mappings	rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: XPN.13 + XPN.14 rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate argonaut-dq-dstu2: NA
Patient.telecom
Definition	A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted.
Cardinality	0...*
Type	ContactPoint
Summary	True
Requirements	People have (primary) ways to contact them in some way such as phone, email.
Comments	A Patient may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently and also to help with identification. The address might not go directly to the individual, but may reach another party that is able to proxy for the patient (i.e. home phone, or pet owner's phone).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` cpt-2: A system is required if a value is provided. `value.empty() or system.exists()`
Mappings	rim: n/a v2: XTN rim: TEL servd: ContactPoint v2: PID-13, PID-14, PID-40 rim: telecom cda: .telecom argonaut-dq-dstu2: NA
Patient.telecom.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.telecom.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.telecom.system
Definition	Telecommunications form for contact point - what communications system is required to make use of the contact.
Cardinality	1...1
Type	code
Binding	Telecommunications form for contact point. ContactPointSystem (required)
Must Support	True
Summary	True
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XTN.3 rim: ./scheme servd: ./ContactPointType argonaut-dq-dstu2: NA
Patient.telecom.value
Definition	The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).
Cardinality	1...1
Type	string
Must Support	True
Summary	True
Requirements	Need to support legacy numbers that are not in a tightly controlled format.
Comments	Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XTN.1 (or XTN.12) rim: ./url servd: ./Value argonaut-dq-dstu2: NA
Patient.telecom.use
Definition	Identifies the purpose for the contact point.
Cardinality	0...1
Type	code
Binding	Use of contact point. ContactPointUse (required)
Must Support	True
Modifier	True
Summary	True
Requirements	Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose.
Comments	Applications can assume that a contact is current unless it explicitly says that it is temporary or old.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XTN.2 - but often indicated by field rim: unique(./use) servd: ./ContactPointPurpose argonaut-dq-dstu2: NA
Patient.telecom.rank
Definition	Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values.
Cardinality	0...1
Type	positiveInt
Summary	True
Comments	Note that rank does not necessarily follow the order in which the contacts are represented in the instance.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: n/a
Patient.telecom.period
Definition	Time period when the contact point was/is in use.
Cardinality	0...1
Type	Period
Summary	True
Comments	A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)`
Mappings	rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: N/A rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate
Patient.gender
Definition	Administrative Gender - the gender that the patient is considered to have for administration and record keeping purposes.
Cardinality	1...1
Type	code
Binding	The gender of a person used for administrative purposes. AdministrativeGender (required)
Must Support	True
Summary	True
Requirements	Needed for identification of the individual, in combination with (at least) name and birth date.
Comments	The gender might not match the biological sex as determined by genetics or the individual's preferred identification. Note that for both humans and particularly animals, there are other legitimate possibilities than male and female, though the vast majority of systems and contexts only support male and female. Systems providing decision support or enforcing business rules should ideally do this on the basis of Observations dealing with the specific sex or gender aspect of interest (anatomical, chromosomal, social, etc.) However, because these observations are infrequently recorded, defaulting to the administrative gender is common practice. Where such defaulting occurs, rule enforcement should allow for the variation between administrative and biological, chromosomal and other gender aspects. For example, an alert about a hysterectomy on a male should be handled as a warning or overridable error, not a "hard" error. See the Patient Gender and Sex section for additional information about communicating patient gender and sex.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: PID-8 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender cda: .patient.administrativeGenderCode argonaut-dq-dstu2: Patient.gender
Patient.birthDate
Definition	The date of birth for the individual.
Cardinality	0...1
Type	date
Must Support	True
Summary	True
Requirements	Age of the individual drives many clinical processes.
Comments	At least an estimated year should be provided as a guess if the real DOB is unknown There is a standard extension "patient-birthTime" available that should be used where Time is required (such as in maternity/infant care systems).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: PID-7 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/birthTime cda: .patient.birthTime loinc: 21112-8 argonaut-dq-dstu2: Patient.birthDate
Patient.deceased[x]
Definition	Indicates if the individual is deceased or not.
Cardinality	0...1
Type	boolean
Modifier	True
Summary	True
Requirements	The fact that a patient is deceased influences the clinical process. Also, in human communication and relation management it is necessary to know whether the person is alive.
Comments	If there's no value in the instance, it means there is no statement on whether or not the individual is deceased. Most systems will interpret the absence of a value as a sign of the person being alive.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: PID-30 (bool) and PID-29 (datetime) rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedTime cda: n/a
Patient.address
Definition	An address for the individual.
Cardinality	0...*
Type	Address
Must Support	True
Summary	True
Requirements	May need to keep track of patient addresses for contacting, billing or reporting requirements and also to help with identification.
Comments	Patient may have multiple addresses with different uses or applicable periods.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XAD rim: AD servd: Address v2: PID-11 rim: addr cda: .addr argonaut-dq-dstu2: Patient.birthDate
Patient.address.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.address.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.address.use
Definition	The purpose of this address.
Cardinality	0...1
Type	code
Binding	The use of an address. AddressUse (required)
Modifier	True
Summary	True
Requirements	Allows an appropriate address to be chosen from a list of many.
Comments	Applications can assume that an address is current unless it explicitly says that it is temporary or old.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General home
Mappings	rim: n/a v2: XAD.7 rim: unique(./use) servd: ./AddressPurpose
Patient.address.type
Definition	Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both.
Cardinality	0...1
Type	code
Binding	The type of an address (physical / postal). AddressType (required)
Summary	True
Comments	The definition of Address states that "address is intended to describe postal addresses, not physical locations". However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the Location resource).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General both
Mappings	rim: n/a v2: XAD.18 rim: unique(./use) vcard: address type parameter
Patient.address.text
Definition	Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts.
Cardinality	0...1
Type	string
Summary	True
Requirements	A renderable, unencoded form.
Comments	Can provide both a text representation and parts. Applications updating an address SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General 137 Nowhere Street, Erewhon 9132
Mappings	rim: n/a v2: XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 rim: ./formatted vcard: address label parameter
Patient.address.line
Definition	This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information.
Cardinality	0...*
Type	string
Must Support	True
Summary	True
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General 137 Nowhere Street
Mappings	rim: n/a v2: XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address) rim: AD.part[parttype = AL] vcard: street servd: ./StreetAddress (newline delimitted) argonaut-dq-dstu2: NA
Patient.address.city
Definition	The name of the city, town, suburb, village or other community or delivery center.
Cardinality	0...1
Type	string
Must Support	True
Summary	True
Alias	Municpality
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General Erewhon
Mappings	rim: n/a v2: XAD.3 rim: AD.part[parttype = CTY] vcard: locality servd: ./Jurisdiction argonaut-dq-dstu2: NA
Patient.address.district
Definition	The name of the administrative area (county).
Cardinality	0...1
Type	string
Summary	True
Alias	County
Comments	District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General Madison
Mappings	rim: n/a v2: XAD.9 rim: AD.part[parttype = CNT \| CPA]
Patient.address.state
Definition	Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).
Cardinality	0...1
Type	string
Binding	Two Letter USPS alphabetic codes. UspsTwoLetterAlphabeticCodes (extensible)
Must Support	True
Summary	True
Alias	Province, Territory
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XAD.4 rim: AD.part[parttype = STA] vcard: region servd: ./Region argonaut-dq-dstu2: NA
Patient.address.postalCode
Definition	A postal code designating a region defined by the postal service.
Cardinality	0...1
Type	string
Must Support	True
Summary	True
Alias	Zip, Zip Code
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Examples	General 9132
Mappings	rim: n/a v2: XAD.5 rim: AD.part[parttype = ZIP] vcard: code servd: ./PostalIdentificationCode argonaut-dq-dstu2: NA
Patient.address.country
Definition	Country - a nation as commonly understood or generally accepted.
Cardinality	0...1
Type	string
Summary	True
Comments	ISO 3166 3 letter codes can be used in place of a human readable country name.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XAD.6 rim: AD.part[parttype = CNT] vcard: country servd: ./Country
Patient.address.period
Definition	Time period when address was/is in use.
Cardinality	0...1
Type	Period
Summary	True
Requirements	Allows addresses to be placed in historical context.
Comments	A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)`
Examples	General { "start": "2010-03-23", "end": "2010-07-01" }
Mappings	rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] v2: XAD.12 / XAD.13 + XAD.14 rim: ./usablePeriod[type="IVL<TS>"] servd: ./StartDate and ./EndDate argonaut-dq-dstu2: NA
Patient.maritalStatus
Definition	This field contains a patient's most recent marital (civil) status.
Cardinality	0...1
Type	CodeableConcept
Binding	The domestic partnership status of a person. Marital Status Codes (extensible)
Requirements	Most, if not all systems capture it.
Comments	Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PID-16 rim: player[classCode=PSN]/maritalStatusCode cda: .patient.maritalStatusCode
Patient.multipleBirth[x]
Definition	Indicates whether the patient is part of a multiple (boolean) or indicates the actual birth order (integer).
Cardinality	0...1
Type	boolean
Requirements	For disambiguation of multiple-birth children, especially relevant where the care provider doesn't meet the patient, such as labs.
Comments	Where the valueInteger is provided, the number is the birth number in the sequence. E.g. The middle birth in triplets would be valueInteger=2 and the third born would have valueInteger=3 If a boolean value was provided for this triplets example, then all 3 patient records would have valueBoolean=true (the ordering is not indicated).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: PID-24 (bool), PID-25 (integer) rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber cda: n/a
Patient.photo
Definition	Image of the patient.
Cardinality	0...*
Type	Attachment
Requirements	Many EHR systems have the capability to capture an image of the patient. Fits with newer social media usage too.
Comments	Guidelines: Use id photos, not clinical photos. Limit dimensions to thumbnail. Keep byte count low to ease resource updates.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` att-1: If the Attachment has data, it SHALL have a contentType `data.empty() or contentType.exists()`
Mappings	rim: n/a v2: ED/RP rim: ED v2: OBX-5 - needs a profile rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/desc cda: n/a
Patient.contact
Definition	A contact party (e.g. guardian, partner, friend) for the patient.
Cardinality	0...*
Type	BackboneElement
Requirements	Need to track people you can contact about the patient.
Comments	Contact covers all kinds of contact parties: family members, business contacts, guardians, caregivers. Not applicable to register pedigree and family ties beyond use of having contact.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` pat-1: SHALL at least contain a contact's details or a reference to an organization `name.exists() or telecom.exists() or address.exists() or organization.exists()`
Mappings	rim: n/a rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON] cda: n/a
Patient.contact.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.contact.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.contact.modifierExtension
Definition	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality	0...*
Type	Extension
Modifier	True
Summary	True
Alias	extensions, user content, modifiers
Requirements	Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.contact.relationship
Definition	The nature of the relationship between the patient and the contact person.
Cardinality	0...*
Type	CodeableConcept
Binding	The nature of the relationship between a patient and a contact person for that patient. PatientContactRelationship (extensible)
Requirements	Used to determine which contact person is the most relevant to approach, depending on circumstances.
Comments	Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: NK1-7, NK1-3 rim: code cda: n/a
Patient.contact.name
Definition	A name associated with the contact person.
Cardinality	0...1
Type	HumanName
Requirements	Contact persons need to be identified by name, but it is uncommon to need details about multiple other names for that contact person.
Comments	Names may be changed, or repudiated, or people may have different names in different contexts. Names may be divided into parts of different type that have variable significance depending on context, though the division into parts does not always matter. With personal names, the different parts might or might not be imbued with some implicit meaning; various cultures associate different importance with the name parts and the degree to which systems must care about name parts around the world varies widely.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XPN rim: EN (actually, PN) servd: ProviderName v2: NK1-2 rim: name cda: n/a
Patient.contact.telecom
Definition	A contact detail for the person, e.g. a telephone number or an email address.
Cardinality	0...*
Type	ContactPoint
Requirements	People have (primary) ways to contact them in some way such as phone, email.
Comments	Contact may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently, and also to help with identification.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` cpt-2: A system is required if a value is provided. `value.empty() or system.exists()`
Mappings	rim: n/a v2: XTN rim: TEL servd: ContactPoint v2: NK1-5, NK1-6, NK1-40 rim: telecom cda: n/a
Patient.contact.address
Definition	Address for the contact person.
Cardinality	0...1
Type	Address
Requirements	Need to keep track where the contact person can be contacted per postal mail or visited.
Comments	Note: address is intended to describe postal addresses for administrative purposes, not to describe absolute geographical coordinates. Postal addresses are often used as proxies for physical locations (also see the Location resource).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: XAD rim: AD servd: Address v2: NK1-4 rim: addr cda: n/a
Patient.contact.gender
Definition	Administrative Gender - the gender that the contact person is considered to have for administration and record keeping purposes.
Cardinality	0...1
Type	code
Binding	The gender of a person used for administrative purposes. AdministrativeGender (required)
Requirements	Needed to address the person correctly.
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: NK1-15 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender cda: n/a
Patient.contact.organization
Definition	Organization on behalf of which the contact is acting or for which the contact is working.
Cardinality	0...1
Type	Reference(Organization)
Requirements	For guardians or business related contacts, the organization is relevant.
Comments	References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))`
Mappings	rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: NK1-13, NK1-30, NK1-31, NK1-32, NK1-41 rim: scoper cda: n/a
Patient.contact.period
Definition	The period during which this contact person or organization is valid to be contacted relating to this patient.
Cardinality	0...1
Type	Period
Comments	A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1: If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)`
Mappings	rim: n/a v2: DR rim: IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] rim: effectiveTime cda: n/a
Patient.communication
Definition	A language which may be used to communicate with the patient about his or her health.
Cardinality	0...*
Type	BackboneElement
Requirements	If a patient does not speak the local language, interpreters may be required, so languages spoken and proficiency are important things to keep track of both for patient and other persons of interest.
Comments	If no language is specified, this implies that the default local language is spoken. If you need to convey proficiency for multiple modes, then you need multiple Patient.Communication associations. For animals, language is not a relevant field, and should be absent from the instance. If the Patient does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: LanguageCommunication cda: patient.languageCommunication argonaut-dq-dstu2: Patient.communication
Patient.communication.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.communication.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.communication.modifierExtension
Definition	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality	0...*
Type	Extension
Modifier	True
Summary	True
Alias	extensions, user content, modifiers
Requirements	Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.communication.language
Definition	The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English.
Cardinality	1...1
Type	CodeableConcept
Binding	A human language. LanguageCodesWithLanguageAndOptionallyARegionModifier (extensible)
Must Support	True
Requirements	Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect.
Comments	The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: CE/CNE/CWE rim: CD orim: fhir:CodeableConcept rdfs:subClassOf dt:CD v2: PID-15, LAN-2 rim: player[classCode=PSN\|ANM and determinerCode=INSTANCE]/languageCommunication/code cda: .languageCode argonaut-dq-dstu2: Patient.communication.language
Patient.communication.preferred
Definition	Indicates whether or not the patient prefers this language (over other languages he masters up a certain level).
Cardinality	0...1
Type	boolean
Requirements	People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method.
Comments	This language is specifically identified for communicating healthcare information.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: PID-15 rim: preferenceInd cda: .preferenceInd
Patient.generalPractitioner
Definition	Patient's nominated care provider.
Cardinality	0...*
Type	Reference(Organization \| Practitioner \| PractitionerRole)
Alias	careProvider
Comments	This may be the primary care provider (in a GP context), or it may be a patient nominated care manager in a community/disability setting, or even organization that will provide people to perform the care provider roles. It is not to be used to record Care Teams, these should be in a CareTeam resource that may be linked to the CarePlan or EpisodeOfCare resources. Multiple GPs may be recorded against the patient for various reasons, such as a student that has his home GP listed along with the GP at university during the school semesters, or a "fly-in/fly-out" worker that has the onsite GP also included with his home GP to remain aware of medical issues. Jurisdictions may decide that they can profile this down to 1 if desired, or 1 per type.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))`
Mappings	rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: PD1-4 rim: subjectOf.CareEvent.performer.AssignedEntity cda: n/a
Patient.managingOrganization
Definition	Organization that is the custodian of the patient record.
Cardinality	0...1
Type	Reference(Organization)
Summary	True
Requirements	Need to know who recognizes this patient record, manages and updates it.
Comments	There is only one managing organization for a specific patient record. Other organizations will have their own Patient record, and may use the Link property to join the records together (or a Person resource which can include confidence ratings for the association).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))`
Mappings	rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) rim: scoper cda: .providerOrganization
Patient.link
Definition	Link to another patient resource that concerns the same actual patient.
Cardinality	0...*
Type	BackboneElement
Modifier	True
Summary	True
Requirements	There are multiple use cases: Duplicate patient records due to the clerical errors associated with the difficulties of identifying humans consistently, and Distribution of patient information across multiple servers.
Comments	There is no assumption that linked patient records have mutual links.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: outboundLink cda: n/a
Patient.link.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Patient.link.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.link.modifierExtension
Definition	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality	0...*
Type	Extension
Modifier	True
Summary	True
Alias	extensions, user content, modifiers
Requirements	Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Patient.link.other
Definition	The other patient resource that the link refers to.
Cardinality	1...1
Type	Reference(Patient \| RelatedPerson)
Summary	True
Comments	Referencing a RelatedPerson here removes the need to use a Person record to associate a Patient and RelatedPerson as the same individual.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1: SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))`
Mappings	rim: n/a rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity) v2: PID-3, MRG-1 rim: id cda: n/a
Patient.link.type
Definition	The type of link between this patient resource and another patient resource.
Cardinality	1...1
Type	code
Binding	The type of link between this patient resource and another patient resource. LinkType (required)
Summary	True
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: typeCode cda: n/a

identity	map	id
argonaut-dq-dstu2	Patient	Patient
argonaut-dq-dstu2	Patient.extension	Patient.extension:race
argonaut-dq-dstu2	Patient.extension	Patient.extension:ethnicity
argonaut-dq-dstu2	Patient.extension	Patient.extension:birthsex
argonaut-dq-dstu2	Patient.identifier	Patient.identifier
argonaut-dq-dstu2	Patient.identifier.system	Patient.identifier.system
argonaut-dq-dstu2	Patient.identifier.value	Patient.identifier.value
argonaut-dq-dstu2	Patient.name	Patient.name
argonaut-dq-dstu2	Patient.name.family	Patient.name.family
argonaut-dq-dstu2	Patient.name.given	Patient.name.given
argonaut-dq-dstu2	NA	Patient.name.suffix
argonaut-dq-dstu2	NA	Patient.name.period
argonaut-dq-dstu2	NA	Patient.telecom
argonaut-dq-dstu2	NA	Patient.telecom.system
argonaut-dq-dstu2	NA	Patient.telecom.value
argonaut-dq-dstu2	NA	Patient.telecom.use
argonaut-dq-dstu2	Patient.gender	Patient.gender
argonaut-dq-dstu2	Patient.birthDate	Patient.birthDate
argonaut-dq-dstu2	Patient.birthDate	Patient.address
argonaut-dq-dstu2	NA	Patient.address.line
argonaut-dq-dstu2	NA	Patient.address.city
argonaut-dq-dstu2	NA	Patient.address.state
argonaut-dq-dstu2	NA	Patient.address.postalCode
argonaut-dq-dstu2	NA	Patient.address.period
argonaut-dq-dstu2	Patient.communication	Patient.communication
argonaut-dq-dstu2	Patient.communication.language	Patient.communication.language
cda	ClinicalDocument.recordTarget.patientRole	Patient
cda	.id	Patient.identifier
cda	n/a	Patient.active
cda	.patient.name	Patient.name
cda	.telecom	Patient.telecom
cda	.patient.administrativeGenderCode	Patient.gender
cda	.patient.birthTime	Patient.birthDate
cda	n/a	Patient.deceased[x]
cda	.addr	Patient.address
cda	.patient.maritalStatusCode	Patient.maritalStatus
cda	n/a	Patient.multipleBirth[x]
cda	n/a	Patient.photo
cda	n/a	Patient.contact
cda	n/a	Patient.contact.relationship
cda	n/a	Patient.contact.name
cda	n/a	Patient.contact.telecom
cda	n/a	Patient.contact.address
cda	n/a	Patient.contact.gender
cda	n/a	Patient.contact.organization
cda	n/a	Patient.contact.period
cda	patient.languageCommunication	Patient.communication
cda	.languageCode	Patient.communication.language
cda	.preferenceInd	Patient.communication.preferred
cda	n/a	Patient.generalPractitioner
cda	.providerOrganization	Patient.managingOrganization
cda	n/a	Patient.link
cda	n/a	Patient.link.other
cda	n/a	Patient.link.type
iso11179	.patient.administrativeGenderCode	Patient.extension:birthsex
loinc	21112-8	Patient.birthDate
rim	Entity. Role, or Act	Patient
rim	Patient[classCode=PAT]	Patient
rim	Act.text?	Patient.text
rim	N/A	Patient.contained
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender	Patient.extension:birthsex
rim	N/A	Patient.modifierExtension
rim	id	Patient.identifier
rim	n/a	Patient.identifier.id
rim	n/a	Patient.identifier.extension
rim	Role.code or implied by context	Patient.identifier.use
rim	Role.code or implied by context	Patient.identifier.type
rim	II.root or Role.id.root	Patient.identifier.system
rim	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)	Patient.identifier.value
rim	Role.effectiveTime or implied by context	Patient.identifier.period
rim	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper	Patient.identifier.assigner
rim	statusCode	Patient.active
rim	name	Patient.name
rim	n/a	Patient.name.id
rim	n/a	Patient.name.extension
rim	unique(./use)	Patient.name.use
rim	./formatted	Patient.name.text
rim	./part[partType = FAM]	Patient.name.family
rim	./part[partType = GIV]	Patient.name.given
rim	./part[partType = PFX]	Patient.name.prefix
rim	./part[partType = SFX]	Patient.name.suffix
rim	./usablePeriod[type="IVL"]	Patient.name.period
rim	telecom	Patient.telecom
rim	n/a	Patient.telecom.id
rim	n/a	Patient.telecom.extension
rim	./scheme	Patient.telecom.system
rim	./url	Patient.telecom.value
rim	unique(./use)	Patient.telecom.use
rim	n/a	Patient.telecom.rank
rim	./usablePeriod[type="IVL"]	Patient.telecom.period
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender	Patient.gender
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/birthTime	Patient.birthDate
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedTime	Patient.deceased[x]
rim	addr	Patient.address
rim	n/a	Patient.address.id
rim	n/a	Patient.address.extension
rim	unique(./use)	Patient.address.use
rim	unique(./use)	Patient.address.type
rim	./formatted	Patient.address.text
rim	AD.part[parttype = AL]	Patient.address.line
rim	AD.part[parttype = CTY]	Patient.address.city
rim	AD.part[parttype = CNT \| CPA]	Patient.address.district
rim	AD.part[parttype = STA]	Patient.address.state
rim	AD.part[parttype = ZIP]	Patient.address.postalCode
rim	AD.part[parttype = CNT]	Patient.address.country
rim	./usablePeriod[type="IVL"]	Patient.address.period
rim	player[classCode=PSN]/maritalStatusCode	Patient.maritalStatus
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthInd, player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber	Patient.multipleBirth[x]
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/desc	Patient.photo
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]	Patient.contact
rim	n/a	Patient.contact.id
rim	n/a	Patient.contact.extension
rim	N/A	Patient.contact.modifierExtension
rim	code	Patient.contact.relationship
rim	name	Patient.contact.name
rim	telecom	Patient.contact.telecom
rim	addr	Patient.contact.address
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender	Patient.contact.gender
rim	scoper	Patient.contact.organization
rim	effectiveTime	Patient.contact.period
rim	LanguageCommunication	Patient.communication
rim	n/a	Patient.communication.id
rim	n/a	Patient.communication.extension
rim	N/A	Patient.communication.modifierExtension
rim	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/languageCommunication/code	Patient.communication.language
rim	preferenceInd	Patient.communication.preferred
rim	subjectOf.CareEvent.performer.AssignedEntity	Patient.generalPractitioner
rim	scoper	Patient.managingOrganization
rim	outboundLink	Patient.link
rim	n/a	Patient.link.id
rim	n/a	Patient.link.extension
rim	N/A	Patient.link.modifierExtension
rim	id	Patient.link.other
rim	typeCode	Patient.link.type
servd	./IdentifierType	Patient.identifier.system
servd	./Value	Patient.identifier.value
servd	./StartDate and ./EndDate	Patient.identifier.period
servd	./IdentifierIssuingAuthority	Patient.identifier.assigner
servd	./NamePurpose	Patient.name.use
servd	./FamilyName	Patient.name.family
servd	./GivenNames	Patient.name.given
servd	./TitleCode	Patient.name.prefix
servd	./StartDate and ./EndDate	Patient.name.period
servd	./ContactPointType	Patient.telecom.system
servd	./Value	Patient.telecom.value
servd	./ContactPointPurpose	Patient.telecom.use
servd	./StartDate and ./EndDate	Patient.telecom.period
servd	./AddressPurpose	Patient.address.use
servd	./StreetAddress (newline delimitted)	Patient.address.line
servd	./Jurisdiction	Patient.address.city
servd	./Region	Patient.address.state
servd	./PostalIdentificationCode	Patient.address.postalCode
servd	./Country	Patient.address.country
servd	./StartDate and ./EndDate	Patient.address.period
v2	PID-3	Patient.identifier
v2	N/A	Patient.identifier.use
v2	CX.5	Patient.identifier.type
v2	CX.4 / EI-2-4	Patient.identifier.system
v2	CX.1 / EI.1	Patient.identifier.value
v2	CX.7 + CX.8	Patient.identifier.period
v2	CX.4 / (CX.4,CX.9,CX.10)	Patient.identifier.assigner
v2	PID-5, PID-9	Patient.name
v2	XPN.7, but often indicated by which field contains the name	Patient.name.use
v2	implied by XPN.11	Patient.name.text
v2	XPN.1/FN.1	Patient.name.family
v2	XPN.2 + XPN.3	Patient.name.given
v2	XPN.5	Patient.name.prefix
v2	XPN/4	Patient.name.suffix
v2	XPN.13 + XPN.14	Patient.name.period
v2	PID-13, PID-14, PID-40	Patient.telecom
v2	XTN.3	Patient.telecom.system
v2	XTN.1 (or XTN.12)	Patient.telecom.value
v2	XTN.2 - but often indicated by field	Patient.telecom.use
v2	n/a	Patient.telecom.rank
v2	N/A	Patient.telecom.period
v2	PID-8	Patient.gender
v2	PID-7	Patient.birthDate
v2	PID-30 (bool) and PID-29 (datetime)	Patient.deceased[x]
v2	PID-11	Patient.address
v2	XAD.7	Patient.address.use
v2	XAD.18	Patient.address.type
v2	XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6	Patient.address.text
v2	XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)	Patient.address.line
v2	XAD.3	Patient.address.city
v2	XAD.9	Patient.address.district
v2	XAD.4	Patient.address.state
v2	XAD.5	Patient.address.postalCode
v2	XAD.6	Patient.address.country
v2	XAD.12 / XAD.13 + XAD.14	Patient.address.period
v2	PID-16	Patient.maritalStatus
v2	PID-24 (bool), PID-25 (integer)	Patient.multipleBirth[x]
v2	OBX-5 - needs a profile	Patient.photo
v2	NK1-7, NK1-3	Patient.contact.relationship
v2	NK1-2	Patient.contact.name
v2	NK1-5, NK1-6, NK1-40	Patient.contact.telecom
v2	NK1-4	Patient.contact.address
v2	NK1-15	Patient.contact.gender
v2	NK1-13, NK1-30, NK1-31, NK1-32, NK1-41	Patient.contact.organization
v2	PID-15, LAN-2	Patient.communication.language
v2	PID-15	Patient.communication.preferred
v2	PD1-4	Patient.generalPractitioner
v2	PID-3, MRG-1	Patient.link.other
vcard	address type parameter	Patient.address.type
vcard	address label parameter	Patient.address.text
vcard	street	Patient.address.line
vcard	locality	Patient.address.city
vcard	region	Patient.address.state
vcard	code	Patient.address.postalCode
vcard	country	Patient.address.country
w5	FiveWs.identifier	Patient.identifier
w5	FiveWs.status	Patient.active

Id	Given_name	Family_name	Link
child-example	Child	Example	Child Example
deceased-example	Mary; A.	Shaw	Mary Shaw
example	Amy; V.; Amy; V.	Shaw; Baxter	Command 'link' could not render: There are multiple resources with 'Patient/example' identifier in this scope.
example-targeted-provenance	Amy; V.	Shaw	Amy Shaw
infant-example	Infant	Example	Infant Example

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="us-core-patient" />
    <text>
        <status value="extensions" />
        --- We have skipped the narrative for better readability of the resource ---
    </text>
    <url value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient" />
    <version value="6.1.0" />
    <name value="USCorePatientProfile" />
    <title value="US Core Patient Profile" />
    <status value="active" />
    <experimental value="false" />
    <date value="2022-09-30" />
    <publisher value="HL7 International - Cross-Group Projects" />
    <contact>
        <name value="HL7 International - Cross-Group Projects" />
        <telecom>
            <system value="url" />
            <value value="http://www.hl7.org/Special/committees/cgp" />
        </telecom>
        <telecom>
            <system value="email" />
            <value value="cgp@lists.HL7.org" />
        </telecom>
    </contact>
    <description value="The US Core Patient Profile meets the U.S. Core Data for Interoperability (USCDI) v3 &#39;Patient Demographics&#39; requirements. This profile sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It identifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource when using this profile to promote interoperability and adoption through common implementation.  It identifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains the way the elements are used when using this profile.  It provides the floor for standards development for specific use cases." />
    <jurisdiction>
        <coding>
            <system value="urn:iso:std:iso:3166" />
            <code value="US" />
        </coding>
    </jurisdiction>
    <copyright value="Used by permission of HL7 International, all rights reserved Creative Commons License" />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="rim" />
        <uri value="http://hl7.org/v3" />
        <name value="RIM Mapping" />
    </mapping>
    <mapping>
        <identity value="cda" />
        <uri value="http://hl7.org/v3/cda" />
        <name value="CDA (R2)" />
    </mapping>
    <mapping>
        <identity value="w5" />
        <uri value="http://hl7.org/fhir/fivews" />
        <name value="FiveWs Pattern Mapping" />
    </mapping>
    <mapping>
        <identity value="v2" />
        <uri value="http://hl7.org/v2" />
        <name value="HL7 v2 Mapping" />
    </mapping>
    <mapping>
        <identity value="loinc" />
        <uri value="http://loinc.org" />
        <name value="LOINC code for the element" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="Patient" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Patient" />
    <derivation value="constraint" />
    <snapshot>
        <element id="Patient">
            <path value="Patient" />
            <short value="Information about an individual or animal receiving health care services" />
            <definition value="\-" />
            <comment value="\-" />
            <alias value="SubjectOfCare Client Resident" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient" />
                <min value="0" />
                <max value="*" />
            </base>
            <constraint>
                <key value="dom-2" />
                <severity value="error" />
                <human value="If the resource is contained in another resource, it SHALL NOT contain nested Resources" />
                <expression value="contained.contained.empty()" />
                <xpath value="not(parent::f:contained and f:contained)" />
                <source value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
            </constraint>
            <constraint>
                <key value="dom-3" />
                <severity value="error" />
                <human value="If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource" />
                <expression value="contained.where(((&#39;#&#39;+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = &#39;#&#39;).exists() or descendants().where(as(canonical) = &#39;#&#39;).exists() or descendants().where(as(canonical) = &#39;#&#39;).exists()).not()).trace(&#39;unmatched&#39;, id).empty()" />
                <xpath value="not(exists(for $id in f:contained/*/f:id/@value return $contained[not(parent::*/descendant::f:reference/@value=concat(&#39;#&#39;, $contained/*/id/@value) or descendant::f:reference[@value=&#39;#&#39;])]))" />
                <source value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
            </constraint>
            <constraint>
                <key value="dom-4" />
                <severity value="error" />
                <human value="If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated" />
                <expression value="contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()" />
                <xpath value="not(exists(f:contained/*/f:meta/f:versionId)) and not(exists(f:contained/*/f:meta/f:lastUpdated))" />
                <source value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
            </constraint>
            <constraint>
                <key value="dom-5" />
                <severity value="error" />
                <human value="If a resource is contained in another resource, it SHALL NOT have a security label" />
                <expression value="contained.meta.security.empty()" />
                <xpath value="not(exists(f:contained/*/f:meta/f:security))" />
                <source value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
            </constraint>
            <constraint>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bestpractice">
                    <valueBoolean value="true" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bestpractice-explanation">
                    <valueMarkdown value="When a resource has no narrative, only systems that fully understand the data can display the resource to a human safely. Including a human readable representation in the resource makes for a much more robust eco-system and cheaper handling of resources by intermediary systems. Some ecosystems restrict distribution of resources to only those systems that do fully understand the resources, and as a consequence implementers may believe that the narrative is superfluous. However experience shows that such eco-systems often open up to new participants over time." />
                </extension>
                <key value="dom-6" />
                <severity value="warning" />
                <human value="A resource should have narrative for robust management" />
                <expression value="text.`div`.exists()" />
                <xpath value="exists(f:text/h:div)" />
                <source value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="Entity. Role, or Act" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="Patient[classCode=PAT]" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="ClinicalDocument.recordTarget.patientRole" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient" />
            </mapping>
        </element>
        <element id="Patient.id">
            <path value="Patient.id" />
            <short value="Logical id of this artifact" />
            <definition value="The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes." />
            <comment value="The only time that a resource does not have an id is when it is being submitted to the server using a create operation." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Resource.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="id" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="true" />
        </element>
        <element id="Patient.meta">
            <path value="Patient.meta" />
            <short value="Metadata about the resource" />
            <definition value="The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Resource.meta" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Meta" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
        </element>
        <element id="Patient.implicitRules">
            <path value="Patient.implicitRules" />
            <short value="A set of rules under which this content was created" />
            <definition value="A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc." />
            <comment value="Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it&#39;s narrative along with other profiles, value sets, etc." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Resource.implicitRules" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="uri" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it&#39;s meaning or interpretation" />
            <isSummary value="true" />
        </element>
        <element id="Patient.language">
            <path value="Patient.language" />
            <short value="Language of the resource content" />
            <definition value="The base language in which the resource is written." />
            <comment value="Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies  to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute)." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Resource.language" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet">
                    <valueCanonical value="http://hl7.org/fhir/ValueSet/all-languages" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="Language" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
                    <valueBoolean value="true" />
                </extension>
                <strength value="preferred" />
                <description value="A human language." />
                <valueSet value="http://hl7.org/fhir/ValueSet/languages" />
            </binding>
        </element>
        <element id="Patient.text">
            <path value="Patient.text" />
            <short value="Text summary of the resource, for human interpretation" />
            <definition value="A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it &quot;clinically safe&quot; for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety." />
            <comment value="Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).  This may be necessary for data from legacy systems where information is captured as a &quot;text blob&quot; or where text is additionally entered raw or narrated and encoded information is added later." />
            <alias value="narrative" />
            <alias value="html" />
            <alias value="xhtml" />
            <alias value="display" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="DomainResource.text" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Narrative" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="Act.text?" />
            </mapping>
        </element>
        <element id="Patient.contained">
            <path value="Patient.contained" />
            <short value="Contained, inline Resources" />
            <definition value="These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope." />
            <comment value="This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels." />
            <alias value="inline resources" />
            <alias value="anonymous resources" />
            <alias value="contained resources" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="DomainResource.contained" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Resource" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="N/A" />
            </mapping>
        </element>
        <element id="Patient.extension">
            <path value="Patient.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
            <short value="Extension" />
            <definition value="An Extension" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
        </element>
        <element id="Patient.extension:race">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="race" />
            <short value="(USCDI) US Core Race Extension" />
            <definition value="Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The race codes used to represent these concepts are based upon the [CDC Race and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 921 reference race.  The race concepts are grouped by and pre-mapped to the 5 OMB race categories:\n\n   - American Indian or Alaska Native\n   - Asian\n   - Black or African American\n   - Native Hawaiian or Other Pacific Islander\n   - White." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-race" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:ethnicity">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="ethnicity" />
            <short value="(USCDI) US Core ethnicity Extension" />
            <definition value="Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The ethnicity codes used to represent these concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:tribalAffiliation">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="tribalAffiliation" />
            <short value="(USCDI) Tribal Affiliation Extension" />
            <definition value="A tribe or band with which a person associates whether or not they are an enrolled member." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
        </element>
        <element id="Patient.extension:birthsex">
            <path value="Patient.extension" />
            <sliceName value="birthsex" />
            <short value="Birth Sex Extension" />
            <definition value="A code classifying the person&#39;s sex assigned at birth  as specified by the [Office of the National Coordinator for Health IT (ONC)](https://www.healthit.gov/newsroom/about-onc)." />
            <comment value="The codes required are intended to present birth sex (i.e., the sex recorded on the patient&#39;s birth certificate) and not gender identity or reassigned sex." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender" />
            </mapping>
            <mapping>
                <identity value="iso11179" />
                <map value=".patient.administrativeGenderCode" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:sex">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="sex" />
            <short value="(USCDI) Sex Extension" />
            <definition value="The US Core Sex Extension is used to reflect the documentation of a person&#39;s sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0)." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
        </element>
        <element id="Patient.extension:genderIdentity">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="genderIdentity" />
            <short value="(USCDI) The individual&#39;s gender identity" />
            <definition value="An individual&#39;s personal sense of being a man, woman, boy, girl, nonbinary, or something else." />
            <comment value="This represents an individual&#39;s identity, ascertained by asking them what that identity is." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="DomainResource.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity" />
            </type>
            <condition value="ele-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &#39;value&#39;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
        </element>
        <element id="Patient.modifierExtension">
            <path value="Patient.modifierExtension" />
            <short value="Extensions that cannot be ignored" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element&#39;s descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself)." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <requirements value="Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension)." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="DomainResource.modifierExtension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="N/A" />
            </mapping>
        </element>
        <element id="Patient.identifier">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier" />
            <short value="(USCDI) An identifier for this patient" />
            <definition value="An identifier for this patient." />
            <requirements value="Patients are almost always assigned specific numerical identifiers." />
            <min value="1" />
            <max value="*" />
            <base>
                <path value="Patient.identifier" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Identifier" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="w5" />
                <map value="FiveWs.identifier" />
            </mapping>
            <mapping>
                <identity value="v2" />
                <map value="PID-3" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="id" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".id" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier" />
            </mapping>
        </element>
        <element id="Patient.identifier.id">
            <path value="Patient.identifier.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.identifier.extension">
            <path value="Patient.identifier.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <description value="Extensions are always sliced by (at least) url" />
                <rules value="open" />
            </slicing>
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.identifier.use">
            <path value="Patient.identifier.use" />
            <short value="usual | official | temp | secondary | old (If known)" />
            <definition value="The purpose of this identifier." />
            <comment value="Applications can assume that an identifier is permanent unless it explicitly says that it is temporary." />
            <requirements value="Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Identifier.use" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This is labeled as &quot;Is Modifier&quot; because applications should not mistake a temporary id for a permanent one." />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="IdentifierUse" />
                </extension>
                <strength value="required" />
                <description value="Identifies the purpose for this identifier, if known ." />
                <valueSet value="http://hl7.org/fhir/ValueSet/identifier-use|4.0.1" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="N/A" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="Role.code or implied by context" />
            </mapping>
        </element>
        <element id="Patient.identifier.type">
            <path value="Patient.identifier.type" />
            <short value="Description of identifier" />
            <definition value="A coded type for the identifier that can be used to determine which identifier to use for a specific purpose." />
            <comment value="This element deals only with general categories of identifiers.  It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage.   Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type." />
            <requirements value="Allows users to make use of identifiers when the identifier system is not known." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Identifier.type" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="CodeableConcept" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="IdentifierType" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
                    <valueBoolean value="true" />
                </extension>
                <strength value="extensible" />
                <description value="A coded type for an identifier that can be used to determine which identifier to use for a specific purpose." />
                <valueSet value="http://hl7.org/fhir/ValueSet/identifier-type" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="CX.5" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="Role.code or implied by context" />
            </mapping>
        </element>
        <element id="Patient.identifier.system">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier.system" />
            <short value="(USCDI) The namespace for the identifier value" />
            <definition value="Establishes the namespace for the value - that is, a URL that describes a set values that are unique." />
            <comment value="Identifier.system is always case sensitive." />
            <requirements value="There are many sets  of identifiers.  To perform matching of two identifiers, we need to know what set we&#39;re dealing with. The system identifies a particular set of unique identifiers." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Identifier.system" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="uri" />
            </type>
            <example>
                <label value="General" />
                <valueUri value="http://www.acme.com/identifiers/patient" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="CX.4 / EI-2-4" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="II.root or Role.id.root" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./IdentifierType" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier.system" />
            </mapping>
        </element>
        <element id="Patient.identifier.value">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier.value" />
            <short value="(USCDI) The value that is unique within the system." />
            <definition value="The portion of the identifier typically relevant to the user and which is unique within the context of the system." />
            <comment value="If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986.  The value&#39;s primary purpose is computational mapping.  As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.)  A value formatted for human display can be conveyed using the [Rendered Value extension](http://hl7.org/fhir/R4/extension-rendered-value.html). Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Identifier.value" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <example>
                <label value="General" />
                <valueString value="123456" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="CX.1 / EI.1" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./Value" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier.value" />
            </mapping>
        </element>
        <element id="Patient.identifier.period">
            <path value="Patient.identifier.period" />
            <short value="Time period when id is/was valid for use" />
            <definition value="Time period during which identifier is/was valid for use." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Identifier.period" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Period" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="CX.7 + CX.8" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="Role.effectiveTime or implied by context" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./StartDate and ./EndDate" />
            </mapping>
        </element>
        <element id="Patient.identifier.assigner">
            <path value="Patient.identifier.assigner" />
            <short value="Organization that issued id (may be just text)" />
            <definition value="Organization that issued/manages the identifier." />
            <comment value="The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Identifier.assigner" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Organization" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="CX.4 / (CX.4,CX.9,CX.10)" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="II.assigningAuthorityName but note that this is an improper use by the definition of the field.  Also Role.scoper" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./IdentifierIssuingAuthority" />
            </mapping>
        </element>
        <element id="Patient.active">
            <path value="Patient.active" />
            <short value="Whether this patient&#39;s record is in active use" />
            <definition value="Whether this patient record is in active use. \nMany systems use this property to mark as non-current patients, such as those that have not been seen for a period of time based on an organization&#39;s business rules.\n\nIt is often used to filter patient lists to exclude inactive patients\n\nDeceased patients may also be marked as inactive for the same reasons, but may be active for some time after death." />
            <comment value="If a record is inactive, and linked to an active record, then future patient/record updates should occur on the other patient." />
            <requirements value="Need to be able to mark a patient record as not to be used because it was created in error." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.active" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="boolean" />
            </type>
            <meaningWhenMissing value="This resource is generally assumed to be active if no value is provided for the active element" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid" />
            <isSummary value="true" />
            <mapping>
                <identity value="w5" />
                <map value="FiveWs.status" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="statusCode" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.name">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name" />
            <short value="(USCDI) A name associated with the patient" />
            <definition value="A name associated with the individual." />
            <comment value="A patient may have multiple names with different uses or applicable periods. For animals, the name is a &quot;HumanName&quot; in the sense that is assigned and used by humans and has the same patterns." />
            <requirements value="Need to be able to track the patient by multiple names. Examples are your official name and a partner name." />
            <min value="1" />
            <max value="*" />
            <base>
                <path value="Patient.name" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="HumanName" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="us-core-6" />
                <severity value="error" />
                <human value="At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present." />
                <expression value="(family.exists() or given.exists()) xor extension.where(url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39;).exists()" />
                <xpath value="(/f:extension/@url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39; and not(/f:family or /f:given)) or (not(/f:extension/@url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39;) and (/f:family or /f:given))" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-5, PID-9" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="name" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".patient.name" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name" />
            </mapping>
        </element>
        <element id="Patient.name.id">
            <path value="Patient.name.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.name.extension">
            <path value="Patient.name.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <description value="Extensions are always sliced by (at least) url" />
                <rules value="open" />
            </slicing>
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.name.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.use" />
            <short value="(USCDI) usual | official | temp | nickname | anonymous | old | maiden" />
            <definition value="Identifies the purpose for this name." />
            <comment value="Applications can assume that a name is current unless it explicitly says that it is temporary or old." />
            <requirements value="Allows the appropriate name for a particular context of use to be selected from among a set of names." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="HumanName.use" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This is labeled as &quot;Is Modifier&quot; because applications should not mistake a temporary or old name etc.for a current/permanent one" />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="NameUse" />
                </extension>
                <strength value="required" />
                <description value="The use of a human name." />
                <valueSet value="http://hl7.org/fhir/ValueSet/name-use|4.0.1" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XPN.7, but often indicated by which field contains the name" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="unique(./use)" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./NamePurpose" />
            </mapping>
        </element>
        <element id="Patient.name.text">
            <path value="Patient.name.text" />
            <short value="Text representation of the full name" />
            <definition value="Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts." />
            <comment value="Can provide both a text representation and parts. Applications updating a name SHALL ensure that when both text and parts are present,  no content is included in the text that isn&#39;t found in a part." />
            <requirements value="A renderable, unencoded form." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="HumanName.text" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="implied by XPN.11" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./formatted" />
            </mapping>
        </element>
        <element id="Patient.name.family">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.family" />
            <short value="(USCDI) Family name (often called &#39;Surname&#39;)" />
            <definition value="The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father." />
            <comment value="Family Name may be decomposed into specific parts using extensions (de, nl, es related cultures)." />
            <alias value="surname" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="HumanName.family" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <condition value="us-core-6" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XPN.1/FN.1" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./part[partType = FAM]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./FamilyName" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name.family" />
            </mapping>
        </element>
        <element id="Patient.name.given">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.given" />
            <short value="(USCDI) Given names (not always &#39;first&#39;). Includes middle names" />
            <definition value="Given name." />
            <comment value="If only initials are recorded, they may be used in place of the full name parts. Initials may be separated into multiple given names but often aren&#39;t due to paractical limitations.  This element is not called &quot;first name&quot; since given names do not always come first." />
            <alias value="first name" />
            <alias value="middle name" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="HumanName.given" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="string" />
            </type>
            <orderMeaning value="Given Names appear in the correct order for presenting the name" />
            <condition value="us-core-6" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XPN.2 + XPN.3" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./part[partType = GIV]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./GivenNames" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name.given" />
            </mapping>
        </element>
        <element id="Patient.name.prefix">
            <path value="Patient.name.prefix" />
            <short value="Parts that come before the name" />
            <definition value="Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="HumanName.prefix" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="string" />
            </type>
            <orderMeaning value="Prefixes appear in the correct order for presenting the name" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XPN.5" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./part[partType = PFX]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./TitleCode" />
            </mapping>
        </element>
        <element id="Patient.name.suffix">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.suffix" />
            <short value="(USCDI) Parts that come after the name" />
            <definition value="Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="HumanName.suffix" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="string" />
            </type>
            <orderMeaning value="Suffixes appear in the correct order for presenting the name" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XPN/4" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./part[partType = SFX]" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.name.period">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.period" />
            <short value="(USCDI) Time period when name was/is in use" />
            <definition value="Indicates the period of time when this name was valid for the named person." />
            <requirements value="Allows names to be placed in historical context." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="HumanName.period" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Period" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XPN.13 + XPN.14" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./usablePeriod[type=&quot;IVL&lt;TS&gt;&quot;]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./StartDate and ./EndDate" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom" />
            <short value="(USCDI) A contact detail for the individual" />
            <definition value="A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted." />
            <comment value="A Patient may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently and also to help with identification. The address might not go directly to the individual, but may reach another party that is able to proxy for the patient (i.e. home phone, or pet owner&#39;s phone)." />
            <requirements value="People have (primary) ways to contact them in some way such as phone, email." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.telecom" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="ContactPoint" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-13, PID-14, PID-40" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="telecom" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".telecom" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.id">
            <path value="Patient.telecom.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.telecom.extension">
            <path value="Patient.telecom.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <description value="Extensions are always sliced by (at least) url" />
                <rules value="open" />
            </slicing>
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.telecom.system">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.system" />
            <short value="(USCDI) phone | fax | email | pager | url | sms | other" />
            <definition value="Telecommunications form for contact point - what communications system is required to make use of the contact." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="ContactPoint.system" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <condition value="cpt-2" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <strength value="required" />
                <description value="Telecommunications form for contact point." />
                <valueSet value="http://hl7.org/fhir/ValueSet/contact-point-system" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XTN.3" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./scheme" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./ContactPointType" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.value">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.value" />
            <short value="(USCDI) The actual contact point details" />
            <definition value="The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address)." />
            <comment value="Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value." />
            <requirements value="Need to support legacy numbers that are not in a tightly controlled format." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="ContactPoint.value" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XTN.1 (or XTN.12)" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./url" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./Value" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.use" />
            <short value="(USCDI) home | work | temp | old | mobile - purpose of this contact point" />
            <definition value="Identifies the purpose for the contact point." />
            <comment value="Applications can assume that a contact is current unless it explicitly says that it is temporary or old." />
            <requirements value="Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="ContactPoint.use" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="true" />
            <isModifierReason value="This is labeled as &quot;Is Modifier&quot; because applications should not mistake a temporary or old contact etc.for a current/permanent one" />
            <isSummary value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="http://hl7.org/fhir/ValueSet/contact-point-use" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XTN.2 - but often indicated by field" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="unique(./use)" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./ContactPointPurpose" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.rank">
            <path value="Patient.telecom.rank" />
            <short value="Specify preferred order of use (1 = highest)" />
            <definition value="Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values." />
            <comment value="Note that rank does not necessarily follow the order in which the contacts are represented in the instance." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="ContactPoint.rank" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="positiveInt" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="n/a" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.telecom.period">
            <path value="Patient.telecom.period" />
            <short value="Time period when the contact point was/is in use" />
            <definition value="Time period when the contact point was/is in use." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="ContactPoint.period" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Period" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="N/A" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./usablePeriod[type=&quot;IVL&lt;TS&gt;&quot;]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./StartDate and ./EndDate" />
            </mapping>
        </element>
        <element id="Patient.gender">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.gender" />
            <short value="(USCDI) male | female | other | unknown" />
            <definition value="Administrative Gender - the gender that the patient is considered to have for administration and record keeping purposes." />
            <comment value="The gender might not match the biological sex as determined by genetics or the individual&#39;s preferred identification. Note that for both humans and particularly animals, there are other legitimate possibilities than male and female, though the vast majority of systems and contexts only support male and female.  Systems providing decision support or enforcing business rules should ideally do this on the basis of Observations dealing with the specific sex or gender aspect of interest (anatomical, chromosomal, social, etc.)  However, because these observations are infrequently recorded, defaulting to the administrative gender is common practice.  Where such defaulting occurs, rule enforcement should allow for the variation between administrative and biological, chromosomal and other gender aspects.  For example, an alert about a hysterectomy on a male should be handled as a warning or overridable error, not a &quot;hard&quot; error.  See the Patient Gender and Sex section for additional information about communicating patient gender and sex." />
            <requirements value="Needed for identification of the individual, in combination with (at least) name and birth date." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Patient.gender" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="PID-8" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".patient.administrativeGenderCode" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.gender" />
            </mapping>
        </element>
        <element id="Patient.birthDate">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.birthDate" />
            <short value="(USCDI) The date of birth for the individual" />
            <definition value="The date of birth for the individual." />
            <comment value="At least an estimated year should be provided as a guess if the real DOB is unknown  There is a standard extension &quot;patient-birthTime&quot; available that should be used where Time is required (such as in maternity/infant care systems)." />
            <requirements value="Age of the individual drives many clinical processes." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.birthDate" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="date" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-7" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".patient.birthTime" />
            </mapping>
            <mapping>
                <identity value="loinc" />
                <map value="21112-8" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.birthDate" />
            </mapping>
        </element>
        <element id="Patient.deceased[x]">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.deceased[x]" />
            <short value="(USCDI) Indicates if the individual is deceased or not" />
            <definition value="Indicates if the individual is deceased or not." />
            <comment value="If there&#39;s no value in the instance, it means there is no statement on whether or not the individual is deceased. Most systems will interpret the absence of a value as a sign of the person being alive." />
            <requirements value="The fact that a patient is deceased influences the clinical process. Also, in human communication and relation management it is necessary to know whether the person is alive." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.deceased[x]" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="boolean" />
            </type>
            <type>
                <code value="dateTime" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This element is labeled as a modifier because once a patient is marked as deceased, the actions that are appropriate to perform on the patient may be significantly different." />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-30  (bool) and PID-29 (datetime)" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.address">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address" />
            <short value="(USCDI) An address for the individual" />
            <definition value="An address for the individual." />
            <comment value="Patient may have multiple addresses with different uses or applicable periods." />
            <requirements value="May need to keep track of patient addresses for contacting, billing or reporting requirements and also to help with identification." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.address" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Address" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-11" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="addr" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".addr" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.birthDate" />
            </mapping>
        </element>
        <element id="Patient.address.id">
            <path value="Patient.address.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.address.extension">
            <path value="Patient.address.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <description value="Extensions are always sliced by (at least) url" />
                <rules value="open" />
            </slicing>
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.address.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.use" />
            <short value="(USCDI) home | work | temp | old | billing - purpose of this address" />
            <definition value="The purpose of this address." />
            <comment value="Applications can assume that an address is current unless it explicitly says that it is temporary or old." />
            <requirements value="Allows an appropriate address to be chosen from a list of many." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.use" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <example>
                <label value="General" />
                <valueCode value="home" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This is labeled as &quot;Is Modifier&quot; because applications should not mistake a temporary or old address etc.for a current/permanent one" />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="AddressUse" />
                </extension>
                <strength value="required" />
                <description value="The use of an address." />
                <valueSet value="http://hl7.org/fhir/ValueSet/address-use|4.0.1" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XAD.7" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="unique(./use)" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./AddressPurpose" />
            </mapping>
        </element>
        <element id="Patient.address.type">
            <path value="Patient.address.type" />
            <short value="postal | physical | both" />
            <definition value="Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both." />
            <comment value="The definition of Address states that &quot;address is intended to describe postal addresses, not physical locations&quot;. However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the [Location](http://hl7.org/fhir/R4/location.html#) resource)." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.type" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <example>
                <label value="General" />
                <valueCode value="both" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="AddressType" />
                </extension>
                <strength value="required" />
                <description value="The type of an address (physical / postal)." />
                <valueSet value="http://hl7.org/fhir/ValueSet/address-type|4.0.1" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XAD.18" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="unique(./use)" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="address type parameter" />
            </mapping>
        </element>
        <element id="Patient.address.text">
            <path value="Patient.address.text" />
            <short value="Text representation of the address" />
            <definition value="Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts." />
            <comment value="Can provide both a text representation and parts. Applications updating an address SHALL ensure that  when both text and parts are present,  no content is included in the text that isn&#39;t found in a part." />
            <requirements value="A renderable, unencoded form." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.text" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <example>
                <label value="General" />
                <valueString value="137 Nowhere Street, Erewhon 9132" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./formatted" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="address label parameter" />
            </mapping>
        </element>
        <element id="Patient.address.line">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.line" />
            <short value="(USCDI) Street name, number, direction &amp; P.O. Box etc." />
            <definition value="This component contains the house number, apartment number, street name, street direction,  P.O. Box number, delivery hints, and similar address information." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Address.line" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="string" />
            </type>
            <orderMeaning value="The order in which lines should appear in an address label" />
            <example>
                <label value="General" />
                <valueString value="137 Nowhere Street" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = AL]" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="street" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./StreetAddress (newline delimitted)" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.city">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.city" />
            <short value="(USCDI) Name of city, town etc." />
            <definition value="The name of the city, town, suburb, village or other community or delivery center." />
            <alias value="Municpality" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.city" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <example>
                <label value="General" />
                <valueString value="Erewhon" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.3" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = CTY]" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="locality" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./Jurisdiction" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.district">
            <path value="Patient.address.district" />
            <short value="District name (aka county)" />
            <definition value="The name of the administrative area (county)." />
            <comment value="District is sometimes known as county, but in some regions &#39;county&#39; is used in place of city (municipality), so county name should be conveyed in city instead." />
            <alias value="County" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.district" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <example>
                <label value="General" />
                <valueString value="Madison" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.9" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = CNT | CPA]" />
            </mapping>
        </element>
        <element id="Patient.address.state">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.state" />
            <short value="(USCDI) Sub-unit of country (abbreviations ok)" />
            <definition value="Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes)." />
            <alias value="Province" />
            <alias value="Territory" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.state" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <strength value="extensible" />
                <description value="Two Letter USPS alphabetic codes." />
                <valueSet value="http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="XAD.4" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = STA]" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="region" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./Region" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.postalCode">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.postalCode" />
            <short value="(USCDI) US Zip Codes" />
            <definition value="A postal code designating a region defined by the postal service." />
            <alias value="Zip" />
            <alias value="Zip Code" />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.postalCode" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <example>
                <label value="General" />
                <valueString value="9132" />
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.5" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = ZIP]" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="code" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./PostalIdentificationCode" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.country">
            <path value="Patient.address.country" />
            <short value="Country (e.g. can be ISO 3166 2 or 3 letter code)" />
            <definition value="Country - a nation as commonly understood or generally accepted." />
            <comment value="ISO 3166 3 letter codes can be used in place of a human readable country name." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.country" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="string" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.6" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="AD.part[parttype = CNT]" />
            </mapping>
            <mapping>
                <identity value="vcard" />
                <map value="country" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./Country" />
            </mapping>
        </element>
        <element id="Patient.address.period">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.period" />
            <short value="(USCDI) Time period when address was/is in use" />
            <definition value="Time period when address was/is in use." />
            <requirements value="Allows addresses to be placed in historical context." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Address.period" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Period" />
            </type>
            <example>
                <label value="General" />
                <valuePeriod>
                    <start value="2010-03-23" />
                    <end value="2010-07-01" />
                </valuePeriod>
            </example>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="XAD.12 / XAD.13 + XAD.14" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="./usablePeriod[type=&quot;IVL&lt;TS&gt;&quot;]" />
            </mapping>
            <mapping>
                <identity value="servd" />
                <map value="./StartDate and ./EndDate" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.maritalStatus">
            <path value="Patient.maritalStatus" />
            <short value="Marital (civil) status of a patient" />
            <definition value="This field contains a patient&#39;s most recent marital (civil) status." />
            <requirements value="Most, if not all systems capture it." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.maritalStatus" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="CodeableConcept" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="MaritalStatus" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
                    <valueBoolean value="true" />
                </extension>
                <strength value="extensible" />
                <description value="The domestic partnership status of a person." />
                <valueSet value="http://hl7.org/fhir/ValueSet/marital-status" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="PID-16" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN]/maritalStatusCode" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".patient.maritalStatusCode" />
            </mapping>
        </element>
        <element id="Patient.multipleBirth[x]">
            <path value="Patient.multipleBirth[x]" />
            <short value="Whether patient is part of a multiple birth" />
            <definition value="Indicates whether the patient is part of a multiple (boolean) or indicates the actual birth order (integer)." />
            <comment value="Where the valueInteger is provided, the number is the birth number in the sequence. E.g. The middle birth in triplets would be valueInteger=2 and the third born would have valueInteger=3 If a boolean value was provided for this triplets example, then all 3 patient records would have valueBoolean=true (the ordering is not indicated)." />
            <requirements value="For disambiguation of multiple-birth children, especially relevant where the care provider doesn&#39;t meet the patient, such as labs." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.multipleBirth[x]" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="boolean" />
            </type>
            <type>
                <code value="integer" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="PID-24 (bool), PID-25 (integer)" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd,  player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.photo">
            <path value="Patient.photo" />
            <short value="Image of the patient" />
            <definition value="Image of the patient." />
            <comment value="Guidelines:\n* Use id photos, not clinical photos.\n* Limit dimensions to thumbnail.\n* Keep byte count low to ease resource updates." />
            <requirements value="Many EHR systems have the capability to capture an image of the patient. Fits with newer social media usage too." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.photo" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Attachment" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="OBX-5 - needs a profile" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact">
            <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-explicit-type-name">
                <valueString value="Contact" />
            </extension>
            <path value="Patient.contact" />
            <short value="A contact party (e.g. guardian, partner, friend) for the patient" />
            <definition value="A contact party (e.g. guardian, partner, friend) for the patient." />
            <comment value="Contact covers all kinds of contact parties: family members, business contacts, guardians, caregivers. Not applicable to register pedigree and family ties beyond use of having contact." />
            <requirements value="Need to track people you can contact about the patient." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.contact" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="BackboneElement" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="pat-1" />
                <severity value="error" />
                <human value="SHALL at least contain a contact&#39;s details or a reference to an organization" />
                <expression value="name.exists() or telecom.exists() or address.exists() or organization.exists()" />
                <xpath value="exists(f:name) or exists(f:telecom) or exists(f:address) or exists(f:organization)" />
                <source value="http://hl7.org/fhir/StructureDefinition/Patient" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.id">
            <path value="Patient.contact.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.extension">
            <path value="Patient.contact.extension" />
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.modifierExtension">
            <path value="Patient.contact.modifierExtension" />
            <short value="Extensions that cannot be ignored even if unrecognized" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element&#39;s descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself)." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <requirements value="Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension)." />
            <alias value="extensions" />
            <alias value="user content" />
            <alias value="modifiers" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="BackboneElement.modifierExtension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="Modifier extensions are expected to modify the meaning or interpretation of the element that contains them" />
            <isSummary value="true" />
            <mapping>
                <identity value="rim" />
                <map value="N/A" />
            </mapping>
        </element>
        <element id="Patient.contact.relationship">
            <path value="Patient.contact.relationship" />
            <short value="The kind of relationship" />
            <definition value="The nature of the relationship between the patient and the contact person." />
            <requirements value="Used to determine which contact person is the most relevant to approach, depending on circumstances." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.contact.relationship" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="CodeableConcept" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="ContactRelationship" />
                </extension>
                <strength value="extensible" />
                <description value="The nature of the relationship between a patient and a contact person for that patient." />
                <valueSet value="http://hl7.org/fhir/ValueSet/patient-contactrelationship" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="NK1-7, NK1-3" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="code" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.name">
            <path value="Patient.contact.name" />
            <short value="A name associated with the contact person" />
            <definition value="A name associated with the contact person." />
            <requirements value="Contact persons need to be identified by name, but it is uncommon to need details about multiple other names for that contact person." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.contact.name" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="HumanName" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="NK1-2" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="name" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.telecom">
            <path value="Patient.contact.telecom" />
            <short value="A contact detail for the person" />
            <definition value="A contact detail for the person, e.g. a telephone number or an email address." />
            <comment value="Contact may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently, and also to help with identification." />
            <requirements value="People have (primary) ways to contact them in some way such as phone, email." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.contact.telecom" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="ContactPoint" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="NK1-5, NK1-6, NK1-40" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="telecom" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.address">
            <path value="Patient.contact.address" />
            <short value="Address for the contact person" />
            <definition value="Address for the contact person." />
            <requirements value="Need to keep track where the contact person can be contacted per postal mail or visited." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.contact.address" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Address" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="NK1-4" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="addr" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.gender">
            <path value="Patient.contact.gender" />
            <short value="male | female | other | unknown" />
            <definition value="Administrative Gender - the gender that the contact person is considered to have for administration and record keeping purposes." />
            <requirements value="Needed to address the person correctly." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.contact.gender" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="AdministrativeGender" />
                </extension>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
                    <valueBoolean value="true" />
                </extension>
                <strength value="required" />
                <description value="The gender of a person used for administrative purposes." />
                <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="NK1-15" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.organization">
            <path value="Patient.contact.organization" />
            <short value="Organization that is associated with the contact" />
            <definition value="Organization on behalf of which the contact is acting or for which the contact is working." />
            <requirements value="For guardians or business related contacts, the organization is relevant." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.contact.organization" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Organization" />
            </type>
            <condition value="pat-1" />
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="NK1-13, NK1-30, NK1-31, NK1-32, NK1-41" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="scoper" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.contact.period">
            <path value="Patient.contact.period" />
            <short value="The period during which this contact person or organization is valid to be contacted relating to this patient" />
            <definition value="The period during which this contact person or organization is valid to be contacted relating to this patient." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.contact.period" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Period" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="effectiveTime" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.communication">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.communication" />
            <short value="(USCDI) A language which may be used to communicate with the patient about his or her health" />
            <definition value="A language which may be used to communicate with the patient about his or her health." />
            <comment value="If no language is specified, this *implies* that the default local language is spoken.  If you need to convey proficiency for multiple modes, then you need multiple Patient.Communication associations.   For animals, language is not a relevant field, and should be absent from the instance. If the Patient does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required." />
            <requirements value="If a patient does not speak the local language, interpreters may be required, so languages spoken and proficiency are important things to keep track of both for patient and other persons of interest." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.communication" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="BackboneElement" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="false" />
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="LanguageCommunication" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="patient.languageCommunication" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.communication" />
            </mapping>
        </element>
        <element id="Patient.communication.id">
            <path value="Patient.communication.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.communication.extension">
            <path value="Patient.communication.extension" />
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.communication.modifierExtension">
            <path value="Patient.communication.modifierExtension" />
            <short value="Extensions that cannot be ignored even if unrecognized" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element&#39;s descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself)." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <requirements value="Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension)." />
            <alias value="extensions" />
            <alias value="user content" />
            <alias value="modifiers" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="BackboneElement.modifierExtension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="Modifier extensions are expected to modify the meaning or interpretation of the element that contains them" />
            <isSummary value="true" />
            <mapping>
                <identity value="rim" />
                <map value="N/A" />
            </mapping>
        </element>
        <element id="Patient.communication.language">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.communication.language" />
            <short value="(USCDI) The language which can be used to communicate with the patient about his or her health" />
            <definition value="The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. &quot;en&quot; for English, or &quot;en-US&quot; for American English versus &quot;en-EN&quot; for England English." />
            <comment value="The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type." />
            <requirements value="Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Patient.communication.language" />
                <min value="1" />
                <max value="1" />
            </base>
            <type>
                <code value="CodeableConcept" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <mustSupport value="true" />
            <isModifier value="false" />
            <isSummary value="false" />
            <binding>
                <strength value="extensible" />
                <valueSet value="http://hl7.org/fhir/us/core/ValueSet/simple-language" />
            </binding>
            <mapping>
                <identity value="v2" />
                <map value="PID-15, LAN-2" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".languageCode" />
            </mapping>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.communication.language" />
            </mapping>
        </element>
        <element id="Patient.communication.preferred">
            <path value="Patient.communication.preferred" />
            <short value="Language preference indicator" />
            <definition value="Indicates whether or not the patient prefers this language (over other languages he masters up a certain level)." />
            <comment value="This language is specifically identified for communicating healthcare information." />
            <requirements value="People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.communication.preferred" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="boolean" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="PID-15" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="preferenceInd" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".preferenceInd" />
            </mapping>
        </element>
        <element id="Patient.generalPractitioner">
            <path value="Patient.generalPractitioner" />
            <short value="Patient&#39;s nominated primary care provider" />
            <definition value="Patient&#39;s nominated care provider." />
            <comment value="This may be the primary care provider (in a GP context), or it may be a patient nominated care manager in a community/disability setting, or even organization that will provide people to perform the care provider roles.  It is not to be used to record Care Teams, these should be in a CareTeam resource that may be linked to the CarePlan or EpisodeOfCare resources.\nMultiple GPs may be recorded against the patient for various reasons, such as a student that has his home GP listed along with the GP at university during the school semesters, or a &quot;fly-in/fly-out&quot; worker that has the onsite GP also included with his home GP to remain aware of medical issues.\n\nJurisdictions may decide that they can profile this down to 1 if desired, or 1 per type." />
            <alias value="careProvider" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.generalPractitioner" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Organization" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Practitioner" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/PractitionerRole" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="v2" />
                <map value="PD1-4" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="subjectOf.CareEvent.performer.AssignedEntity" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.managingOrganization">
            <path value="Patient.managingOrganization" />
            <short value="Organization that is the custodian of the patient record" />
            <definition value="Organization that is the custodian of the patient record." />
            <comment value="There is only one managing organization for a specific patient record. Other organizations will have their own Patient record, and may use the Link property to join the records together (or a Person resource which can include confidence ratings for the association)." />
            <requirements value="Need to know who recognizes this patient record, manages and updates it." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Patient.managingOrganization" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Organization" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="rim" />
                <map value="scoper" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value=".providerOrganization" />
            </mapping>
        </element>
        <element id="Patient.link">
            <path value="Patient.link" />
            <short value="Link to another patient resource that concerns the same actual person" />
            <definition value="Link to another patient resource that concerns the same actual patient." />
            <comment value="There is no assumption that linked patient records have mutual links." />
            <requirements value="There are multiple use cases:   \n\n* Duplicate patient records due to the clerical errors associated with the difficulties of identifying humans consistently, and \n* Distribution of patient information across multiple servers." />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Patient.link" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="BackboneElement" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="This element is labeled as a modifier because it might not be the main Patient resource, and the referenced patient should be used instead of this Patient record. This is when the link.type value is &#39;replaced-by&#39;" />
            <isSummary value="true" />
            <mapping>
                <identity value="rim" />
                <map value="outboundLink" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.link.id">
            <path value="Patient.link.id" />
            <representation value="xmlAttr" />
            <short value="Unique id for inter-element referencing" />
            <definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
            <min value="0" />
            <max value="1" />
            <base>
                <path value="Element.id" />
                <min value="0" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
                    <valueUrl value="string" />
                </extension>
                <code value="http://hl7.org/fhirpath/System.String" />
            </type>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.link.extension">
            <path value="Patient.link.extension" />
            <short value="Additional content defined by implementations" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <alias value="extensions" />
            <alias value="user content" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="Element.extension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="false" />
            <mapping>
                <identity value="rim" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.link.modifierExtension">
            <path value="Patient.link.modifierExtension" />
            <short value="Extensions that cannot be ignored even if unrecognized" />
            <definition value="May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element&#39;s descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself)." />
            <comment value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone." />
            <requirements value="Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension)." />
            <alias value="extensions" />
            <alias value="user content" />
            <alias value="modifiers" />
            <min value="0" />
            <max value="*" />
            <base>
                <path value="BackboneElement.modifierExtension" />
                <min value="0" />
                <max value="*" />
            </base>
            <type>
                <code value="Extension" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <constraint>
                <key value="ext-1" />
                <severity value="error" />
                <human value="Must have either extensions or value[x], not both" />
                <expression value="extension.exists() != value.exists()" />
                <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), &quot;value&quot;)])" />
                <source value="http://hl7.org/fhir/StructureDefinition/Extension" />
            </constraint>
            <isModifier value="true" />
            <isModifierReason value="Modifier extensions are expected to modify the meaning or interpretation of the element that contains them" />
            <isSummary value="true" />
            <mapping>
                <identity value="rim" />
                <map value="N/A" />
            </mapping>
        </element>
        <element id="Patient.link.other">
            <path value="Patient.link.other" />
            <short value="The other patient or related person resource that the link refers to" />
            <definition value="The other patient resource that the link refers to." />
            <comment value="Referencing a RelatedPerson here removes the need to use a Person record to associate a Patient and RelatedPerson as the same individual." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Patient.link.other" />
                <min value="1" />
                <max value="1" />
            </base>
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy">
                    <valueBoolean value="false" />
                </extension>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <mapping>
                <identity value="v2" />
                <map value="PID-3, MRG-1" />
            </mapping>
            <mapping>
                <identity value="rim" />
                <map value="id" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
        <element id="Patient.link.type">
            <path value="Patient.link.type" />
            <short value="replaced-by | replaces | refer | seealso" />
            <definition value="The type of link between this patient resource and another patient resource." />
            <min value="1" />
            <max value="1" />
            <base>
                <path value="Patient.link.type" />
                <min value="1" />
                <max value="1" />
            </base>
            <type>
                <code value="code" />
            </type>
            <constraint>
                <key value="ele-1" />
                <severity value="error" />
                <human value="All FHIR elements must have a @value or children" />
                <expression value="hasValue() or (children().count() &gt; id.count())" />
                <xpath value="@value|f:*|h:div" />
                <source value="http://hl7.org/fhir/StructureDefinition/Element" />
            </constraint>
            <isModifier value="false" />
            <isSummary value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="LinkType" />
                </extension>
                <strength value="required" />
                <description value="The type of link between this patient resource and another patient resource." />
                <valueSet value="http://hl7.org/fhir/ValueSet/link-type|4.0.1" />
            </binding>
            <mapping>
                <identity value="rim" />
                <map value="typeCode" />
            </mapping>
            <mapping>
                <identity value="cda" />
                <map value="n/a" />
            </mapping>
        </element>
    </snapshot>
    <differential>
        <element id="Patient">
            <path value="Patient" />
            <definition value="\-" />
            <comment value="\-" />
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient" />
            </mapping>
        </element>
        <element id="Patient.extension:race">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="race" />
            <short value="(USCDI) US Core Race Extension" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-race" />
            </type>
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:ethnicity">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="ethnicity" />
            <short value="(USCDI) US Core ethnicity Extension" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity" />
            </type>
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:tribalAffiliation">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="tribalAffiliation" />
            <short value="(USCDI) Tribal Affiliation Extension" />
            <min value="0" />
            <max value="*" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation" />
            </type>
            <mustSupport value="false" />
        </element>
        <element id="Patient.extension:birthsex">
            <path value="Patient.extension" />
            <sliceName value="birthsex" />
            <short value="Birth Sex Extension" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex" />
            </type>
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.extension" />
            </mapping>
        </element>
        <element id="Patient.extension:sex">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="sex" />
            <short value="(USCDI) Sex Extension" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex" />
            </type>
            <mustSupport value="false" />
        </element>
        <element id="Patient.extension:genderIdentity">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.extension" />
            <sliceName value="genderIdentity" />
            <short value="(USCDI) The individual&#39;s gender identity" />
            <min value="0" />
            <max value="*" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity" />
            </type>
            <mustSupport value="false" />
        </element>
        <element id="Patient.identifier">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier" />
            <short value="(USCDI) An identifier for this patient" />
            <min value="1" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier" />
            </mapping>
        </element>
        <element id="Patient.identifier.system">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier.system" />
            <short value="(USCDI) The namespace for the identifier value" />
            <min value="1" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier.system" />
            </mapping>
        </element>
        <element id="Patient.identifier.value">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.identifier.value" />
            <short value="(USCDI) The value that is unique within the system." />
            <min value="1" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.identifier.value" />
            </mapping>
        </element>
        <element id="Patient.name">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name" />
            <short value="(USCDI) A name associated with the patient" />
            <min value="1" />
            <constraint>
                <key value="us-core-6" />
                <severity value="error" />
                <human value="At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present." />
                <expression value="(family.exists() or given.exists()) xor extension.where(url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39;).exists()" />
                <xpath value="(/f:extension/@url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39; and not(/f:family or /f:given)) or (not(/f:extension/@url=&#39;http://hl7.org/fhir/StructureDefinition/data-absent-reason&#39;) and (/f:family or /f:given))" />
            </constraint>
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name" />
            </mapping>
        </element>
        <element id="Patient.name.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.use" />
            <short value="(USCDI) usual | official | temp | nickname | anonymous | old | maiden" />
        </element>
        <element id="Patient.name.family">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.family" />
            <short value="(USCDI) Family name (often called &#39;Surname&#39;)" />
            <condition value="us-core-6" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name.family" />
            </mapping>
        </element>
        <element id="Patient.name.given">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.given" />
            <short value="(USCDI) Given names (not always &#39;first&#39;). Includes middle names" />
            <condition value="us-core-6" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.name.given" />
            </mapping>
        </element>
        <element id="Patient.name.suffix">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.suffix" />
            <short value="(USCDI) Parts that come after the name" />
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.name.period">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.name.period" />
            <short value="(USCDI) Time period when name was/is in use" />
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom" />
            <short value="(USCDI) A contact detail for the individual" />
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.system">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.system" />
            <short value="(USCDI) phone | fax | email | pager | url | sms | other" />
            <min value="1" />
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <description value="Telecommunications form for contact point." />
                <valueSet value="http://hl7.org/fhir/ValueSet/contact-point-system" />
            </binding>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.value">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.value" />
            <short value="(USCDI) The actual contact point details" />
            <min value="1" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.telecom.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.telecom.use" />
            <short value="(USCDI) home | work | temp | old | mobile - purpose of this contact point" />
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="http://hl7.org/fhir/ValueSet/contact-point-use" />
            </binding>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.gender">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.gender" />
            <short value="(USCDI) male | female | other | unknown" />
            <min value="1" />
            <type>
                <code value="code" />
            </type>
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender" />
            </binding>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.gender" />
            </mapping>
        </element>
        <element id="Patient.birthDate">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.birthDate" />
            <short value="(USCDI) The date of birth for the individual" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.birthDate" />
            </mapping>
        </element>
        <element id="Patient.deceased[x]">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.deceased[x]" />
            <short value="(USCDI) Indicates if the individual is deceased or not" />
        </element>
        <element id="Patient.address">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address" />
            <short value="(USCDI) An address for the individual" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.birthDate" />
            </mapping>
        </element>
        <element id="Patient.address.use">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.use" />
            <short value="(USCDI) home | work | temp | old | billing - purpose of this address" />
        </element>
        <element id="Patient.address.line">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.line" />
            <short value="(USCDI) Street name, number, direction &amp; P.O. Box etc." />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.city">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.city" />
            <short value="(USCDI) Name of city, town etc." />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.state">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.state" />
            <short value="(USCDI) Sub-unit of country (abbreviations ok)" />
            <mustSupport value="true" />
            <binding>
                <strength value="extensible" />
                <description value="Two Letter USPS alphabetic codes." />
                <valueSet value="http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state" />
            </binding>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.postalCode">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.postalCode" />
            <short value="(USCDI) US Zip Codes" />
            <alias value="Zip Code" />
            <mustSupport value="true" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.address.period">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.address.period" />
            <short value="(USCDI) Time period when address was/is in use" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="NA" />
            </mapping>
        </element>
        <element id="Patient.communication">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.communication" />
            <short value="(USCDI) A language which may be used to communicate with the patient about his or her health" />
            <mustSupport value="false" />
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.communication" />
            </mapping>
        </element>
        <element id="Patient.communication.language">
            <extension url="http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement">
                <valueBoolean value="true" />
            </extension>
            <path value="Patient.communication.language" />
            <short value="(USCDI) The language which can be used to communicate with the patient about his or her health" />
            <mustSupport value="true" />
            <binding>
                <strength value="extensible" />
                <valueSet value="http://hl7.org/fhir/us/core/ValueSet/simple-language" />
            </binding>
            <mapping>
                <identity value="argonaut-dq-dstu2" />
                <map value="Patient.communication.language" />
            </mapping>
        </element>
    </differential>
</StructureDefinition>

{
    "resourceType": "StructureDefinition",
    "id": "us-core-patient",
    "text": {
        "status": "extensions",
        --- We have skipped the narrative for better readability of the resource ---
    },
    "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
    "version": "6.1.0",
    "name": "USCorePatientProfile",
    "title": "US Core Patient Profile",
    "status": "active",
    "experimental": false,
    "date": "2022-09-30",
    "publisher": "HL7 International - Cross-Group Projects",
    "contact":  [
        {
            "name": "HL7 International - Cross-Group Projects",
            "telecom":  [
                {
                    "system": "url",
                    "value": "http://www.hl7.org/Special/committees/cgp"
                },
                {
                    "system": "email",
                    "value": "cgp@lists.HL7.org"
                }
            ]
        }
    ],
    "description": "The US Core Patient Profile meets the U.S. Core Data for Interoperability (USCDI) v3 'Patient Demographics' requirements. This profile sets minimum expectations for the Patient resource to record, search, and fetch basic demographics and other administrative information about an individual patient. It identifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource when using this profile to promote interoperability and adoption through common implementation.  It identifies which core elements, extensions, vocabularies, and value sets **SHALL** be present in the resource and constrains the way the elements are used when using this profile.  It provides the floor for standards development for specific use cases.",
    "jurisdiction":  [
        {
            "coding":  [
                {
                    "system": "urn:iso:std:iso:3166",
                    "code": "US"
                }
            ]
        }
    ],
    "copyright": "Used by permission of HL7 International, all rights reserved Creative Commons License",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "rim",
            "uri": "http://hl7.org/v3",
            "name": "RIM Mapping"
        },
        {
            "identity": "cda",
            "uri": "http://hl7.org/v3/cda",
            "name": "CDA (R2)"
        },
        {
            "identity": "w5",
            "uri": "http://hl7.org/fhir/fivews",
            "name": "FiveWs Pattern Mapping"
        },
        {
            "identity": "v2",
            "uri": "http://hl7.org/v2",
            "name": "HL7 v2 Mapping"
        },
        {
            "identity": "loinc",
            "uri": "http://loinc.org",
            "name": "LOINC code for the element"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "Patient",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Patient",
    "derivation": "constraint",
    "snapshot": {
        "element":  [
            {
                "id": "Patient",
                "path": "Patient",
                "short": "Information about an individual or animal receiving health care services",
                "definition": "\\-",
                "comment": "\\-",
                "alias":  [
                    "SubjectOfCare Client Resident"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient",
                    "min": 0,
                    "max": "*"
                },
                "constraint":  [
                    {
                        "key": "dom-2",
                        "severity": "error",
                        "human": "If the resource is contained in another resource, it SHALL NOT contain nested Resources",
                        "expression": "contained.contained.empty()",
                        "xpath": "not(parent::f:contained and f:contained)",
                        "source": "http://hl7.org/fhir/StructureDefinition/DomainResource"
                    },
                    {
                        "key": "dom-3",
                        "severity": "error",
                        "human": "If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource",
                        "expression": "contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()",
                        "xpath": "not(exists(for $id in f:contained/*/f:id/@value return $contained[not(parent::*/descendant::f:reference/@value=concat('#', $contained/*/id/@value) or descendant::f:reference[@value='#'])]))",
                        "source": "http://hl7.org/fhir/StructureDefinition/DomainResource"
                    },
                    {
                        "key": "dom-4",
                        "severity": "error",
                        "human": "If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated",
                        "expression": "contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()",
                        "xpath": "not(exists(f:contained/*/f:meta/f:versionId)) and not(exists(f:contained/*/f:meta/f:lastUpdated))",
                        "source": "http://hl7.org/fhir/StructureDefinition/DomainResource"
                    },
                    {
                        "key": "dom-5",
                        "severity": "error",
                        "human": "If a resource is contained in another resource, it SHALL NOT have a security label",
                        "expression": "contained.meta.security.empty()",
                        "xpath": "not(exists(f:contained/*/f:meta/f:security))",
                        "source": "http://hl7.org/fhir/StructureDefinition/DomainResource"
                    },
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bestpractice",
                                "valueBoolean": true
                            },
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bestpractice-explanation",
                                "valueMarkdown": "When a resource has no narrative, only systems that fully understand the data can display the resource to a human safely. Including a human readable representation in the resource makes for a much more robust eco-system and cheaper handling of resources by intermediary systems. Some ecosystems restrict distribution of resources to only those systems that do fully understand the resources, and as a consequence implementers may believe that the narrative is superfluous. However experience shows that such eco-systems often open up to new participants over time."
                            }
                        ],
                        "key": "dom-6",
                        "severity": "warning",
                        "human": "A resource should have narrative for robust management",
                        "expression": "text.`div`.exists()",
                        "xpath": "exists(f:text/h:div)",
                        "source": "http://hl7.org/fhir/StructureDefinition/DomainResource"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "Entity. Role, or Act"
                    },
                    {
                        "identity": "rim",
                        "map": "Patient[classCode=PAT]"
                    },
                    {
                        "identity": "cda",
                        "map": "ClinicalDocument.recordTarget.patientRole"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient"
                    }
                ]
            },
            {
                "id": "Patient.id",
                "path": "Patient.id",
                "short": "Logical id of this artifact",
                "definition": "The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.",
                "comment": "The only time that a resource does not have an id is when it is being submitted to the server using a create operation.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Resource.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "id"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": true
            },
            {
                "id": "Patient.meta",
                "path": "Patient.meta",
                "short": "Metadata about the resource",
                "definition": "The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Resource.meta",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Meta"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true
            },
            {
                "id": "Patient.implicitRules",
                "path": "Patient.implicitRules",
                "short": "A set of rules under which this content was created",
                "definition": "A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.",
                "comment": "Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Resource.implicitRules",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "uri"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation",
                "isSummary": true
            },
            {
                "id": "Patient.language",
                "path": "Patient.language",
                "short": "Language of the resource content",
                "definition": "The base language in which the resource is written.",
                "comment": "Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies  to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Resource.language",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet",
                            "valueCanonical": "http://hl7.org/fhir/ValueSet/all-languages"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "Language"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding",
                            "valueBoolean": true
                        }
                    ],
                    "strength": "preferred",
                    "description": "A human language.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/languages"
                }
            },
            {
                "id": "Patient.text",
                "path": "Patient.text",
                "short": "Text summary of the resource, for human interpretation",
                "definition": "A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it \"clinically safe\" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.",
                "comment": "Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).  This may be necessary for data from legacy systems where information is captured as a \"text blob\" or where text is additionally entered raw or narrated and encoded information is added later.",
                "alias":  [
                    "narrative",
                    "html",
                    "xhtml",
                    "display"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "DomainResource.text",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Narrative"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "Act.text?"
                    }
                ]
            },
            {
                "id": "Patient.contained",
                "path": "Patient.contained",
                "short": "Contained, inline Resources",
                "definition": "These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.",
                "comment": "This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.",
                "alias":  [
                    "inline resources",
                    "anonymous resources",
                    "contained resources"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "DomainResource.contained",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Resource"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "N/A"
                    }
                ]
            },
            {
                "id": "Patient.extension",
                "path": "Patient.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                },
                "short": "Extension",
                "definition": "An Extension",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false
            },
            {
                "id": "Patient.extension:race",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "race",
                "short": "(USCDI) US Core Race Extension",
                "definition": "Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The race codes used to represent these concepts are based upon the [CDC Race and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 921 reference race.  The race concepts are grouped by and pre-mapped to the 5 OMB race categories:\n\n   - American Indian or Alaska Native\n   - Asian\n   - Black or African American\n   - Native Hawaiian or Other Pacific Islander\n   - White.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:ethnicity",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "ethnicity",
                "short": "(USCDI) US Core ethnicity Extension",
                "definition": "Concepts classifying the person into a named category of humans sharing common history, traits, geographical origin or nationality.  The ethnicity codes used to represent these concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/phin/resources/vocabulary/index.html) which includes over 900 concepts for representing race and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic or Latino.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:tribalAffiliation",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "tribalAffiliation",
                "short": "(USCDI) Tribal Affiliation Extension",
                "definition": "A tribe or band with which a person associates whether or not they are an enrolled member.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false
            },
            {
                "id": "Patient.extension:birthsex",
                "path": "Patient.extension",
                "sliceName": "birthsex",
                "short": "Birth Sex Extension",
                "definition": "A code classifying the person's sex assigned at birth  as specified by the [Office of the National Coordinator for Health IT (ONC)](https://www.healthit.gov/newsroom/about-onc).",
                "comment": "The codes required are intended to present birth sex (i.e., the sex recorded on the patient's birth certificate) and not gender identity or reassigned sex.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender"
                    },
                    {
                        "identity": "iso11179",
                        "map": ".patient.administrativeGenderCode"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:sex",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "sex",
                "short": "(USCDI) Sex Extension",
                "definition": "The US Core Sex Extension is used to reflect the documentation of a person's sex. It aligns with the C-CDA Sex Observation (LOINC 46098-0).",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false
            },
            {
                "id": "Patient.extension:genderIdentity",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "genderIdentity",
                "short": "(USCDI) The individual's gender identity",
                "definition": "An individual's personal sense of being a man, woman, boy, girl, nonbinary, or something else.",
                "comment": "This represents an individual's identity, ascertained by asking them what that identity is.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "DomainResource.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity"
                        ]
                    }
                ],
                "condition":  [
                    "ele-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "mustSupport": false,
                "isModifier": false
            },
            {
                "id": "Patient.modifierExtension",
                "path": "Patient.modifierExtension",
                "short": "Extensions that cannot be ignored",
                "definition": "May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "DomainResource.modifierExtension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them",
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "N/A"
                    }
                ]
            },
            {
                "id": "Patient.identifier",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier",
                "short": "(USCDI) An identifier for this patient",
                "definition": "An identifier for this patient.",
                "requirements": "Patients are almost always assigned specific numerical identifiers.",
                "min": 1,
                "max": "*",
                "base": {
                    "path": "Patient.identifier",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Identifier"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "w5",
                        "map": "FiveWs.identifier"
                    },
                    {
                        "identity": "v2",
                        "map": "PID-3"
                    },
                    {
                        "identity": "rim",
                        "map": "id"
                    },
                    {
                        "identity": "cda",
                        "map": ".id"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier"
                    }
                ]
            },
            {
                "id": "Patient.identifier.id",
                "path": "Patient.identifier.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.identifier.extension",
                "path": "Patient.identifier.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "description": "Extensions are always sliced by (at least) url",
                    "rules": "open"
                },
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.identifier.use",
                "path": "Patient.identifier.use",
                "short": "usual | official | temp | secondary | old (If known)",
                "definition": "The purpose of this identifier.",
                "comment": "Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.",
                "requirements": "Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Identifier.use",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This is labeled as \"Is Modifier\" because applications should not mistake a temporary id for a permanent one.",
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "IdentifierUse"
                        }
                    ],
                    "strength": "required",
                    "description": "Identifies the purpose for this identifier, if known .",
                    "valueSet": "http://hl7.org/fhir/ValueSet/identifier-use|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "N/A"
                    },
                    {
                        "identity": "rim",
                        "map": "Role.code or implied by context"
                    }
                ]
            },
            {
                "id": "Patient.identifier.type",
                "path": "Patient.identifier.type",
                "short": "Description of identifier",
                "definition": "A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.",
                "comment": "This element deals only with general categories of identifiers.  It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage.   Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.",
                "requirements": "Allows users to make use of identifiers when the identifier system is not known.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Identifier.type",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "IdentifierType"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding",
                            "valueBoolean": true
                        }
                    ],
                    "strength": "extensible",
                    "description": "A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/identifier-type"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "CX.5"
                    },
                    {
                        "identity": "rim",
                        "map": "Role.code or implied by context"
                    }
                ]
            },
            {
                "id": "Patient.identifier.system",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier.system",
                "short": "(USCDI) The namespace for the identifier value",
                "definition": "Establishes the namespace for the value - that is, a URL that describes a set values that are unique.",
                "comment": "Identifier.system is always case sensitive.",
                "requirements": "There are many sets  of identifiers.  To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Identifier.system",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "uri"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueUri": "http://www.acme.com/identifiers/patient"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "CX.4 / EI-2-4"
                    },
                    {
                        "identity": "rim",
                        "map": "II.root or Role.id.root"
                    },
                    {
                        "identity": "servd",
                        "map": "./IdentifierType"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier.system"
                    }
                ]
            },
            {
                "id": "Patient.identifier.value",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier.value",
                "short": "(USCDI) The value that is unique within the system.",
                "definition": "The portion of the identifier typically relevant to the user and which is unique within the context of the system.",
                "comment": "If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986.  The value's primary purpose is computational mapping.  As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.)  A value formatted for human display can be conveyed using the [Rendered Value extension](http://hl7.org/fhir/R4/extension-rendered-value.html). Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Identifier.value",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueString": "123456"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "CX.1 / EI.1"
                    },
                    {
                        "identity": "rim",
                        "map": "II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)"
                    },
                    {
                        "identity": "servd",
                        "map": "./Value"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier.value"
                    }
                ]
            },
            {
                "id": "Patient.identifier.period",
                "path": "Patient.identifier.period",
                "short": "Time period when id is/was valid for use",
                "definition": "Time period during which identifier is/was valid for use.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Identifier.period",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "CX.7 + CX.8"
                    },
                    {
                        "identity": "rim",
                        "map": "Role.effectiveTime or implied by context"
                    },
                    {
                        "identity": "servd",
                        "map": "./StartDate and ./EndDate"
                    }
                ]
            },
            {
                "id": "Patient.identifier.assigner",
                "path": "Patient.identifier.assigner",
                "short": "Organization that issued id (may be just text)",
                "definition": "Organization that issued/manages the identifier.",
                "comment": "The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Identifier.assigner",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Organization"
                        ]
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "CX.4 / (CX.4,CX.9,CX.10)"
                    },
                    {
                        "identity": "rim",
                        "map": "II.assigningAuthorityName but note that this is an improper use by the definition of the field.  Also Role.scoper"
                    },
                    {
                        "identity": "servd",
                        "map": "./IdentifierIssuingAuthority"
                    }
                ]
            },
            {
                "id": "Patient.active",
                "path": "Patient.active",
                "short": "Whether this patient's record is in active use",
                "definition": "Whether this patient record is in active use. \nMany systems use this property to mark as non-current patients, such as those that have not been seen for a period of time based on an organization's business rules.\n\nIt is often used to filter patient lists to exclude inactive patients\n\nDeceased patients may also be marked as inactive for the same reasons, but may be active for some time after death.",
                "comment": "If a record is inactive, and linked to an active record, then future patient/record updates should occur on the other patient.",
                "requirements": "Need to be able to mark a patient record as not to be used because it was created in error.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.active",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "boolean"
                    }
                ],
                "meaningWhenMissing": "This resource is generally assumed to be active if no value is provided for the active element",
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "w5",
                        "map": "FiveWs.status"
                    },
                    {
                        "identity": "rim",
                        "map": "statusCode"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.name",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name",
                "short": "(USCDI) A name associated with the patient",
                "definition": "A name associated with the individual.",
                "comment": "A patient may have multiple names with different uses or applicable periods. For animals, the name is a \"HumanName\" in the sense that is assigned and used by humans and has the same patterns.",
                "requirements": "Need to be able to track the patient by multiple names. Examples are your official name and a partner name.",
                "min": 1,
                "max": "*",
                "base": {
                    "path": "Patient.name",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "HumanName"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "us-core-6",
                        "severity": "error",
                        "human": "At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present.",
                        "expression": "(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()",
                        "xpath": "(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason' and not(/f:family or /f:given)) or (not(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason') and (/f:family or /f:given))"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-5, PID-9"
                    },
                    {
                        "identity": "rim",
                        "map": "name"
                    },
                    {
                        "identity": "cda",
                        "map": ".patient.name"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name"
                    }
                ]
            },
            {
                "id": "Patient.name.id",
                "path": "Patient.name.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.name.extension",
                "path": "Patient.name.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "description": "Extensions are always sliced by (at least) url",
                    "rules": "open"
                },
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.name.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.use",
                "short": "(USCDI) usual | official | temp | nickname | anonymous | old | maiden",
                "definition": "Identifies the purpose for this name.",
                "comment": "Applications can assume that a name is current unless it explicitly says that it is temporary or old.",
                "requirements": "Allows the appropriate name for a particular context of use to be selected from among a set of names.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "HumanName.use",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This is labeled as \"Is Modifier\" because applications should not mistake a temporary or old name etc.for a current/permanent one",
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "NameUse"
                        }
                    ],
                    "strength": "required",
                    "description": "The use of a human name.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/name-use|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN.7, but often indicated by which field contains the name"
                    },
                    {
                        "identity": "rim",
                        "map": "unique(./use)"
                    },
                    {
                        "identity": "servd",
                        "map": "./NamePurpose"
                    }
                ]
            },
            {
                "id": "Patient.name.text",
                "path": "Patient.name.text",
                "short": "Text representation of the full name",
                "definition": "Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts.",
                "comment": "Can provide both a text representation and parts. Applications updating a name SHALL ensure that when both text and parts are present,  no content is included in the text that isn't found in a part.",
                "requirements": "A renderable, unencoded form.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "HumanName.text",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "implied by XPN.11"
                    },
                    {
                        "identity": "rim",
                        "map": "./formatted"
                    }
                ]
            },
            {
                "id": "Patient.name.family",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.family",
                "short": "(USCDI) Family name (often called 'Surname')",
                "definition": "The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father.",
                "comment": "Family Name may be decomposed into specific parts using extensions (de, nl, es related cultures).",
                "alias":  [
                    "surname"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "HumanName.family",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "condition":  [
                    "us-core-6"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN.1/FN.1"
                    },
                    {
                        "identity": "rim",
                        "map": "./part[partType = FAM]"
                    },
                    {
                        "identity": "servd",
                        "map": "./FamilyName"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name.family"
                    }
                ]
            },
            {
                "id": "Patient.name.given",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.given",
                "short": "(USCDI) Given names (not always 'first'). Includes middle names",
                "definition": "Given name.",
                "comment": "If only initials are recorded, they may be used in place of the full name parts. Initials may be separated into multiple given names but often aren't due to paractical limitations.  This element is not called \"first name\" since given names do not always come first.",
                "alias":  [
                    "first name",
                    "middle name"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "HumanName.given",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "orderMeaning": "Given Names appear in the correct order for presenting the name",
                "condition":  [
                    "us-core-6"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN.2 + XPN.3"
                    },
                    {
                        "identity": "rim",
                        "map": "./part[partType = GIV]"
                    },
                    {
                        "identity": "servd",
                        "map": "./GivenNames"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name.given"
                    }
                ]
            },
            {
                "id": "Patient.name.prefix",
                "path": "Patient.name.prefix",
                "short": "Parts that come before the name",
                "definition": "Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "HumanName.prefix",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "orderMeaning": "Prefixes appear in the correct order for presenting the name",
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN.5"
                    },
                    {
                        "identity": "rim",
                        "map": "./part[partType = PFX]"
                    },
                    {
                        "identity": "servd",
                        "map": "./TitleCode"
                    }
                ]
            },
            {
                "id": "Patient.name.suffix",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.suffix",
                "short": "(USCDI) Parts that come after the name",
                "definition": "Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "HumanName.suffix",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "orderMeaning": "Suffixes appear in the correct order for presenting the name",
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN/4"
                    },
                    {
                        "identity": "rim",
                        "map": "./part[partType = SFX]"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.name.period",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.period",
                "short": "(USCDI) Time period when name was/is in use",
                "definition": "Indicates the period of time when this name was valid for the named person.",
                "requirements": "Allows names to be placed in historical context.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "HumanName.period",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XPN.13 + XPN.14"
                    },
                    {
                        "identity": "rim",
                        "map": "./usablePeriod[type=\"IVL<TS>\"]"
                    },
                    {
                        "identity": "servd",
                        "map": "./StartDate and ./EndDate"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom",
                "short": "(USCDI) A contact detail for the individual",
                "definition": "A contact detail (e.g. a telephone number or an email address) by which the individual may be contacted.",
                "comment": "A Patient may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently and also to help with identification. The address might not go directly to the individual, but may reach another party that is able to proxy for the patient (i.e. home phone, or pet owner's phone).",
                "requirements": "People have (primary) ways to contact them in some way such as phone, email.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.telecom",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "ContactPoint"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-13, PID-14, PID-40"
                    },
                    {
                        "identity": "rim",
                        "map": "telecom"
                    },
                    {
                        "identity": "cda",
                        "map": ".telecom"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.id",
                "path": "Patient.telecom.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.telecom.extension",
                "path": "Patient.telecom.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "description": "Extensions are always sliced by (at least) url",
                    "rules": "open"
                },
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.telecom.system",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.system",
                "short": "(USCDI) phone | fax | email | pager | url | sms | other",
                "definition": "Telecommunications form for contact point - what communications system is required to make use of the contact.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "ContactPoint.system",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "condition":  [
                    "cpt-2"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "strength": "required",
                    "description": "Telecommunications form for contact point.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/contact-point-system"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XTN.3"
                    },
                    {
                        "identity": "rim",
                        "map": "./scheme"
                    },
                    {
                        "identity": "servd",
                        "map": "./ContactPointType"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.value",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.value",
                "short": "(USCDI) The actual contact point details",
                "definition": "The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).",
                "comment": "Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value.",
                "requirements": "Need to support legacy numbers that are not in a tightly controlled format.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "ContactPoint.value",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XTN.1 (or XTN.12)"
                    },
                    {
                        "identity": "rim",
                        "map": "./url"
                    },
                    {
                        "identity": "servd",
                        "map": "./Value"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.use",
                "short": "(USCDI) home | work | temp | old | mobile - purpose of this contact point",
                "definition": "Identifies the purpose for the contact point.",
                "comment": "Applications can assume that a contact is current unless it explicitly says that it is temporary or old.",
                "requirements": "Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "ContactPoint.use",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": true,
                "isModifierReason": "This is labeled as \"Is Modifier\" because applications should not mistake a temporary or old contact etc.for a current/permanent one",
                "isSummary": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "http://hl7.org/fhir/ValueSet/contact-point-use"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XTN.2 - but often indicated by field"
                    },
                    {
                        "identity": "rim",
                        "map": "unique(./use)"
                    },
                    {
                        "identity": "servd",
                        "map": "./ContactPointPurpose"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.rank",
                "path": "Patient.telecom.rank",
                "short": "Specify preferred order of use (1 = highest)",
                "definition": "Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values.",
                "comment": "Note that rank does not necessarily follow the order in which the contacts are represented in the instance.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "ContactPoint.rank",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "positiveInt"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "n/a"
                    },
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.telecom.period",
                "path": "Patient.telecom.period",
                "short": "Time period when the contact point was/is in use",
                "definition": "Time period when the contact point was/is in use.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "ContactPoint.period",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "N/A"
                    },
                    {
                        "identity": "rim",
                        "map": "./usablePeriod[type=\"IVL<TS>\"]"
                    },
                    {
                        "identity": "servd",
                        "map": "./StartDate and ./EndDate"
                    }
                ]
            },
            {
                "id": "Patient.gender",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.gender",
                "short": "(USCDI) male | female | other | unknown",
                "definition": "Administrative Gender - the gender that the patient is considered to have for administration and record keeping purposes.",
                "comment": "The gender might not match the biological sex as determined by genetics or the individual's preferred identification. Note that for both humans and particularly animals, there are other legitimate possibilities than male and female, though the vast majority of systems and contexts only support male and female.  Systems providing decision support or enforcing business rules should ideally do this on the basis of Observations dealing with the specific sex or gender aspect of interest (anatomical, chromosomal, social, etc.)  However, because these observations are infrequently recorded, defaulting to the administrative gender is common practice.  Where such defaulting occurs, rule enforcement should allow for the variation between administrative and biological, chromosomal and other gender aspects.  For example, an alert about a hysterectomy on a male should be handled as a warning or overridable error, not a \"hard\" error.  See the Patient Gender and Sex section for additional information about communicating patient gender and sex.",
                "requirements": "Needed for identification of the individual, in combination with (at least) name and birth date.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Patient.gender",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-8"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender"
                    },
                    {
                        "identity": "cda",
                        "map": ".patient.administrativeGenderCode"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.gender"
                    }
                ]
            },
            {
                "id": "Patient.birthDate",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.birthDate",
                "short": "(USCDI) The date of birth for the individual",
                "definition": "The date of birth for the individual.",
                "comment": "At least an estimated year should be provided as a guess if the real DOB is unknown  There is a standard extension \"patient-birthTime\" available that should be used where Time is required (such as in maternity/infant care systems).",
                "requirements": "Age of the individual drives many clinical processes.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.birthDate",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "date"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-7"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime"
                    },
                    {
                        "identity": "cda",
                        "map": ".patient.birthTime"
                    },
                    {
                        "identity": "loinc",
                        "map": "21112-8"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.birthDate"
                    }
                ]
            },
            {
                "id": "Patient.deceased[x]",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.deceased[x]",
                "short": "(USCDI) Indicates if the individual is deceased or not",
                "definition": "Indicates if the individual is deceased or not.",
                "comment": "If there's no value in the instance, it means there is no statement on whether or not the individual is deceased. Most systems will interpret the absence of a value as a sign of the person being alive.",
                "requirements": "The fact that a patient is deceased influences the clinical process. Also, in human communication and relation management it is necessary to know whether the person is alive.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.deceased[x]",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "boolean"
                    },
                    {
                        "code": "dateTime"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This element is labeled as a modifier because once a patient is marked as deceased, the actions that are appropriate to perform on the patient may be significantly different.",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-30  (bool) and PID-29 (datetime)"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.address",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address",
                "short": "(USCDI) An address for the individual",
                "definition": "An address for the individual.",
                "comment": "Patient may have multiple addresses with different uses or applicable periods.",
                "requirements": "May need to keep track of patient addresses for contacting, billing or reporting requirements and also to help with identification.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.address",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Address"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-11"
                    },
                    {
                        "identity": "rim",
                        "map": "addr"
                    },
                    {
                        "identity": "cda",
                        "map": ".addr"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.birthDate"
                    }
                ]
            },
            {
                "id": "Patient.address.id",
                "path": "Patient.address.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.address.extension",
                "path": "Patient.address.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "description": "Extensions are always sliced by (at least) url",
                    "rules": "open"
                },
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.address.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.use",
                "short": "(USCDI) home | work | temp | old | billing - purpose of this address",
                "definition": "The purpose of this address.",
                "comment": "Applications can assume that an address is current unless it explicitly says that it is temporary or old.",
                "requirements": "Allows an appropriate address to be chosen from a list of many.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.use",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueCode": "home"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This is labeled as \"Is Modifier\" because applications should not mistake a temporary or old address etc.for a current/permanent one",
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "AddressUse"
                        }
                    ],
                    "strength": "required",
                    "description": "The use of an address.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/address-use|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.7"
                    },
                    {
                        "identity": "rim",
                        "map": "unique(./use)"
                    },
                    {
                        "identity": "servd",
                        "map": "./AddressPurpose"
                    }
                ]
            },
            {
                "id": "Patient.address.type",
                "path": "Patient.address.type",
                "short": "postal | physical | both",
                "definition": "Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both.",
                "comment": "The definition of Address states that \"address is intended to describe postal addresses, not physical locations\". However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the [Location](http://hl7.org/fhir/R4/location.html#) resource).",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.type",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueCode": "both"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "AddressType"
                        }
                    ],
                    "strength": "required",
                    "description": "The type of an address (physical / postal).",
                    "valueSet": "http://hl7.org/fhir/ValueSet/address-type|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.18"
                    },
                    {
                        "identity": "rim",
                        "map": "unique(./use)"
                    },
                    {
                        "identity": "vcard",
                        "map": "address type parameter"
                    }
                ]
            },
            {
                "id": "Patient.address.text",
                "path": "Patient.address.text",
                "short": "Text representation of the address",
                "definition": "Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts.",
                "comment": "Can provide both a text representation and parts. Applications updating an address SHALL ensure that  when both text and parts are present,  no content is included in the text that isn't found in a part.",
                "requirements": "A renderable, unencoded form.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.text",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueString": "137 Nowhere Street, Erewhon 9132"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6"
                    },
                    {
                        "identity": "rim",
                        "map": "./formatted"
                    },
                    {
                        "identity": "vcard",
                        "map": "address label parameter"
                    }
                ]
            },
            {
                "id": "Patient.address.line",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.line",
                "short": "(USCDI) Street name, number, direction & P.O. Box etc.",
                "definition": "This component contains the house number, apartment number, street name, street direction,  P.O. Box number, delivery hints, and similar address information.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Address.line",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "orderMeaning": "The order in which lines should appear in an address label",
                "example":  [
                    {
                        "label": "General",
                        "valueString": "137 Nowhere Street"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = AL]"
                    },
                    {
                        "identity": "vcard",
                        "map": "street"
                    },
                    {
                        "identity": "servd",
                        "map": "./StreetAddress (newline delimitted)"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.city",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.city",
                "short": "(USCDI) Name of city, town etc.",
                "definition": "The name of the city, town, suburb, village or other community or delivery center.",
                "alias":  [
                    "Municpality"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.city",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueString": "Erewhon"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.3"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = CTY]"
                    },
                    {
                        "identity": "vcard",
                        "map": "locality"
                    },
                    {
                        "identity": "servd",
                        "map": "./Jurisdiction"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.district",
                "path": "Patient.address.district",
                "short": "District name (aka county)",
                "definition": "The name of the administrative area (county).",
                "comment": "District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead.",
                "alias":  [
                    "County"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.district",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueString": "Madison"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.9"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = CNT | CPA]"
                    }
                ]
            },
            {
                "id": "Patient.address.state",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.state",
                "short": "(USCDI) Sub-unit of country (abbreviations ok)",
                "definition": "Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).",
                "alias":  [
                    "Province",
                    "Territory"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.state",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "strength": "extensible",
                    "description": "Two Letter USPS alphabetic codes.",
                    "valueSet": "http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.4"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = STA]"
                    },
                    {
                        "identity": "vcard",
                        "map": "region"
                    },
                    {
                        "identity": "servd",
                        "map": "./Region"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.postalCode",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.postalCode",
                "short": "(USCDI) US Zip Codes",
                "definition": "A postal code designating a region defined by the postal service.",
                "alias":  [
                    "Zip",
                    "Zip Code"
                ],
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.postalCode",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valueString": "9132"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.5"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = ZIP]"
                    },
                    {
                        "identity": "vcard",
                        "map": "code"
                    },
                    {
                        "identity": "servd",
                        "map": "./PostalIdentificationCode"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.country",
                "path": "Patient.address.country",
                "short": "Country (e.g. can be ISO 3166 2 or 3 letter code)",
                "definition": "Country - a nation as commonly understood or generally accepted.",
                "comment": "ISO 3166 3 letter codes can be used in place of a human readable country name.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.country",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "string"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.6"
                    },
                    {
                        "identity": "rim",
                        "map": "AD.part[parttype = CNT]"
                    },
                    {
                        "identity": "vcard",
                        "map": "country"
                    },
                    {
                        "identity": "servd",
                        "map": "./Country"
                    }
                ]
            },
            {
                "id": "Patient.address.period",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.period",
                "short": "(USCDI) Time period when address was/is in use",
                "definition": "Time period when address was/is in use.",
                "requirements": "Allows addresses to be placed in historical context.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Address.period",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "example":  [
                    {
                        "label": "General",
                        "valuePeriod": {
                            "start": "2010-03-23",
                            "end": "2010-07-01"
                        }
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "XAD.12 / XAD.13 + XAD.14"
                    },
                    {
                        "identity": "rim",
                        "map": "./usablePeriod[type=\"IVL<TS>\"]"
                    },
                    {
                        "identity": "servd",
                        "map": "./StartDate and ./EndDate"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.maritalStatus",
                "path": "Patient.maritalStatus",
                "short": "Marital (civil) status of a patient",
                "definition": "This field contains a patient's most recent marital (civil) status.",
                "requirements": "Most, if not all systems capture it.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.maritalStatus",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "MaritalStatus"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding",
                            "valueBoolean": true
                        }
                    ],
                    "strength": "extensible",
                    "description": "The domestic partnership status of a person.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/marital-status"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-16"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN]/maritalStatusCode"
                    },
                    {
                        "identity": "cda",
                        "map": ".patient.maritalStatusCode"
                    }
                ]
            },
            {
                "id": "Patient.multipleBirth[x]",
                "path": "Patient.multipleBirth[x]",
                "short": "Whether patient is part of a multiple birth",
                "definition": "Indicates whether the patient is part of a multiple (boolean) or indicates the actual birth order (integer).",
                "comment": "Where the valueInteger is provided, the number is the birth number in the sequence. E.g. The middle birth in triplets would be valueInteger=2 and the third born would have valueInteger=3 If a boolean value was provided for this triplets example, then all 3 patient records would have valueBoolean=true (the ordering is not indicated).",
                "requirements": "For disambiguation of multiple-birth children, especially relevant where the care provider doesn't meet the patient, such as labs.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.multipleBirth[x]",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "boolean"
                    },
                    {
                        "code": "integer"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-24 (bool), PID-25 (integer)"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd,  player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.photo",
                "path": "Patient.photo",
                "short": "Image of the patient",
                "definition": "Image of the patient.",
                "comment": "Guidelines:\n* Use id photos, not clinical photos.\n* Limit dimensions to thumbnail.\n* Keep byte count low to ease resource updates.",
                "requirements": "Many EHR systems have the capability to capture an image of the patient. Fits with newer social media usage too.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.photo",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Attachment"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "OBX-5 - needs a profile"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-explicit-type-name",
                        "valueString": "Contact"
                    }
                ],
                "path": "Patient.contact",
                "short": "A contact party (e.g. guardian, partner, friend) for the patient",
                "definition": "A contact party (e.g. guardian, partner, friend) for the patient.",
                "comment": "Contact covers all kinds of contact parties: family members, business contacts, guardians, caregivers. Not applicable to register pedigree and family ties beyond use of having contact.",
                "requirements": "Need to track people you can contact about the patient.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.contact",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "BackboneElement"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "pat-1",
                        "severity": "error",
                        "human": "SHALL at least contain a contact's details or a reference to an organization",
                        "expression": "name.exists() or telecom.exists() or address.exists() or organization.exists()",
                        "xpath": "exists(f:name) or exists(f:telecom) or exists(f:address) or exists(f:organization)",
                        "source": "http://hl7.org/fhir/StructureDefinition/Patient"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.id",
                "path": "Patient.contact.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.extension",
                "path": "Patient.contact.extension",
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.modifierExtension",
                "path": "Patient.contact.modifierExtension",
                "short": "Extensions that cannot be ignored even if unrecognized",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
                "alias":  [
                    "extensions",
                    "user content",
                    "modifiers"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "BackboneElement.modifierExtension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "N/A"
                    }
                ]
            },
            {
                "id": "Patient.contact.relationship",
                "path": "Patient.contact.relationship",
                "short": "The kind of relationship",
                "definition": "The nature of the relationship between the patient and the contact person.",
                "requirements": "Used to determine which contact person is the most relevant to approach, depending on circumstances.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.contact.relationship",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "ContactRelationship"
                        }
                    ],
                    "strength": "extensible",
                    "description": "The nature of the relationship between a patient and a contact person for that patient.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/patient-contactrelationship"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-7, NK1-3"
                    },
                    {
                        "identity": "rim",
                        "map": "code"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.name",
                "path": "Patient.contact.name",
                "short": "A name associated with the contact person",
                "definition": "A name associated with the contact person.",
                "requirements": "Contact persons need to be identified by name, but it is uncommon to need details about multiple other names for that contact person.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.contact.name",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "HumanName"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-2"
                    },
                    {
                        "identity": "rim",
                        "map": "name"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.telecom",
                "path": "Patient.contact.telecom",
                "short": "A contact detail for the person",
                "definition": "A contact detail for the person, e.g. a telephone number or an email address.",
                "comment": "Contact may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently, and also to help with identification.",
                "requirements": "People have (primary) ways to contact them in some way such as phone, email.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.contact.telecom",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "ContactPoint"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-5, NK1-6, NK1-40"
                    },
                    {
                        "identity": "rim",
                        "map": "telecom"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.address",
                "path": "Patient.contact.address",
                "short": "Address for the contact person",
                "definition": "Address for the contact person.",
                "requirements": "Need to keep track where the contact person can be contacted per postal mail or visited.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.contact.address",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Address"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-4"
                    },
                    {
                        "identity": "rim",
                        "map": "addr"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.gender",
                "path": "Patient.contact.gender",
                "short": "male | female | other | unknown",
                "definition": "Administrative Gender - the gender that the contact person is considered to have for administration and record keeping purposes.",
                "requirements": "Needed to address the person correctly.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.contact.gender",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "AdministrativeGender"
                        },
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding",
                            "valueBoolean": true
                        }
                    ],
                    "strength": "required",
                    "description": "The gender of a person used for administrative purposes.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-15"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.organization",
                "path": "Patient.contact.organization",
                "short": "Organization that is associated with the contact",
                "definition": "Organization on behalf of which the contact is acting or for which the contact is working.",
                "requirements": "For guardians or business related contacts, the organization is relevant.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.contact.organization",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Organization"
                        ]
                    }
                ],
                "condition":  [
                    "pat-1"
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "NK1-13, NK1-30, NK1-31, NK1-32, NK1-41"
                    },
                    {
                        "identity": "rim",
                        "map": "scoper"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.contact.period",
                "path": "Patient.contact.period",
                "short": "The period during which this contact person or organization is valid to be contacted relating to this patient",
                "definition": "The period during which this contact person or organization is valid to be contacted relating to this patient.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.contact.period",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "effectiveTime"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.communication",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.communication",
                "short": "(USCDI) A language which may be used to communicate with the patient about his or her health",
                "definition": "A language which may be used to communicate with the patient about his or her health.",
                "comment": "If no language is specified, this *implies* that the default local language is spoken.  If you need to convey proficiency for multiple modes, then you need multiple Patient.Communication associations.   For animals, language is not a relevant field, and should be absent from the instance. If the Patient does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required.",
                "requirements": "If a patient does not speak the local language, interpreters may be required, so languages spoken and proficiency are important things to keep track of both for patient and other persons of interest.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.communication",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "BackboneElement"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": false,
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "LanguageCommunication"
                    },
                    {
                        "identity": "cda",
                        "map": "patient.languageCommunication"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.communication"
                    }
                ]
            },
            {
                "id": "Patient.communication.id",
                "path": "Patient.communication.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.communication.extension",
                "path": "Patient.communication.extension",
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.communication.modifierExtension",
                "path": "Patient.communication.modifierExtension",
                "short": "Extensions that cannot be ignored even if unrecognized",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
                "alias":  [
                    "extensions",
                    "user content",
                    "modifiers"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "BackboneElement.modifierExtension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "N/A"
                    }
                ]
            },
            {
                "id": "Patient.communication.language",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.communication.language",
                "short": "(USCDI) The language which can be used to communicate with the patient about his or her health",
                "definition": "The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. \"en\" for English, or \"en-US\" for American English versus \"en-EN\" for England English.",
                "comment": "The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type.",
                "requirements": "Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Patient.communication.language",
                    "min": 1,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "mustSupport": true,
                "isModifier": false,
                "isSummary": false,
                "binding": {
                    "strength": "extensible",
                    "valueSet": "http://hl7.org/fhir/us/core/ValueSet/simple-language"
                },
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-15, LAN-2"
                    },
                    {
                        "identity": "rim",
                        "map": "player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code"
                    },
                    {
                        "identity": "cda",
                        "map": ".languageCode"
                    },
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.communication.language"
                    }
                ]
            },
            {
                "id": "Patient.communication.preferred",
                "path": "Patient.communication.preferred",
                "short": "Language preference indicator",
                "definition": "Indicates whether or not the patient prefers this language (over other languages he masters up a certain level).",
                "comment": "This language is specifically identified for communicating healthcare information.",
                "requirements": "People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.communication.preferred",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "boolean"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-15"
                    },
                    {
                        "identity": "rim",
                        "map": "preferenceInd"
                    },
                    {
                        "identity": "cda",
                        "map": ".preferenceInd"
                    }
                ]
            },
            {
                "id": "Patient.generalPractitioner",
                "path": "Patient.generalPractitioner",
                "short": "Patient's nominated primary care provider",
                "definition": "Patient's nominated care provider.",
                "comment": "This may be the primary care provider (in a GP context), or it may be a patient nominated care manager in a community/disability setting, or even organization that will provide people to perform the care provider roles.  It is not to be used to record Care Teams, these should be in a CareTeam resource that may be linked to the CarePlan or EpisodeOfCare resources.\nMultiple GPs may be recorded against the patient for various reasons, such as a student that has his home GP listed along with the GP at university during the school semesters, or a \"fly-in/fly-out\" worker that has the onsite GP also included with his home GP to remain aware of medical issues.\n\nJurisdictions may decide that they can profile this down to 1 if desired, or 1 per type.",
                "alias":  [
                    "careProvider"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.generalPractitioner",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Organization",
                            "http://hl7.org/fhir/StructureDefinition/Practitioner",
                            "http://hl7.org/fhir/StructureDefinition/PractitionerRole"
                        ]
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PD1-4"
                    },
                    {
                        "identity": "rim",
                        "map": "subjectOf.CareEvent.performer.AssignedEntity"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.managingOrganization",
                "path": "Patient.managingOrganization",
                "short": "Organization that is the custodian of the patient record",
                "definition": "Organization that is the custodian of the patient record.",
                "comment": "There is only one managing organization for a specific patient record. Other organizations will have their own Patient record, and may use the Link property to join the records together (or a Person resource which can include confidence ratings for the association).",
                "requirements": "Need to know who recognizes this patient record, manages and updates it.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Patient.managingOrganization",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Organization"
                        ]
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "scoper"
                    },
                    {
                        "identity": "cda",
                        "map": ".providerOrganization"
                    }
                ]
            },
            {
                "id": "Patient.link",
                "path": "Patient.link",
                "short": "Link to another patient resource that concerns the same actual person",
                "definition": "Link to another patient resource that concerns the same actual patient.",
                "comment": "There is no assumption that linked patient records have mutual links.",
                "requirements": "There are multiple use cases:   \n\n* Duplicate patient records due to the clerical errors associated with the difficulties of identifying humans consistently, and \n* Distribution of patient information across multiple servers.",
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Patient.link",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "BackboneElement"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "This element is labeled as a modifier because it might not be the main Patient resource, and the referenced patient should be used instead of this Patient record. This is when the link.type value is 'replaced-by'",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "outboundLink"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.link.id",
                "path": "Patient.link.id",
                "representation":  [
                    "xmlAttr"
                ],
                "short": "Unique id for inter-element referencing",
                "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
                "min": 0,
                "max": "1",
                "base": {
                    "path": "Element.id",
                    "min": 0,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                                "valueUrl": "string"
                            }
                        ],
                        "code": "http://hl7.org/fhirpath/System.String"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.link.extension",
                "path": "Patient.link.extension",
                "short": "Additional content defined by implementations",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "alias":  [
                    "extensions",
                    "user content"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "Element.extension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": false,
                "isSummary": false,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.link.modifierExtension",
                "path": "Patient.link.modifierExtension",
                "short": "Extensions that cannot be ignored even if unrecognized",
                "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
                "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
                "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
                "alias":  [
                    "extensions",
                    "user content",
                    "modifiers"
                ],
                "min": 0,
                "max": "*",
                "base": {
                    "path": "BackboneElement.modifierExtension",
                    "min": 0,
                    "max": "*"
                },
                "type":  [
                    {
                        "code": "Extension"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    },
                    {
                        "key": "ext-1",
                        "severity": "error",
                        "human": "Must have either extensions or value[x], not both",
                        "expression": "extension.exists() != value.exists()",
                        "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
                        "source": "http://hl7.org/fhir/StructureDefinition/Extension"
                    }
                ],
                "isModifier": true,
                "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "N/A"
                    }
                ]
            },
            {
                "id": "Patient.link.other",
                "path": "Patient.link.other",
                "short": "The other patient or related person resource that the link refers to",
                "definition": "The other patient resource that the link refers to.",
                "comment": "Referencing a RelatedPerson here removes the need to use a Person record to associate a Patient and RelatedPerson as the same individual.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Patient.link.other",
                    "min": 1,
                    "max": "1"
                },
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy",
                                "valueBoolean": false
                            }
                        ],
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Patient",
                            "http://hl7.org/fhir/StructureDefinition/RelatedPerson"
                        ]
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "mapping":  [
                    {
                        "identity": "v2",
                        "map": "PID-3, MRG-1"
                    },
                    {
                        "identity": "rim",
                        "map": "id"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            },
            {
                "id": "Patient.link.type",
                "path": "Patient.link.type",
                "short": "replaced-by | replaces | refer | seealso",
                "definition": "The type of link between this patient resource and another patient resource.",
                "min": 1,
                "max": "1",
                "base": {
                    "path": "Patient.link.type",
                    "min": 1,
                    "max": "1"
                },
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "constraint":  [
                    {
                        "key": "ele-1",
                        "severity": "error",
                        "human": "All FHIR elements must have a @value or children",
                        "expression": "hasValue() or (children().count() > id.count())",
                        "xpath": "@value|f:*|h:div",
                        "source": "http://hl7.org/fhir/StructureDefinition/Element"
                    }
                ],
                "isModifier": false,
                "isSummary": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "LinkType"
                        }
                    ],
                    "strength": "required",
                    "description": "The type of link between this patient resource and another patient resource.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/link-type|4.0.1"
                },
                "mapping":  [
                    {
                        "identity": "rim",
                        "map": "typeCode"
                    },
                    {
                        "identity": "cda",
                        "map": "n/a"
                    }
                ]
            }
        ]
    },
    "differential": {
        "element":  [
            {
                "id": "Patient",
                "path": "Patient",
                "definition": "\\-",
                "comment": "\\-",
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient"
                    }
                ]
            },
            {
                "id": "Patient.extension:race",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "race",
                "short": "(USCDI) US Core Race Extension",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
                        ]
                    }
                ],
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:ethnicity",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "ethnicity",
                "short": "(USCDI) US Core ethnicity Extension",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
                        ]
                    }
                ],
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:tribalAffiliation",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "tribalAffiliation",
                "short": "(USCDI) Tribal Affiliation Extension",
                "min": 0,
                "max": "*",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation"
                        ]
                    }
                ],
                "mustSupport": false
            },
            {
                "id": "Patient.extension:birthsex",
                "path": "Patient.extension",
                "sliceName": "birthsex",
                "short": "Birth Sex Extension",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex"
                        ]
                    }
                ],
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.extension"
                    }
                ]
            },
            {
                "id": "Patient.extension:sex",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "sex",
                "short": "(USCDI) Sex Extension",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex"
                        ]
                    }
                ],
                "mustSupport": false
            },
            {
                "id": "Patient.extension:genderIdentity",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.extension",
                "sliceName": "genderIdentity",
                "short": "(USCDI) The individual's gender identity",
                "min": 0,
                "max": "*",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity"
                        ]
                    }
                ],
                "mustSupport": false
            },
            {
                "id": "Patient.identifier",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier",
                "short": "(USCDI) An identifier for this patient",
                "min": 1,
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier"
                    }
                ]
            },
            {
                "id": "Patient.identifier.system",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier.system",
                "short": "(USCDI) The namespace for the identifier value",
                "min": 1,
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier.system"
                    }
                ]
            },
            {
                "id": "Patient.identifier.value",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.identifier.value",
                "short": "(USCDI) The value that is unique within the system.",
                "min": 1,
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.identifier.value"
                    }
                ]
            },
            {
                "id": "Patient.name",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name",
                "short": "(USCDI) A name associated with the patient",
                "min": 1,
                "constraint":  [
                    {
                        "key": "us-core-6",
                        "severity": "error",
                        "human": "At least name.given and/or name.family are present or, if neither is available, the Data Absent Reason Extension is present.",
                        "expression": "(family.exists() or given.exists()) xor extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists()",
                        "xpath": "(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason' and not(/f:family or /f:given)) or (not(/f:extension/@url='http://hl7.org/fhir/StructureDefinition/data-absent-reason') and (/f:family or /f:given))"
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name"
                    }
                ]
            },
            {
                "id": "Patient.name.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.use",
                "short": "(USCDI) usual | official | temp | nickname | anonymous | old | maiden"
            },
            {
                "id": "Patient.name.family",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.family",
                "short": "(USCDI) Family name (often called 'Surname')",
                "condition":  [
                    "us-core-6"
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name.family"
                    }
                ]
            },
            {
                "id": "Patient.name.given",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.given",
                "short": "(USCDI) Given names (not always 'first'). Includes middle names",
                "condition":  [
                    "us-core-6"
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.name.given"
                    }
                ]
            },
            {
                "id": "Patient.name.suffix",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.suffix",
                "short": "(USCDI) Parts that come after the name",
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.name.period",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.name.period",
                "short": "(USCDI) Time period when name was/is in use",
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom",
                "short": "(USCDI) A contact detail for the individual",
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.system",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.system",
                "short": "(USCDI) phone | fax | email | pager | url | sms | other",
                "min": 1,
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "description": "Telecommunications form for contact point.",
                    "valueSet": "http://hl7.org/fhir/ValueSet/contact-point-system"
                },
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.value",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.value",
                "short": "(USCDI) The actual contact point details",
                "min": 1,
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.telecom.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.telecom.use",
                "short": "(USCDI) home | work | temp | old | mobile - purpose of this contact point",
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "http://hl7.org/fhir/ValueSet/contact-point-use"
                },
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.gender",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.gender",
                "short": "(USCDI) male | female | other | unknown",
                "min": 1,
                "type":  [
                    {
                        "code": "code"
                    }
                ],
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender"
                },
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.gender"
                    }
                ]
            },
            {
                "id": "Patient.birthDate",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.birthDate",
                "short": "(USCDI) The date of birth for the individual",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.birthDate"
                    }
                ]
            },
            {
                "id": "Patient.deceased[x]",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.deceased[x]",
                "short": "(USCDI) Indicates if the individual is deceased or not"
            },
            {
                "id": "Patient.address",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address",
                "short": "(USCDI) An address for the individual",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.birthDate"
                    }
                ]
            },
            {
                "id": "Patient.address.use",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.use",
                "short": "(USCDI) home | work | temp | old | billing - purpose of this address"
            },
            {
                "id": "Patient.address.line",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.line",
                "short": "(USCDI) Street name, number, direction & P.O. Box etc.",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.city",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.city",
                "short": "(USCDI) Name of city, town etc.",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.state",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.state",
                "short": "(USCDI) Sub-unit of country (abbreviations ok)",
                "mustSupport": true,
                "binding": {
                    "strength": "extensible",
                    "description": "Two Letter USPS alphabetic codes.",
                    "valueSet": "http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state"
                },
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.postalCode",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.postalCode",
                "short": "(USCDI) US Zip Codes",
                "alias":  [
                    "Zip Code"
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.address.period",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.address.period",
                "short": "(USCDI) Time period when address was/is in use",
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "NA"
                    }
                ]
            },
            {
                "id": "Patient.communication",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.communication",
                "short": "(USCDI) A language which may be used to communicate with the patient about his or her health",
                "mustSupport": false,
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.communication"
                    }
                ]
            },
            {
                "id": "Patient.communication.language",
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement",
                        "valueBoolean": true
                    }
                ],
                "path": "Patient.communication.language",
                "short": "(USCDI) The language which can be used to communicate with the patient about his or her health",
                "mustSupport": true,
                "binding": {
                    "strength": "extensible",
                    "valueSet": "http://hl7.org/fhir/us/core/ValueSet/simple-language"
                },
                "mapping":  [
                    {
                        "identity": "argonaut-dq-dstu2",
                        "map": "Patient.communication.language"
                    }
                ]
            }
        ]
    }
}