prisae / em-apps

Interactive applications for electromagnetics in geophysics

overview | launching the notebooks | running the notebooks | issues | contributing

em-apps

Overview

This is a repo of notebooks and interactive examples for http://em.geosci.xyz. The examples are based on code available in em_examples. Numerical simulations are based on SimPEG.

The notebooks are available on

• Binder
• Azure Notebooks

Launching the notebooks

The notebooks can be run online through Binder or Azure notebooks, or downloaded and run locally.

Binder

1. Launch the binder by clicking on the badge above or going to: https://mybinder.org/v2/gh/geoscixyz/em-apps/master?filepath=index.ipynb. This can sometimes take a couple minutes, so be patient...

2. Select the notebook of interest from the contents

3. Run the Jupyter notebook

Azure

1. Navigate to Azure notebooks by clicking on the badge above or going to: https://notebooks.azure.com/import/gh/geoscixyz/em-apps, and select Import to import the library

2. Sign in to your microsoft account (or Create One if you do not already have an account)

3. Create the new library: Select Import

4. Select index.ipynb to view the notebook contents

5. Select the notebook of interest from the contents

6. Run the Jupyter notebook

Locally

To run them locally, you will need to have python installed, preferably through anaconda.

You can then clone this reposiroty. From a command line, run

git clone https://github.com/geoscixyz/em-apps.git

Then cd into em-apps

cd em-apps

To setup your software environment, we recommend you use the provided conda environment

conda env create -f environment.yml
source activate geosci-labs

alternatively, you can install dependencies through pypi

pip install -r requirements.txt

You can then launch Jupyter

jupyter notebook

Jupyter will then launch in your web-browser.

Running the notebooks

Each cell of code can be run with shift + enter or you can run the entire notebook by selecting cell, Run All in the toolbar.

For more information on running Jupyter notebooks, see the Jupyter Documentation

Issues

If you run into problems or bugs, please let us know by creating an issue in this repository.

For Contributors

We are glad you are interested in contributing!

This repo tracks geosci-labs. To contribute code, ideas or bug-fixes, please head over to the geosci-labs repository.