Concentration / Display / Contours

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 Run 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. This plotting program also supports the use of ESRI formatted shapefiles.

The GIS output option will create an output file of the contour polygons (latitude-longitude vectors) in two different format: the ESRI generate format for import into ArcMap or ArcExplorer, or XML formatted files packaged by Info-Zip for import into Google Earth.

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 and color fill can be specified as black and white or color. The none option eliminates the black line defining contours and only leaves the color fill. This option is incompatible with GIS output options, which require computation of the contour vector. Contours can be determined DYNamically by the program, changing with each map, or FIXed to be the same for all maps. A user can set the contour scaling (difference between contours) to be computed on an EXPonential scale or a LINear scale.

A Python implementation of the concplot program is added to this distribution package. By default, the GUI uses concplot built from FORTRAN code. To use the Python implementation, select the Python tab near the bottom of the user interface before generating a plot.

Concplot Command Line Options

The Postscript conversion program (concplot), found in the /exec directory with all other executables, reads the binary concentration output file, calculates the most optimum map for display, and creates the output file 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-ESRI (log10), 2-ESRI (decimal), 3-Google Earth]
  • +a[KML altitude mode: 0-clampedToGround, 1-relativeToGround]:
  • -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, 2-threshold, 3-special, 4-mass loading]
  • -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, 2-No lines Color, 3-No lines B&W]
  • -l[Label options: ascii code, (73)-open star]
  • -L[LatLonLabels: 0=none, (1)=auto, 2=set:{value tenths}]
  • -m[Map projection: (0)-Auto, 1-Polar, 2-Lambert, 3-Mercator, 4-CylEqu]
  • +m[Max-Min value plotting: 0=none, (1)=both, 2=values, 3=max-square]
  • -n[Number of time periods: (0)-all, number, min:max,-increment]
  • -o[Output file name: (]
  • -p[Process file name suffix: (ps) or process ID]
  • -q[Quick DATEM plot file: ( )-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 (:labels:colors are optional) for up to 10 fixed contours: val1+val2+...val10]
  • -w[Grid point scan for contour smoothing (0)-none 1,2,3, ... grid points]
  • -x[Concentration multiplier: (1.0)]
  • -y[Deposition multiplier: (1.0)]
  • -z[Zoom factor: 0-least zoom, (50), 100-most zoom]

    Additional supplemental text may be added at the bottom of the graphic by creating a file called MAPTEXT.CFG, which should be located in the working 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 / Panel Labels menu tab. Units and title information can be edited by creating a LABELS.CFG file which can also be edited manually or through the Advanced / Border Labels menu tab.

    Additional Concplot Command Line Options for Python Implementation

    The following options are available only to the Python concplot.







    ESRI Shapefile Map Background Files

    Another mapping option would be to specify a special pointer file, (origianlly called shapefiles.txt, but now a suffix other than "txt" is permitted) to replace the map background file arlmap in the -j command line option (see above). Note -jshapefiles... rather than -j./shapefiles... is required. 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:

    Table of Contents