Skip to content

Latest commit

 

History

History
116 lines (83 loc) · 4.4 KB

INSTALL.md

File metadata and controls

116 lines (83 loc) · 4.4 KB
Raw

Installing the workshop environment

Overview

This workshop is delivered mainly through a series of Jupyter notebooks that allow for interactive Python programming. We will also be using the git version control software during this workshop. We will be using GitHub as a remote host for a git repository, which will require a GitHub account. If you do not already have one, you can create one by going to github.com, and clicking "Sign Up".

To use these, several Python packages must be installed. A full list of these can be found in environment.yml. Should you want to install MDAnalysis under a separate environment, you can find the installation instructions here: https://www.mdanalysis.org/pages/installation_quick_start/. See below for instructions on how to set up a local copy of the Python environment.

Installing the Python environment

Due to the complexity of the workshop environment, we strongly recommend the use of miniforge to leverage mamba as it provides a fast and reliable way to install conda packages.

Alternatively you can use anaconda. In this case, switch invocations of mamba to conda in the following instructions.

0. Install miniforge/mamba

Follow the miniforge installation instructions: in your terminal, download the installer for your operating system and run it:

curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash "Miniforge3-$(uname)-$(uname -m).sh"

We recommend you answer yes to the question to add code to your startup files.

Exit the terminal and open a new terminal.

To check that the installation is working, type

mamba --version

and you should see something like

mamba 1.5.8
conda 24.3.0

1. Creating a workshop environment

To create an environment named mda_workshop with all the necessary Python dependencies, first download the environment.yml file to your working directory with

curl -L -O https://raw.githubusercontent.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/jun24-ws/environment.yml

Then create the environment with

mamba env create --file=environment.yml

See the conda documentation for more information on how to access and manage conda environments.

To then activate this environment:

mamba activate mda_workshop

2. Activating the Jupyter extensions

The workshop leverages the extended utility of several Jupyter nbextensions.

To install these, the followed should be run once (after having activated the conda environment):

jupyter contrib nbextension install --user
jupyter nbextension enable splitcell/splitcell
jupyter nbextension enable rubberband/main
jupyter nbextension enable exercise2/main
jupyter nbextension enable autosavetime/main
jupyter nbextension enable collapsible_headings/main
jupyter nbextension enable codefolding/main
jupyter nbextension enable limit_output/main
jupyter nbextension enable toc2/main

Installing git

With your environment activated, you can check if you have git installed with:

git --version

If you do not have git installed, or the version output is not at least 2.28, you should install a new version of git with:

mamba install -c conda-forge git

Once installed, you can configure your git username and email with the following commands, inserting your name and email"

git config --global user.name "YOUR_FIRSTNAME YOUR_LASTNAME"
git config --global user.email "YOUR_EMAIL_ADDRESS"

Connecting to GitHub using the Secure Shell Protocol (SSH)

If you don't have a GitHub account, create one at https://github.com first.

You will need to set up credentials to securely push data to and retrieve data from GitHub. Follow the instructions given by GitHub to create an SSH key and add it to your account.