Materials for the June 24-25, 2024 MDAnalysis/MolSSI workshop at Arizona State University (ASU).
Irfan Alibay - @IAlibay
Oliver Beckstein - @orbeckst
Sam Ellis - @sjayellis
Mike Henry - @mikemhenry
Ian Kenney - @ianmkenney
Fiona Naughton - @fiona-naughton
Ashley Ringer-Macdonald - @armcdona
Yuxuan Zhuang - @yuxuanzhuang
Room PSF 186, Physical Sciences F Building
Department of Physics
Arizona State University
550 E Tyler Mall, PSF 186
Tempe, AZ 85287
USA
| Time (MST) | Session | Materials |
|---|---|---|
| 08:00-09:00 | Breakfast and Check-In/Registration | |
| 09:00-09:15 | Introduction | Introduction Slides |
| 09:15-10:05 | Introduction to MDAnalysis: Atoms | Lecture 1, Tutorial 1 |
| 10:05-11:00 | Introduction to MDAnalysis: Dynamics | Lecture 2, Tutorial 2 |
| 11:00-11:15 | Break | |
| 11:15-12:05 | MDAnalysis: Analysis | Tutorial 3 |
| 12:05-12:45 | MDAnalysis: Advanced Tips and Tricks | Tutorial 4 |
| 12:45-12:55 | Introduction to MDAKits | |
| 12:55-13:05 | Group Photo | |
| 13:05-14:00 | Lunch | |
| 14:00-14:30 | Introduction to the Bash Shell | Software Carpentry Tutorial, MolSSI Command Line Basics Lesson |
| 14:30-16:00 | Python Packaging | MolSSI Python Package Set-Up Lesson |
| 16:00-16:15 | Break | |
| 16:15-18:15 | Version Control | MolSSI git and GitHub Lessons |
| Time (MST) | Session | Materials |
|---|---|---|
| 08:00-09:00 | Breakfast and Check-In/Registration | |
| 09:00-10:45 | Testing and pytest | MolSSI Continuous Integration, Testing, Distribution Lessons |
| 10:45-11:00 | Break | |
| 11:00-12:30 | Documentation | MolSSI Code Style and documentation Lessons |
| 12:30-13:30 | Lunch | |
| 13:30-13:40 | Hackathon Introduction | |
| 13:40-15:30 | Hackathon | Hackathon Directory |
| 15:30-15:45 | Break | |
| 15:45-17:15 | Hackathon | Hackathon Directory |
| 17:15-17:45 | Hackathon Wrap-Up and Showcase | |
| 17:45-18:00 | Closing Remarks |
The hackathon will be held on the second day of the workshop. We encourage you to start thinking about what you want to work on early. More information and ideas can be found in the hackathon directory.
Instructions for setting up your environment to run this workshop locally
are provided in INSTALL.md.
A full list of the required Python packages can be seen inside environment.yml.
As downloading and installing everything will take a little while, ideally you should follow these steps before the workshop starts. If you encounter any issues during installation, we can help!
Note: Materials may change between now and the time of the workshop, so while we ask you to install ahead of time, also make sure to git pull just prior to the start of the workshop.
If for any reason you cannot set up a local environment with all required packages, you can use Google Colab to run all workshop notebooks directly from your browser, no installation required.
| Tutorial | Materials |
|---|---|
| Tutorial 1: Loading and Manipulating your Molecular Simulation Data |  |
| Tutorial 2: Positions, Distances and Trajectories | |
| Tutorial 3: Analysis Tools | |
| Tutorial 4: Advanced Universe Creation and Attributes | |
The primary communication channel for asking questions and having relevant discussions for this workshop will be the MDAnalysis Discord server. To join the server, use the invitation link, https://discord.gg/dMQWjNcZmh. If you are new to Discord, here are some resources to help you get started.
Once you join the server, you will see a “ASU WORKSHOP 2024” category. Start exploring the specific channels and read their descriptions to get used to the organization. You are welcome to introduce yourself in the #general channel and start asking any workshop-related questions in the #questions forum. Unfortunately Discord is limited in its ability to collapse the post titles posted in the #questions and #hackathon forums, so a workaround is to mute these channels (a post should show again if someone updates it).
- The asu guest wireless network is available to all participants but limited in capabilities.
- The eduroam network is available to anyone whose institution participates in eduroam. If you need to set up anything, talk to your institution's IT support before coming to ASU.
- The asu network is only available to members of Arizona State University.
Full instructions for connecting to the asu guest wireless network can be found in connecting-to-the-asu-wifi.pdf. You will need a means to read email or receice text messages because as part of the registration process, a code will be sent to you.
The "asu guest" network is bandwidth-limited. Make sure that you install the workshop environment before coming to ASU.
Provide your institution credentials. See https://eduroam.org/ and your institution's documentation for how to set up.
The workshop assumes that attendees have a working knowledge of Jupyter notebooks and Python (especially the NumPy library). For a better idea of things participants should be comfortable doing in Python or to freshen up on your skills, please have a look at the MolSSI lesson, “Python Scripting for Computational Molecular Science”.
All members of the MDAnalysis community and participants in MDAnalysis workshops are expected to abide by the MDAnalysis Code of Conduct.
Written materials are provided under the CC-BY-4.0 SA license.
Please see AUTHORS.md for a list of contributors to the workshop materials.
We would like to give a special thanks to our partner for this workshop, the Molecular Sciences Software Institute (MolSSI).
This workshop has been made possible in part by a grant from the Chan Zuckerberg Initiative (CZI) DAF, a donor advised fund of Silicon Valley Community Foundation (funder DOI 10.13039/100014989). MDAnalysis also thanks NumFOCUS for its continued support as our fiscal sponsor.
