38
Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters College, Newark, NJ, USA

Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

Embed Size (px)

Citation preview

Page 1: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

Notes on HYSPLIT4_SV Simulations

Mexico City Workshop, Feb 2012

Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA

Paul Bartlett St. Peters College, Newark, NJ, USA

Page 2: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 2Mexico City Workshop, Feb 2012

HYSPLIT-format meteorological data prepared for these

simulations

Page 3: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 3Mexico City Workshop, Feb 2012

• Subgrid (shown) extracted from full NARR grid for this project

• Why a subgrid? Less data to transfer & computational efficiency

• July 2007 – Jan 2011 (for simulations from 2008-2010)

• Converted to HYSPLIT format

• Monthly files with 3 hr temporal resolution

• Each monthly file ~650 MB

• 43 months (July 2007 – Jan 2011) ~ 27 GB

36km North American Regional Reanalysis (NARR)

Page 4: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 4Mexico City Workshop, Feb 2012

Page 5: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 5Mexico City Workshop, Feb 2012

Page 6: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 6Mexico City Workshop, Feb 2012

Page 7: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 7Mexico City Workshop, Feb 2012

Page 8: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 8Mexico City Workshop, Feb 2012

TO DO TEST RUNS, MUST INSTALL “basic” HYSPLIT

first, so that you have graphical utilities, etc.

Page 9: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

9Mexico City Workshop, Feb 20122/9/2012

An installation package for “basic” HYSPLIT has been placed on the FTP site under the following folder:PLAIN_HYSPLIT4_INSTALLATION

To do the various installations, you will need administrative privileges on the computer. Use default install locations if you can.

First install utilities, in the following order.

TCL (ActiveTcl8.5.8.1.291945-win32-ix86-threaded.exe)Ghostscript (gs863w32.exe)Ghostview (gsv49w32.exe)ImageMagick (ImageMagick-6.6.1-5-Q8-windows-dll.exe)

Then install the HYSPLIT program (HYSPLIT_win32R.exe)

You can always download latest PC version from:https://ready.arl.noaa.gov/HYSPLIT.php

Page 10: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 10Mexico City Workshop, Feb 2012

First, try to do one initial test Run

Page 11: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

11Mexico City Workshop, Feb 20122/9/2012

1. USING BINARY MODE, download folder from the FTP site: hysplit4_SV_feb_2012

2. Open up a DOS Window

3. Navigate to c:\ hysplit4_SV_feb_2012\working_SV

4. To see batch files present, type: dir *.bat [return]

5. Install Notepad++ or Some Other Text Editor with Context-Highlighting

6. Examine SET_SV_007.bat [open it up in an editor; don’t double click on it!]

7. Adjust the “environment” [ENVR==2] … see the next page

8. Once you’ve done this, return to the DOS window (working_SV)

9. Try to run the first test by typing: run_test_1 then hit return

10. If it all works, you will see the program running, and when done, you will end up with the following directory: C:\hysplit4_SV_feb_2012\HYSPLIT_RESULTS\testing\test_run_1\

11. Navigate to this directory from Windows Explorer and examine the files there

Page 12: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

12Mexico City Workshop, Feb 20122/9/2012

rem ***********************************************************************if %ENVR%==2 (rem right now same as ENVR=1, but, can be customized for any given local rem environment, on anyone's particular computerrem ***********************************************************************

rem directory for overall run and set batch files (do NOT include back slash at end)SET master_work_dir=C:\hysplit4_SV_feb_2012\working_SV

rem here is the base directory for met data; individual datasets are subdirectories of thisrem met data home directory - do NOT include backslash, will be included laterSET met_home=C:\hysplit4_SV_feb_2012\metdata

rem reaction concentration data directory (DO include back slash at end)SET conc_data=C:\hysplit4_SV_feb_2012\gridded_chem_data\1999_global_EMEP_data\

rem directory for concplot, con2asc (do NOT include back slash at end)SET conc_exec_dir=C:\hysplit4_SV_feb_2012\exec_release_v23a

if %debug_release%==debug SET hycs_exec_dir=C:\hysplit4_SV_feb_2012\exec_debug_v23arem HYPSLIT-SV executable directory (do NOT include back slash at end)if %debug_release%==release SET hycs_exec_dir=C:\hysplit4_SV_feb_2012\exec_release_v23arem HYPSLIT-SV executable directory (do NOT include back slash at end))rem *************************rem end of ENVR=2 rem *************************

For your installation, the directories may be the same as shown below. But if they are not, edit them the text below to correspond to your situation

Page 13: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

13Mexico City Workshop, Feb 20122/9/2012

Ok… hopefully, if you double click on the file test_run_1_MEXICO_totrun.ps you will get something that looks like the image below

If you can’t open the postscript file, maybe ghostscript and ghostview were not installed properly?

Page 14: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

14Mexico City Workshop, Feb 20122/9/2012

There are a lot of other files, and we will examine them shortly…

But for now, lets just make sure that this initial run worked.

If you got the postscript image on the previous page, it worked!

If not, we will have to figure out what is going on… Don’t worry, usually the problems are relatively easy to find and fix.

A “pre-computed” version of the output from this test is provided, in the directory “pre_computed_testing”

Page 15: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

15Mexico City Workshop, Feb 20122/9/2012

HYSPLIT produces output as postscript files (.ps). These can be viewed with GhostView, but they are not very convenient to use. For example, they can’t easily be imported into PowerPoint or MS-Word.

If you have ImageMagick installed, you can “convert” the postscript file to a jpg (or other format) using the following command from the DOS command line:

convert -density 300 test_run_1_MEXICO_totrun.ps name.jpg

(where “name” can be anything you want… )

If the program “convert” was not found, check your PATH, and either change your PATH or copy the program “convert.exe” from the ImageMagick directory to someplace in your PATH.

On my computer, the “convert” program is at the following location:

C:\Program Files (x86)\ImageMagick-6.6.1-Q8\convert.exe

Page 16: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

16Mexico City Workshop, Feb 20122/9/2012

IMPORTANT NOTE ABOUT MET DATA

In order to minimize download time and facilitate initial testing, only a minimum set of met files have been included in the hysplit4_SV_feb_2012 folder that you have downloaded from the FTP site.

In fact, only “two” files have been included:

One NARR_MX_36km file, for Jan 2008:C:\hysplit4_SV_feb_2012\metdata\NARR_MX_36km NARR_MX_2008_JAN.bin

And one NCEP/NCAR Global Reanalysis file, for Jan 2008:C:\hysplit4_SV_feb_2012\metdata\GLOBAL_2p5 RP200801.gbl

Additional files are available on the FTP site, and in order to carry out runs for time periods other than Jan 2008, you can download these from the FTP site. Remember to use BINARY MODE. You should put any additional files you download in the same folders as the two files above.

The full set of NARR_MX_36km met files is in the FTP folder: NARR_MX_met_data

The full set of Global_Reanalysis met files is in the FTP folder: Global_MX_met_data

Page 17: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 17Mexico City Workshop, Feb 2012

Receptors Used for Initial Test Simulations

(on the following page is a map of the receptors that we

have set up so far)

Page 18: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 18Mexico City Workshop, Feb 2012

Montes Azules

Biosphere (see inset

lower right)

Preliminary Point and Area Receptors Used for Initial Test Simulations

GOM grid cell #10

GOM grid cell #9

GOM grid cell #8

Calakmul Biosphere

Lake Mirimar (inside Montes Azules)*

Celestun Biosphere

Monterrey agricultural

cattle

Monterrey urban cattle*

* Receptor is too small to see at this scale

Veracruz Agriculture

Lake Chapala

El Vizcaino Biosphere

Baja west coast

Dioxin Air Monitoring Site

Baja California

Sinaloa

Chihuahua

Nuevo Leon

Jalisco

Colima Distrito Federal

Veracruz

Chiapas

Yucatan

Nuevo Leon

Yucatan

Chiapas

Page 19: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 19Mexico City Workshop, Feb 2012

Montes Azules

Biosphere (see inset

lower right)

Source Locations and Preliminary Point and Area Receptors Used for Initial Model Simulations

GOM grid cell #10

GOM grid cell #9

GOM grid cell #8

Calakmul Biosphere

Lake Mirimar (inside Montes Azules)*

Celestun Biosphere

Monterrey agricultural

cattle

Monterrey urban cattle*

* Receptor is too small to see at this scale

Veracruz Agriculture

Lake Chapala

El Vizcaino Biosphere

Baja west coast

Dioxin Air Monitoring Site

Baja California

Sinaloa

Chihuahua

Nuevo Leon

Jalisco

Colima Distrito Federal

Veracruz

Chiapas

Yucatan

Nuevo Leon

Yucatan

Chiapas

Source Locations for initial test runs

5

14 32

Page 20: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

20Mexico City Workshop, Feb 20122/9/2012

SUMMARY OF FILES PRODUCED DURING EACH SIMULATION

Page 21: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

21Mexico City Workshop, Feb 2012

File Name Description

run_name_ctl The CONTROL file with the “basic” HYSPLIT parameters

run_name_cfg The SETUP.CFG file with “advanced” HYSPLIT parameters

run_name_sve “extra semi-volatile” parameters needed by HYSPLIT-SV

run_name_sfg Simulation configuration parameters used by HYSPLIT-SV

run_name_gemSimulation configuration parameters used by optional Global Eulerian Model (GEM) component of HYSPLIT-SV

run_name_rfgReceptor setup configuration file, where area and point receptor groups are selected for inclusion in the simulation

Simulation parameter files written by SET batch file as HYSPLIT_SV inputs

· Problems with run? These are good place to look, as errors might be apparent here…

2/9/2012

Page 22: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

22Mexico City Workshop, Feb 2012

File Name Description

run_name_ccfDump of “advanced simulation parameters”, to see if “_cfg” file parameters were ingested into HYSPLIT_SV correctly

run_name_clt List of “concentration evaluation points” (CEP) receptors used in simulation

run_name_ps1 (and_ps2) Information about particle size distribution used in simulation

run_name_rla Summary of area receptors, one record for each “recp” area receptor

run_name_rlbMore detailed summary of area receptors, one record for each sub-rectangle of each “recp” area receptor

run_name_cltSummary of point receptors (concentration evaluation points, “CEP’s”)(not to be confused with “run_name.ctl”, the CONTROL file)

Files written at “beginning” of HYSPLIT_SV simulation

· Problems with run? These are good place to look, as errors might be apparent here…

2/9/2012

Page 23: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

23Mexico City Workshop, Feb 2012

File Name Description

run_name_global.temporal.ps

Postscript format deposition map over a global domain for PUFF results only, written as specified in the RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file. This is produced by the program “gridplot”. Note that this program also produces ascii text output, as specified in SET batch file, for each output time step: run_name_global_temporal_PUF_001.txt, run_name_global_temporal_PUF_002.txt, …

run_name_global.totrun.ps

Postscript format deposition map over a global domain for PUFF results only, written as specified in the RUN and SET batch files, cumulative for the entire simulation. This is produced by the program “gridplot”, along with an ascii text output for each grid point: run_name_global_totrun_PUF_001.txt

run_name_MEXICO.temporal.ps

Postscript format deposition map over a MEXICO domain for PUFF results only, written as specified in RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file. This is produced by the program “concplot”.

run_name_MEXICO.totrun.psPostscript format deposition map over a MEXICO domain for PUFF results only, written as specified in RUN and SET batch files, cumulative for the entire simulation. This is produced by the program “concplot”.

“postscript image results” files produced after the HYSPLIT_SV simulation

2/9/2012

· These are produced using settings and choices established in the RUN and SET files; most of the settings are “hardwired” in the SET batch file but can be edited.

· These files can get pretty big if the temporal_hrs setting is too small for long runs.

Page 24: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

24Mexico City Workshop, Feb 2012

File Name Description

run_name_SOURCE.temporal.ps

Postscript format deposition map over a domain centered at the source location. For PUFF results only, written as specified in RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file. This is produced by the program “concplot”.

Currently, the “resolution” of the grid is set to be 0.10 degrees (~10 km) but this could be adjusted up or down.

Currently the “extent” of the grid is 3 degrees in each direction, but this could be adjusted up or down.

run_name_SOURCE.totrun.ps Same as the deposition map above but cumulative for the entire run.

… continued… “postscript image results” files produced

2/9/2012

· Current settings for all of the above maps are to show “deposition”. However, concentrations can also be shown, if this is desired. Recommendation would be to change the SET file to add another call to CONCPLOT with slightly different settings, to tell CONCPLOT to produce map(s) of concentration rather than deposition.

Page 25: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

25Mexico City Workshop, Feb 2012

File Name Description

run_name_.flx_sum_1.txtTotal deposition flux at each point receptor over entire simulation (based on “.flx” file)

run_name_.flx_sum_2.txt For SV simulations, same as .flx_sum_1.txt (but with no header information)

run_name_.flx_sum_3.txt

Total deposition flux for each deposition pathway over entire simulation (based on “.flx” file). File does not contain an explanatory header. Columns are: CEP_number, name, lat, long, land_type, dry gas dep flux, dry particle dep flux, wet gas dep flux, wet particle below cloud dep flux, wet particle in cloud dep flux

run_name_.flx_tim_1.txt

Optional total, dry, and wet deposition flux to one or all point receptors, at each time step in the “CEP” file. The choice is made by the parameter “key_CEP” in the RUN batch file:key_CEP = 0: write for allkey_CEP = n: write only for specific CEP number

Note that there are actually more choices, that can be set in the SET batch file. The output frequency is the time step is set in the SET batch file by the parameter “dep_delta”. The current value of dep_delta is 1440 minutes (=24 hrs). If you want to change this, you will have to edit the “SET” batch file. This summary file is also based on the “.flx” file

“summary results” files for deposition flux to point receptors produced after HYSPLIT_SV simulation

· These are produced by a specialized program after HYSPLIT-SV is completed

2/9/2012

Page 26: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

26Mexico City Workshop, Feb 2012

File Name Description

run_name _cepconc_0001.txt

Air concentration (mass/m3) at concentration evaluation point (CEP) receptor #1, at each elevation specified in the SET batch file, at each time step specified by the parameter “cep_conc”. Based on “.cep” file. Note that the elevation = 0 values are for deposition (mass/m2). See description of “.cep” file for additional details. This file does have reasonably complete header information and is “designed” to be able to be read into a spreadsheet using spaces as delimiters.

run_name _cepconc_0002.txt Same as above for CEP point receptor #2

.

.

.

run_name _cepconc_nnnn.txt Same as above for CEP point receptor #nnnn

“summary results” files for air concentrations at point receptors produced after HYSPLIT_SV simulation

· These are produced by a specialized program after HYSPLIT-SV is completed

· One file for each point receptor in the simulation

· There is reasonably complete header information in these files, but you can easily determine which file you “want” by looking at the receptor numbers in the “.clt” file

2/9/2012

Page 27: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

27Mexico City Workshop, Feb 2012

File Name Description

run_name_.recpsum_1.txt

Total mass deposited to each area receptor over entire simulation (based on the “.rdp” file). Note that the deposition is repeated in the last column. This is actually the total deposition over all species, but since we only do one species in the SV simulations, the deposition is essentially “repeated”.

run_name_.recpsum_2.txt For SV simulations, same as above (but with no header information)

run_name_.recpsum_3.txt

Total mass deposited to each area receptor for each deposition pathway over entire simulation (based on the “.rdp” file).

File does not contain an explanatory header. Columns are: RECP_number, name, area km2, centroid lat, centroid long, land type, dry gas dep mass, dry particle dep mass, wet gas dep mass, wet particle below cloud dep mass, wet particle in cloud dep mass

run_name_.recptim_1.txt

Total, dry, and wet deposition mass to each area receptor, at each time step in the “RDP” file. This time step is set in the SET batch file by the parameter “dep_delta”, the same parameter that determines the deposition output at the point receptors. The current value of dep_delta is 1440 minutes (=24 hrs). If you want to change this, you will have to edit the “SET” batch file. This summary file is also based on the “.rdp” file.

“summary results” files for area receptors produced after HYSPLIT_SV simulation

· These are produced by a specialized program after HYSPLIT-SV is completed

2/9/2012

Page 28: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

28Mexico City Workshop, Feb 2012

File Name Description

run_name_cep

Concentration at each point receptor, at each elevation, at each “cepconc_delta” interval, as defined in the SET batch file. This is set at 180 minutes = 3 hours for initial testing. The elevations are also established in the SET batch file. Currently they are set at 0, 100, 500, 1000, 2000, 3000, and 4000 meters above ground level. If you want to change the elevations, you can. The “0” level is actually deposition. Units in this file are “mass/m3” for concentrations and “mass/m2” for deposition. Depending on the number of point receptors, the number of elevations, the frequency of output, and the run duration, this file can get pretty big.

run_name_flx

Deposition flux at each point receptor, for each deposition pathway, at each “dep_delta” interval, as defined in the SET batch file. This is set at 1440 minutes = 24 hours for initial testing. Units in this file are “mass/m2”.

run_name_rdpDeposition flux at each area receptor, for each deposition pathway, at each “dep_delta” interval, as defined in the SET batch file. This is set at 1440 minutes = 24 hours for initial testing. Units in this file are “mass”.

“raw results” files produced during HYSPLIT_SV simulation

2/9/2012

Page 29: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

29Mexico City Workshop, Feb 2012

File Name Description

run_name.global.temporal.binBinary format CDUMP file over global domain for PUFF results only, written as specified in RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file.

run_name.global.totrun.binBinary format CDUMP file over global domain for PUFF results only, written as specified in RUN and SET batch files, cumulative for the entire simulation.

run_name.MEXICO.temporal.binBinary format CDUMP file over a MEXICO domain for PUFF results only, written as specified in RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file.

run_name.MEXICO.totrun.binBinary format CDUMP file over a MEXICO domain for PUFF results only, written as specified in RUN and SET batch files, cumulative for the entire simulation.

run_name.SOURCE.temporal.binBinary format CDUMP file over a source-centered domain for PUFF results only, written as specified in RUN and SET batch files, at the frequency specified by “temporal_hrs” in the SET batch file.

run_name.SOURCE.totrun.binBinary format CDUMP file over a source-centered domain for PUFF results only, written as specified in RUN and SET batch files, cumulative for the entire simulation.

“binary raw results” files produced during HYSPLIT_SV simulation

2/9/2012

Page 30: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

30Mexico City Workshop, Feb 2012

File Name Description

run_name_msg

This is the “MESSAGE” file produced by HYSPLIT, the basic diagnostic output generated by the program. The format is somewhat cryptic, but can be deciphered with some effort. If a run crashed, this file can tell you when it happened, and sometimes even why it happened.

run_name_hg_out.000.txtA dump of some HYSPLIT parameters during the run, to see if they were ingested into HYSPLIT properly for this particular run

run_name_hg_out.001.txt

Area receptor puff overlap diagnostics. There is no header in this file. recp_test.f:write(kf_hg(1),21) 1,kdisp,intrinsic_kdisp,zplat,zplong,zsigh,psr,zfrac21 format(I5,I5,I5,3E12.3,999E12.3)MAIN:write(KF_HG(1),21) 2, kp, hdwp(kp), zlat, zlong, meto%land, sigh(kp), sigh(kp), fracland, pfrac21 format(3I5,2E12.3,I5,9999E12.3)

run_name_hg_out.005.txt

OH concentration diagnostics. There is no header in this file.get_sv_chem_conc.f: write(kf_hg(k5write),920) ncall, localhr, month, elevkm, latp, ohconc, svchem%oh_mm3 920 format (I5,F8.3,I5,2F8.3,2E12.3)note: svchem%oh_mm3 is OH conc in moles/m3

Some diagnostic files written during HYSPLIT_SV simulation

· Aside from the first file (msg), these should probably be ignored for now…

2/9/2012

Page 31: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

31Mexico City Workshop, Feb 2012

File Name Description

run_name_hg_out.008.txt

Some chemistry diagnostics. There is no header in this file. From subroutineget_sv_chem_conc.f: write(kf_hg(k8write),104) ncall, JET, year, month, day, hour, localhr, elevm, latp, longp, air_temperature, air_density, zatm, global_x, global_y, global_z, svchem104 format(6I14,99E14.5)

run_name_hg_out.014.txt

Diagnostic for estimate of liquid water content of atmosphere. There is no header in this file. From subroutine lwc_estimate.fWRITE(KF_HG(klwcwrite),1400) ncall, nrange, nndist, NL, method, surface_layer, zrh, zzrh, pden, pcon, lwc, drop_liquid, zfrac_cloud1400FORMAT(5I12,L12,999ES15.6)

run_name_hg_out.025.txtDiagnostics for deposition and chemical transformations. There are multiple write statements combined here, with no header. Too complicated to summarize here.

run_name_hg_out.028.txt

Diagnostics for deposition and chemical transformations. There is no header in this file. From subroutine depelm_sv.f:write(kf_hg(k28write),107) JET,zlat,zlong,rain, & ncall,1,nran(k28write),nd,-99,zbetatot(nd),zbeta(nd), & zsbetatot(nd), zsbeta(nd),zsmass(nd),depelm_mass(nd), & zinitmass(nd),ztotremov(nd),DT,dept(nd), & (zpbeta(nd,npt),npt=0,npath),(zdep(nd,npt),npt=0,npath) 107 format(I15,3ES14.5,2I5,I15,2I5,999ES14.5)

Some diagnostic files written during HYSPLIT_SV simulation

· these should probably be ignored for now…

2/9/2012

Page 32: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

32Mexico City Workshop, Feb 2012

File Name Description

run_name_hg_out.033.txt

ASCII TEXT output of the grid points in the first met data grid. For these runs, it’s the NARR_MX_36km grid. There are 166 grid points in the x-direction and 100 grid points in the y-direction. Total number of grid points are 166x100 = 16600.

run_name_hg_out.036.txtDeposition diagnostic output from cep_pufsum.f, where puff deposition is allocated to specific point receptors. There is actually a header in this file.

run_name_hg_out.037.txt

Vapor particle partitioning diagnostic output, from depelm_sv.f. There is no header information in this file.write(kf_hg(k37write),2037) nwrite(k37write),1,ncase,nd, & DIRT_SV(nd)%TMELT,DIRT_SV(nd)%TBOIL,DIRT_SV(nd)%SVP, & DIRT_SV(nd)%TSVP,totsurf(nndist),T,fracpart_dry2037 format(4I12,999ES12.3)

run_name_hg_out.136.txtConcentration diagnostic output from cep_pufsum.f, where puff air concentrations are allocated to specific point receptors. There is actually a header in this file.

Some diagnostic files written during HYSPLIT_SV simulation

· These are potentially interesting, but can be safely ignored for now…

2/9/2012

Page 33: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

33Mexico City Workshop, Feb 2012

File Name Description

run_name_zdest_out.txt

Diagnostic output for chemical transformation, written each hour. This is the total chemical transformation mass of the pollutant – i.e., the “destruction” of the pollutant by chemical reaction or photolysis – during the preceding hour. Imagine there is a total of X grams of mass in the model at the start of the hour. This file contains the model-estimated values of the total Y grams of mass in the model that were “destroyed” during the next hour. Thus, if there were no deposition or no loss of pollutant out the top or sides of the grid, the total mass of pollutant at the end of the hour would be X – Y. For pure PUF runs (without GEM) the GEM component will be zero.

Here is the write statement in sv_chem.fwrite(2060,2061) JET,kyear,kmonth,kday,khour,kminute, & (zdest_puf(nd),nd=1,numpol),(zdest_gem(nd),nd=1,numpol), & (zdest_puf(nd)+zdest_gem(nd),nd=1,numpol)2061 format(I15,5I5,9999E15.6)

Note that in the above write statement, numpol=1 for these HYSPLIT4_SV runs, i.e., there is only one species per run. So, the columns in the file are simply:JET, year, month, hour, minute, zdest_puf, zdest_gem, zdest_tot

Where JET = “J elapsed time”, an internal time stamp in HYSPLIT, referring to the cumulative elapsed minutes since the beginning of 1970.And where zdest_tot = zdest_puf + zdest_gem

Some diagnostic files written during HYSPLIT_SV simulation

· This is potentially interesting, but would need some effort to interpret and/or /utilize it…

2/9/2012

Page 34: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

34Mexico City Workshop, Feb 2012

File Name Description

run_name_hg_out.601.txt Written at the beginning of each hour

run_name_hg_out.602.txt Generally not used…

run_name_hg_out.603.txt Written every “KSPL” hours (frequency of splitting), before splitting

run_name_hg_out.604.txt Written every “KSPL” hours (frequency of splitting), after vertical splitting

run_name_hg_out.605.txt Written every “KSPL” hours (frequency of splitting), after horizontal splitting

run_name_hg_out.606.txt Written every hour, before PUF deletion

run_name_hg_out.607.txtWritten every hour, after PUF deletion, e.g., if they are outside any met grid or if they contain zero mass, etc.

run_name_hg_out.608.txt Written every hour, before PUF merging

run_name_hg_out.609.txt Written every hour, after PUF merging

run_name_hg_out.610.txt Written every hour, after post-merge PUF deletion, e.g., if outside any met grid

run_name_hg_out.611.txtWritten every “KRND” hours, after enhanced merging and optional deletion of low-mass puffs

Files with information about the distribution of PUFF ages and sizes· They only contain information about the puffs, i.e., there is no information about pollutant mass in the

Global Eulerian Model (GEM) component, if that was included in the run

2/9/2012

Page 35: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 35Mexico City Workshop, Feb 2012

A SET OF INITIAL TEST RUNS FOR:

2,3,7,8-TCDD 2,3,4,7,8-PeCDF

2,3,7,8-TCDF and OCDD

Page 36: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 36Mexico City Workshop, Feb 2012

If desired, several other test runs can be done. DOS Batch files for these test runs are also provided in the working_SV directory. These runs have also been “pre-computed”, and all the results are available at the FTP site under the folder: “ADDITIONAL_pre_computed_test_runs”.

A set of 168-hr runs from std pts 1 thru 5, with each batch file containing separate runs for 2,3,7,8-TCDF, 2,3,7,8-TCDD, 2,3,4,7,8-PeCDF, and OCDD, with a time step of 60 minutes:

• run_stdpt_1_168hr.bat • run_stdpt_2_168hr.bat• run_stdpt_3_168hr.bat• run_stdpt_4_168hr.bat• run_stdpt_5_168hr.bat

A set of 672-hr runs from std pts 1 thru 5, with each batch file containing separate runs for 2,3,7,8-TCDF, 2,3,7,8-TCDD, 2,3,4,7,8-PeCDF, and OCDD, with a time step of 30 minutes:

• run_stdpt_1_672hr.bat• run_stdpt_2_672hr.bat• run_stdpt_3_672hr.bat• run_stdpt_4_672hr.bat• run_stdpt_5_672hr.bat

A set of runs showing an example of parameter variation, a process that should be explored further as the project proceeds. In this case a series of 672-hr runs from std pt 2 for 2,3,7,8-TCDD, for different values of “maxpar”, the maximum number of puffs allowed in the simulation at any one time. In all the simulations above, a value of 10,000 was used for “maxpar”. Here a series of runs is done with values of 1000, 2000, 5000, 20000, and 50000, to compare with the run done earlier with maxpar=10000

• run_stdpt_2_tcdd_672hr_maxpar.bat

Page 37: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

2/9/2012 37Mexico City Workshop, Feb 2012

SOME KEY PARAMETERS to CONSIDER

Page 38: Notes on HYSPLIT4_SV Simulations Mexico City Workshop, Feb 2012 Mark Cohen NOAA Air Resources Laboratory, Silver Spring, MD, USA Paul Bartlett St. Peters

38Mexico City Workshop, Feb 20122/9/2012

Parameter Description Where set Current value Approximate Possible range

Notes

To be completed…