{"abstract":false,"baseDefinition":"http://hl7.org/fhir/StructureDefinition/DataType","contact":[{"telecom":[{"system":"url","value":"http://hl7.org/fhir"}]},{"telecom":[{"system":"url","value":"http://www.hl7.org/Special/committees/fiwg"}]}],"date":"2026-03-29T21:54:20+00:00","derivation":"specialization","description":"Ratio Type: A relationship of two Quantity values - expressed as a numerator and a denominator.","differential":{"element":[{"comment":"The Ratio datatype should only be used to express a relationship of two numbers if the relationship cannot be suitably expressed using a Quantity and a common unit. Where the denominator value is known to be fixed to \"1\", Quantity should be used instead of Ratio.","constraint":[{"expression":"(numerator.exists() and denominator.exists()) or (numerator.empty() and denominator.empty() and extension.exists())","human":"Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present","key":"rat-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Ratio"}],"definition":"A relationship of two Quantity values - expressed as a numerator and a denominator.","id":"Ratio","mapping":[{"identity":"v2","map":"N/A"},{"identity":"rim","map":"RTO"}],"max":"*","min":0,"path":"Ratio","short":"A ratio of two Quantity values - a numerator and a denominator"},{"condition":["rat-1"],"definition":"The value of the numerator.","id":"Ratio.numerator","isSummary":true,"mapping":[{"identity":"rim","map":".numerator"}],"max":"1","min":0,"path":"Ratio.numerator","short":"Numerator value","type":[{"code":"Quantity"}]},{"condition":["rat-1"],"definition":"The value of the denominator.","id":"Ratio.denominator","isSummary":true,"mapping":[{"identity":"rim","map":".denominator"}],"max":"1","min":0,"path":"Ratio.denominator","short":"Denominator value","type":[{"code":"Quantity","profile":["http://hl7.org/fhir/StructureDefinition/SimpleQuantity"]}]}]},"experimental":false,"extension":[{"url":"http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status","valueCode":"normative"},{"url":"http://hl7.org/fhir/StructureDefinition/structuredefinition-wg","valueCode":"fhir"}],"fhirVersion":"6.0.0-ballot4","id":"Ratio","jurisdiction":[{"coding":[{"code":"001","display":"World","system":"http://unstats.un.org/unsd/methods/m49/m49.htm"}]}],"kind":"complex-type","mapping":[{"identity":"v2","name":"HL7 V2 Mapping","uri":"http://hl7.org/v2"},{"identity":"rim","name":"RIM Mapping","uri":"http://hl7.org/v3"}],"name":"Ratio","publisher":"HL7 International / FHIR Infrastructure","purpose":"Need to able to capture ratios for some measurements (titers) and some rates (costs).","resourceType":"StructureDefinition","snapshot":{"element":[{"base":{"max":"*","min":0,"path":"Ratio"},"comment":"The Ratio datatype should only be used to express a relationship of two numbers if the relationship cannot be suitably expressed using a Quantity and a common unit. Where the denominator value is known to be fixed to \"1\", Quantity should be used instead of Ratio.","constraint":[{"expression":"hasValue() or (children().count() > id.count())","human":"All FHIR elements must have a @value or children","key":"ele-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Element"},{"expression":"(numerator.exists() and denominator.exists()) or (numerator.empty() and denominator.empty() and extension.exists())","human":"Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present","key":"rat-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Ratio"}],"definition":"A relationship of two Quantity values - expressed as a numerator and a denominator.","id":"Ratio","isModifier":false,"mapping":[{"identity":"rim","map":"n/a,RTO"},{"identity":"v2","map":"N/A"}],"max":"*","min":0,"path":"Ratio","short":"A ratio of two Quantity values - a numerator and a denominator"},{"base":{"max":"1","min":0,"path":"Element.id"},"condition":["ele-1"],"definition":"Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.","id":"Ratio.id","isModifier":false,"isSummary":false,"mapping":[{"identity":"rim","map":"n/a"}],"max":"1","min":0,"path":"Ratio.id","representation":["xmlAttr"],"short":"Unique id for inter-element referencing","type":[{"code":"http://hl7.org/fhirpath/System.String","extension":[{"url":"http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type","valueUrl":"string"}]}]},{"alias":["extensions","user content"],"base":{"max":"*","min":0,"path":"Element.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.","constraint":[{"expression":"hasValue() or (children().count() > id.count())","human":"All FHIR elements must have a @value or children","key":"ele-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Element"}],"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 managable, 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.","id":"Ratio.extension","isModifier":false,"isSummary":false,"mapping":[{"identity":"rim","map":"n/a"}],"max":"*","min":0,"path":"Ratio.extension","short":"Additional content defined by implementations","slicing":{"description":"Extensions are always sliced by (at least) url","discriminator":[{"path":"url","type":"value"}],"rules":"open"},"type":[{"code":"Extension"}]},{"base":{"max":"1","min":0,"path":"Ratio.numerator"},"condition":["rat-1"],"constraint":[{"expression":"hasValue() or (children().count() > id.count())","human":"All FHIR elements must have a @value or children","key":"ele-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Element"}],"definition":"The value of the numerator.","id":"Ratio.numerator","isModifier":false,"isSummary":true,"mapping":[{"identity":"rim","map":".numerator"}],"max":"1","min":0,"path":"Ratio.numerator","short":"Numerator value","type":[{"code":"Quantity"}]},{"base":{"max":"1","min":0,"path":"Ratio.denominator"},"condition":["rat-1"],"constraint":[{"expression":"hasValue() or (children().count() > id.count())","human":"All FHIR elements must have a @value or children","key":"ele-1","severity":"error","source":"http://hl7.org/fhir/StructureDefinition/Element"}],"definition":"The value of the denominator.","id":"Ratio.denominator","isModifier":false,"isSummary":true,"mapping":[{"identity":"rim","map":".denominator"}],"max":"1","min":0,"path":"Ratio.denominator","short":"Denominator value","type":[{"code":"Quantity","profile":["http://hl7.org/fhir/StructureDefinition/SimpleQuantity"]}]}]},"status":"active","text":{"div":"
\r\n\r\n\r\n
NameFlagsCard.TypeDescription & Constraints\"doco\"
\".\"\".\" RatioΣNElementA ratio of two Quantity values - a numerator and a denominator
+ Rule: Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present

Elements defined in Ancestors: id, extension
\".\"\".\"\".\" numeratorΣC0..1QuantityNumerator value
\".\"\".\"\".\" denominatorΣC0..1SimpleQuantityDenominator value

\"doco\" Documentation for this format
","status":"generated"},"type":"Ratio","url":"http://hl7.org/fhir/StructureDefinition/Ratio","version":"6.0.0-ballot4"}