uq-physicell 1.0.0

Project to perform uncertainty quantification of PhysiCell models

Installation

Install the package from the root folder:

pip install .

with option to edit: pip install -e .

Examples

Here are some examples to help you get started with using the package:

1. Example 1: Basic Usage

   • Description: Print information of models physicell_model_1 and physicell_model_2 as shown in the config file examples/SampleModel.ini, without running the PhysiCell simulation.
   • Code:

     python examples/ex1_print.py
     

2. Example 2: Running PhysiCell Simulations

   • Description: Run PhysiCell simulations of physicell_model_2
   • Step 1: Compile the virus-macrophage example in the PhysiCell folder.
   • Code:

     make reset && make virus-macrophage-sample && make
     

   • Step 2: Change the path of the executable variable in physicell_model_2 model in the examples/SampleModel.ini file.
   • Code:

     executable = [new path]
     

   • Step 3: run the simulations.
   • Code:

     python examples/ex2_runModel.py
     

3. Example 3: Customizable Summary Function

   • Description: This example illustrates how to run PhysiCell simulations of physicell_model_2 with a customizable summary function that generates population time series.
   • Code:

     python examples/ex3_runModelCust.py
     

Feel free to explore these examples to understand the capabilities of the package and how to use it effectively.