Disclaimer:
This repository and all associated models, scripts, and data are provided strictly for academic and research purposes. The models herein are based on published theory and experimental data, but they are not validated for clinical, operational, or real-world risk prediction.
These tools do not predict, diagnose, or guarantee the risk of decompression sickness (DCS) for any individual or exposure scenario.
No part of this project should be used as a substitute for professional medical advice, operational safety protocols, or regulatory guidance.
The authors and contributors accept no liability for any use, misuse, or interpretation of the information or code provided in this repository.
This repository contains a comprehensive suite of models, scripts, and data for the analysis and simulation of decompression sickness (DCS) in various environments. The project integrates legacy code, machine learning models, NASA models, and supporting documentation for research and operational use.
- 3RTU_BU_2025_02_02/: Documentation and theory for 3RTU models.
- 3RUT_MBe1/: Markdown documentation and theory for 3RUT models.
- BU_3RUT/: Contains 3RUT_MBe1 with calibration scripts, risk models, configs, and results.
- BU_Model_2025/: Main Python scripts for DCS simulation, CLI, and outputs (models, predictions).
- DCS Python Project_old/: Legacy code and previous BU projects.
- Dive_DCS/libbuhlmann-master/: Buhlmann decompression model implementation (with its own README).
- ML model/: Machine learning scripts, results, and visualizations.
- Model_Rel_Candidate/: Candidate models and metrics for release.
- NASA_model/: NASA-specific DCS model.
- output/: Model outputs and predictions.
- .vscode/: Editor settings.
- pycache/: Python bytecode cache (can be ignored).
- Python 3.8+
- Recommended: Create a virtual environment
git clone <repo-url>
cd DCS
pip install -r requirements.txt # (if requirements.txt exists)
- BU_Model_2025:
python BU_Model_2025/dcs_cli.py --help
- ML model:
python "ML model/dcs_cli.py" --help
- Model outputs (predictions, parameters, encoders, scalers) are stored in the
output/
directories of respective modules. - Example output files:
.xlsx
(predictions),.joblib
(models, encoders, scalers).
dcs_cli.py
,dcs_app.py
,DCSv10.py
,DCSv11.py
: Main simulation and CLI scripts.output/
: Contains.joblib
model files and.xlsx
prediction outputs.
- Contains its own documentation and source for the Buhlmann model.
- Calibration, risk analysis, and test scripts for 3RUT models.
dcs_simulation.py
,dcs_cli.py
,dcs_app.py
: ML-based DCS simulation and analysis.
- Fork the repo and create your branch (
git checkout -b feature/fooBar
) - Commit your changes (
git commit -am 'Add some fooBar'
) - Push to the branch (
git push origin feature/fooBar
) - Create a new Pull Request
- See
Dive_DCS/libbuhlmann-master/LICENSE
for Buhlmann model. - Other code: Specify your license here (e.g., MIT, GPL, etc.).
- NASA, Buhlmann model authors, and all contributors.
- Special thanks to all researchers and developers who contributed to the DCS modeling efforts.