HYSPLIT4 - General Instructions Last Revised: February 2016 _________________________________________________________________ What's new in this version ... New module to compute decay and deposition of the Foot and Mouth disease virus. Resuspension subroutine revised. Added Ganser fall velocity applicable for particles larger than 20 microns. New option to calculate nuclide daughter products. Updates/Bug fixes ... Bug fix for multiple vertical line sources. New options in concadd program. ___________________________________________________________________ If the install procedure worked without error you should have links to the Hysplit GUI on your Desktop and in the Start Programs Menu. These links will only work if Tcl/Tk has been previously installed. Check the \guicode\@readme.txt for more information on installing Tcl/Tk. Programs called from within the GUI will also convert the model output to Postscript files. To automatically view these files you should have Ghostview already installed on your system. It may be downloaded from: www.cs.wisc.edu/~ghost. The model installation is to several directories as noted below. For more information on the contents of each directory, please see its associated @README.TXT file. The complete model User's Guide and other technical information can be found as an Adobe Acrobat PDF file in the \document directory. Individual sections, in Postscript format, are used by the GUI on-line help. Also if you have trouble with Ghostview or other programs called from the GUI, or if you installed Hysplit to a different directory than suggested, first try changing the default directories through the "Advanced-Configuration-Directories" menu tab. If the GUI is not opening or there are other problems, it may be necessary to edit the directory pointers in the upper-level \guicode\hysplit4.tcl script. Note that all the executables have been compiled using Intel Fortran Version 11 with "big-endian" compatiblility. Some sample code and compilation makefiles are provided in certain directories. ____________________________________________________________________ The following directories have been installed. Note the the individual directory readme files may indicate programs that are not be found in the Windows distribution. auxiliary - This directory contains nucleid information used in the daughter product application. bdyfiles - This directory contains an ascii version gridded land use, roughness length, and terrain height data. It also contains the pointer file ASCDATA.CFG, which may require editing in non- standard installations. cluster - Contains various subdirectories that store the input and output files from the cluster analysis. data2arl - Contains various sample programs to convert meteorological data and grib files to ARL packed format. ARL packed format is compatible for direct input to Hysplit. datem - Experimental data for CAPTEX release number two in the DATEM (Data Archive of Tracer Experiments and Meteorology) format, including sample CONTROL and SETUP.CFG files, and NARR meteorological data. Permits interactive model verification through the GUI. document - This directory contains PDF versions of the User's Guide and other technical documentation such as ARL-224. These documents will contain the most recent corrections. examples - Contains a variety of sample configurations, data files, and scripts for MS-DOS, Tcl, and UNIX. exec - Contains all the executable programs. The GUI looks for all programs in this directory. When running examples from the command prompt in certain directories, the relative path should preceed the executable: "..\exec\program.exe" graphics - All graphical routines use the global map background file ARLMAP in this directory. This file may be replaced by other higher resolution map backgrounds, some of which are in the mapfiles subdirectory. guicode - This directory contains a Tcl/Tk GUI interface source code for Hysplit. To use the interface you must first install Tcl/Tk. The default (or Start In) directory for running the GUI should be the Hysplit root directory. The model should not be run from the ..\guicode directory to avoid over-writing example files. html - Contains the individual help files that are called from within the GUI through the integrated browser. The files may also be displayed with Netscape or IE. qwikcode - The "QWIK" Graphical User Interface is designed to quickly configure, run, and display dispersion simulations customized for very short-range emergency response applications. It runs independently of the main GUI. testing - The xrun batch file executes a series of simulation in sequence as configured in the various CONTROL and SETUP namelist files. There is one output graphic for each simulation which is combined into a single Postscript file. The xrun batch file can be used as a guidline in configuring a variety of different simulations. updates - When the "Scan for Updates" tab is selected from the Advanced menu, if any new executables or scripts are found on the ARL server, the existing versions are first copied to this directory before the updates are downloaded to the appropriate directory. working - Contains sample CONTROL files that can be used for initial guidance to set up more complex simulations. These should be loaded into the GUI from the approprate "Retrieve" menu tab. Examples include: sample_conc - concentration simulation example from users guide sample_traj - trajectory simulation example from users guide The "plants.txt" file contains a sample listing of starting locations that can be opened in the GUI to select from a list of previously deterimined starting locations. This file can easily be customized. __________________________________________________________________ General help information is not available, however problems and errors should be reported to: arl.webmaster@noaa.gov NOAA Air Resources Laboratory NOAA Center for Weather and Climate Prediction (R/ARL) 5830 University Research Court College Park, Maryland 20740-3818