# GeoSci Labs
[![binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/geoscixyz/geosci-labs/master?filepath=notebooks%2Findex.ipynb) [![azure](https://notebooks.azure.com/launch.png)](https://notebooks.azure.com/import/gh/geoscixyz/geosci-labs) [![pypi](https://img.shields.io/pypi/v/geoscilabs.svg)](https://pypi.python.org/pypi/geoscilabs) [![travis](https://travis-ci.org/geoscixyz/geosci-labs.svg?branch=master)](https://travis-ci.org/geoscixyz/geosci-labs) [![License](https://img.shields.io/github/license/geoscixyz/geosci-labs.svg)](https://github.com/geoscixyz/geosci-labs/blob/master/LICENSE) [![SimPEG](https://img.shields.io/badge/powered%20by-SimPEG-blue.svg)](http://simpeg.xyz)
The examples are based on code available in [SimPEG](http://simpeg.xyz).
Interactive visualizations are a powerful way to interrogate mathematical equations. The goal of this repository is to be the home for code that can be plugged into jupyter notebooks so that we can play with the governing equations of geophysical electromagnetics.
The repository contains the python code to run the ipython-widget style apps in http://github.com/geoscixyz/geosci-labs. These are mainly plotting code and some simple analytics. More complex numerical simulations depend on [SimPEG](http://simpeg.xyz)
The notebooks can be run online through [Binder](#Binder), or [downloaded and run locally](#Locally).
- Launch the binder by clicking on the badge above or going to: https://mybinder.org/v2/gh/geoscixyz/geosci-labs/master?filepath=notebooks%2Findex.ipynb. This can sometimes take a couple minutes, so be patient…
- Select the notebook of interest from the contents
- [Run the Jupyter notebook](#Running-the-notebooks)
To run them locally, you will need to have python installed, preferably through [anaconda](https://www.anaconda.com/download/).
You can then clone this reposiroty. From a command line, run
` git clone https://github.com/geoscixyz/geosci-labs.git `
Then cd into geosci-labs
` cd geosci-labs `
To setup your software environment, we recommend you use the provided conda environment
` conda env create -f environment.yml conda 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](https://jupyter.readthedocs.io/en/latest/)
## Using in a course
If you run into problems or bugs, please let us know by [creating an issue](https://github.com/geoscixyz/em-apps/issues/new) in this repository.
## For Contributors
### Notebook Structure
Each notebook has the following structure
- Purpose : Motivation and key concepts addressed by the notebook
- Setup : Overview of the relevant parameters in the problem
- Questions : Guiding questions related to the purpose
- App : interactive visualizations
- Explore : further questions that can be explored with the app
### Setting up your environment
- to develop code for these notebooks, please see https://github.com/geoscixyz/geosci-labs
- add the notebook name and path to the [index](index.ipynb)
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size geoscilabs-0.1.1-py2.py3-none-any.whl (220.6 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View hashes|
|Filename, size geoscilabs-0.1.1.tar.gz (174.6 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for geoscilabs-0.1.1-py2.py3-none-any.whl