Welcome to the Hemodynamics Calculator! Built for the Emory School of Medicine's Cardiac ICU, this tool is designed to assist healthcare professionals and clinicians in the ICU, providing a streamlined, user-friendly interface to calculate, track, and analyze hemodynamic values and trends for patients.
- Added a Patient Record List:
- Displays each patient's initials, DOB, sex, height, weight, and current medications
- Allows new patients to be created
- Allows exisitng patients to be edited
- Allows patient notes to be viewed at a glance
- Allows patients to be archived
- Allows the user to quickly navigate to an individual patient page for each page
- Added an individual patient page for each patient, accessible from the patient record list
- Allows the user to quickly view more detailed patient information such as hardware devices
- Allows the user to view a patients saved calculations
- Allows the user to edit the date, time, formula, and value of a saved calculation
- Allows the user to quickly navigate to a patients trends page
- Added a calculate page to calculate hemodynamic values
- Added calculations:
- Systemic Vascular Resistance
- Pulmonary Vascular Resistance
- Transpulmonary gradient
- Diastolic Pulmonary Gradient
- Pulmonary Artery Pulsatility Index
- Cardiac Index
- FICK Cardiac Output
- VO2 by Weight
- VO2 by Body Surface Area
- VO2 by LaFarge Equation
- Inputs that are shared across calculator components are updated across all components
- Inputs that can be calculated based on patient profile data are automatically filled in when the patient is selected
- Calculator components update the calculated value in real time with proper error handling
- All valid calculations can be saved at once
- Added calculations:
- Added functionality to save particular calculations to a selected patient
- Added a trends page to provide data visualization for patient profiles
- Allows the user to select the calculations that they wish to view trends for
- Allows the user to save the current view to a PDF
- Allows the user to export calculation, medication, and hardware history to CSV
- Allows the user to quickly navigate to the patient profile page
- Added an archive page to view archived patients
- Allows the user to restore archived patients
- Allows the user to permanently delete archived patients from the database
- Fixed an issue where sidebar and navbar were not rendering on every page
- Fixed an issue where sidebar and navbar were doubling on every page
- Fixed an issue where the Emory logo disappears when reloading on particular pages
- Added refresh on editing patient's past calculations
- Moved create patient out of navbar
- Fixed issue with sidebar color where the highlighted element does not properly highlight
- Fixed edit patient screen bug where fields would not populate
- Fixed bug where getting patient records by patient id did not return any records
- DateTime for patient calculation is now a correctly formatted object
- Fixed month indexing in edit calculations page
- Fixed an issue where graphs weren't appearing correctly on the trends page
- Fixed an issue where page wouldn't adjust to fit all new trend graphs
- Removed the Emory logo from the navbar and moved it into the sidebar
- Removed the navbar.
- Application is missing the functionality for login and logout
- Future DOBs are allowed
- Any range of numerical values for height and weight are allowed
- Selecting from patients with the same initials may be difficult to do on the calculate and trends pages
- Created an Archive page to display archived patients with ability to unarchive patients
- Changed the delete button on the Patients page to an archive button
- Moved the delete button from the Patients page to the Archive page
- Added a feature to export a patient's data to a CSV file
- Updated the calculation page to display and save all calculations at once
- Removed the Emory logo from the navbar and moved it into the sidebar
- Removed the navigation bar to decrease white space on pages
- Patient notes don't display anywhere
- Trend graphs sometimes flicker when processing lots of data
- Exported CSV does not show all values for a given timestamp
- Navigation bar is shown in exported PDFs
- Patient notes popup is not working
- Sidebar width does not resize according to screen size
- Calculate page has excessive padding on the top
- Deleting a patient does not delete calculations associated with the patient
- Medication selection should be checkboxes instead of radio buttons
- Implemented data visualization for patient profiles and calculations
- Fleshed out trends page to display graphs for each type of calculation for a selected patient
- Added navigational buttons to each page to improve navigation intuitiveness
- Added table of past values to trends page
- Implemented time window selection for trend graphs/tables
- General refinements and polishing to the sidebar CSS
- Fixed an issue where graphs weren't appearing correctly on the trends page
- Fixed an issue where page wouldn't adjust to fit all new trend graphs
- Trend graphs sometimes flicker when processing lots of data
- Emory logo still continues to disappear unpredictably
- Patient notes don't display anywhere
- All hemodynamics formulas added as frontend components:
- VO2 by LaFarge Equation
- VO2 by Body Surface Area
- VO2 by Weight
- FICK Cardiac Output
- Cardiac Index
- Systemic Vascular Resistance
- Pulmonary Vascular Resistance
- Transpulmonary gradient
- Diastolic Pulmonary Gradient
- Pulmonary Artery Pulsatility Index
- Fleshed out calculator page with dropdown menu for patient and calculator values
- Calculator components update the calculated value in real time with proper error handling
- Added functionality to save particular calculations to a selected patient
- Added refresh on editing patient's past calculations
- Moved create patient out of navbar
- Fixed issue with sidebar color where the highlighted element does not properly highlight
- Fixed edit patient screen bug where fields would not populate
- Fixed bug where getting patient records by patient id did not return any records
- DateTime for patient calculation is now a correctly formatted object
- Fixed month indexing in edit calculations page
- Removed Herobrine
- Emory logo still disappears unpredictably
- Patient notes don't display anywhere
- Edit patient screen updated to match create patient screen
- Calculator page added
- Added "selected patient" functionality using dropdown on Calculator page
- Added functionality for saving calculated values to database with unique patient id
- Sidebar color changed to blue
- Patient history page added
- Added functionality for editing calculated values and associated fields on patient history screen
- Added functionality to view calculated values of a specific patient
- Fixed an issue where sidebar and navbar were not rendering on every page
- Fixed an issue where sidebar and navbar were doubling on every page
- Removed Herobrine.
- Getting patient records by record/:id endpoint does not return any records
- DateTime for patient calculations is an unparsed string when editing
- Saving a calculated value does not refresh the page, thus the form does not update
- Month on patient history table is indexed (January shows as 0)
- Sidebar text shows as black when hovering over any part
- Edit patient screen does not auto-fill values
- Sometimes, when saving an edited value, the Emory logo will disappear
For our current artifact implementation of this application, version 0.1.0, we have decided to implement the basic patient screen. The current application allows users to create patient profiles, with the following fields for patients:
- Patient Initials/Identifier
- Date of Birth
- Sex
- Height
- Weight
- Patient Medications
This basic patient system is the backbone of the application, as users must be able to save calculations and view trends for these patients. While specific data fields will be included in future updates, this version of our product provides the necessary foundation for us to expand further.
This application uses the MERN Tech Stack (MongoDB, ExpressJS, React, Node).
- MongoDB: MongoDB's document-oriented database allows efficient storage and retrieval of patient profiles, data, and trends. It provides the foundation for our patient database system, and is scalable so that should the application need to expand, we have the capacity to do so.
- Express.JS: Paired with Node, Express allows the creation of RESTful APIs, allowing for efficient and easy access from our backend MongoDB database to our front-end.
- React: React's component-based architecture provides the application with a myriad of easy-to-implement, interactive elements. This provides a foundation for our intuitive UX and UI to be built off of.
- Node.JS: Paired with Express, Node allows us to easily integrate our front-end components with our back-end database through its "JavaScript Everywhere" format.
This application is designed to be accessed from web browsers on MacOS, Windows, and Linux desktops and laptops. The application is primarily written in JavaScript due to its simplicity and ease of integration with Node.js. CSS, HTML, as well as React-specific components are also used to provide a visually appealing and easy-to-use front-end for users.
In order to use our software, you must have the required software:
- Git
- Node.js
- npm
To download our software, simply clone the github repository into your desired destination. This can be achieved by opening a git bash terminal in your desired location and running
git clone https://github.com/NamkhangNLe/Hemodynamics-Calculator-JIC-3343.gitTo get started with the Hemodynamics Calculator, follow these steps:
- First, make sure you have node and npm installed. You can do this by downloading node.js (https://nodejs.org/en/download), or using nvm to install node and npm. To check if you have node/npm installed, you can run the following command in any terminal, which will output the version of node/npm you currently have.
npm -v- Next, make sure you install the MongoDB, Express, cors, and dotenv with npm:
npm install mongodb express cors dotenv- Navigate to the root directory of the application and open a git bash terminal. Run the following command to download the required node packages.
npm install-
Next we need to connect to our MongoDB Atlas cluster. Navigate to https://account.mongodb.com/account/login and sign in using the account information that was provided to you. If you wish to create a new deployment with new login information, sign up for a new account at https://account.mongodb.com/account/login and follow the instructions at https://www.mongodb.com/docs/atlas/create-database-deployment/. Once you are signed in and have a database deployment (already done with provided login information), click "Get connection string" under "Application Development". Copy the connection string to be used in step 4.
-
Now, open up the project and add a file "config.env" under the "server" folder. Add "ATLAS_URI=[connection string]" to the file. [connection string] is the string you copied in step 2. Replace the section in the connection string with the password provided to you or the one you created if you made a new deployment. Note that once this step has been done, it does not need to be completed again.
-
To run the application, we first start by running the local server. Open up a bash terminal, and navigate to the "server" directory in the repository. Then, run the following command to run the server. After a minute, you should see that the server is running on localhost:5000 (port 5000). Note that if you are using Mac, make sure to turn off Airdrop in order for this to work.
node server.js- Once the server is running, open up a separate bash terminal and navigate to the "client" directory in the repository. Then, run the following command to run the client side. The application should now be running locally on localhost:3000. Open up your browser and go to this URL, and you should see the site!
npm startIf you get an error regarding a missing package, return to the root directory of the application and run the following command:
npm installIf you run the application but are recieving a "Failed to fetch" error, ensure that the server is running. You should see "Server is running on port: 5000" before attempting to open the application.
This Hemodynamics Calculator is distributed under the MIT License, which allows for both personal and commercial use. Please review the attached license for more details.