Delft Workshop 2017
A guide to use Dynamo during the TU Delft workshop for Cryo-EM. This covers the afternoon session of the 6th of September of 2017.
- 1 Preinstalling the software
- 1.1 Downloading Dynamo
- 1.2 Free license for Matlab
- 1.3 Virtual machines
- 1.4 Instructions for Windows users
- 2 Data
- 3 Accessing Delft servers
- 4 Program
- 5 Instructors
Preinstalling the software
We suggest students to download, install and test the software before departing for the workshop. Data should also be downloaded beforehand. Also note that you might need admin privileges to complete the steps below. Make sure that you have access to admin credentials on your laptop.
You can use Dynamo with or without Matlab (standalone modus). We advice you to use it under Matlab.
To install it, first create a folder in your filesystem in an arbitrary location of your choice:
mkdir <path to installation folder>
and untar the downloaded tarball into it:
tar -xf <tar file> -C <path to installation folder>
Testing your standalone installation
Activate your installation to work in standalone modus by typing in a Linux shell the activation script:
source <path to installation>/dynamo_activate_linux_shippedMCR.sh
or correspondingly for Mac:
source <path to installation>/dynamo_activate_mac_shippedMCR.sh
and then, to test the activated installation, just type in the terminal:
You should get the standalone Dynamo prompt in your terminal:
It might take some time till it is operative (between seconds and minutes).
Free license for Matlab
If the standalone installation works, you don't need to install further elements. However, we advice you to preinstall Matlab on your laptop. This makes the work with Dynamo much easier
Testing your Matlab installation
Inside the Matlab shell type:
run <path to installation>/dynamo_activate.m
If your system does not recognize the libraries provided in your package, you always have the option of installing a Virtual Machine in your system that emulates the Ubuntu distribution of linux. In this environment, Dynamo will run without errors, although the performance of the graphics system will be severely decreased. We recommend to use this device as a last resource.
Download an Ubuntu distribution
The version 16.04.3 of Ubuntu can be download as an iso file here
Download the virtual machine
Instructions for Windows users
Windows is not the native development platform of Dynamo. We provide Windows versions of it, but cannot guarantee that they'll work.
The standalone for Windows can be downloaded in this google drive link.
Activating the Windows standalone
In DOS terminal write:
C:\ <path to the Dynamo isntallation>\dynamo_activate_windows.bat
then open a Dynamo terminal by typing in the DOS
If it doesn't work, create a .bat file with this text:
@echo off REM cd /d %~dp0 REM We assume that compilation was performed on Matlab R2017a set DYNAMO_ROOT=%~dp0 echo ---------------------------------------- echo Dynamo installation is in %DYNAMO_ROOT% echo Executables for Win 64bit activated echo ---------------------------------------- set PATH=%PATH%;%DYNAMO_ROOT%\Windows echo Assuming use of Matlab libraries in this distribution set MCR_ROOT=%DYNAMO_ROOT%\mcrWindows echo MCR libraries in %MCR_ROOT% set PATH=%PATH%;%MCR_ROOT%\runtime\win64
and execute it from the DOS command line.
Preparing your Matlab in Windows
If the standalone fails, a Matlab trial version should be used. Please download it from Mathworks. In order to check if your system has all the libraries needed to run Dynamo, write in the Matlab shell
run <path to installation>/dynamo_activate.m
If the activation fails, you need to compile (i.e. 'mex') some files. These requieres to have a compiler on your system. Write
in the Matlab shell.
Installing a C++ compiler for windows
This will direct you to install a c++ compiler specific for the Matlab-Windows (MinGW-w64). You just need to follow the instructions on screen. Should take less than three minutes.
When the compiler is installed, run
to check that the system recognizes it. Then run dynamo_activate.m again.
Data should be downloaded beforehand:
wget https://wiki.dynamo.biozentrum.unibas.ch/w/doc/data/hiv/v17.rec wget https://wiki.dynamo.biozentrum.unibas.ch/w/doc/data/t20s/t20s.mrc wget https://wiki.dynamo.biozentrum.unibas.ch/w/doc/data/fhv/crop.rec
Accessing Delft servers
There is the possibility of connecting to a GPU machine provided by TU Delft. The machine hpc04.tudelft.net has 8 GPUs installed. Number crunching will be extremely fast here, although graphical response will be probably sluggish when visualizing tomograms.
Accessing the remote machine
For linux and Mac users, open a terminal on your laptop and type
ssh -Y <user>@hpc04.tudelft.net
User accounts will be distributed during the workshop.
Windows users do the same through their preinstalled virtual box.
Opening a Linux terminal in the remote machine
We need to create a command terminal. Right click on the screen and select Open Terminal in the menu . A Linux command window will popup. You can check the GPUS in the machine through writing:
In the Linux terminal on hpc04.tudelft.net , we first need to make Matlab accessible invoking the corresponding module:
module load matlab
and then open it through:
it will take some secons. Then, in the Matlab window write:
run <PATH TO DYNAMO> /dynamo/dynamo_activate.m
This will activate Dynamo in the current Matlab session.
Introduction to tomography and subtomogram averaging
30 minutes of presentation to introduce tomography, subtomogram averaging and Dynamo.
Tutorial 1: Getting started
on screen presentation/hands-on practical. The presentation will loosely the introductory materials in:
- tutorial on basic elements: help, data and metadata formats.
- tutorial on the basic concept in Dynamo alignment: the project.
After the introduction of these general concepts, will follow together the basic hands-on tutorial of Dynamo.
Advanced getting started
In the afternoon session, participants will proceed to work on their own with the advanced introduction on a reduced data set from a real tomogram.
Further walkthroughs are available for participants that complete this, they can be chosen according to the particular interests:
- Treatment of densely packed spherical geometry (~1 hour)
- walkthrough for automated identification of proteosomes on a real tomogram through template matching. (~1 hour)
- Walkthrough on the FHV data set (~1hour)
- Daniel Castaño-Díez, BioEM Lab, University of Basel
- Paula Pérez-Navarro, C-CINA, University of Basel
- Cynthia Taveneau, Institut Curie, Paris