2. Session 1 Video 2a: Set Up Pre-Configured Environment

Developed for METplus Version 4.0.

2.1. Description

METplus 4.0 Online Tutorial Session 1 : Setup Video 2a: Set Up Pre-Configured Environment

The content in this video corresponds to this online tutorial section: https://dtcenter.org/metplus-practical-session-guide-version-4-0/session-1-metplus-setupgrid-grid/metplus-setup/metplus-initial-setup

Next Video: https://www.youtube.com/embed/ZsFE4aOYqMc

Questions? Visit the METplus GitHub Discussions Form: https://github.com/dtcenter/METplus/discussions

METplus DTC Webpage: https://dtcenter.org/community-code/metplus

METplus User’s Guide: https://metplus.readthedocs.io/en/latest/Users_Guide

2.2. Preparation for Presenter

  • Slides: metplus_online_tutorial_session_1_setup.pptx (note formatting of PowerPoint presentation differs between PowerPoint and Google Drive! Please use PowerPoint if available or copy file and adjust formatting)

  • Open a web browser

  • Open a terminal on a pre-configured machine such as Hera or Cheyenne and set the PS1 environment variable to something that hides the user and machine names, i.e. export PS1=”$~”

2.3. Script

(show slide 4 - title)

Welcome to the “Set Up Pre-Configured Environment” video, part of the “Session 1: Setup” portion of the METplus 4.0 Online Tutorial.

(show slide 5 - Topics Covered in This Video)

This video covers how to set up the tutorial if you are running in a pre-configured environment such as Hera or Cheyenne. If you are running on your own computer, then please watch the “Set Up User Workstation Environment” video instead.

(open a web browser and navigate to https://dtcenter.org/metplus-practical-session-guide-version-4-0/session-1-metplus-setupgrid-grid/metplus-setup/metplus-initial-setup)

The content in this video corresponds to the online tutorial section titled “METplus: Initial Setup” which is found in the “METplus Setup” portion of “Session 1: METplus Setup / Grid-to-Grid.”

(navigate to Pre-Configured Environments / User Configured Environments headers)

I will go through the instructions for setting up the tutorial on Hera. The instructions for the other pre-configured environments are very similar.

(navigate to Hera instructions: https://dtcenter.org/metplus-practical-session-guide-version-4-0/session-1-metplus-setupgrid-grid/metplus-setup/metplus-initial-setup/setting-tutorial-environment-hera)

(open terminal on Hera on left side of screen, shift the browser window to the right side of the screen)

Open a shell and follow the instructions. Be sure to read each instruction carefully.

(run through the instructions to create a directory and cd in the directory)

Navigate to a directory where you have write permissions. Next create a directory called METplus dash 4.0.0 underscore tutorial. This directory will contain all of your tutorial work including configuration files, output data, and any other notes you’d like to keep. Change directory into this directory. You can run the “pwd” command to see which directory you are currently in if it is not displayed in the shell. Next create the user_config and output directories.

Tutorial files are copied from a local directory. This command also renames the files so that the subsequent tutorial instructions will be identical regardless of the environment used.

The tutorial setup script runs any module commands, if applicable, and sets environment variables that are referenced throughout the tutorial. Simply source this file each time you return to the tutorial instructions and you will be ready to run.

At the end of each environment specific page is a link to the page titled “Verify Environment is Set Correctly.”

(show slide 6 - links)

The next video in this tutorial is titled “Verify Environment is Set Correctly.” This is an important next step to ensure that all of the instructions in this video were completed correctly.

If you have any questions, please visit the METplus GitHub Discussions Forum. On this page you can check if your question has already been asked by another user or create a new discussion topic.

Other useful resources, such as the User’s Guide and Contributor’s Guide, can be found on the Developmental Testbed Center webpage.

All of the links can also be found in the description of this video.

Thank you for watching!