Advanced / Special Topics / Message File Format

A MESSAGE file is created during each simulation. The file contains information from certain key subroutines that can be used for diagnostic purposes if a simulation were to fail. An example file is shown below in the left column from the test concentration simulation. A trajectory MESSAGE file would be similar but without the particle number and mass information. In the right column, in red, a more detailed description of each item is provided.

Some common warning messages

WARNING EMSPNT: exceeding puff limit
This warning occurs when the number of computational particles or puffs in the simulation reaches the number set by MAXPAR in the SETUP.CFG file. The model will not allow the simulation to have more than the number of particles or puffs specified by MAXPAR. When that number has been reached, the model will not create more particles or puffs.
For particles, this will prevent any new emissions to occur.
For puffs, this will both prevent any new emissions and will prevent any puff splitting.
Solutions include increasing MAXPAR, decreasing NUMPAR,

WARNING DEPSUS: exceeding puff limit
This warning occurs when the user has a value set for the particle resuspension and the number of particles carried in the simulation has exceeded the maximum number set in the SETUP.CFG file. It will occur in conjunction with the previous warning. Utilizing this pollutant resuspension algorithm may lead to excessive particle generation See #31 .

Description of File Format

Start Namelist configuration

Internal grid parameters (nlvl,aa,bb,cc): 19 30.0 -25.0 5.0
&SETUP INITD = 4, KHMAX = 9999, NUMPAR = 500, MAXPAR = 10000, MAXDIM = 1,
QCYCLE = 0.0000E+00,
FRME = 0.10000000,
FRMR = 0.0000E+00,
KRND = 6,
DELT = 0.0000E+00,
ISOT = 0,
TKER = 0.50000000,
NDUMP = 0,
NCYCL = 0,
TRATIO = 0.75000000,
MGMIN = 10,
KMSL = 0,
NSTR = 0,
CPACK = 1,
ICHEM = 0,
NOUT = 0, TM_PRES = 0, TM_TPOT = 0, TM_TAMB = 0, TM_RAIN = 0, TM_MIXD = 0,
DXF = 1.0000000,
DYF = 1.0000000,
DZF = 9.9998E-03,
NINIT = 1,
PINPF = PARINIT,
POUTF = PARDUMP
-- End Namelist configuration ---
NOTICE main: pollutant initialization flags
Gas pollutant - T
Current version and release date
Tabulates value of namelist variables
NOTICE metpos: (mtime,ftime) - 50379840 0
NOTICE metpos: (mtime,ftime) - 50379960 0
NOTICE advpnt: (kg,nx,ny,nz) - 1 10 10 19
NOTICE sfcinp: reading ASCDATA.CFG
NOTICE metgrd: (kg, xyr,xy1) - 1 10 10 17 9
NOTICE metinp: NGM 1 1 10 10 17 9 50379840 95 10 16 0
#################################
WARNING prfsig: extrapolation from level (k,m): 16 7159.121
Input data levels: 10
Internal Sigma levels: 19
##################################
NOTICE metinp: NGM 1 63 10 10 17 9 50379960 95 10 16 2
NOTICE main: Initial time step (min) 20
NOTICE main: 1 50379860166 0.33333320
NOTICE main: 1 50379880332 0.6666647
NOTICE main: 1 50379900498 0.9999961
NOTICE main: 2 50379930498 0.9999961
NOTICE main: 2 50379960498 0.9999961
NOTICE metpos: (mtime,ftime) - 50380080 50379840
NOTICE metinp: NGM 1 125 10 10 17 9 50380080 95 10 16 4
NOTICE main: 3 50379990498 0.9999961
NOTICE main: 3 50380020498 0.9999961
NOTICE main: 4 50380050498 0.9999961
NOTICE main: 4 50380080498 0.9999961
NOTICE metpos: (mtime,ftime) - 50380200 50379960
NOTICE metinp: NGM 1 187 10 10 17 9 50380200 95 10 16 6
NOTICE main: 5 50380110498 0.9999961
NOTICE main: 5 50380140498 0.9999961
NOTICE main: 6 50380170498 0.9999961
NOTICE main: 6 50380200498 0.9999961

Computations proceed as before for computational hours 3 and 4. Particle number remains the same because no particles have moved off the computational domain. The mass remains the same because deposition is not turned on for this simulation.

At the end of hour 4, data are required for 6 UTC (time 200) to proceed with the calculation. These data replace the 2 UTC (time 960) in memory.

Every 6 hours, the model prints out the vertical mass distribution of all the particles within the computational domain. This is the mass distribution relative to the model's internal sigma levels and there is no relation to the levels that may be specified for the concentration output file. Only non-zero levels are shown. The internal levels are defined by the polynomial parameters given at the beginning of the MESSAGE file.

At this point the computation will continue for the number of hours specified in the CONTROL file. Vertical profiles are shown every 6 hours. As the particles move across the computational domain, the sub-grid position may be moved (from position 17,9) or expanded larger than 10x10) to match the spatial extent of the particle distribution. This may occur at any time during the computation or even multiple times during the same computational hour.



Table of Contents