Healthy Route Implementation Guide
0.1.0 - ci-build
Healthy Route Implementation Guide, published by Savannah Informatics. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/healthy-route-ig/ and changes regularly. See the Directory of published versions
| Draft as of 2026-10-11 |
{
"resourceType" : "CodeSystem",
"id" : "hr-measurement",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem hr-measurement</b></p><a name=\"hr-measurement\"> </a><a name=\"hchr-measurement\"> </a><p>This case-sensitive code system <code>https://fhir.savannahghi.org/ig/healthy-route/CodeSystem/hr-measurement</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style=\"white-space:nowrap\">age-at-consent<a name=\"hr-measurement-age-at-consent\"> </a></td><td>Age at consent</td><td>Completed years on the date consent was given, calculated from the date of birth. Derived.</td></tr><tr><td style=\"white-space:nowrap\">capable-of-consent<a name=\"hr-measurement-capable-of-consent\"> </a></td><td>Capable of giving signed informed consent</td><td>Inclusion criterion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">documented-egfr<a name=\"hr-measurement-documented-egfr\"> </a></td><td>Documented eGFR</td><td>An eGFR documented by the referring service before the visit, as the record shows it. Distinct from the eGFR the study calculates from its own creatinine.</td></tr><tr><td style=\"white-space:nowrap\">excl-undesirable<a name=\"hr-measurement-excl-undesirable\"> </a></td><td>Condition making participation undesirable</td><td>Exclusion criterion, in the investigator's opinion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">excl-eye-condition<a name=\"hr-measurement-excl-eye-condition\"> </a></td><td>Eye condition precluding retinal imaging</td><td>Exclusion criterion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">excl-emergency<a name=\"hr-measurement-excl-emergency\"> </a></td><td>Hypertensive, hyperglycaemic or hypoglycaemic emergency</td><td>Exclusion criterion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">excl-involvement<a name=\"hr-measurement-excl-involvement\"> </a></td><td>Involvement in the planning or conduct of the study</td><td>Exclusion criterion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">excl-noncompliance<a name=\"hr-measurement-excl-noncompliance\"> </a></td><td>Unlikely to comply with study procedures</td><td>Exclusion criterion. True or false.</td></tr><tr><td style=\"white-space:nowrap\">eligibility-outcome<a name=\"hr-measurement-eligibility-outcome\"> </a></td><td>Eligibility outcome</td><td>The outcome the rules in force computed from the criteria. Derived.</td></tr><tr><td style=\"white-space:nowrap\">cohort<a name=\"hr-measurement-cohort\"> </a></td><td>Cohort</td><td>Case or control, assigned from the documented eGFR. Derived.</td></tr><tr><td style=\"white-space:nowrap\">history-dm<a name=\"hr-measurement-history-dm\"> </a></td><td>Diabetes, reported</td><td>The participant reports a diagnosis of diabetes. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-htn<a name=\"hr-measurement-history-htn\"> </a></td><td>Hypertension, reported</td><td>The participant reports a diagnosis of hypertension. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-ckd<a name=\"hr-measurement-history-ckd\"> </a></td><td>Chronic kidney disease, reported</td><td>The participant reports a diagnosis of chronic kidney disease. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-hiv<a name=\"hr-measurement-history-hiv\"> </a></td><td>HIV, reported</td><td>The participant reports a diagnosis of HIV. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-heart<a name=\"hr-measurement-history-heart\"> </a></td><td>Heart disease, reported</td><td>The participant reports a diagnosis of heart disease. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-traditional<a name=\"hr-measurement-history-traditional\"> </a></td><td>Traditional medicine use</td><td>The participant reports current or previous use of traditional medicine. True or false.</td></tr><tr><td style=\"white-space:nowrap\">history-alcohol<a name=\"hr-measurement-history-alcohol\"> </a></td><td>Alcohol use</td><td>Current, past or nil. LOINC codes the quantity of alcohol, not whether a person drinks, so the status takes a local code.</td></tr><tr><td style=\"white-space:nowrap\">medications-none<a name=\"hr-measurement-medications-none\"> </a></td><td>No current medication</td><td>The participant takes no medication at present. Recorded so that an absent medication list is distinguishable from one not yet taken.</td></tr><tr><td style=\"white-space:nowrap\">fruit-days<a name=\"hr-measurement-fruit-days\"> </a></td><td>Days fruit eaten in a usual week</td><td>0 to 7.</td></tr><tr><td style=\"white-space:nowrap\">veg-days<a name=\"hr-measurement-veg-days\"> </a></td><td>Days vegetables eaten in a usual week</td><td>0 to 7.</td></tr><tr><td style=\"white-space:nowrap\">salt-added<a name=\"hr-measurement-salt-added\"> </a></td><td>Salt added at the table</td><td>How often, on the study's frequency scale.</td></tr><tr><td style=\"white-space:nowrap\">sugar-drinks<a name=\"hr-measurement-sugar-drinks\"> </a></td><td>Sugar-sweetened drinks</td><td>How often, on the study's frequency scale.</td></tr><tr><td style=\"white-space:nowrap\">work-activity<a name=\"hr-measurement-work-activity\"> </a></td><td>Physical activity at work</td><td>On the study's work activity scale.</td></tr><tr><td style=\"white-space:nowrap\">activity-days<a name=\"hr-measurement-activity-days\"> </a></td><td>Days of moderate or vigorous activity in a usual week</td><td>0 to 7.</td></tr><tr><td style=\"white-space:nowrap\">activity-minutes<a name=\"hr-measurement-activity-minutes\"> </a></td><td>Minutes of moderate or vigorous activity on those days</td><td>0 to 1440.</td></tr><tr><td style=\"white-space:nowrap\">seated-hours<a name=\"hr-measurement-seated-hours\"> </a></td><td>Hours seated in a usual day</td><td>0 to 24.</td></tr><tr><td style=\"white-space:nowrap\">fruit-veg-5plus<a name=\"hr-measurement-fruit-veg-5plus\"> </a></td><td>Fruit and vegetables eaten five days or more</td><td>Both day counts at five or more. Derived.</td></tr><tr><td style=\"white-space:nowrap\">activity-weekly-minutes<a name=\"hr-measurement-activity-weekly-minutes\"> </a></td><td>Weekly minutes of moderate or vigorous activity</td><td>Days multiplied by minutes. Derived.</td></tr><tr><td style=\"white-space:nowrap\">activity-who-met<a name=\"hr-measurement-activity-who-met\"> </a></td><td>WHO physical activity recommendation met</td><td>150 minutes a week or more. Derived.</td></tr><tr><td style=\"white-space:nowrap\">hip-circumference<a name=\"hr-measurement-hip-circumference\"> </a></td><td>Hip circumference</td><td>In centimetres. LOINC publishes a protocol code for hip circumference but not a measurement code, so the measurement takes a local one.</td></tr><tr><td style=\"white-space:nowrap\">waist-hip-ratio<a name=\"hr-measurement-waist-hip-ratio\"> </a></td><td>Waist-to-hip ratio</td><td>Waist circumference over hip circumference. Derived.</td></tr><tr><td style=\"white-space:nowrap\">bp-position<a name=\"hr-measurement-bp-position\"> </a></td><td>Blood pressure reading position</td><td>Whether the reading was taken before or after retinal capture, for the reading the protocol allows either side of it. Carried on the reading as an extension.</td></tr><tr><td style=\"white-space:nowrap\">bp-device<a name=\"hr-measurement-bp-device\"> </a></td><td>Blood pressure monitor</td><td>Which of the study's monitors took the reading. Carried on each reading as an extension.</td></tr><tr><td style=\"white-space:nowrap\">retinal-capture-time<a name=\"hr-measurement-retinal-capture-time\"> </a></td><td>Time of retinal capture</td><td>When retinal photography finished. The blood pressure readings are timed relative to it.</td></tr><tr><td style=\"white-space:nowrap\">flag-hypertension<a name=\"hr-measurement-flag-hypertension\"> </a></td><td>Hypertension flag</td><td>Raised readings, a reported history or current antihypertensive treatment. Derived.</td></tr><tr><td style=\"white-space:nowrap\">flag-t2d<a name=\"hr-measurement-flag-t2d\"> </a></td><td>Type 2 diabetes flag</td><td>HbA1c above threshold or a reported history. Derived.</td></tr><tr><td style=\"white-space:nowrap\">flag-ckd-stage-3<a name=\"hr-measurement-flag-ckd-stage-3\"> </a></td><td>CKD stage 3 or worse flag</td><td>Calculated eGFR below 60. Derived.</td></tr><tr><td style=\"white-space:nowrap\">creatinine-converted<a name=\"hr-measurement-creatinine-converted\"> </a></td><td>Serum creatinine, converted</td><td>The creatinine in mg/dL as the eGFR equation used it, when the laboratory reported another unit. Derived.</td></tr><tr><td style=\"white-space:nowrap\">hiv-test<a name=\"hr-measurement-hiv-test\"> </a></td><td>HIV test result</td><td>Reactive or non-reactive, as the laboratory reports it. The test method is not captured, so no LOINC code asserting one is used.</td></tr><tr><td style=\"white-space:nowrap\">fbc-taken<a name=\"hr-measurement-fbc-taken\"> </a></td><td>Full blood count taken</td><td>Whether a full blood count was taken. The count itself is not captured. True or false.</td></tr><tr><td style=\"white-space:nowrap\">images-dilated<a name=\"hr-measurement-images-dilated\"> </a></td><td>Images taken with dilation</td><td>True or false.</td></tr><tr><td style=\"white-space:nowrap\">images-right<a name=\"hr-measurement-images-right\"> </a></td><td>Image captured of the right eye</td><td>True or false.</td></tr><tr><td style=\"white-space:nowrap\">images-left<a name=\"hr-measurement-images-left\"> </a></td><td>Image captured of the left eye</td><td>True or false.</td></tr><tr><td style=\"white-space:nowrap\">images-synced<a name=\"hr-measurement-images-synced\"> </a></td><td>Images synced to the device cloud storage</td><td>True or false.</td></tr></table></div>"
},
"url" : "https://fhir.savannahghi.org/ig/healthy-route/CodeSystem/hr-measurement",
"version" : "0.1.0",
"name" : "HRMeasurementCS",
"title" : "Healthy Route Measurement Codes",
"status" : "draft",
"experimental" : false,
"date" : "2026-10-11T11:12:01+00:00",
"publisher" : "Savannah Informatics",
"contact" : [
{
"name" : "Savannah Informatics",
"telecom" : [
{
"system" : "url",
"value" : "https://savannahghi.org"
}
]
},
{
"name" : "Savannah Informatics",
"telecom" : [
{
"system" : "url",
"value" : "https://savannahghi.org"
}
]
}
],
"description" : "Codes for the questions on the visit forms that LOINC does not cover, and for the values the study derives from them.",
"caseSensitive" : true,
"content" : "complete",
"count" : 44,
"concept" : [
{
"code" : "age-at-consent",
"display" : "Age at consent",
"definition" : "Completed years on the date consent was given, calculated from the date of birth. Derived."
},
{
"code" : "capable-of-consent",
"display" : "Capable of giving signed informed consent",
"definition" : "Inclusion criterion. True or false."
},
{
"code" : "documented-egfr",
"display" : "Documented eGFR",
"definition" : "An eGFR documented by the referring service before the visit, as the record shows it. Distinct from the eGFR the study calculates from its own creatinine."
},
{
"code" : "excl-undesirable",
"display" : "Condition making participation undesirable",
"definition" : "Exclusion criterion, in the investigator's opinion. True or false."
},
{
"code" : "excl-eye-condition",
"display" : "Eye condition precluding retinal imaging",
"definition" : "Exclusion criterion. True or false."
},
{
"code" : "excl-emergency",
"display" : "Hypertensive, hyperglycaemic or hypoglycaemic emergency",
"definition" : "Exclusion criterion. True or false."
},
{
"code" : "excl-involvement",
"display" : "Involvement in the planning or conduct of the study",
"definition" : "Exclusion criterion. True or false."
},
{
"code" : "excl-noncompliance",
"display" : "Unlikely to comply with study procedures",
"definition" : "Exclusion criterion. True or false."
},
{
"code" : "eligibility-outcome",
"display" : "Eligibility outcome",
"definition" : "The outcome the rules in force computed from the criteria. Derived."
},
{
"code" : "cohort",
"display" : "Cohort",
"definition" : "Case or control, assigned from the documented eGFR. Derived."
},
{
"code" : "history-dm",
"display" : "Diabetes, reported",
"definition" : "The participant reports a diagnosis of diabetes. True or false."
},
{
"code" : "history-htn",
"display" : "Hypertension, reported",
"definition" : "The participant reports a diagnosis of hypertension. True or false."
},
{
"code" : "history-ckd",
"display" : "Chronic kidney disease, reported",
"definition" : "The participant reports a diagnosis of chronic kidney disease. True or false."
},
{
"code" : "history-hiv",
"display" : "HIV, reported",
"definition" : "The participant reports a diagnosis of HIV. True or false."
},
{
"code" : "history-heart",
"display" : "Heart disease, reported",
"definition" : "The participant reports a diagnosis of heart disease. True or false."
},
{
"code" : "history-traditional",
"display" : "Traditional medicine use",
"definition" : "The participant reports current or previous use of traditional medicine. True or false."
},
{
"code" : "history-alcohol",
"display" : "Alcohol use",
"definition" : "Current, past or nil. LOINC codes the quantity of alcohol, not whether a person drinks, so the status takes a local code."
},
{
"code" : "medications-none",
"display" : "No current medication",
"definition" : "The participant takes no medication at present. Recorded so that an absent medication list is distinguishable from one not yet taken."
},
{
"code" : "fruit-days",
"display" : "Days fruit eaten in a usual week",
"definition" : "0 to 7."
},
{
"code" : "veg-days",
"display" : "Days vegetables eaten in a usual week",
"definition" : "0 to 7."
},
{
"code" : "salt-added",
"display" : "Salt added at the table",
"definition" : "How often, on the study's frequency scale."
},
{
"code" : "sugar-drinks",
"display" : "Sugar-sweetened drinks",
"definition" : "How often, on the study's frequency scale."
},
{
"code" : "work-activity",
"display" : "Physical activity at work",
"definition" : "On the study's work activity scale."
},
{
"code" : "activity-days",
"display" : "Days of moderate or vigorous activity in a usual week",
"definition" : "0 to 7."
},
{
"code" : "activity-minutes",
"display" : "Minutes of moderate or vigorous activity on those days",
"definition" : "0 to 1440."
},
{
"code" : "seated-hours",
"display" : "Hours seated in a usual day",
"definition" : "0 to 24."
},
{
"code" : "fruit-veg-5plus",
"display" : "Fruit and vegetables eaten five days or more",
"definition" : "Both day counts at five or more. Derived."
},
{
"code" : "activity-weekly-minutes",
"display" : "Weekly minutes of moderate or vigorous activity",
"definition" : "Days multiplied by minutes. Derived."
},
{
"code" : "activity-who-met",
"display" : "WHO physical activity recommendation met",
"definition" : "150 minutes a week or more. Derived."
},
{
"code" : "hip-circumference",
"display" : "Hip circumference",
"definition" : "In centimetres. LOINC publishes a protocol code for hip circumference but not a measurement code, so the measurement takes a local one."
},
{
"code" : "waist-hip-ratio",
"display" : "Waist-to-hip ratio",
"definition" : "Waist circumference over hip circumference. Derived."
},
{
"code" : "bp-position",
"display" : "Blood pressure reading position",
"definition" : "Whether the reading was taken before or after retinal capture, for the reading the protocol allows either side of it. Carried on the reading as an extension."
},
{
"code" : "bp-device",
"display" : "Blood pressure monitor",
"definition" : "Which of the study's monitors took the reading. Carried on each reading as an extension."
},
{
"code" : "retinal-capture-time",
"display" : "Time of retinal capture",
"definition" : "When retinal photography finished. The blood pressure readings are timed relative to it."
},
{
"code" : "flag-hypertension",
"display" : "Hypertension flag",
"definition" : "Raised readings, a reported history or current antihypertensive treatment. Derived."
},
{
"code" : "flag-t2d",
"display" : "Type 2 diabetes flag",
"definition" : "HbA1c above threshold or a reported history. Derived."
},
{
"code" : "flag-ckd-stage-3",
"display" : "CKD stage 3 or worse flag",
"definition" : "Calculated eGFR below 60. Derived."
},
{
"code" : "creatinine-converted",
"display" : "Serum creatinine, converted",
"definition" : "The creatinine in mg/dL as the eGFR equation used it, when the laboratory reported another unit. Derived."
},
{
"code" : "hiv-test",
"display" : "HIV test result",
"definition" : "Reactive or non-reactive, as the laboratory reports it. The test method is not captured, so no LOINC code asserting one is used."
},
{
"code" : "fbc-taken",
"display" : "Full blood count taken",
"definition" : "Whether a full blood count was taken. The count itself is not captured. True or false."
},
{
"code" : "images-dilated",
"display" : "Images taken with dilation",
"definition" : "True or false."
},
{
"code" : "images-right",
"display" : "Image captured of the right eye",
"definition" : "True or false."
},
{
"code" : "images-left",
"display" : "Image captured of the left eye",
"definition" : "True or false."
},
{
"code" : "images-synced",
"display" : "Images synced to the device cloud storage",
"definition" : "True or false."
}
]
}