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.

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.

• 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

Refer to our github wiki for build requirments here

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 deprecated soon.
  • xsd/ - XSD definition 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

• Custom Compound Infusion
• Respiratory Improvments and Tuning
• Improved website generation targets
• Updates to CMD_BIO executable for batch validation and scenario execution
• Website generation python preprocess tool
• Transmucosal Fentanyl implementation
  • oral diffusion through the mucosa layer and a model for GI transit and small intestine absorption
• Hemorrhage model updates
  • Direct model connection to energy and nutrient model
• Tourniquet action for use with Hemorrhage scenarios
• New drug: Tranexamic Acid
  • Validated for use in a hemorrhage scenario to decrease bleed rates
• Propofol validation and bug fixes
• Expansion of the cerebral circuit to a larger more complex system
  • Added cerebral autoregulation, hemorrhage, and updated TBI model
• New drugs: Moxifloxacin and Ertapenem (intravenous and intra-arterial)
  • Used in sepsis model, validated for treatment guidelines
• Validation updates to Fentanyl drug
  • Updated tissue volumes, updated perfusion limited diffusion method, and updates to PK values
• New override functionality
  • Heart rate, respiration rate, and blood pressure values may now be set while running a conformant engine
    • Other physiology will change in collaboration with these values to accurately change major physiology during runtime without an injury or action
• New whole blood model/substance
  • Antigens, agglutination model and typed blood substance files for administration during runtime
• New drug administration route: oral tablet
  • Antibiotic with validated PK profiles and infection interactions
  • May be used in sepsis scenarios for management of infection
  • New future tylenol drug for moderate pain management
• python plotter util updates to batch plot csv files generated by BioGears
• New complex How-to files covering burn and sepsis for developers use
• Modifications to SE classes to support Unreal Engine integration
• Updated website generation and layout
• Patient blood type added as patient parameter
• General CMAKE updates to the build system

• General bug fixes and updates
  • Finalization for testing and implementation to BioGears override functionality with full physiology request data support
• Arterial and Venous PH data requests
• Inflammation state data to support sepsis model serialization
• Generalized sepsis model to a more generic inflammation model
  • Will be critical to future modeling efforts (hemorrhage, burn, infection)
• New example sepsis xml files (SepsisSevere_Gut.xml)
• New lymph circuit
  • Handles Albumin transport and re-circulation
  • Creates realistic oncotic pressure sources for substance transport
  • Transport from tissue systems back into the vasculature via lymph
• New command line utility project (cmd_bio) for native c++ runtime, driver, batch run organizer/manager
• Optional name value for xml actions meal and environment
• New burn model
  • User defined total body surface area input
  • Inflammation cascade validated for long running scenarios (24 hr +)
  • Validated for traditional treatment protocols with USISR SMEs
• New unit testing framework (Google Test) to better support multiplatform functionality
  • Unit Test harness is a separate project in CMAKE which can be controlled with Biogears_BUILD_TEST variable
• Introduced const char* DLL interfaces for all functions dealing with std::string to avoid windows related issues dealing with XSD implicitly exporting string through inheritance
• Updated functionality to tension pneumothorax to fix bug in bilateral behavior
• Updated hemorrhage bugs to update blood gas levels and metabolic requirements
  • Validated with University of Washington

• Patches to drug blood pressure modifications to restrict pathways to be more physiologically accurate
• Vasopressin support and validation
• Major patches to #include requirements, reduction in file dependencies
  • Increases modularity of the project, increase build times during development
• Change in how we generate code from our CDM XSD files to one file per XSD file instead of per type
  • Reduced build times for the full source from 40 to 10 min
  • empty constructors in SETypes to = default and adding override markers
  • no longer use stdafx.h while compiling and so many headers make direct reference to COmmonDataModel.h and Biogears.h which were previously bundled in these precompiled headers
• Override functionality now supported in BioGears
  • May override any physiology data request with desired value
  • Logging will document range of possible values if typing unsupported data
  • Engine can now be globally flagged as conformant or non conformant to increase future development possibilities
  • Can be manipulated via action api calls
  • Example xmls and sdks demonstrate functionality
• Moved all BioGears functionality in to the BioGears namespace

• BioGears python plotting tool
• Max work rate now a patient parameter and is configurable
• Hemorrhage action updates, may now specify location and rate
  • Rate will diminish as pressure in the vessel decreases
• Update build process to be entirely supported by CMAKE
  • Removed Apache Ant dependency
  • Updated build directory and runtime directory dependencies
• Full build support for arm platforms
• Updates to source to support all major platforms: mac, win, linux, and Arm
• Updated build architecture to python buildbot libraries
  • 8 concurrent nightly builds to ensure multi-platform support
• Setup mirroring onto our new github repository
  • All development now open to the community with feature branches also supporting nightly builds
• Dockerfile and testing/support now supported, see more at https://cloud.docker.com/u/biogears/repository/docker/biogears/engine
• Pain model and patient pain susceptibility configuration flag
  • Validated pain model supported, stimulus can be specified with severity from 0-1
  • Works with all supported pain medication in the BioGears engine
    • Treat patient with Morphine, Fentynal, and/or Ketamine
  • New How-to-pain file to display sdk support
• Sepsis model
  • Robust whole body inflammation model with severity and location specifiers in .xml and SDK
  • New How-to-sepsis file to show sdk functionality (command-line tool)
  • Validated treatments with fluid resuscitation guidelines, vasopressin, norepinephrine, and antibiotics
  • Validated blood chemistry markers such as bilirubin, white blood cell count, and lactate
• New antibiotic IV drip
  • Can be used to treat sepsis
• Two new supported patients: toughguy and toughgirl
• Sweat rate patches now meeting validation
  • Better core temperature regulation during exercise
  • Hyper/hypo-hidrosis now a supported patient parameter
• Updates and new 7.0 java GUI release to support users who want to create their own substance
  • Includes ability to patch in new drugs
• Chemoreceptor method updated to track validation for hypercapnic and hypoxic conditions
  • Better support for respiratory validation across the board, particularly supported respiratory conditions
• Patches to saline infusion loading on the patient for better respiratory validation

BioGears was originally developed under the TATRC funded project: W81XWH-13-2-0068. BioGears development is currently funded under the following contracts:

• W81XWH-17-C-0172
• W911NF-17-D-0006
• W81XWH-18-C-0169

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.

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.

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.

You can access our public slack through our development website.

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