2025-aqgeo-pde-magnetics-tutorial

How to run the notebooks

Install a Python distribution

In order to run the notebooks you need to install a Python distribution like Miniforge, Anaconda or Miniconda.

Follow the instructions provided by any of them to install it in your system.

Note

In the following steps we'll instruct you to run some commands. They are meant to be run in a terminal (for Mac and Linux users), or in an Anaconda Prompt or Miniforge Prompt if you are running Windows.

Download the repository

Then, download this repository as a zip file and extract it. Or clone it with git:

git clone https://github.com/ubcgif/2025-aqgeo-pde-magnetics-tutorial

Create a new conda environment

First, navigate to the downloaded folder using the cd command:

cd 2025-aqgeo-pde-magnetic-tutorial

Tip

If you downloaded the repository as a zip file, the extracted folder might be called 2025-aqgeo-pde-magnetic-tutorial-main. Take that into account when navigating into that folder:

cd 2025-aqgeo-pde-magnetic-tutorial-main

In that folder you'll find an environment.yml file that you can use to create a conda environment by running:

conda env create -f environment.yml

Once the new environment is created and all the packages are installed, we need to activate the environment with:

conda activate aqgeo_pdemag

Run Jupyter Notebook

After we activated the environment, let's start a Jupyter notebook, where we can open, edit and execute the notebooks:

jupyter notebook

I will automatically open a new tab in your browser with the Jupyter notebook, where you can navigate into the notebooks folder and open any of the notebooks you'll find there.

Important

It's important not to close the terminal (or Prompt) window while you are using the Jupyter notebook. Closing the terminal will quit the Jupyter notebook.