FHIR IG Statistics: Questionnaire/questionnaire-sdc-profile-example-framingham-hchd-lhc

Resources that use this resource

No resources found

Resources that this resource uses

No resources found

Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: Questionnaire questionnaire-sdc-profile-example-framingham-hchd-lhc

Profile: SDC Base Questionnaire

Structure

LinkID	Text	Cardinality	Type	Flags	Description & Constraints
FraminghamHCHD	A form for calculating the 10-year-risk of Hard Coronary Heart Disease. The constants used in the formula match those in https://www.framinghamheartstudy.org/fhs-risk-functions/hard-coronary-heart-disease-10-year-risk/, but the actual formulas are not listed there, and so we have not been able to verify them. However, the output of this form matches the output of a perl program (from which the formulas were taken) which matched the output of a calculator on a website, which regrettably no longer exists. So, while this form is good enough or a demo, it should not be relied on for real purposes without first verifying its formulas or its output against some other source.		Questionnaire		http://hl7.org/fhir/uv/sdc/Questionnaire/questionnaire-sdc-profile-example-framingham-hchd-lhc#4.0.0-ballot
/age	Age (in years)	1..1	decimal
/age_requirement_notice	Sorry, but the formulas are only valid for ages in the range 30 to 79.	0..1	display		Enable When: /age < /age >
/46098-0	Gender	1..1	choice		Options: 2 options
/smokes	Do you smoke?	1..1	choice		Options: 2 options
/8480-6	Systolic blood pressure	1..1	decimal
/2093-3	Cholesterol [Mass/Vol]	1..1	decimal
/2085-9	Cholesterol in HDL [Mass/Vol]	1..1	decimal
/antihypertensive	Are you taking medication for high blood pressure?	1..1	choice		Options: 2 options
/all_answers_required_notice	All answers are required before the risk probability can be computed.	0..1	display
riskDecimal	10-year HCHD Risk Probabilily as a decimal (0 to 1)	0..1	decimal
riskPercentage	10-year HCHD Risk Probabilily	0..1	string
Documentation for this format

---

Options Sets

Answer options for /46098-0

• http://loinc.org#LA2-8 ("Male")
• http://loinc.org#LA3-6 ("Female")

Answer options for /smokes

• http://example.org#Y ("Yes")
• http://example.org#N ("No")

Answer options for /antihypertensive

• http://example.org#Y ("Yes")
• http://example.org#N ("No")

Source

{
  "resourceType": "Questionnaire",
  "id": "questionnaire-sdc-profile-example-framingham-hchd-lhc",
  "meta": {
    "profile": [
      "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire"
    ]
  },
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.versionAlgorithm[x]",
      "valueCoding": {
        "system": "http://hl7.org/fhir/version-algorithm",
        "code": "semver"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "age",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/age').answer.value"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "gender",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/46098-0').answer.value.display"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "smokesCode",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/smokes').answer.value.code"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "smokes",
        "language": "text/fhirpath",
        "expression": "iif(%smokesCode.exists(), iif(%smokesCode = 'Y', 1, 0), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "systolic",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/8480-6').answer.value"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "tChol",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/2093-3').answer.value"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "hdl",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/2085-9').answer.value"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "antihypertCode",
        "language": "text/fhirpath",
        "expression": "item.where(linkId='/antihypertensive').answer.value.code"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "antihypert",
        "language": "text/fhirpath",
        "expression": "iif(%antihypertCode.exists(), iif(%systolic >= 120, iif(%antihypertCode = 'Y', 1, 0), 0), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "allQuestionsAnswered",
        "language": "text/fhirpath",
        "expression": "%age.exists() and %gender.exists() and %smokes.exists() and %systolic.exists() and %tChol.exists() and %hdl.exists() and %antihypert.exists()"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "femaleOver78",
        "language": "text/fhirpath",
        "expression": "iif(%allQuestionsAnswered, iif(%gender = 'Female', iif(%age>78, 1 - (0.98767).power((31.764001 * (%age.ln() - 3.9213204) + 22.465206 * (%tChol.ln() - 5.3628984) - 1.187731 * (%hdl.ln() - 4.0146369) + 2.552905 * (%systolic.ln() - 4.8376494) + 0.420251 * (%antihypert - 0.142802) + 13.07543 * (%smokes - 0.3236202) - 5.060998 * (%age.ln() * %tChol.ln() - 21.0557746) - 2.996945 * (78.ln() * %smokes - 1.2519882)).exp()), {}), {}), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "femaleNotOver78",
        "language": "text/fhirpath",
        "expression": "iif(%allQuestionsAnswered, iif(%gender = 'Female', iif(%age<=78, 1 - (0.98767).power((31.764001 * (%age.ln() - 3.9213204) + 22.465206 * (%tChol.ln() - 5.3628984) - 1.187731  * (%hdl.ln() - 4.0146369) + 2.552905  * (%systolic.ln() - 4.8376494) + 0.420251  * (%antihypert - 0.142802) + 13.07543  * (%smokes - 0.3236202) - 5.060998  * (%age.ln() * %tChol.ln() - 21.0557746) - 2.996945  * (%age.ln() * %smokes  - 1.2519882)).exp()), {}), {}), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "maleOver70",
        "language": "text/fhirpath",
        "expression": "iif(%allQuestionsAnswered, iif(%gender = 'Male', iif(%age>70, 1 - (0.9402).power((52.00961  * (%age.ln() - 3.8926095) + 20.014077 * (%tChol.ln() - 5.3441475) - 0.905964  * (%hdl.ln() - 3.7731132) + 1.305784  * (%systolic.ln() - 4.8618212) + 0.241549  * (%antihypert - 0.1180474) + 12.096316 * (%smokes - 0.335602) - 4.605038  * (%age.ln() * %tChol.ln() - 20.8111562) - 2.84367   * (70.ln() * %smokes  - 1.2890301) - 2.93323   * (%age.ln() * %age.ln() - 15.2144965)).exp()), {}), {}), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "maleNotOver70",
        "language": "text/fhirpath",
        "expression": "iif(%allQuestionsAnswered, iif(%gender = 'Male', iif(%age<=70, 1 - (0.9402).power((52.00961  * (%age.ln() - 3.8926095) + 20.014077 * (%tChol.ln() - 5.3441475) - 0.905964  * (%hdl.ln() - 3.7731132) + 1.305784  * (%systolic.ln() - 4.8618212) + 0.241549  * (%antihypert - 0.1180474) + 12.096316 * (%smokes - 0.335602) - 4.605038  * (%age.ln() * %tChol.ln() - 20.8111562) - 2.84367   * (%age.ln() * %smokes  - 1.2890301) - 2.93323   * (%age.ln() * %age.ln() - 15.2144965)).exp()), {}), {}), {})"
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/variable",
      "valueExpression": {
        "name": "risk",
        "language": "text/fhirpath",
        "expression": "%femaleOver78 | %femaleNotOver78 | %maleOver70 | %maleNotOver70"
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/sdc/Questionnaire/questionnaire-sdc-profile-example-framingham-hchd-lhc",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.40.17.35.10"
    }
  ],
  "version": "4.0.0-ballot",
  "name": "FraminghamHCHD",
  "title": "Hard Coronary Heart Disease (10-year risk)",
  "status": "active",
  "experimental": true,
  "subjectType": [
    "Patient"
  ],
  "date": "2025-08-07T06:58:13+00:00",
  "publisher": "HL7 International / FHIR Infrastructure",
  "contact": [
    {
      "name": "HL7 International / FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    },
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "A form for calculating the 10-year-risk of Hard Coronary Heart Disease.  The constants used in the formula match those in https://www.framinghamheartstudy.org/fhs-risk-functions/hard-coronary-heart-disease-10-year-risk/, but the actual formulas are not listed there, and so we have not been able to verify them.  However, the output of this form matches the output of a perl program (from which the formulas were taken) which matched the output of a calculator on a website, which regrettably no longer exists.  So, while this form is good enough or a demo, it should not be relied on for real purposes without first verifying its formulas or its output against some other source.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "item": [
    {
      "linkId": "/age",
      "code": [
        {
          "system": "http://loinc.org",
          "code": "30525-0",
          "display": "Age"
        }
      ],
      "text": "Age (in years)",
      "type": "decimal",
      "required": true
    },
    {
      "linkId": "/age_requirement_notice",
      "text": "Sorry, but the formulas are only valid for ages in the range 30 to 79.",
      "type": "display",
      "enableWhen": [
        {
          "question": "/age",
          "operator": "<",
          "answerDecimal": 30
        },
        {
          "question": "/age",
          "operator": ">",
          "answerDecimal": 79
        }
      ],
      "enableBehavior": "any"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/questionnaire-item-control",
                "code": "drop-down",
                "display": "Drop down"
              }
            ],
            "text": "Drop down"
          }
        }
      ],
      "linkId": "/46098-0",
      "code": [
        {
          "system": "http://loinc.org",
          "code": "46098-0",
          "display": "Sex"
        }
      ],
      "text": "Gender",
      "type": "choice",
      "required": true,
      "answerOption": [
        {
          "valueCoding": {
            "system": "http://loinc.org",
            "code": "LA2-8",
            "display": "Male"
          }
        },
        {
          "valueCoding": {
            "system": "http://loinc.org",
            "code": "LA3-6",
            "display": "Female"
          }
        }
      ]
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/questionnaire-item-control",
                "code": "radio-button",
                "display": "Radio Button"
              }
            ],
            "text": "Radio Button"
          }
        }
      ],
      "linkId": "/smokes",
      "text": "Do you smoke?",
      "type": "choice",
      "required": true,
      "answerOption": [
        {
          "valueCoding": {
            "system": "http://example.org",
            "code": "Y",
            "display": "Yes"
          }
        },
        {
          "valueCoding": {
            "system": "http://example.org",
            "code": "N",
            "display": "No"
          }
        }
      ]
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-unit",
          "valueCoding": {
            "display": "mm[Hg]"
          }
        }
      ],
      "linkId": "/8480-6",
      "code": [
        {
          "system": "http://loinc.org",
          "code": "8480-6",
          "display": "Systolic blood pressure"
        }
      ],
      "text": "Systolic blood pressure",
      "type": "decimal",
      "required": true
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-unit",
          "valueCoding": {
            "display": "mg/dL"
          }
        }
      ],
      "linkId": "/2093-3",
      "code": [
        {
          "system": "http://loinc.org",
          "code": "2093-3",
          "display": "Cholesterol [Mass/volume] in Serum or Plasma"
        }
      ],
      "text": "Cholesterol [Mass/Vol]",
      "type": "decimal",
      "required": true
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-unit",
          "valueCoding": {
            "display": "mg/dL"
          }
        }
      ],
      "linkId": "/2085-9",
      "code": [
        {
          "system": "http://loinc.org",
          "code": "2085-9",
          "display": "Cholesterol in HDL [Mass/volume] in Serum or Plasma"
        }
      ],
      "text": "Cholesterol in HDL [Mass/Vol]",
      "type": "decimal",
      "required": true
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-minOccurs",
          "valueInteger": 1
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-itemControl",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/questionnaire-item-control",
                "code": "radio-button",
                "display": "Radio Button"
              }
            ],
            "text": "Radio Button"
          }
        }
      ],
      "linkId": "/antihypertensive",
      "text": "Are you taking medication for high blood pressure?",
      "type": "choice",
      "required": true,
      "answerOption": [
        {
          "valueCoding": {
            "system": "http://example.org",
            "code": "Y",
            "display": "Yes"
          }
        },
        {
          "valueCoding": {
            "system": "http://example.org",
            "code": "N",
            "display": "No"
          }
        }
      ]
    },
    {
      "linkId": "/all_answers_required_notice",
      "text": "All answers are required before the risk probability can be computed.",
      "type": "display"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression",
          "valueExpression": {
            "description": "HCHD risk as decimal",
            "language": "text/fhirpath",
            "expression": "%risk"
          }
        },
        {
          "url": "http://hl7.org/fhir/StructureDefinition/questionnaire-hidden",
          "valueBoolean": true
        }
      ],
      "linkId": "riskDecimal",
      "text": "10-year HCHD Risk Probabilily as a decimal (0 to 1)",
      "type": "decimal",
      "required": false
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression",
          "valueExpression": {
            "description": "HCHD risk as percentage",
            "language": "text/fhirpath",
            "expression": "iif(%risk.exists(), (%risk * 100).round(2).toString() & '%', {})"
          }
        }
      ],
      "linkId": "riskPercentage",
      "text": "10-year HCHD Risk Probabilily",
      "type": "string",
      "required": false
    }
  ]
}