= EMAN2 Workshop =
== December 16 - 18, 2019 ==
Sessions will alternate between theory talks and tutorial sessions. Participants will need to use their own laptops to participate in the tutorials (see below).
 * Day 1 - AM: Introduction to EMAN 2.31, 2-D analysis and single particle methods
 * Day 1 - PM: First tomography tutorial session
 * Day 2 - AM: Second tomography session
 * Day 2 - PM: EMAN2 from Python, other concepts

'''The schedule does not include time for software installation! Make sure software is preinstalled and tested! [[http://eman2.org/Install/BinaryInstallAnaconda/2.31|Install EMAN2.31]]'''
=== Presentations ===
 * [[attachment:intro_eman.pdf|Introduction to EMAN]]
 * [[attachment:variability_eman.pdf|2D Variability Analysis]]
 * [[attachment:tomography_intro.pdf|Tomography Introduction]]
 * [[attachment:programming_eman.pdf|Python Programming with EMAN]]
 * [[attachment:muyuan_jupyter.ipynb|Jupyter Demo]]

=== Laptop Requirements ===
 * Participants in the tutorial sessions will need to use their own laptop computers. While the tutorials are scaled back versions of 'real' problems, a reasonably powerful laptop computer is still required.
 * '''Strongly suggest having a wheel mouse, working with the trackpad alone is difficult'''
 * Recommended laptop specifications:
  * 4 cores, 2.0+ ghz processor (4 cores, not threads)
  * 16 GB RAM
  * 50 - 75 GB of free disk space
  * high resolution capable display (1080P or similar recommended)
  * Mac/Linux preferred. 
   * EMAN2 does support windows, but:
    * Windows users will need to be familiar with working from the command-line (often windows users don't even realize it exists)
    * there can be many different machine-specific problems with installation under Windows. Users are very strongly encouraged to install and thoroughly test the installation ASAP. 

What if my laptop doesn't meet these specifications?
 * With 2 cores jobs will run slower, so you may get a bit behind in the demos, but can probably still participate
 * Most tutorials will probably be ok with 8 GB of RAM, but you may have some interactivity problems, and it is possible a few memory intensive tasks may not work right
 * While you will not need 75 GB of storage for any single demo, if you have less space than this you may, for example, have to move the first day's tutorial files to an external drive to make space for day 2 and so on...
 * If you plan to remotely log in to a more powerful computer for the tutorial, please see: [[http://eman2.org/Remote|Remote display in EMAN2]]

=== YOU MUST INSTALL AND TEST SOFTWARE AND DATA BELOW IN ADVANCE IF YOU WISH TO PARTICIPATE! ===
Please install the software and insure it works before the workshop. If you have problems ask for help by email '''before the workshop!'''

==== EMAN2 ====

Software:
 * Please read [[http://eman2.org/Install/BinaryInstallAnaconda/2.31|Installation Instructions]] before downloading
 * Please install [[https://cryoem.bcm.edu/cryoem/downloads/view_eman2_version/30|EMAN2.31]]
 * It is critical that you have EMAN2.31 installed. EMAN2.22 lacks many newly developed features we will cover.

Data for Tutorials (please download and make sure you have working space on your computer):

 * [[http://blake.bcm.edu/dl/eman2_samples.zip|Sample data for learning GUI]]
 * [[http://blake.bcm.edu/dl/fassub.tgz|2-D Variability Data]]
 * [[http://blake.bcm.edu/dl/tutorial_tomo_mini.zip|Tomography Small-tutorial Data Download]]

 * If you experience e2display.py crashing on Windows 10 using the Ubuntu method, with an error related to GLU, try:
  * sudo apt-get install libglu1-mesa libglu1-mesa-dev
 * If you have problems please email Steve Ludtke <sludtke@bcm.edu>