Files
medicallib/include/MedicalLib/Heart.h
T
google-labs-jules[bot] ede2dee772 Feat: Implement interconnected organ simulation
This commit refactors the organ simulation to enable dynamic interactions between organs, replacing the previous "faked" or hardcoded connections.

Key changes include:
- Major Refactoring: Changed the `Organ::update` method signature to `update(Patient& patient, double deltaTime_s)`, allowing organs to access the shared patient state and other organs. This was propagated to all organ classes.
- Blood Chemistry Model: Introduced a central `Blood` struct in the `Patient` model to track shared resources like oxygen, CO2, glucose, and toxins.
- Organ System Interconnections:
    - Lungs & Brain: Lungs now perform gas exchange affecting the blood. The brain consumes O2, produces CO2, and its GCS is affected by hypoxia/hypercapnia.
    - Liver-Gallbladder: Gallbladder now receives bile directly from the liver's production rate.
    - Digestive System: Stomach passes chyme to the intestines, which absorb glucose into the blood. The pancreas responds to blood glucose changes.
    - Renal System: Kidneys' GFR is now influenced by the heart's aortic pressure, and they produce urine that fills the bladder directly.
    - Cardiovascular & Neurological: The heart rate responds to hypoxia, and the brain uses live aortic pressure from the heart.
- Comprehensive Test Scenario: Updated the main example to include a 60-second simulation with a meal and a lung injury event to verify the new interconnected system.

This creates a more realistic and scalable physiological simulation framework where organ behaviors are emergent from their interactions.
2025-08-20 08:30:53 +00:00

94 lines
2.7 KiB
C++

#pragma once
#include "Organ.h"
#include <vector>
#include <string>
#include <map>
#include <deque>
/**
* @brief Represents the state of a heart valve.
*/
enum class ValveStatus { OPEN, CLOSED };
/**
* @brief Represents a single heart valve and its potential pathologies.
*/
struct Valve {
std::string name;
ValveStatus status = ValveStatus::CLOSED;
double stenosis = 0.0; // Degree of narrowing [0, 1]
double regurgitation = 0.0; // Degree of leakage [0, 1]
};
/**
* @brief Represents the state of a heart chamber.
*/
enum class ChamberState { SYSTOLE, DIASTOLE };
/**
* @brief Represents a single chamber of the heart.
*/
struct Chamber {
std::string name;
ChamberState state = ChamberState::DIASTOLE;
double volume_mL = 0.0;
double pressure_mmHg = 0.0;
double endDiastolicVolume_mL = 120.0;
double endSystolicVolume_mL = 50.0;
};
/**
* @brief Represents the Heart organ, with detailed mechanical and electrical simulation.
*/
class MEDICAL_LIB_API Heart : public Organ {
public:
/**
* @brief Constructor for the Heart class.
* @param id The ID of the organ.
* @param numLeads The number of EKG leads to simulate (e.g., 3, 5, or 12).
*/
Heart(int id, int numLeads = 12);
/**
* @brief Updates the heart's state over time, simulating the cardiac cycle.
* @param patient A reference to the patient object.
* @param deltaTime_s The time elapsed in seconds.
*/
void update(Patient& patient, double deltaTime_s) override;
/**
* @brief Gets a string summary of the heart's vitals, including EKG and mechanical data.
* @return A string containing the heart's vital signs.
*/
std::string getSummary() const override;
// --- Electrical Properties ---
double getHeartRate() const;
const std::map<std::string, std::deque<double>>& getEkgData() const;
// --- Mechanical Properties ---
double getEjectionFraction() const;
double getAorticPressure() const; // Represents systemic blood pressure
private:
// --- Electrical Simulation ---
double simulateEkgWaveform(double timeInCycle);
double heartRate; // Underlying target heart rate (bpm)
double measuredHeartRate;
int numLeads;
std::vector<std::string> leadNames;
std::map<std::string, std::deque<double>> ekgData;
size_t ekgHistorySize;
// Cycle timing
double totalTime_s;
double cardiacCyclePosition_s;
double lastRPeakTime_s;
bool rPeakDetectedInCycle;
// --- Mechanical Simulation ---
Chamber leftAtrium, rightAtrium, leftVentricle, rightVentricle;
Valve mitralValve, tricuspidValve, aorticValve, pulmonaryValve;
double ejectionFraction; // Percentage
};