README 
				  (Version 2016.1)

					README.TXT		1/7/2016


This readme file lists the system requirements for installing the PC Version of 
HAPEM7 model and provides instructions on how to install and run the model. 
The detailed instruction on how to run the model is provided in the "The HAPEM7 
User's Guide." 

The PC version HAPEM7 model can be run on an IBM-compatible personal computer 
with an PENTIUM II or higher processor, a Window 95 or higher MS-DOS operating system, 
and a 200 MB or higher RAM. The program requires 700 MB disk space for installation and 
a minimum of 1.5 GB disk space to run.  

The installation procedures are as follows:

1. 	Click the HAPEM7_setup.exe icon in the location to which you downloaded it; and
2.	Follow the instructions shown on the screen until the installation finishes.

The following files are included in the HAPEM7 directory after installation:

1. Setup-path\:

	HAPEM7			The subdirectory containing the model executables,
				subdirectories of model input files, and a subdirectory
				of model output files (empty)
	SRC			The subdirectory containing the module source code
	
	readme.txt		This readme
	HAPEM7 User's Guide 	The HAPEM7 User's Guide
	(07-02-2015).pdf	

2. Setup-path\HAPEM7:

	input			The subdirectory of model input files
	output			The subdirectory of model output files (empty)

	p1.txt			The parameter input file, file 1 (set up for an example run)
	p2.txt			The parameter input file, file 2 (set up for an example run)

	durav7.exe		The PC-executable file for the durav module
	indexpop7.exe		The PC-executable file for the indexpop module
	commute7.exe		The PC-executable file for the commute module
	airqual7.exe		The PC-executable file for the airqual module
	hapem7.exe		The PC-executable file for the HAPEM module

4. Setup-path\HAPEM7\input:

	Activity Pattern	The subdirectory for input files of default activity patterns
	Add			The subdirectory for input files of default Add factors	
	AirQual         	The subdirectory for the input file of ambient air quality (example)	
	Commute         	The subdirectory for input file of default commute patterns
	Factor          	The subdirectory for input files of default microenvironmental factors 
				(including the on-road mobile source)
	Others			The subdirectory for input files of default work/at-home population fractions, 
				default commuting times (by car/public transit), and 
				default probabilities and area fractions of major-road proximity
	Population      	The subdirectory for the input file of default population data
	
	FIPS_StateCrosswalk_
	v7.DAT			The input file for state FIP codes                         

5. Setup-path\HAPEM7\output:

	No contents upon installation.	

2. Setup-path\SRC:

	durav7.f90	The FORTRAN 90 source code for the durav module
	indexpop7.f90	The FORTRAN 90 source code for the indexpop module
	commute7.f90	The FORTRAN 90 source code for the commute module
	airqual7.f90	The FORTRAN 90 source code for the airqual module
	hapem7.f90	The FORTRAN 90 source code for the HAPEM module


HAPEM7 is a non-interactive program.  The parameters and input files are specified 
in p1.txt (for the durav, indexpop, and commute modules) and p2.txt (for the airqual 
and HAPEM modules). The HAPEM model is run by executing HAPEM modules in the following order:

	durav7
	indexpop7
	commute7
	airqual7
	hapem7

To execute a module, type the name of the module and the name of a parameter file 
at the DOS prompt or clicking the executable icon in the program folder window.  
The example p1, p2, and airqual files are automatically installed and the program 
is ready to run. The user could test the model by running the HAPEM modules in the order 
as indicated above. 

For questions, please see the HAPEM7 User's Guide. For additional questions or comments on HAPEM7, 
please contact Chris Holder at (919) 293-1631 or via chris.holder@icfi.com, 
or Ted Palma at (919) 541-5470 or via Palma.ted@Epa.gov.