HA File Showing Data File Values for All Years


This relates to what you see when, in the Results for Individual Years part of the Results page, you have

selected a data file (one which relates to a Header Array file (not a text file) which is updated input or is output only),

you have selected All AHO or All CHO at the bottom of the list of years,

and you have clicked on the View button.

You will be shown a single Header Array file which shows the data in the versions of this file for all relevant years.

Example 1. Suppose you have selected logical file BASEDATA which is an updated input HA file, and asked to see the combined file for all years of the Base which begins with data for year 2001 and ends with data for year 2009. Then as the last set in each array on the combined file, you will see a set called Combined. Its elements will be called something like

year2001, year2002, …, year2009.

The values corresponding to set element year2001 are the starting values, while those for year2002 to year2009 are the updated values corresponding to those years. The name of the output file will be something like bas-bs1-2001-2009-cmbhar.har where BS1 is the 3-letter Sim name for the Base.

Example 2. Suppose you have selected logical file SUMMARY which is an output HA file, and asked to see the combined file for all years of the Policy which carries out simulations for years 2003 to 2009 (so starts with data representing year 2002). Then as the last set in each array on the combined file, you will see a set called Combined. Its elements will be called something like

yr_2002_2003, yr_2004_2005, …, yr_2008_2009.

The values corresponding to set element yr_2002_2003 are those output during the simulation for the year 2003 -- these values may represent year 2002 or (if there are Postsim statements in the TAB file or Command file) year 2003 (or both). Similarly the values corresponding to the set element yr_2008_2009 are those written during the simulation for year 2009. The name of the output file will be something like sum-bs1-br1r-pl1p-2003-2009-cmbhar.har where BS1, BR1 and PL1 are the 3-letter Sim names for the Base, Rerun and Policy respectively.

Notes

The combined file is generated afresh whenever you click on the View button. The combined file is produced in the Working directory.

RunDynam makes no attempt to check whether or not the input files used to produce the combined file are up-to-date. [But RunDynam does check that these files exist.]

The combined files are not included when you zip up all or selected results.

The combined file is produced by running the GEMPACK program CMBHARA.EXE using option SNE and either option AHO (if you clicked on All AHO) or option CHO (if you clicked on All CHO). These options require Version 2.4 (February 2009) or later of CMBHAR.

CMBHARA uses a STI file which is stored (since November 2015) in the Working directory.  It will  have a name like "INF-BASB-2015-2040-cmbhar-cho.sti". In fact, it has the same name as the the combined (or output) file, but with the suffix STI. You could use this STI file later to automate results processing by typing from the command line:
       cmbhar -sti INF-BASB-2015-2040-cmbhar-cho.sti
or, you could include this line in a BAT file.

The option AHO or CHO determines which headers are put on the output file:

If you clicked on All AHO, all headers on all relevant files will be shown on the output file. If a header is not present on one of the relevant files, all values in that files part of the combined header will be set equal to the special value -99,999.0.

If you clicked on All CHO, only headers which are on all relevant files will be shown on the output file.

For example, if you are looking at values across all years for one of the input data files, there may be headers on the original file which are not read by the model and so do not appear on the updated versions of this file. Or, if you have a

READ (IfHeaderExist) statement in your model, or a

FORMULA (INITIAL, Write Updated Value to File …) statement,

there may be headers on the updated data which were not present on the original data. Then these headers will be on the output file if you clicked on All AHO but not if you clicked on All CHO.



URL of this topic: www.copsmodels.com/webhelp/rundynam/hc_combinedhafile.htm

Link to full GEMPACK Manual

Link to GEMPACK homepage