only rendered in printing; ARL website banner
only rendered in printing; ARL website banner

HYSPLIT for Apple Mac - Registered and Trial Version Download

For details on the currently available version see HYSPLIT Updates.

READY logo
 

What is available for downloading

An Apple Mac (tested with Intel OSX 10.10 and 10.12) executable version of HYSPLIT is available in both a trial (unregistered) and registered version. The package contains all the documentation and test data. However, the Tcl/Tk software to run the graphical interface must be independently downloaded and should be installed prior to installing HYSPLIT. A version that has been tested with HYSPLIT is available here for convenience. More recent versions, including registration information, can be obtained from the main site listed below.

The graphical user interface - Tcl/Tk

Although not required to run HYSPLIT, a GUI composed of multiple Tcl/Tk scripts are provided with HYSPLIT. The model can also be run using a command line interface. However, it is easier for novice users to use the Tcl/Tk interface. The standard HYSPLIT installation includes all the GUI scripts, but the Tcl/Tk interpreter is not part of the distribution. A version (8.6.4) can be downloaded here or more recent versions from the developer's web site. It should be installed prior to installing HYSPLIT.

Download the HYSPLIT Installation Package

Download and open the installation package (HYSPLIT_mac.dmg) and copy the Hysplit4 directory to your $HOME directory. This version was compiled under OSX 10.12 using the INTEL FORTRAN compiler.

Getting Started using the Tcl/Tk Graphical User Interface

If Tcl/Tk has been installed, then the model GUI can be started from the ./hysplit4/working directory by running ./hysplit4.tcl from the terminal window. When the GUI starts for the first time it will automatically create several files with names starting with default_{} which contain various default parameters. If the startup fails it may be necessary to edit the directory location file (default_exec) for elements such as the location of the X11 "xterm" command. These directories can be changed from the "advanced/configuration/directories" menu tab. X11 is not required and the model GUI can be started from the regular terminal display if the X11 directory entry remains blank.

Getting Started from the Terminal Window

If Tcl/Tk has not been installed, then the model can be run from the terminal window from the ./hysplit4/working directory. Prior to the models first time use it may be necessary to copy ../bdyfiles/ASCDATA.CFG to the ./working directory.

Command line trajectory example:

  • cp sample_traj CONTROL
  • ../exec/hyts_std
  • ../exec/trajplot tdump
  • open trajplot.ps

Command line concentration example:

  • cp sample_conc CONTROL
  • ../exec/hycs_std
  • ../exec/concplot cdump
  • open concplot.ps

END OF REQUIRED INSTALLATION

Many of the following programs have links that can be accessed through the HYSPLIT GUI. Copies of these are provided independently here to download for convenience. More recent versions, including registration information, can be obtained from each of the sites listed below.

Viewing Output in ArcExplorer GIS

The GUI also has an option to convert most graphical products to a GIS compatible format. The Meteorology, Trajectory, and Concentration sections can create an optional text output file in the ESRI "GENERATE" format, which is essentially a latitude-longitude listing of the points, lines, or contours. Hysplit's GUI utility menu has an option to convert the GENERATE format to shapefiles. These shapefiles can then be imported and viewed in the GIS viewer: ArcExplorer. It is possible to overlay trajectories, meteorological data, and concentration contours, all on the same map background.



Installing ImageMagick Graphics File Converter

A recent feature added to the GUI is the ability to convert the Postscript graphics output file to other graphical formats. This capability is enabled through the installation of ImageMagick, which normally requires the prior installation of Ghostscript. However, on Apple systems Ghostscript is not required and therefore when using Preview, export the file to any non-Adobe format, which then can be converted to any other format using ImageMagick. After installation, it may be necessary to edit the location of the Imagemagick "convert" command. Directories can be changed from the "advanced/configuration/directories" menu tab".



Installing the Ghostscript/Ghostview Postscript viewer

The HYSPLIT trajectory and concentration programs create high resolution publication quality graphics files in Postscript format. These can be printed directly on any Postscript printer or viewed and printed on any printer (even non-Postscript) if Ghostscript has been installed. On Apple Darwin systems Postscript files are opened directly using Preview and therefore Ghostscript is not required.