Minimal Installation Instructions

If you need more information on the installation process, check out the Detailed Installation instructions!

Ubuntu users can consider an alternative installation method.

Step 1

Install Miniconda. When prompted, select the option to install for “me” insted of “all users”. This will install miniconda into your user folder.

Step 2

Open Anaconda Powershell Prompt or Anaconda Prompt.

Windows Users: Go to the start menu and search for ‘Anaconda’.

Step 3

Update conda:

conda update -n base conda

Step 4

Conda has released a new environment solver called libmamba that is considerably faster then installing environments with the classic installer. Install libmamba with:

conda install -n base conda-libmamba-solver

Set libmamba as the default solver:

conda config --set solver libmamba

You can revert to the classic installer by running:

conda config --set solver classic

Step 5

Install git:

conda install git

Step 6

Now navigate to where you would like to save PING Mapper. Here I am saving PING-Mapper into ‘MyPythonRepos’, a folder inside my user folder:

cd C:\users\Cam\MyPythonRepos

If you haven’t navigated through your file system with the command prompt before, here is a video to explain how! (PING-Mapper developers did not make this video.)

Step 7

Clone the repo:

git clone --depth 1 https://github.com/CameronBodine/PINGMapper

Step 8

Change directory into PINGMapper folder:

cd PINGMapper

Step 9

Create a conda environment called ping and activate it:

conda env create --file conda/PINGMapper.yml
conda activate ping

Since we installed libmamba and set it as the default solver, it will be used to solve the environment. This will install PING-Mapper in approximately 10 minutes (or less) compared to nearly 1 hour with the classic solver!

Step 10

Now let’s run a test to make sure everything is functioning as expected.

Back to top

This study was made possible by a partnership between the U.S. Fish and Wildlife Service and Northern Arizona University. Funding for this work was provided by the Open Ocean Trustee Implementation Group to restore natural resources injured by the 2010 Deepwater Horizon oil spill in the Gulf of Mexico. The contents of this website are those of the authors and do not necessarily represent the views of the U.S. Fish and Wildlife Service or Northern Arizona University. Copyright © 2024 Cameron Bodine.