CoFI Examples

Related repositories by InLab:

• CoFI
• Espresso

CoFI (Common Framework for Inference) is an open-source initiative for interfacing between generic inference algorithms and specific geoscience problems. Read CoFI's documentation for more details.

This repository contains examples for running inversion algorithms using CoFI with increasing complexity in problems.

Explore the examples and tutorials

An interactive web-based explorer is available that allows the user to find examples and tutorials of interest, organized either from an application domain perspective, or a inference methods perspective. Go to [https://inlab.au/inlab-explorer/]

Alternatively you can just explore the examples or the tutorials directories in this repository.

Run the examples

• To run the examples interactively without any local setup, click on the "Colab" (recommended) or "binder" badges above
• To view the examples and sample output (without interaction, no local setup), click on the "Example Gallery"
• To install cofi and run the examples locally, follow the instructions below

Run the examples with cofi locally

Step 1. Get cofi

(Strongly recommended) Create a virtual environment to avoid conflicts with your other projects:

$ mamba env create -f envs/environment.yml
$ mamba activate cofi_env

Otherwise (skip this if you've followed above), ensure you have scipy and jupyter-lab in your environment and then install cofi with the following. Install related packages specifically for the notebooks you would like to run.

$ pip install cofi

Step 2. Get the examples

Clone this repository:

$ git clone https://github.com/inlab-geo/cofi-examples.git

Step 3. Run the examples

Open up Jupyter-lab:

$ cd cofi-examples
$ jupyter-lab

Run through examples and have fun 🎉! We recommend opening up the index.ipynb to decide where to start.

Contribution

Thanks for contributing! Please refer to our Contributor's Guide for details.

Licence

This project is distributed under a 2-clause BSD licence. A copy of this licence is accessible here.