Skip to main content

How to Customize Reference Data

The reference data includes normalfindings and labvalues. To add new reference data or configure the existing ones, follow the steps described in this article.

1. Choose the right file​

  • To add new lab values, open the file ./src/utils/logic/labvalues.js. Continue with Section 2.1.
  • To configure or add findings, open the file ./src/utils/logic/normalfindings_collection.js. Continue with Section 2.2.

2.1 Configure labvalues.js​

2.1.1 Add a new lab value​

Add a new lab value to labValueRanges by defining the name (e.g., "leukocytes"), the unit (e.g., "cells/µL") and the normal range.

Example:

"leukocytes": {
    "unit": "cells/µL",
    "normal": [4000, 10000]
}

Some lab values can have several normal ranges, which vary according to gender or other circumstances. In this case, you can define the ranges as shown in the following examples:

"beta_hcg": {
    "unit": "IU/L",
    "normal": [0, 5],
    "normal_during_pregnancy": [null, null],
    "normal_during_postmenopause": [null, 8]
},
"erythrocytes": {
    "unit": "cells/pL",
    "normal": {
        "m": [4.3, 5.9],
        "w": [3.5, 5.0]
    }
}

If there is no defined unit for a lab value, specify unit as an empty string:

"ph": {
    "unit": "",
    "normal": [7.35, 7.45]
}

2.1.2 Group several lab values​

If you want to group some lab values, add a new group to labValueGroups. Define the group name with id (e.g., blood_count) and insert the desired lab value names in measurements.

Example:

{
    "id": "blood_count",
    "measurements": ["leukocytes", "erythrocytes", "haemoglobin", "hematocrit", "reticulocytes", "mcv", "mch", "mchc", "thrombocytes"]
}

2.2 Configure normalfindings_collection.js​

2.2.1 Add vitals​

If you want to add new vitals, add the measurements to vitalRanges with the specific ranges, for example:

"temperature": {
    "unit": "°C",
    "normal": [36.0, 37.2],
    "fever": [38.0, 40.0],
    "hypothermia": [34.0, 35.0],
    "decimal_precision": 1
}

Also add the vital to vitalGroups.

2.2.2 Configure normalfindings_history​

normalfindings_history contains normal findings that can occur in the patient history, more specific the general history and information about the menstruation of the patient. You can for example create additional pre_existing_conditions or another cycle_length with probabilities and also change the existing ones:

"history": {
    "general_history": {
        "pre_existing_conditions": {
            "common_pre_existing_conditions_women": {
                "diabetes_mellitus_type_1": 0.05,
                "diabetes_mellitus_type_2": 0.1,
                "depression": 0.15,
                "anxiety_disorder": 0.15,
                "migraine": 0.1,
                "iron_deficiency": 0.10,
                "vitamin_d_deficiency": 0.25,
                "nicotine_abuse": 0.20,
                "uterine_myoma": 0.20,
                "pcos": 0.10,
                "endometriosis": 0.10,
                "recurring_urinary_tract_infections": 0.1,
                "autoimmune_disease": 0.1, 
                "hypothyroidism": 0.1,
                "hyperthyroidism": 0.05,
                "hypertension": 0.25
            }
        }
    },
    "menstruation": {
        "normal": {
            "cycle_length": {
                "21-24_days": 0.1,
                "25-28_days": 0.4,
                "29-32_days": 0.4,
                "33-35_days": 0.09,
                "36-40_days": 0.01,
                "singular": true
            }
        }
    }
}

"singular": true ensures that only one option is selected for each patient.