Advanced / Special Topics / Particle Dump File Format

The concentration configuration menu provides an option to write a model initialization file, which by default is always named "PARDUMP" (for particle dump). This file can be written at regular intervals during the simulation, a convenient way to restart a simulation in case of unexpected failure. To restart the model using the PARDUMP file it is only necessary for the file to be present in the root working directory. If the internal time stamp of the file matches the start time of the simulation, the model will initialize the particle count from the file before emitting new particles according to the emission scenario defined in the control file. The format of the PARDUMP file is given below:

Record #1

Record #2 - Loop to record: Number of particles

The "Particle" tab of the "Special File Display" menu brings up a Windows based viewer that shows the particle positions over a map background. The display can be zoomed and otherwise adjusted using the left and right mouse buttons in conjunction with the shift and cntl keys. Help is provided on the screen with the left and right side comments corresponding to the respective mouse button. The particle viewer can also be used to overlay satellite images on the particle positions. More information on this is provided "FTP Satellite Data" help menu. The particle position file may be converted to a binary concentration file through the command line utility program par2conc.

Number of pollutants per particle is set by MAXDIM. Default is 1.

HEIGHT is in meters agl. The height is in agl even when KMSL=1 is set in SETUP.CFG

POLLUTANT is an integer, N, which corresponds to the Nth pollutant species defined in the CONTROL file. Pollutant definition

METEO-GRID is n integer, N, which corresponds to the Nth meteorological data grid defined in the CONTROL file.

SORT-INDEX Each particle or puff is assigned its own unique sort-index. The sort index is used within HYSPLIT for looping through all the computational particles or puffs. If a computational particle is removed during the simulation, the sort indices are reassigned so that there are only as many sort indices as particles. Consequently, the sort index for a computational particle may change during a simulation. If ichem=8, then particle deletion is turned off, and the sort index will refer to the same computational particle throughout the simulation. In the case of puffs, the sort indices are reassigned when puffs are deleted, merged or split.

Table of Contents