Files
medicallib/include/MedicalLib/Esophagus.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

74 lines
1.9 KiB
C++

#pragma once
#include "Organ.h"
#include <string>
#include <vector>
/**
* @brief Represents the state of esophageal muscle contraction.
*/
enum class PeristalsisState {
IDLE,
CONTRACTING,
RELAXING
};
/**
* @brief Represents a small mass of chewed food.
*/
struct Bolus {
double volume_mL;
double position_cm; // Position from the top of the esophagus
};
/**
* @brief Represents the Esophagus with a more detailed physiological model.
*/
class MEDICAL_LIB_API Esophagus : public Organ {
public:
/**
* @brief Constructor for the Esophagus class.
* @param id The ID of the organ.
*/
Esophagus(int id);
/**
* @brief Updates the esophagus state over a time interval.
* @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 esophagus's state.
* @return A string containing the esophagus's state.
*/
std::string getSummary() const override;
/**
* @brief Initiates a swallow.
* @param bolusVolume_mL The volume of the bolus being swallowed.
*/
void initiateSwallow(double bolusVolume_mL);
// --- Getters for Esophageal State ---
/** @brief Gets the current state of peristalsis. */
PeristalsisState getCurrentState() const;
/** @brief Checks if a bolus is currently being swallowed. */
bool isSwallowing() const;
private:
// --- Helper to convert enum to string ---
std::string stateToString(PeristalsisState state) const;
// --- Physiological Parameters ---
PeristalsisState currentState;
double lowerEsophagealSphincterTone; // Pressure in mmHg
// --- Simulation State ---
std::vector<Bolus> activeBoli;
const double length_cm = 25.0; // Average length of esophagus
};