The HYSPLIT Mac installation is similar to a Windows PC. Starting with HYSPLIT v5.2.0, the graphical user interface only requires Tcl/Tk because the Postscript graphics have been replaced by Scalable Vector Graphics (SVG) which can be displayed through any browser.
- Tcl/Tk Graphical User Interface
Version 8.5 or later is required.
Although not required to run HYSPLIT, a GUI composed of multiple Tcl/Tk scripts is 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 HYSPLIT installation includes all the GUI scripts, but the Tcl/Tk interpreter is not part of the distribution. Most Unix / Linux operating system distributions, as well as Mac OS X, include Tcl/Tk. If not already installed, you can download Tcl/Tk from the Tcl/Tk web site. Install the software to the suggested default directory prior to installing HYSPLIT.
- ImageMagick Converter
Tested versions include up to 7.0.7.
The capability to convert SVG to other graphical formats is enabled within the GUI through ImageMagick. However, on MAC systems the Preview function can also be used to export SVG to a select number of formats. ImageMagick can then be used to convert these files to unsupported formats. Go to the ImageMagick web site to download the most recent Mac version. Note that all HYSPLIT SVG graphic frames are packaged within a single HTML file. Conversion by ImageMagick to other formats requires that the individual frames (within the SVG tags) are written to individual SVG files. This is accomplished through the splitsvg program provided with the HYSPLIT distribution.
- Mac OSX HYSPLIT Installation
Download and open the installation package (hysplit_v5.2.0.dmg) and then run the Install_hysplit.app. This will copy the hysplit directory to your $HOME directory (/Users/account/hysplit) and place the hysplit.app on your desktop. If the installation fails because permission is denied for an unidentified developer, then Open Anyway, or better, if available, go to System Preferences and then Security & Privacy and check the box to Allow apps downloaded from: Anywhere. If this option is unavailable or multiple apps are affected, you may need to run sudo spctl --master-disable from the terminal before going back to the security and privacy menu. When finished, enable security again.
- Optional Python Emulator
A new class of display programs for trajectories and air concentration contours using the Python language has been developed. These programs are still undergoing modifications to their capabilities and interface requirements. To use them a Python emulator is required. If the Python display programs are provided with your HYSPLIT distribution, you will find detailed installation instructions in the python directory (e.g. install_macos.txt). More information about these displays can be found in the Python section. A system reboot may be required after installation.
- Optional Google Earth Viewer
Go to the Google Earth web site to download the most recent Mac version.
- Starting the first time
Once the installation is complete, HYSPLIT can be started from the desktop app or by opening a terminal window or X-window and changing directory to hysplit/working. Then just execute the softlink ./hysplit.tcl and the GUI should open if Tcl/Tk has been installed. If the softlink does not exist, one should be created in the working directory using the command ln -s ../guicode/hysplit.tcl hysplit.tcl. The desktop app also runs the model from the same working directory. Never run the model from the guicode directory. If using an X-window (optional), ensure that the X-directory location (usually /opt/X11/bin) in file default_exec points to the location of xterm, which can be determined from the command which xterm. If you are trying to run FTP through the GUI, you may need to install the FTP client through brew install inetutils.