Difference between revisions of "Prato Workshop 2018"

From Dynamo
Jump to navigation Jump to search
 
(20 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
== Computers ==
 
== Computers ==
 +
  
  
Line 7: Line 8:
 
To activate ''Dynamo''
 
To activate ''Dynamo''
  
<tt> export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libstdc++.so.6</tt>
 
 
  <tt> activate_dynamo </tt>
 
  <tt> activate_dynamo </tt>
  
=== Start a ''Dynamo'' window ===
+
=== Start a ''Dynamo'' console  ===
  
 
Type in the shell:
 
Type in the shell:
Line 16: Line 16:
 
  <tt>dynamo</tt>
 
  <tt>dynamo</tt>
  
=== Run ''Dynamo'' projects in a shell ===
+
=== Run ''Dynamo'' projects in a different shell ===
  
 +
It is inconvenient to run projects in the ''Dynamo'' console. Instead, do the following:
 +
* Open a new Linux terminal
 
* Activate ''Dynamo''
 
* Activate ''Dynamo''
* type the <tt>.nameOfTheProject.exe</tt>
+
* ''If'' you are going to use a GPU, you need to make the CUDA libraries visible:
 +
<tt>export LD_LIBRARY_PATH=/usr/local/cuda-9.1/lib64:$LD_LIBRARY_PATH</tt>
 +
*go to the folder containing the project.  Type the name of the project executable (extension .exe). For a project called <tt>myProject</tt>:
 +
<tt>./myProject.exe</tt>
 +
 
 +
=== Compiling  ''Dynamo'' for the GPU===
 +
 
 +
You only need to do  this if you want to '''compile''  the  GPU projects:
 +
<tt>export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libstdc++.so.6</tt>
 +
<tt>export LD_LIBRARY_PATH=/usr/local/cuda-9.1/lib64:$LD_LIBRARY_PATH</tt>
 +
<tt>cd ~/ws/opt</tt>
 +
<tt>sudo make clean </tt>
 +
<tt>sudo make all</tt>
 +
 
 +
== Materials ==
 +
 
 +
If you are not able to follow the tutorials from your laptop, a local offline copy of the materials is available in
 +
 
 +
<tt>~/ws/data/dynamo</tt>
 +
 
 +
To open a pdf file, type:
 +
 
 +
  <tt>evince Dynamo_01_jargon.pdf &</tt>
 +
 
 +
=== Material list ===
 +
Files in bold are walkthroughs. Students will complete them on their own.
 +
 
 +
* Dynamo_01_jargon.pdf
 +
A single slide with the basic concepts in  Dynamo.
 +
* Dynamo_02_basic.pdf
 +
Notes covering first on-screen presentation.
 +
General commands for visualization.
 +
* Dynamo_03_projects.pdf
 +
General operation of the GUI that creates alignment projects.
 +
* '''Dynamo_04_starters.pdf'''
 +
Walkthrough with synthetic data
 +
* '''Dynamo_05_advanced.pdf'''
 +
A single slide with the basic concepts in  Dynamo.
 +
* Dynamo_06_membranes.pdf
 +
Creation of surfaces  modeling membranes in the tomogram browser.
 +
* Dynamo_07_filaments.pdf
 +
Creation of filaments in the tomogram browser.
 +
* '''Dynamo_08_lattices.pdf'''
 +
Walkthrough on extraction of particles in densely populated vesicles.
  
 
== Program ==
 
== Program ==
  
Before the hands-on session, we will go to  [http://{{SERVERNAME}}/w/doc/presentations/oxford2017.pptx this presentation] for a general introduction of the ''Dynamo''software.
+
Before the hands-on session, we will go to  [http://{{SERVERNAME}}/w/doc/presentations/oxford2017.pptx this presentation] for a general introduction of the ''Dynamo'' software.
  
 
===General Introduction===
 
===General Introduction===
Line 31: Line 76:
 
Guided presentation:  
 
Guided presentation:  
  
We will take one hour to go over the basic technical aspects of ''Dynamo''.
+
We will take one hour to go over the basic technical aspects of ''Dynamo''. This material is covered by the guides below:
  
 
* [http://{{SERVERNAME}}/w/doc/misc/conceptsSheet.pdf Basic ''Dynamo'' jargon]
 
* [http://{{SERVERNAME}}/w/doc/misc/conceptsSheet.pdf Basic ''Dynamo'' jargon]
Line 40: Line 85:
 
Working on your own:  
 
Working on your own:  
  
* Basic [[Starters guide | walkthrough]]:  on synthetic data. Covers creating a catalogue, picking particles, launching a project. (~1.5 hours)
+
* Basic [[Starters guide | walkthrough (Starters guide)]]:  on synthetic data. Covers creating a catalogue, picking particles, launching a project. (~1.5 hours)
* [[Advanced starters guide]]  on a real tomogram. (~3 hours)
+
 
* Further work:
+
* Related materials (not covered in this course):
 
** {{pdftutorial|commandline|tutorial}} on the use command line operations for general purposes.
 
** {{pdftutorial|commandline|tutorial}} on the use command line operations for general purposes.
 
** {{pdftutorial|command_line_projects|tutorial}} on the use of the command line to manage projects.
 
** {{pdftutorial|command_line_projects|tutorial}} on the use of the command line to manage projects.
  
===Geometric modeling===
+
===Particle picking===
  
 
[[File:membraneExampleCommandLineCroppingPositionsOnMesh.png|thumb|upright|200px| Geometric modeling for [http://{{SERVERNAME}}/w/doc/misc/modelMembrane.pdf surfaces] and [http://{{SERVERNAME}}/w/doc/misc/modelFilament.pdf filaments ]]]
 
[[File:membraneExampleCommandLineCroppingPositionsOnMesh.png|thumb|upright|200px| Geometric modeling for [http://{{SERVERNAME}}/w/doc/misc/modelMembrane.pdf surfaces] and [http://{{SERVERNAME}}/w/doc/misc/modelFilament.pdf filaments ]]]
Short guided presentation:
+
Short guided presentation (~1 hour):
  
 
*  [http://{{SERVERNAME}}/w/doc/misc/modelMembrane.pdf tutorial on] membrane modeling with <tt> dmslice </tt>
 
*  [http://{{SERVERNAME}}/w/doc/misc/modelMembrane.pdf tutorial on] membrane modeling with <tt> dmslice </tt>
Line 57: Line 102:
 
* Reusing model workflows ([[Walkthrough model worfklow reuse | walkthrough]])
 
* Reusing model workflows ([[Walkthrough model worfklow reuse | walkthrough]])
 
* Further work: catalogue
 
* Further work: catalogue
 +
 +
===Case studies ===
 +
*  [[Advanced starters guide]]  on a real tomogram. (~3 hours)
  
 
Working on your own:
 
Working on your own:
Line 65: Line 113:
 
| [[File:FhvTmsliceUpdates.png|thumb|right|200px| lattice directions ]]
 
| [[File:FhvTmsliceUpdates.png|thumb|right|200px| lattice directions ]]
 
|} -->
 
|} -->
* In the afternoon, after the research talks, we will focus on the extraction of particles  [[Walkthrough for lattices on vesicles| from densely packed spherical geometry  on HIV viral capsides]]  (~1 hour)
+
* Extraction of particles  [[Walkthrough for lattices on vesicles| from densely packed spherical geometry  on HIV viral capsides]]  (~1 hour)
  
 
== Further work ==
 
== Further work ==

Latest revision as of 13:31, 12 April 2018

This page describes the contents of the practical hands-on sessions in Diamond (11th-12th November 2018).

Computers

Activating Dynamo

To activate Dynamo

 activate_dynamo 

Start a Dynamo console

Type in the shell:

dynamo

Run Dynamo projects in a different shell

It is inconvenient to run projects in the Dynamo console. Instead, do the following:

  • Open a new Linux terminal
  • Activate Dynamo
  • If you are going to use a GPU, you need to make the CUDA libraries visible:
export LD_LIBRARY_PATH=/usr/local/cuda-9.1/lib64:$LD_LIBRARY_PATH
  • go to the folder containing the project. Type the name of the project executable (extension .exe). For a project called myProject:
./myProject.exe

Compiling Dynamo for the GPU

You only need to do this if you want to 'compile the GPU projects:

export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libstdc++.so.6
export LD_LIBRARY_PATH=/usr/local/cuda-9.1/lib64:$LD_LIBRARY_PATH
cd ~/ws/opt
sudo make clean 
sudo make all

Materials

If you are not able to follow the tutorials from your laptop, a local offline copy of the materials is available in

~/ws/data/dynamo

To open a pdf file, type:

 evince Dynamo_01_jargon.pdf &

Material list

Files in bold are walkthroughs. Students will complete them on their own.

  • Dynamo_01_jargon.pdf

A single slide with the basic concepts in Dynamo.

  • Dynamo_02_basic.pdf

Notes covering first on-screen presentation. General commands for visualization.

  • Dynamo_03_projects.pdf

General operation of the GUI that creates alignment projects.

  • Dynamo_04_starters.pdf

Walkthrough with synthetic data

  • Dynamo_05_advanced.pdf

A single slide with the basic concepts in Dynamo.

  • Dynamo_06_membranes.pdf

Creation of surfaces modeling membranes in the tomogram browser.

  • Dynamo_07_filaments.pdf

Creation of filaments in the tomogram browser.

  • Dynamo_08_lattices.pdf

Walkthrough on extraction of particles in densely populated vesicles.

Program

Before the hands-on session, we will go to this presentation for a general introduction of the Dynamo software.

General Introduction

Clicking particles in the Starters guide

Guided presentation:

We will take one hour to go over the basic technical aspects of Dynamo. This material is covered by the guides below:

  • tutorial on basic elements: help, data and metadata formats.
  • tutorial on the basic concept in Dynamo alignment: the project.

Working on your own:

  • Related materials (not covered in this course):
    • tutorial on the use command line operations for general purposes.
    • tutorial on the use of the command line to manage projects.

Particle picking

Geometric modeling for surfaces and filaments

Short guided presentation (~1 hour):

Case studies

Working on your own:

Further work

Due to time constraints, we will not cover all functionalities of Dynamo in this course. With the basis acquired in these two days, participants can complete on their own the rest of the program.

Template matching

Working on your own:

  • We will follow this walkthrough for automated identification of proteosomes on a real tomogram through template matching. (~1 hour)

Adaptive bandpass filtering

Working on your own:

  • We will follow this walkthrough to create a small synthetic data set that illustrates the principles of adaptive bandpass filtering, a way of conducting a golden standard alignment procedure . (~40 mins)

Classification

Short guided presentation:

Creation of 3D scenes

Working on your own:

Further support material.

  • Walkthrough on depiction and manipulation of triangulations (synthetic data).

Additional tools

Wednesday afternoon session.

Data sets

The data sets will be updated here.

Exercises

Exercises are scheduled for the last day. Nevertheless, feel free to start them any time during the workshop.

Organizers

  • Alex de Marco, Monash University.

Instructors

  • Daniel Castaño-Díez, University of Basel.
  • Misha Kudryashev, MPI Frankfurt