Skip to content
/ core Public
forked from BioGearsEngine/core

Repository for libbiogears and all core utilities

License

Notifications You must be signed in to change notification settings

ntatum94/core

 
 

Repository files navigation

Overview

BioGears® source code is hosted here and will be developed through this public repository to encourage community facing development. In addition we also support official stable releases. Our latest deployment (found under releases) is still in a beta phase, and is intended to be an intermediate release to showcase the capabilities of the BioGears® Physiology Engine. The current version of the software includes examples of all types of engine interfaces, but does not include all of the functionality or physiologic systems that will be present in the final product. This version of the software is meant to elicit feedback and enhance community involvement in establishing end product expectations.

What is BioGears®

BioGears® is a C++ based, open source, multi-platform (Windows, Mac, and Linux), comprehensive human physiology engine that will drive medical education, research, and training technologies. BioGears enables accurate and consistent physiology simulation across the medical community. The engine can be used as a standalone application or integrated with simulators, sensor interfaces, and models of all fidelities.

BioGears high-level objectives

  • Create a publicly available physiology research platform that enables accurate and consistent simulated physiology across training applications
  • Lower the barrier to create medical training content
  • Engage the community to develop and extend physiology models
  • Meet the training needs of the military
  • Expand the body of knowledge regarding the use of simulated physiology for medical education

Building Source

Refer to our github wiki for build requirments here

Structure

The BioGears source is structured as follows:

  • cmake/ - Custom CMake scripts needed by the biuld system including some JAVA search behavior overrides
    • common/ - package files for common cmake deps
    • toolchains/ - Templates for cmake toolchain files
  • share/ - Non source files
    • astyle/ - Astyle template for formating source (depricated)
    • data/ - BioGears configuration files for various senarios
    • doc/ - BioGears documentation files (doxygen,markdown,...)
    • etc/ - Other
    • jar/ - Jar files for BioGears JAVA based components hopefully depricated soon.
    • xsd/ - XSD defintion files for the Common Data Model.
  • projects/
    • java/ - JNI utilities for running biogears
      • biogears/ - Core code for libbiogears
    • howto/ - libbiogears SDK examples
      • unit/ - Unit test harness used for testing libbiogears components

What's new in ver 6.3 (March 1, 2018)

The latest deployment includes the following notable updates:

  • General bug fixes, system improvements, and tools/solver improvements
  • Fasciculation patient event flags
  • Updated sweat methodology (fixes to ions lost in sweat)
  • Updated substance and compound infusion functionality
    • Added Ringers lactate and updated
    • Saline compound ion concentrations corrected
    • Hardened implementation
  • MuscleMass new patient data request
    • Muscle catabolism patient flag
  • Added dehydration condition
    • Implemented as scalar 0to1 representing fractional total body water lost
    • Fluid removed from patient compartments
    • Updated patient flag for event and track body weight change (validated)
    • Added totalbodyfluidVolume as data request
    • Updated patient weight as a function of condition
  • Added starvation condition
    • TimeSinceMeal determines how long since the patient's last meal
    • Scales internal nutrient storages from validated starvation data
    • Removed ConsumeMeal condition, now replaced by starvation condition
    • Validated blood concentrations for ketones, glucose, and amino acids
    • Updated patient weight as a function of condition
  • Intracellular ion transport
    • Model uses membrane potential (see @ref TissueMethodology for details)
    • Michaelis coefficient could support more ion regulation in the future
    • Gated ion transport allows for differences between intra/extracellular spaces
  • COPD now supports elevated anaerobic metabolism
  • Ion transport model in the small intestine
  • Updated drug library so all drugs support an effects site transport rate
  • Diabetes type 1 and type 2 conditions
    • insulin resistance and insulin production effects
  • Hemorrhage action now initialized with a 0-1 severity and a location (MCIS SDK example still exists)
  • New drug Vasopressin
  • New drug classifications in the CDM for better grouping in-code
    • Include anesthetic, sedative, opioid, and reversal agent
    • More grouping in future work

Programmatics

BioGears is being developed under the TATRC funded project: W81XWH-13-2-0068.

Disclaimer:

This work is supported by the US Army Medical Research and Materiel Command. The views, opinions and/or findings contained in this report are those of the author(s) and should not be construed as an official Department of the Army position, policy, or decision unless so designated by other documentation. BioGears is released under the Apache 2.0 liscense.

BioGears has Publications papers and abstracts on several systems and clinical scenarios.

Additional Information

Code of Conduct

We support the contributor covenant and the scope and enforcement it details. We reserve the right of enforcement that we feel is appropriate given the nature of the offense up to and including a permanent ban from the project.

Contributing

Details will be filled in shortly. In the meantime if you have a contribution or issue to post/push feel free to contact [email protected] with the details.

Additional Documentation

For more detailed documentation including model discussions and implementation details can be found at www.BioGearsEngine.com

About

Repository for libbiogears and all core utilities

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 72.7%
  • Java 22.4%
  • CMake 2.6%
  • CSS 1.6%
  • C 0.4%
  • Python 0.2%
  • Other 0.1%