## Trajectory / Display / Trajectory

The trajectory model generates a text output file of end-point positions. The end-point position file is processed by trajplot to produce the Postscript display file. Trajplot can be accessed through the GUI or run directly from the command line. The display program has a variety of command line options, most of which are available through the GUI. There is a one-to-one relationship between GUI options, an example of which is shown below, and the command line options. There are several features particular to the GUI. First the Trajectory Display menu will not open unless the Trajectory Setup menu was first opened and Saved. This procedure sets all the GUI parameters to their default_traj values. These are the values shown in the Display menu. Normally the map projection is computed automatically based upon the location and length of the trajectory. However some trajectory combinations may give no maps or improperly scaled maps. In these situations one would want to over-ride the default projection and try forcing a selection.

Trajplot Command Line Options

The Postscript conversion program trajplot reads the trajectory endpoints output file, calculates the most optimum map for display, and creates the output file - trajplot.ps. When executed from the command line, there are several Unix style command line options. There should be no space between the option and any arguments: trajplot -[options (default)]

-a[GIS Output: 0-none, 1-ESRI Generate, 3-Google Earth]

Selecting the ESRI Generate format output creates an ASCII text file for each output time period that consists of the value and latitude-longitude points along each trajectory. This file can be converted to an ESRI Shapefile or converted for other GIS applications through the utility menu "GIS to Shapefile. The view checkbox would be disabled to do just the GIS conversion without opening the Postscript viewer. Selecting Google Earth will create a compressed file (*.kmz) for use in Google Earth; a free software package to display geo-referenced information in 3-dimensions. You must have the free Info-Zip file compression software installed to compress the Google Earth file and associated graphics.

-e[End hour to plot: #, (all hours)]

-f[Frames: (0)-all frames in one file 1-one frame per file]

= 0 - all files plotted on one frame
= 1 - one input file per output frame

-g [Circle overlay: ( )-auto, #circ (4), #circ:dist(km)]

= {blank} - draws four distance rings about source point, automatically scaled
= {#} - draws the indicated number of rings about the source point
= {#1}:{#2} - draws the number {#1} of rings about the source point each {#2} kilometers apart. In the special case where #1 is zero, the rings are not drawn, but the size of the plot is scaled as if one ring of radius {#2} is to be drawn.

-h [Hold map at center lat-lon: (source point), lat:lon]

= latitude:longitude - forces the map center to be at the selected location instead of the source point. In conjunction with the -g1:{km} option it is possible to create a constant map projection for each execution.

-i[Input files: name1+name2+name3+... or +listfile or (tdump)]

= tdump - default file name when the -i option is undefined.
= {user defined file name}
= {name1+name2+...} - to overlay multiple tdump files on the same plot based upon file name1 plot limits.
= +filename - filename is a file of filenames to be plotted following the same convention as the previous argument (limit <=5000 files).

-j[Map background file: (arlmap) or shapefiles.txt]

= arlmap - default ASCII file
= shapefiles.txt - file of shapefile names

-k[Kolor: 0-B&W (1)-Color, N:colortraj#1,...colortraj#N]

= 0 - for black and white output
= 1 - for color differentiation of multiple trajectories
= N - 1=red,2=blue,3=green,4=cyan,5=magenta,6=yellow,7=olive

-l[Label interval: -12, -6, 0, (6), 12, ... hrs]

= 0 - for no labels along the trajectory
= 6 - for labels every 6 hours
= 12 - for labels every 12 hours
= {X} - positive at synoptic times
= {-X} - negative with respect to traj start

-L[LatLonLineLabels]

= 0 - none
= 1 - auto
= 2:tenths - at interval specified

-m[Map projection: (0)-auto 1-polar 2-lambert 3-mercator 4-CylEqu]

-o[Output file name: (trajplot.ps)]

= trajplot.ps is the default Postscript output file name, otherwise it may be {user defined}.

-p[Process file name suffix: (ps) or process ID}

-s[Symbol at trajectory origin: 0-no (1)-yes]

-v[Vertical: 0-pressure (1)-agl 2-isentropic 3-meteorology 4-none]

= 0 - The vertical trajectory plot coordinate is in hPa (absolute pressure units).
= 1 - The vertical trajectory plot coordinate is meters above ground level.
= 2 - An isentropic coordinate display requires the trajectory to have been run in those coordinates.
= 3 - Forces the display of one of the selected meteorological variables along the trajectory rather than a trajectory vertical position coordinate. The meteorological variable is selected in the "Trajectory" tab of the Advanced Configuration menu. Only one meteorological variable can be selected for display. If multiple variables are selected, then only the last variable will be plotted.
= 4 - No vertical projection drawn.

-z[Zoom factor: 0-least zoom, (50), 100-most zoom]

= 50 - for standard resolution maps.
= 100 - for high resolution maps (maximum zoom)

Additional Map Label Customization

Many of the Postscript graphics programs have label information that can be customized to some extent. This is accomplished by placing a file called Labels.cfg in the startup directory which contains the following valid entries (all in single quotes terminated by &) replacing the new string with the desired text. A sample file called Labels.bak may be found in the relevant directory. Not all label strings are valid with every plotting program. For instance with trajplot, only the title entry would be used to replace the top label line of the plot.

'TITLE&','NATIONAL WEATHER SERVICE&'
'MAPID&','PROBABILITY&'
'LAYER&','BOUNDARY LAYER AVERAGE&'
'UNITS&','BQ&'
'VOLUM&','/M3&'

Additional supplemental text may be added at the bottom of the graphic by creating a file called MAPTEXT.CFG, also to be located in the startup directory. This is a generic file used by all plotting programs but each program will used different lines in its display. The file can be created and edited through the Advanced menu tab.

Standard ASCII Map Background File

By default, all mapping programs use the same text map background file, arlmap, which normally would be located in the ../graphics directory. However, all graphics programs first search the local start directory (../working if running the GUI), then the ../graphics directory. Customized map background files can be read instead of the default file for specialized applications. Some higher resolution map background files are available from the HYSPLIT download web page. These different map files may be accessed implicitly by putting them in the "../working (the startup directory), or explicitly through the GUI by entering the name of the customized map background file. The map background file format consists of three or more records per graphic line with the following format:

2I5 - line number, number of latitude-longitude points in the line
10F6.2 - latitude points in line
10F7.2 - longitude points in line

ESRI Shapefile Map Background Files

Another mapping option would be to specify a special pointer file, always called shapefiles.txt to replace the map background file arlmap in the -j command line option (see above). This file would contain the name of one or more shapefiles that can be used to create the map background. The line characteristics (spacing, thickness, color) can be specified for each shapefile following the format specified below:

Record format: 'file.shp' dash thick red green blue
file.shp = /dir/name of input shapefile in quotes
dash = {0} for solid; {dashes}/in; <0 color fill
thick = line thickness in inches (default = 0.0)
Red Green Blue = RGB values (0.0 0.0 0.0 is black)
Record example for default: 'arlmap.shp' 0 0.005 0.4 0.6 0.8

Table of Contents