Skip to content

A professional tool for calculating burn patient caloric needs and required amount of nutrition formulas based on patient medical data.

Notifications You must be signed in to change notification settings

ritalarina/CaloricMedCare

Repository files navigation

CaloricMedCare

Description

CaloricMedCare is a tool designed for medical professionals to calculate the caloric needs and nutritional intake of burn patients. This application takes patient data, calculates daily caloric requirements using established formulas, and determines the required nutrition formula volumes.

Input

  • Gender (Male/Female)
  • Age (0-120 years)
  • Weight (1-300 kg, precision up to 0.1 kg)
  • Height (50-300 cm)
  • Body Temperature (in °C, precision up to 0.1°C)
  • Total Burn Surface Area (1-100%)
  • Days Since Trauma (0 or more days)
  • Energy Intake (500-5000 kcal)
  • Other Conditions (multiple-choice options)

Output

  • BMR Calculation: Calculates Basal Metabolic Rate (BMR) using the Harris-Benedict formula.
  • Kcal Requirement: Calculates daily caloric intake using the Toronto formula for major burns.
  • Protein Requirement:
    • 2g protein per kg of body weight for 1-15 days post-trauma.
    • 1.5g protein per kg of body weight after 15 days.
  • Nutrition Volume: Based on patient data, the algorithm selects nutrition formulas and calculates amount of each so that the total calories and proteins fit within 10% of the daily need.

About the algorithm

To calculate volume of each nutrition needed linear programming is used to minimize total nutrition volume while sticking to certain constraints:

  • sum of calories provided by all nutrition formulas is ±10% of the total required by patient,
  • the total amount of protein provided by all nutrition formulas is either equal to or up to 10% less than the total protein required by the patient,
  • protein powder quantity is limited to a maximum of 15g (educated guess),
  • small drinks with formula are limited to a maximum 3 bottles (600 ml) as per manufactirer instructions,
  • if such calculation is possible then recommended volume of each nutrition will be at least half a smallest package to make it economic, if not, calculation is performed with no lower limits,
  • for each other health condition a patient has, a special nutrition formula is added to the nutrition mix. If calculation becomes impossible, lower bounds are ignored and some nutrition formulas might be skipped.

Running the app

Option 1. Running the App from a Published Release

  1. Go to the Releases page and download the latest release for Windows (e.g., .exe file).
  2. Once downloaded, run the installer and follow the instructions.
  3. Launch the app after installation.

Option 2. Running the App from Source

  1. Open command prompt.
  2. Navigate to desired folder.
  3. Clone the repository:
    git clone https://github.com/ritalarina/caloricmedcare
  4. Install dependencies:
    npm install
  5. Run the app:
    npm start

Usage

Once the app is running, input the following data to calculate patient caloric needs and nutrition requirements:

  1. Enter the patient's gender, age, weight, height, body temperature, and burn surface area. Specify the number of days since the trauma and other conditions.
  2. Once all input fields are complete, the app will automatically calculate
    • Basal Metabolic Rate (BMR),
    • necessary kcal intake during treatment,
    • protein requirements,
    • set of nutrition formulas and their volumes necessary to fulfill necessary daily caloric and protein requirements.

Contributing

  • Check out the TODO file to see what's planned.
  • If you want to contribute to this project, feel free to open issues or submit pull requests.
  • I am currently working using GitHub Flow method (master and feature branches), so if you want to make a feature, make a new branch and when ready merge it back to master.

License

This project is licensed under the GPL 3.0 License.

Credits

Icon used in this app is by Freepik - Flaticon.