.. -*- mode: reST; coding: utf-8 -*-

===================================================================================
 MDAnalysis Tutorial at the 2015 CECAM Macromolecular Simulation Software Workshop
===================================================================================

:Last updated: |today|
:Authors: `Oliver Beckstein`_, `David Dotson`_
:Tutorial: |release|
:MDAnalysis: ≥ |MDAnalysis_version|

MDAnalysis_ is an open source Python library that helps you to quickly
write your own analysis algorithm for studying trajectories produced
by the most popular simulation packages [Michaud-Agrawal2011]_.


The `CECAM Macromolecular simulation software workshop`_ contains a
two-day `mini-workshop on analysing simulation data`_ lead by Dr
Phillip Fowler (Oct 14/15, 2015). As part of the workshop, a team of
MDAnalysis_ developers (`Oliver Beckstein`_, `David Dotson`_, `Tyler
Reddy`_, `Phil Fowler`_) will be at hand to give an *introduction to
MDAnalysis* on the first day and be available to help with projects
during the *hackathon* on the second day.

.. _CECAM Macromolecular simulation software workshop:
   http://www.cecam.org/workshop-0-1214.html
.. _mini-workshop on analysing simulation data:
   http://philipwfowler.me/cecam-analysing-simulation-data-mini-workshop/
.. _MDAnalysis: http://mdanalysis.org
.. _Oliver Beckstein:
   http://becksteinlab.physics.asu.edu/people/11/oliver-beckstein
.. _David Dotson:
   http://becksteinlab.physics.asu.edu/people/19/david-dotson
.. _Tyler Reddy:
   http://sbcb.bioch.ox.ac.uk/currentmembers/reddy.php
.. _Phil Fowler:
   http://philipwfowler.me/

In order to prepare for the tutorial session on Wednesday Oct 14, 2015
you should

1. :ref:`install MDAnalysis<chapter-installing-mdanalysis>` (and
   its dependencies) on your laptop (Linux or Mac OS X)
2. :ref:`download example data<chapter-datadownload>`

.. Note:: 

   Please complete these two tasks well in advance of the workshop
   because there will be very little time to do this during the
   tutorial session. The example data real-world trajectories are
   about 300 MiB and downloading over a WiFi connection with 25 other
   people attempting to do the same will almost certainly fail.


Contents
--------

.. toctree::
   :maxdepth: 1

   installation
   testing
   datadownload
   notebooks
   references