README 

				  (commute Version)



					README.TXT		5/15/2002





This readme file lists the system requirements for installing the PC Version of HAPEM4 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 HAPEM4 User's Guide." 



The PC version HAPEM4 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 350 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 Hapem_setup icon in the CD-ROM;

2.	Follow the instructions shown on the screen until the installation finishes;

3a.	Open the Program fold window by clicking the Hapem4 folder icon or

3b.	Open the MS-DOS window and go to the directory in which the hapem has been installed;

4.	Unzip the input.zip file into the HAPEM4 directory.



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



1. Setup-path\hapem4:



	param_file.1	The parameter input file, file 1

	param_file.2	The parameter input file, file 2



	durav.exe	The PC-executable file for the Durav module

	indexpop.exe	The PC-executable file for the Indexpop module

	commute.exe	The PC-executable file for the Commute module

	airqual.exe		The PC-executable file for the Airqual module

	hapem.exe	The PC-executable file for the HAPEM module



	input		The subdirectory for hapem input files

	output		The subdirectory for hapem output files





2. Setup-path\hapem4\input:



	durhw.fix.txt	The activity pattern file for the Durav module

	concensus.txt	The population file for the Indexpop module

	allcomm.txt	The commute file for the Commute module



	airqual		The subdirectory for concentration input files 

	factor		The subdirectory for pollutant penetration factor files



	airqual\con45201.txt		An example input file

	factor\con45201.fact.txt	An example input file



3. Setup-path\hapem4\output:



	Statefip.dat	The input file for state fip codes



4. Setup-path\SRC:



	durav.f90	The FORTRAN 90 source code for durav

	indexpop.f90	The FORTRAN 90 source code for indexpop

	commute.f90	The FORTRAN 90 source code for commute

	airqual.f90	The FORTRAN 90 source code for airqual

	hapem.f90	The FORTRAN 90 source code for hapem



HAPEM is a non-interactive program.  The parameters and input files are specified in param_file.1 (for Durav, indexpop, and commute) and param_file.2 (for airqual and hapem).  The HAPEM model is run by executing hapem modules in the following order:



	durav

	indexpop

	commute

	airqual

	hapem



To execute a module, type the name of the module at the DOS prompt or clicking the executable icon in the program folder window.  The example 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. 



The HAPEM4 Model User's Guide is provided in the userguide.wp file in the CD-ROM.  For additional questions or comments on HAPEM4, please contact Arlene Rosenbaum or Mike Huang at (703) 934-3982 or via mhuang@icfconsulting.com.