Welcome to the home of your materials for Unidata's 2023 AMS short course. This collection of materials includes notebooks (and accompanying solutions) that enable you to complete the course.
For this workshop, we have two separate ways you can participate, work ahead, and follow along. As part of the learning experience, we recommend setting up a Python environment on your personal computer. We understand potential limitations on this, so you will be provided access to Unidata's Science Gateway to do your work on the NSF Jetstream2 Cloud as part of your registration.
Note that we at Unidata are not able to plan for specific hardware limitations your personal computer might have. We will have limited time and facilitator capacity for on-site technical support. Please plan to use Science Gateway if this is a concern for you. We will be using and supporting Conda for installing and managing a Python environment from your computer's command line. Please have this environment prepared ahead of time if you'll be using your own computer.
- Install Miniconda if you don't already have command-line access to
conda.- Get a copy of this code! You have a few options from the green button above,
a.git clone https://github.com/Unidata/metpy-workshop.gitfrom your command line, within some directory on your computer. Install git if necessary. If you're comfortable withgit, we recommend this approach as it will let you keep this code regularly up to date.
b.Open with GitHub Desktopif you have and prefer this graphically-focused software.
c.Download ZIPif you prefer to get a single snapshot of the code right here and now.- Wherever you have this code saved, set up your Python environment with
conda env create -f environment.ymlfrom your command line.- Give this some time. Once it's done, activate this new environment with
conda activate metpy-ams-2023. Always do this before starting on work for this workshop!- Launch Jupyter and get to coding with
jupyter lab. Don't forget to activate your environment first!
☁️ Using Science Gateway
If you've registered for this workshop, you can do all of this work on our very own gateway to the NSF Jetstream Cloud! For this course, temporary logins will be generated and handed out to registrants in the classroom. Keep your login handout with you! You will have short-term access to use the Jetstream resources and download your work after the end of the workshop.
When you first sign in, it may take a few seconds for your personal workspace to populate and your coding environment to be fully set up. From here you will discover a Jupyter Lab interface pre-populated with these materials and a few tools to enable you to update the materials if needed.
This requires only a web browser and a stable internet connection. Get to coding!
It is often important to update your environment and code you're working with frequently, and that is true for our workshop! Please make sure to re-download any updated code and confirm that your environment works before the start of the course. To support this, our facilitators will be available in the half-hour before the workshop to have room for doing this together. Whether you set up a local Python environment or participate in the cloud, please come to the classroom during this time window for a smooth start to the course!
Launching this JupyterHub server is the result of a collaboration between several research and academic institutions and their staff. For Jetstream2 and JupyterHub expertise, we thank Andrea Zonca (San Diego Supercomputing Center), Jeremy Fischer, Mike Lowe (Indiana University), the NSF Jetstream2 (doi:10.1145/3437359.3465565) team.
This work employs the NSF Jetstream2 Cloud at Indiana University through allocation EES220002 from the Advanced Cyberinfrastructure Coordination Ecosystem: Services & Support (ACCESS) program, which is supported by National Science Foundation grants #2138259, #2138286, #2138307, #2137603, and #2138296.
Unidata is one of the University Corporation for Atmospheric Research (UCAR)'s Community Programs (UCP), and is funded primarily by the National Science Foundation (AGS-1901712).
If you have benefited from the Unidata Science Gateway, please cite doi:10.5065/688s-2w73. Additional citation information can be found in this Citation File Format file.