GEMPAK EZ scripts (No changes from 5.2 to 5.4 -PB/NWS 10/96) This document describes how to set up and run the GEMPAK EZ scripts. These scripts allow the user to quickly produce a GEMPAK plot of various meteorological fields. NOTE: This document is for running the ezscripts with version 5.2 or 5.4 of GEMPAK. This version provides looping and multiple windows. To run any of the EZ scripts, the user needs only type the name of the script at the UNIX prompt. The script will prompt you for all necessary parameters. You can short cut the prompting by supplying the necessary parameters on the command line. That is, after typing the name of the desired script but BEFORE hitting the enter key, type the necessary parameters separated by spaces. For example: ezrelh 700 There are two "set up" programs, ezset and ezarea which are used infrequently to specify the gridded data file and the area of interest to use. Once set, the user may run the remaining scripts as often as desired. Note that you need to run these FIRST to initially set up your display map and gridded data source. Most of the EZ scripts display the data in plan view. Some require a level or levels to be input by the user. There are also cross section, time-height section, and sounding scripts which require the user to input the location of the section or sounding. See below for more information. ****** IMPORTANT ****** Note that you should ALWAYS run the GEMPAK command gpend when you're all done examining data. gpend removes the GEMPAK X window from you screen. DO NOT CLOSE THIS WINDOW WITH THE X-WINDOW WIDGET (the button on the upper left corner of the window). To run gpend type gpend at the Unix prompt. ---------------------------------------------------------------------------- VERTICAL Scripts Vertical EZ scripts require that the user specify the location of the sounding, time-height section, or spatial cross section. There are two ways to accomplish this. The user can 1. Enter the 3-character station identifier(s) or 2. Graphically select the locations using the mouse on a map/field window that has already been generated using a different ez script. In the first case, the user merely runs the desired vertical EZ script, such as ezprof, and enters the station ID(s) when prompted. You can also supply the station ID(s) on the command line. See below for the syntax and examples. In the second case, the user would first have run a plan-view (horizontal) EZ script such as ezfront and have a display on the screen of frontogenesis. Without removing that graphic, the user then runs ezprof to generate a sounding from the gridded data. Once the script is running and all required parameters have been input, place the cursor on the graphics screen. When the cursor changes from an arrow to a + sign, you can select the location(s) with the mouse. For a single point, just click the left button at the desired location. For a line (spatial cross section), press and hold the left mouse button at the location where you want the left side of the cross section to start. Then "drag" the line to the desired location and release the left mouse button to select the cross section. ---------------------------------------------------------------------------- List of scripts and descriptions EZ250 This script will plot the 250 mb isotachs, heights and winds for all of the times for the given model. Syntax: ez250 EZ500 This script will plot the 500 mb absolute vorticity and heights for all of the times for the given model. Syntax: ez500 EZ700 This script will plot the 700 mb vertical motions, RH and heights for all of the times for the given model. Syntax: ez700 EZ850 This script will plot the 850 mb temperatures, heights and winds for all of the times for the given model. Syntax: ez850 EZAREA This script allows the user to graphically define the area to view for all subsequent EZ scripts. By default, the user is shown a map of North America in medium resolution. The user may also specify the projection, graphics area and map resolution by answering the script's prompts. When the mouse cursor becomes a + sign while on the graphics window, press and hold down the left button on one corner of the desired area. Then "stretch" the rubber rectangle to the desired size and release the left button to select the area. This area will now be used for ALL EZ scripts until EZAREA is run again. EZAREA does not take any command line arguments. Syntax: ezarea EZCROSS.CSI This script displays a spatial cross section of theta-e, rh and momentum surfaces. The end points for the cross section may be chosen by (1) entering the station IDs for two stations; or (2) graphically selecting the locations using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the fcst_hour and the left and right stations, as above. Syntax: ezcross.csi fcst_hour [left_stn right_stn] Examples: ezcross.csi 00 ( The script will prompt for station IDs or graphical selection. ) ezcross.csi 18 GEG ELP EZCROSS.IPV This script displays a cross section of theta, isotachs and potential vorticity. The end points for the cross section may be chosen by (1) entering the station IDs for two stations; or (2) graphically selecting the locations using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the fcst_hour and the left and right stations, as above. Syntax: ezcross.ipv fcst_hour [left_stn right_stn] Examples: ezcross.ipv 00 ( The script will prompt for station IDs or graphical selection. ) ezcross.ipv 18 GEG ELP EZCROSS.KINEM This script displays a cross section of circulation vectors, vertical motion and isotachs. The end points for the cross section may be chosen by (1) entering the station IDs for two stations; or (2) graphically selecting the locations using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the fcst_hour and the left and right stations, as above. Syntax: ezcross.kinem fcst_hour [left_stn right_stn] Examples: ezcross.kinem 00 ( The script will prompt for station IDs or graphical selection. ) ezcross.kinem 18 GEG ELP EZCROSS.THTA This script will plot a cross section of circulation vectors, rh, theta and isotachs. The end points for the cross section may be chosen by (1) entering the station IDs for two stations; or (2) graphically selecting the locations using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the fcst_hour and the left and right stations, as above. Syntax: ezcross.thta fcst_hour [left_stn right_stn] Examples: ezcross.thta 00 ( The script will prompt for station IDs or graphical selection. ) ezcross.thta 18 GEG ELP EZDELTA This script displays the 12 hour change of a given field along with the field itself. If the user asks for the change in 700 mb temperature at 24-h, the script will compute the change between the 12- and 24-h 700 mb temperatures and display it, along with the 24-h temperature field. The user must supply the forecast time (from which 12 hrs will be subtracted to compute the difference), level, and a field. Syntax: ezdelta fcst_hour level field Examples: ezdelta 24 700 temp ezdelta 36 500 hght EZDIVQ This script displays the divergence of layer averaged Q-vectors along with the lapse rate through the same layer. The user must supply the script with the bottom and top pressure levels of the layer. Note that the order is important. Syntax: ezdivq lower_level upper_level Example: ezdivq 500 300 EZDOC This script will create a user document from the README file and the headers of all of the scripts. Syntax: ezdoc EZFRONT This script displays the frontogenesis function, wind barbs, and temperature for a given level. The user must supply the level. Syntax: ezfront level Example: ezfront 850 EZLOOP This script allows the user to loop the graphics previously created. Note that the user can loop the plan view graphics so long as he/she has not yet run a vertical (skew-T, time-height section, or cross-section) ezscript. Once one of these has been run, the existing graphics in the plan view window can no longer be looped without re-running the plan view ezscript to regenerate them. However, the vertical graphics generated for the Skew-T may be looped by the user. The following are the looping commands: ;l = begin looping forward ;r = begin looping backward ;s = step forward one frame ;b = step backward one frame ;N = change loop speed, where N = 1 (slowest) to 5 (fastest). To stop loop, click the left mouse button on the graphic window. To end looping script, enter "exit" in the text window. EZMSLP This script displays the mean sea level pressure, winds, and 1000-500 thickness. No command line parameters are necessary. Syntax: ezmslp EZPCPN This script will plot the precipitation for the shortest interval in the grid file, then overlay the mean sea level pressure. Syntax: ezpcpn EZPIVA This script displays the vorticity advection by the 700-300 mb thermal wind along with the 500 mb winds and 850-500 mb lapse rate. No command line parameters are requried. Syntax: ezpiva EZMSLP This script will plot the mean sea level pressure and the 1000-500 thickness for all of the times in the given model. Syntax: ezmslp EZPRINT This script will print any X windows graphic on a laser printer. It uses the xwd and xpr programs to accomplish this. Both have man pages if you need more information on them. To use, type EZPRINT after you have a window of graphics displayed. When the mouse cursor changes to a + sign, click the mouse on the window you want to print. The script is set up to print on laser jet printers by default but can be easily modified for postscript or other drivers. Syntax: ezprint EZPROF This script will plot a Skew-T diagram for a given location. The location for the Skew-T may be chosen by (1) entering the station ID for a station; or (2) graphically selecting the location using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the location, as above. Syntax: ezprof [station_id] Examples: ezprof ( The script will prompt for station ID or graphical selection. ) ezprof GLD EZQVEC This script displays the layer averaged Q-vectors with the layer thickness and layer averaged isotachs. The user must supply the script with the bottom and top pressure levels of the layer. Note that the order is important. Syntax: ezqvec lower_level upper_level Example: ezqvec 500 300 EZRELH This script displays the relative humidity, winds and temperature at a given level. The user must supply the level. Syntax: ezrelh level Example: ezrelh 750 check syntax of fcst hour change image type to upper case construct the time based on the input handle the common problem of rgl vs ngm set two variables for the model name, lower and upper case now for the hard part. based on the valid time (initial + forecast hour) we have to figure out what images we want to display. we'll do this by looking at what's available and going back 6 hrs from the valid time to create up to a 6 frame loop (e.g., if VT = 18z, loop = 13, 14, 15, 16, 17, and 18Z). = change loop speed, where EZSET This script allows the user to select the model and the date/time of the model run. For the date/time, the user can enter the full yymmddhh (year, month, day, hour) or merely a 00 or 12 for the current date. The model can be eta, ruc, ngm, avn, or mrf. EZSET assumes a file naming convention and location. The location is set through the MODEL environment variable, which is defined by the .cshrc file. The file naming convention by default is mdl_yymmddhh, where yymmddhh is the year/month/day/hour of the model run and mdl is the lowercase 3 letter id of the model. Syntax: ezset yymmddhh|hh model Examples: ezset 94052612 eta ezset 00 ngm EZTHETAE This script displays theta-e, wind barbs, Lifted Index, and convergence. Note that the LI is the "most unstable" LI from the four lowest levels of the model. The user must supply the level. Syntax: ezthetae level Example: ezthetae 850 EZTHGT.OMEGA This script will plot a time-height section of omega and zero-divergence. The location for the time-height section may be chosen by (1) entering the station ID for a station; or (2) graphically selecting the location using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the location, as above. Syntax: ezthgt.omega [station_id] Examples: ezthgt.omega ( The script will prompt for station ID or graphical selection. ) ezthgt.omega GLD EZTHGT.RHOM This script will plot a time-height section of omega, freezing level and rh. The location for the time-height section may be chosen by (1) entering the station ID for a station; or (2) graphically selecting the location using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the location, as above. Syntax: ezthgt.rhom [station_id] Examples: ezthgt.rhom ( The script will prompt for station ID or graphical selection. ) ezthgt.rhom GLD EZTHGT.WIND This script will plot a time-height section of wind freezing level and rh. The location for the time-height section may be chosen by (1) entering the station ID for a station; or (2) graphically selecting the location using the mouse on a map/field window that has already been generated using a different EZ script. The user must enter the location, as above. Syntax: ezthgt.wind [station_id] Examples: ezthgt.wind ( The script will prompt for station ID or graphical selection. ) ezthgt.wind GLD EZSAT This script plots a loop of satellite images underneath height and vorticity contours at your choice of level and model. Syntax: ezsat level satresol sattype datte/time fhour model or ezsat (and script will prompt for each setting) Examples: ezsat 500 4km IR 95113000 12 eta or ezsat help or ezsat Brad Colman NWS/WSFO-SEA Ron Miller COMET Updated 31 Aug 94 -----------------------------------------------------------------------