google-labs-jules[bot]
ede2dee772
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.
115 lines
3.2 KiB
C++
115 lines
3.2 KiB
C++
#pragma once
|
|
|
|
#include "Organ.h"
|
|
#include <vector>
|
|
#include <string>
|
|
#include <deque>
|
|
|
|
/**
|
|
* @brief Enum for the current state of the respiratory cycle.
|
|
*/
|
|
enum class RespiratoryState {
|
|
INSPIRATION,
|
|
EXPIRATION,
|
|
PAUSE
|
|
};
|
|
|
|
/**
|
|
* @brief Represents a single lobe of the lung.
|
|
*/
|
|
struct Lobe {
|
|
std::string name;
|
|
double volume_mL;
|
|
double compliance; // How easily it inflates
|
|
};
|
|
|
|
/**
|
|
* @brief Represents a major airway.
|
|
*/
|
|
struct Bronchus {
|
|
std::string name;
|
|
double resistance; // Airflow resistance
|
|
};
|
|
|
|
/**
|
|
* @brief Represents the Lungs organ with a more detailed physiological model.
|
|
*/
|
|
class MEDICAL_LIB_API Lungs : public Organ {
|
|
public:
|
|
/**
|
|
* @brief Constructor for the Lungs class.
|
|
* @param id The ID of the organ.
|
|
*/
|
|
Lungs(int id);
|
|
|
|
/**
|
|
* @brief Updates the lungs' 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 lungs' vitals.
|
|
* @return A string containing the lungs' vital signs.
|
|
*/
|
|
std::string getSummary() const override;
|
|
|
|
/**
|
|
* @brief Inflicts damage on the lungs, reducing their compliance.
|
|
* @param damage The amount of damage to inflict (0-1).
|
|
*/
|
|
void inflictDamage(double damage);
|
|
|
|
// --- Getters for Key Respiratory Vitals ---
|
|
|
|
/** @brief Gets the current respiration rate in breaths per minute. */
|
|
double getRespirationRate() const;
|
|
|
|
/** @brief Gets the current oxygen saturation (SpO2) as a percentage. */
|
|
double getOxygenSaturation() const;
|
|
|
|
/** @brief Gets the volume of air in a normal breath (tidal volume) in mL. */
|
|
double getTidalVolume() const;
|
|
|
|
/** @brief Gets the end-tidal CO2 (etCO2) value in mmHg. */
|
|
double getEndTidalCO2() const;
|
|
|
|
/** @brief Gets the peak airway pressure during inspiration in cmH2O. */
|
|
double getPeakInspiratoryPressure() const;
|
|
|
|
/** @brief Gets the data for the capnography waveform (etCO2 over time). */
|
|
const std::deque<double>& getCapnographyWaveform() const;
|
|
|
|
private:
|
|
// --- Private Helper Methods ---
|
|
void updateRespiratoryMechanics(double deltaTime_s);
|
|
void updateGasLevels(double deltaTime_s);
|
|
double generateCapnographyValue();
|
|
|
|
// --- Physiological Parameters ---
|
|
double respirationRate; ///< Breaths per minute
|
|
double oxygenSaturation; ///< SpO2 percentage
|
|
double tidalVolume_mL; ///< Volume of air per breath
|
|
double endTidalCO2_mmHg; ///< End-tidal CO2
|
|
double peakInspiratoryPressure_cmH2O; ///< Peak airway pressure
|
|
double totalLungCapacity_mL; ///< Total lung capacity
|
|
|
|
// --- Simulation State ---
|
|
RespiratoryState currentState;
|
|
double cyclePosition_s; ///< Current position in the respiratory cycle (seconds)
|
|
double totalTime_s; ///< Total simulation time
|
|
|
|
// --- Anatomical Components ---
|
|
Lobe rightUpperLobe;
|
|
Lobe rightMiddleLobe;
|
|
Lobe rightLowerLobe;
|
|
Lobe leftUpperLobe;
|
|
Lobe leftLowerLobe;
|
|
Bronchus mainBronchus;
|
|
|
|
// --- Waveform Data ---
|
|
std::deque<double> capnographyData;
|
|
size_t capnographyHistorySize;
|
|
};
|