Launching VAPOR GUI, VDCWizard (and other VAPOR apps)

After VAPOR has been installed, the launching of VAPOR GUI and VDCWizard depends on the platform.

On Windows click on "vaporgui" or "VDCWizard" from the Programs menu of the Start panel.

On Mac, click on "VAPOR.app" or "VDCWizard.app" in the VAPOR subfolder of the Applications folder. 

On Linux some setup is required.  Let VAPORBIN represent the path to the bin directory of the VAPOR installation.

• Open a shell 
  • In csh or tcsh, issue the command 'source VAPORBIN/vapor-setup.csh'
  • In bash or similar shells, issue the command '.  VAPORBIN/vapor-setup.sh'
• From the command line in the shell, issue the command 'vaporgui'
• You may want to include the above setup command in your .cshrc or .bashrc files so that your shells will always be able to launch vaporgui

The other VAPOR apps (raw2vdf, wrfvdfcreate, getWMSImage.sh, etc)  must be launched from a shell where vapor has been set up. 

On Windows, vaporgui and vdcwizard can be invoked from the Programs menu.

On Windows, all the VAPOR command-line apps (except getWMSImage.sh) can be launched from a standard DOS (cmd) shell.  Beginning with VAPOR 2.4.0, Windows users must execute the command "vapor-setup" (or "vapor-setup.bat") prior to invoking any of the command-line apps from a command shell.

Windows users who have Cygwin installed can launch the vapor command-line apps from a csh, tcsh or a bash shell.  To initialize the shell environment:

Open a shell and:

• In csh or tcsh, issue the command 'source "$VAPOR_HOME/bin/vapor-setup.csh" ' (The double-quotes are important because $VAPOR_HOME contains backslashes.)
• In bash or similar shells, issue the command:'.  "$VAPOR_HOME/bin/vapor-setup.csh" '  (Be sure to include the double-quotes).

To launch getWMSImage.sh, Windows users need to install Cygwin and launch getWMSImage.sh from the bash or csh shell as above.

On Linux, all VAPOR apps can be launched from a shell in which the vapor-setup script has been sourced (as described above).

On Mac, prior to launching a VAPOR utility in a shell, it is necessary to source vapor-setup.csh or vapor-setup.sh, as described above for Linux, depending on the shell you are using.  With the default binary install, the vapor-setup.sh and vapor-setup.csh scripts can be found in /Applications/VAPOR.app/Contents/MacOS/ .

After one first launches VAPOR GUI, the most important setting is to match the VAPOR data cache size to a value appropriate to the computer being used.  This setting is made in the User Preferences panel.