Workshop. A four-day HYSPLIT workshop will be
given online from June 15 to 18, 2021. Monday, June 14, is set
aside as a preworkshop day for illustrating HYSPLIT installation
and answering installation questions. The virtual workshop will
be focused on the use of the most recent version of the model on
the PC/Mac and its Graphical User Interface (GUI). The Workshop
designed to be "hands-on", with participants following along and
carrying out HYSPLIT modeling on their own local computers. No
prior modeling or experience with HYSPLIT is required. An overview
of the installation, model GUI, meteorological display programs,
and extensive training on how to solve atmospheric dispersion
problems will be presented. As the Workshop proceeds, several
real-world examples of increasing complexity will be explored.
Participants will be encouraged to install the model and download
course materials prior to attending, and instructions are provided
Advance registration is required. We regret to say that we
have reached the participant limit and registration is now
For those unable to participate because of our attendance
limitations, the material taught in the Workshop is both online
and downloadable [HYSPLIT Tutorials]
and is designed to be carried out independently in a
If your status for the Workshop is "Confirmed Participant" and you decide not to attend, please cancel your registration, to make room for others, by emailing email@example.com.
Guidance for Participants who are Live-Streaming.
A Live-Stream Event Guide with screenshots has been prepared to assist attendees in their participation within Go-to-Webinar. The guide describes how to ask general questions about the Webinar within Go-to-Webinar, and how to ask technical questions about HYSPLIT and the Tutorial in the HYSPLIT Forum.
Unique sign-in URL's was emailed to each confirmed participant. These URL's will be unique to each individual and should not be shared.
Guidance for Participants who are viewing recordings.
A Recorded Event Guide with screenshots has been prepared to assist attendees who are only viewing the event recordings. To access the recordings, see the section immediately below. The guide describes how to ask general questions about the Webinar, and how to ask technical questions about HYSPLIT and the Tutorial in the HYSPLIT Forum. We will make every effort to respond to questions as soon as possible, but due to differences in time zones, there will be delays in our responses (e.g., we will generally be waiting until the next morning to try to answer questions that arrived at night).
Handouts, Notes, and Recordings.
Videos of each day's on-line sessions are being created for review by participants, e.g., for those in time zones that would make online participation difficult. Processing of the videos to make them viewable takes significant time.
When the video is posted, the corresponding entry below will become a link. When you click on one of these links, you should be able to view the video directly.
To download a video recording, start playing it. Then place your mouse anywhere in the video area and right click the mouse. Choose the "Save As" menu.
Workshop day 2 wrap-up
(pdf, 2.3 MB;
pptx, 85 MB) - The PPTX version contains the video of a pressurized balloon and it is much bigger. The balloon launch video may be downloaded
this link (mp4, 82 MB).
Workshop participation certificates were emailed to attendees who requested
Since this is a hands-on Workshop -- i.e., participants will follow along with their own HYSPLIT Modeling -- several kinds of items will need to be displayed at the same time on your screen(s):
Several HYSPLIT windows devoted to your own hands-on HYSPLIT modeling
One or more windows devoted to your own viewing of the Tutorial
The Workshop Webinar being presented by the instructor, containing many of the same types of windows
The figure below gives you an example of what this might look like. It will be difficult to simultaneously display all of these windows on a single screen, especially a relatively small laptop screen. We recommend that a 2nd screen be used, if this is possible, e.g., to display the Workshop Webinar video. In this way, the participant can carry out their hands-on HYSPLIT work, in conjunction with the Workshop, and still conveniently view the ongoing, associated instructions. If desired and if the participant has this available to them, the Workshop Webinar can even be "cast" to a different device (e.g., a TV), leaving the computer screen for the Participant to carry out their hand-on HYSPLIT work and their own display of the Tutorial.
Key Steps to Take Before the Workshop
Download the primary course materials - Tutorial.zip - and unzip the contents. For Windows users, unzipping to c:\Tutorial is recommended, to be most fully consistent with preconfigured input files, but placing the file elsewhere is also possible, e.g., c:\users\your_name\Tutorial. For MAC users, the file can be unzipped to the Home directory. On any operating system, if unzipping to a different directory name, avoid directories with embedded spaces because many programs in the HYSPLIT system use the space as a file name delimiter.
Navigate to the Tutorial directory and open Index.html in a browser window. You should see something like the screenshot at right.
Click on the link in section 1. Installing HYSPLIT to the instructions for your operating system (Windows PC, Apple MAC OSX, or UNIX-LINUX) and follow the instructions there to install HYSPLIT and associated software on your computer. As described in the Installation instructions, graphical utilities should be installed prior to HYSPLIT. E.g., for Windows installations, Tcl/Tk, Ghostscript, Ghostview, and ImageMagick should be installed prior to installing HYSPLIT.
If you have a high-resolution screen, the HYSPLIT window may appear
too small in size and the labels are not readily readable. To work
around this issue, the following files can be copied to your
hysplit installation to replace the files of the same name in the
guicode subdirectory. For Windows users, the subdirectory is
typically located at C:\hysplit\guicode.
Installation may require administrative privileges, and we urge you to work with your IT colleagues to successfully complete this installation process if necessary. The Workshop is intended to be hands-on, i.e., the participants will be following along and will be carrying out the steps in the Tutorial themselves.
Due to the large number of participants, it will be difficult for us to provide significant installation help once the Workshop starts. We will try to answer questions, but installation issues can be difficult to efficiently resolve remotely. Thus, we strongly encourage all participants to make every effort to complete the installation before the Workshop starts.
For all remaining installation issues, we will attempt to provide assistance by appointment on Monday June 14, between the hours of 9 AM and 5 PM Eastern Daylight Time. To make an appointment, please use our web application for scheduling at https://apps.arl.noaa.gov/pickurtm.
If possible, try "test" the installation by following instructions in section 2 of the Tutorial,
"Test trajectory calculation" and "Test air concentration calculation". If you can successfully reproduce the steps outlined in these sections on your computer, the installation process has most likely been successful.
If you are not already registered for the HYSPLIT Forum, create a free account at https://hysplitbbs.arl.noaa.gov/, by clicking on the Register link near the top right of the page. Questions before the Workshop, e.g., about installation, can be posted here. The Forum will also be the primary way that participants will be able to ask questions during the Workshop itself.