Throughout these tutorials, we have provided sample code that users can copy and paste into their own environments to run different functions from OpenWillis. For those looking for a more hands-on demonstration, we have also created a sample jupyter notebook that will allow users to run code on sample data and see results in real time. Below are instructions on how to access this interactive notebook.

1 - Create OpenWillis environment

This demo is geared towards those who are ready to begin analyzing data. Once the OpenWillis environment is set up following the instructions here: Installing OpenWillis, you will be ready to walk through the interactive demo and process your own data as well.

<aside> ⚠️

Be sure you go through the installation steps before continuing! Once you get to Step 3.2 - activating the jupyter environment, you will be ready to proceed.

For the demo, users can install either openwillis or the following subpackages:

Functions in openwillis-gps are not covered in this demo.

</aside>

Once the requirements are installed, activate your existing environment by entering the following into a terminal window:

conda activate openwillis_env

juptyer notebook

2 - Download jupyter notebook

The sample jupyter notebook can be found on our GitHub repository here.

Click on the file called “InteractiveDemo.ipynb”:

interactiv_demo_click.png

Click “download” in the upper right-hand corner:

ipynb_download.png

3 - Upload into local jupyter notebook environment

Once the .ipynb file is downloaded, you’ll only be able to open it within a jupyter notebook environment. Make sure yours is active and open, then upload the file directly into jupyter notebook.

local_jn_upload.png

Once uploaded, double click the notebook to open and activate:

ipynb_click.png

Within the jupyter notebook, you will then be able to run all cells and edit or add comments as needed. Since it is now stored locally, you won’t change the notebook for others.

ipynb_blank.png

<aside> 💡

Helpful tips and shortcuts while working in jupyter notebook can be found here:

Tips on using jupyter notebook

</aside>