{"id":18524285,"url":"https://github.com/mdanalysis/mdanalysismolssiworkshop-intermediate2day","last_synced_at":"2025-04-09T11:32:00.171Z","repository":{"id":242729075,"uuid":"810395736","full_name":"MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day","owner":"MDAnalysis","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-25T23:57:59.000Z","size":32829,"stargazers_count":13,"open_issues_count":4,"forks_count":16,"subscribers_count":7,"default_branch":"jun24-ws","last_synced_at":"2025-04-05T13:24:38.720Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MDAnalysis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-04T15:59:00.000Z","updated_at":"2025-03-14T11:58:40.000Z","dependencies_parsed_at":"2024-06-04T18:11:07.107Z","dependency_job_id":"c3d36a31-3ada-4f1f-9fd8-c10081499fc1","html_url":"https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day","commit_stats":{"total_commits":158,"total_committers":13,"mean_commits":"12.153846153846153","dds":0.6139240506329113,"last_synced_commit":"8ba4da0a71f7cdfac645ef3194882b162802c08f"},"previous_names":["mdanalysis/mdanalysismolssiworkshop-intermediate2day"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MDAnalysis%2FMDAnalysisMolSSIWorkshop-Intermediate2Day","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MDAnalysis%2FMDAnalysisMolSSIWorkshop-Intermediate2Day/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MDAnalysis%2FMDAnalysisMolSSIWorkshop-Intermediate2Day/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MDAnalysis%2FMDAnalysisMolSSIWorkshop-Intermediate2Day/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MDAnalysis","download_url":"https://codeload.github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/tar.gz/refs/heads/jun24-ws","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248031638,"owners_count":21036445,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T17:40:22.061Z","updated_at":"2025-04-09T11:32:00.156Z","avatar_url":"https://github.com/MDAnalysis.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MDAnalysis/MolSSI Workshop at Arizona State University 2024\nMaterials for the June 24-25, 2024 [MDAnalysis/MolSSI workshop](https://www.mdanalysis.org/2024/05/14/ASUworkshop/) at [Arizona State University](https://www.asu.edu/) (ASU).\n\n## Instructors\nIrfan Alibay - [@IAlibay](https://github.com/IAlibay) \nOliver Beckstein - [@orbeckst](https://github.com/orbeckst) \nSam Ellis - [@sjayellis](https://github.com/sjayellis) \nMike Henry - [@mikemhenry](https://github.com/mikemhenry) \nIan Kenney - [@ianmkenney](https://github.com/ianmkenney) \nFiona Naughton - [@fiona-naughton](https://github.com/fiona-naughton) \nAshley Ringer-Macdonald - [@armcdona](https://github.com/armcdona) \nYuxuan Zhuang - [@yuxuanzhuang](https://github.com/yuxuanzhuang) \n\n## Location\n\n#### Workshop Lectures and Tutorials:\n\nRoom PSF 186, [Physical Sciences F Building](https://maps.app.goo.gl/b2kKhEBdvdvS2M3h9) \nDepartment of Physics \nArizona State University \n550 E Tyler Mall, PSF 186 \nTempe, AZ 85287 \nUSA\n\n## Schedule\n### Day 1, June 24th\n| Time (MST) | Session | Materials |\n|---------------|----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|\n| 08:00-09:00 | Breakfast and Check-In/Registration | \t |\n| 09:00-09:15 | Introduction \t | [Introduction Slides](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/June%202024%20MDAnalysis-MolSSI%20Workshop%20Introduction%20Slides.pdf) \t |\n| 09:15-10:05 | Introduction to MDAnalysis: The Universe | [Lecture 1](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Lecture1_MDAnalysisBasics_TheUniverse.ipynb), [Tutorial 1](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial1_System_Manipulation.ipynb) |\n| 10:05-11:00 | Introduction to MDAnalysis: File I/O | [Lecture 2](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Lecture2_FileIO.ipynb), [Tutorial 2](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial2_Trajectories.ipynb) |\n| 11:00-11:15 | Break \t | \t |\n| 11:15-12:05 | MDAnalysis: Analysis \t | [Lecture 3](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Lecture3_Analysis.ipynb), [Tutorial 3](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial3_Analysis.ipynb) |\n| 12:05-12:45 | MDAnalysis: Advanced Tips and Tricks \t | [Lecture 4](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Lecture4_Advanced.ipynb), [Tutorial 4](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial4_Advanced.ipynb) |\n| 12:45-12:55 | Introduction to MDAKits | [MDAKits intro lecture](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/MDAKitsIntro.pdf) |\n| 12:55-13:05 | Group Photo | |\n| 13:05-14:00 | Lunch \t | \t |\n| 14:00-14:30 | Introduction to the Bash Shell | [Software Carpentry Tutorial](https://swcarpentry.github.io/shell-novice/), [MolSSI Command Line Basics Lesson](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Command_Line.md) |\n| 14:30-16:00 | Python Packaging \t | [MolSSI Python Package Set-Up Lesson](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Python_Packaging.md) \t |\n| 16:00-16:15 | Break \t | \t |\n| 16:15-18:15 | Version Control \t | [MolSSI git and GitHub Lessons](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Version_Control.md) \t |\n\n### Day 2, June 25th\n| Time (MST) | Session | Materials |\n|---------------|----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|\n| 08:00-09:00 | Breakfast and Check-In/Registration | \t |\n| 09:00-10:45 | Testing and pytest \t | [MolSSI Testing Lessons](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Testing.md) \t |\n| 10:45-11:00 | Break \t | \t |\n| 11:00-12:30 | Documentation \t | [MolSSI Documentation Lessons](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Documentation.md) |\n| 12:30-13:30 | Lunch \t | \t |\n| 13:30-13:40 | Hackathon Introduction | [Hackathon Intro Slides](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/HackathonIntroduction_ASUworkshop.pdf) |\n| 13:40-15:30 | [Hackathon](#hackathon) \t | [Hackathon Directory](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/tree/jun24-ws/hackathon) |\n| 15:30-15:45 | Break \t | \t |\n| 15:45-17:15 | [Hackathon](#hackathon) \t | [Hackathon Directory](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/tree/jun24-ws/hackathon) |\n| 17:15-17:45 | Hackathon Wrap-Up and Showcase \t | \t |\n| 17:45-18:00 | Closing Remarks \t | \t |\n\n## Hackathon\n\nThe 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](./hackathon).\n\n## Setting up your Python Environment *Before the Workshop*\n\n\u003c!--The workshop will be in a blended learning environment and hands-on. You will need a working installation of MDAnalysis and related packages including data to analyze in order to participate. The full installation may take up to about 1 GB of space (mostly for data, which you can delete after the workshop).--\u003e \n\nInstructions for setting up your environment to run this workshop locally\nare provided in [`INSTALL.md`](INSTALL.md).\n\nA full list of the required Python packages can be seen inside [`environment.yml`](environment.yml).\n\nAs 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!\n\n**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.\n\n## Google Colab\n\nIf 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. \n| Tutorial | Materials |\n|-------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| **Tutorial 1:** Loading and Manipulating your Molecular Simulation Data | [![MDA Part 1](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial1_System_Manipulation.ipynb) \t |\n| **Tutorial 2:** Positions, Distances and Trajectories \t | [![MDA Part 2](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial2_Trajectories.ipynb) |\n| **Tutorial 3:** Analysis Tools | [![MDA Part 3](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial3_Analysis.ipynb) |\n| **Tutorial 4:** Advanced Universe Creation and Attributes | [![MDA Part 4](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/notebooks/Tutorial4_Advanced.ipynb) |\n\n## Asking Questions *Before and During the Workshop*\n\nThe primary communication channel for asking questions and having relevant discussions for this workshop will be the [MDAnalysis Discord server](https://discord.com/channels/807348386012987462/). To join the server, use the invitation link, [https://discord.gg/dMQWjNcZmh](https://discord.gg/dMQWjNcZmh). If you are new to Discord, [here are some resources](https://support.discord.com/hc/en-us/categories/115000217151) to help you get started.\n\nOnce 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).\n\n## Connecting to the Wireless Network/Wifi\n\n* The **asu guest** wireless network is *available to all participants* but limited in capabilities.\n* The **eduroam** network is available to anyone whose institution participates in [eduroam](https://eduroam.org/). If you need to set up anything, talk to your institution's IT support *before* coming to ASU.\n* The **asu** network is only available to members of Arizona State University.\n\n### \"asu guest\" network\n\nFull instructions for connecting to the **asu guest** wireless network can be found in [`connecting-to-the-asu-wifi.pdf`](https://github.com/MDAnalysis/MDAnalysisMolSSIWorkshop-Intermediate2Day/blob/jun24-ws/connecting-to-the-asu-wifi.pdf). You will need a means to read email or receive text messages because as part of the registration process, a code will be sent to you.\n\n*The \"asu guest\" network is bandwidth-limited. Make sure that you [install the workshop environment](INSTALL.md) before coming to ASU.*\n\n### eduroam\n\nProvide your institution credentials. See https://eduroam.org/ and your institution's documentation for how to set up.\n\n## Workshop Pre-Requisites\n\nThe workshop assumes that attendees have a working knowledge of [Jupyter notebooks][1] and Python (especially the [NumPy library][2]). 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](https://education.molssi.org/python_scripting_cms/)”.\n\n## Code of Conduct\n\nAll members of the MDAnalysis community and participants in MDAnalysis workshops are expected to abide by the MDAnalysis [Code of Conduct](https://www.mdanalysis.org/pages/conduct/).\n\nIf at any point you experience harassment or witness a violation of our Code of Conduct, please [report it](https://www.mdanalysis.org/pages/conduct/#reporting).\n\nIf you just need to talk to someone, maybe you are unsure about something or something just doesn't quite feel right, please see the [list of ombudspersons with contact details](REPORTING.md)\n\n\n## Health and Safety\nWe are committed to providing a safe, comfortable, and healthy environment for the workshop and have looked to local and international entities and other organizations in the open source community to develop onsite safety measures for workshop attendees.\n\n### Testing\nA limited number of rapid self-tests will be made available at check-in for those who would like to test themselves for COVID-19 during the meeting.\n\n**Testing Positive for COVID-19**\n\n*Individuals who are COVID-positive should not attend the workshop.* If you receive a positive COVID-19 test result during the workshop, please [notify the workshop organizing committee][workshop_email] and do not return to the event while you are still COVID-positive.\n\n* We will treat any information about your testing status as confidential. (If you want to notify any of your contacts you may, of course, do so yourself.)\n* We will announce to attendees if we are made aware of anyone testing positive for SARS-Cov-2 so that all attendees and instructors are put in a position to make choices that are right for them and their exposure risk level.\n\n### Face Coverings\nFace coverings are not required, but are welcomed. We view face coverings as a personal choice and will support attendees in their choice to wear or not to wear a face covering.\n\n### Fire Safety\nFollow the instructions given at the workshop.\n\n\n## License\n\nWritten materials are provided under the [CC-BY-4.0 SA license](LICENSE.md).\n\n## Acknowledgements\n\nPlease see [`AUTHORS.md`](AUTHORS.md) for a list of contributors to the workshop materials.\n\nWe would like to give a special thanks to our partner and primary sponsor for this workshop, the [Molecular Sciences Software Institute](https://molssi.org/) (MolSSI).\n\n\u003cimg\nsrc=\"/logos/MolSSI_Logo.png\"\ntitle=\"Molecular Sciences Software Institute Logo\" alt=\"Molecular Sciences Software Institute Logo\"\nstyle=\"float: left; height: 5em; \" /\u003e\n\nThis workshop has been made possible in part by grants ([EOSS4](https://chanzuckerberg.com/eoss/proposals/mdanalysis-faster-extensible-molecular-analysis-for-reproducible-science/) and [EOSS5](https://chanzuckerberg.com/eoss/proposals/mdanalysis-outreach-and-project-manager/)) from the [Chan Zuckerberg Initiative](https://chanzuckerberg.com) (CZI) DAF, a donor advised fund of Silicon Valley Community Foundation (funder DOI 10.13039/100014989) and through the support of the [Center for Biological Physics](https://cbp.asu.edu/) at Arizona State University.\n\nMDAnalysis also thanks NumFOCUS for its continued support as our fiscal sponsor.\n\n\u003cimg\nsrc=\"/logos/CZI_Logo.jpg\"\ntitle=\"Chan Zuckerberg Initiative Logo\" alt=\"Chan Zuckerberg Initiative Logo\"\nstyle=\"float: left; height: 5em; \" /\u003e\n\n\u003cimg\nsrc=\"/logos/CBP_logo.png\"\ntitle=\"Center for Biological Physics Logo\" alt=\"Center for Biological Physics (CBP) at Arizona State University (logo) \"\nstyle=\"float: left; height: 5em; \" /\u003e\n\n\u003cimg\nsrc=\"/logos/numfocus-sponsored.png\"\ntitle=\"NumFOCUS Sponsored Project Logo\" alt=\"NumFOCUS Sponsored Project Logo\"\nstyle=\"float: left; height: 5em; \" /\u003e\n\n##\n[1]: https://jupyter-notebook.readthedocs.io/en/stable/\n[2]: https://numpy.org/\n\n[workshop_email]: mailto:workshops@mdanalysis.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdanalysis%2Fmdanalysismolssiworkshop-intermediate2day","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmdanalysis%2Fmdanalysismolssiworkshop-intermediate2day","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdanalysis%2Fmdanalysismolssiworkshop-intermediate2day/lists"}