Concentration / Display Options / Concentration

The concentration model generates a binary (big-endian) output file on a regular latitude-longitude grid, which is read by the other programs to produce various displays and other output. The plotting program, concplot, can be accessed through the GUI, which is shown in the illustration below, or it can be run directly from the command line. Most, but not all, of the command line options are available through the GUI.

Normally only one input file is shown, unless multiple files have been defined in the Concentration Setup menu. The default output file name is shown and unless the box is checked all frames (time periods and/or levels) will be output to that one file. The program uses the map background file, arlmap, which by default is located in the \graphics directory. Other customized map background files could be defined. Some of these higher resolution map background files are available from the HYSPLIT download web page. For multiple pollutant files, only one pollutant may be selected for display by individual levels, or averaged between selected levels. These levels must have been predefined in the Concentration Setup menu. Multipliers can be defined for deposition or air concentrations. Normally these values would default to 1.0, unless it is desired to change the output units (for instance, g/m3 to ug/m3 would require a multiplier of 106). Contours can be determined dynamically by the program, changing with each map, or fixed to be the same for all maps. A user can also set a maximum value as the base 10 exponent.

Concplot Command Line Options

The Postscript conversion program (concplot), found in the \concmdl directory, reads the binary concentration output file, calculates the most optimum map for display, and creates the output file concplot.ps. Multiple pollutant species or levels can be accommodated. Most routine variations can be invoked from the GUI. More complicated conversions should be run from the command line using the following optional parameters:

concplot -[options (default)]

  • -a[Arcview GIS: (0)-no dump 1-dump to files]
  • -b[Bottom display level: (0) m]
  • -c[Contours: (0)]

  • -d[Display: (1)-by level, 2-levels averaged]
  • -e[Exposure units flag: (0)-concentrations, 1-exposure]
  • -f[Frames: (0)-all frames one file, 1-one frame per file]
  • -g[Graphic circle overlay: ( )-auto, 0-numb, numb:dist(50) km]
  • -h[Hold map at center lat-lon: (source point), lat:lon]
  • -i[Input file name: (cdump)]
  • -j[Graphics map background file name: (arlmap)]
  • -k[Kolor: 0-B&W, (1)-Color]
  • -l[Label options: ascii code, (73)-open star]
  • -m[Map projection: (0)-auto, 1-polar, 2-lambert, 3-mercator]
  • -n[Number of time periods: (0)-all, number, min:max,-increment]
  • -o[Output file name: (concplot.ps)]
  • -p[Process file name suffix: (ps)]
  • -q[Quick data plot: ( )-none, filename]
  • -r[Removal: 0-none, (1)-each time, 2-sum, 3-total]
  • -s[Species: 0-Sum (1)-Single Pollutant {N}-Species Number]
  • -t[Top display level: (99999) m]
  • -u[Units label for mass: (mass), also see "labels.cfg" file]
  • -v[Values for fixed contours: val1+val2+val3+val4]
  • -w[Weight for contour smoothing: (0.25), none=0.0]
  • -x[Concentration multiplier: (1.0)]
  • -y[Deposition multiplier: (1.0)]
  • -z[Zoom factor: 0-least zoom, (50), 100-most 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.

    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.



    Table of Contents