darpa-askem / mira

MIRA modeling framework

MIRA

MIRA is a framework for representing systems using ontology-grounded meta-model templates, and generating various model implementations and exchange formats from these templates. It also implements algorithms for assembling and querying domain knowledge graphs in support of modeling.

Resources

• Template JSON schema: schema.json
• Epidemiology Domain Knowledge Graph (DKG) service: DKG service
• MIRA Metaregistry service: Metaregistry service

Example notebooks

• Defining multiple model variants using MIRA Templates: Notebook 1
• Generating an executable model from MIRA Templates and running simulation: Notebook 2
• Stratifying and visualizing MIRA models, and exporting as Petri nets: Notebook 3
• Processing an SBML model from BioModels, visualizing and exporting into Petri nets: Notebook 4
• Using the MIRA Domain Knowledge Graph REST API: Notebook 5
• Using the Model REST API to perform various model operations: Notebook 6
• Using the web client in python that connects to the REST API: Notebook 7

Related work

MIRA builds on and generalizes prior work including:

• EMMAA: A framework for automatically maintaining a set of models surrounding the biology of viral pandemics, cancer, and other disease areas based on new findings as soon as they appear in the literature. Models are automatically analyzed against observations.
• INDRA: An automated model building system from literature mining, structured databases, and natural language input for molecular biology. INDRA Statements serve as domain-specific instances of MIRA Templates.
• INDRA CoGEx: A 3*10^7-relation scale domain-specific knowledge graph of biomedicine combining causal mechanisms with ontologies and relations derived from data.
• INDRA World: A generalization of INDRA to modeling socio-economic systems, using a templated approach representing causal influence, events, and concepts.

Installation

The most recent code and data can be installed directly from GitHub with:

python -m pip install git+https://github.com/indralab/mira.git

To install in development mode, use the following:

git clone git+https://github.com/indralab/mira.git
cd mira
python -m pip install -e .

Documentation

Full documentation can be found here.

Funding

The development of MIRA is funded by the DARPA ASKEM program, grant number HR00112220036.