AERMAP Readme  

AERMAP is being made available as a second beta release dated
(03107).  Details of the changes are enumerated on the first few
pages of the AERMAP source code and in the body of the source 
code listing as appropriate.  This whole AERMAP download
package consists of several zipped files and this readme file. 
The following list defines the general contents of each file:

  DEMFILZ.ZIP - SDTS to DEM file format conversion program
  AERMAPSRB2.ZIP - AERMAP source code
  AERMAPEXB2.ZIP - AERMAP executable
  AERMAPTCB2.ZIP - AERMAP test case with support files
  AERMAPUGB2.PDF - revised draft of the AERMAP User's Guide

The user should download each one of the above zip files into
its own subdirectories and unzip it there.  DEMFILZ.ZIP has
its own readme file.

It would be advisable to read the revised draft of the AERMAP
User's Guide first, the DEMFILZ.RME readme file second and 
then this readme file before running the test case or any 
other AERMAP program.

AERMAPSRB2.ZIP consists of the main source code program,
AERMAP.FOR and a module, MODULE.FOR.  They were written in
Fortran 90 and compiled with Compaq Visual Fortran (CVF) version
6.6.  The source code has been standardized to Fortran 90 and
should recompile using other versions of Fortran.  In CVF, it is
advisable to compile Module.FOR first and then followed by
AERMAP.FOR.  

Debug statements were added to the source code and have been
deactivated.  Allocatable arrays, 10m DEM data processing, and XYZ
formats have **not** yet been added.

AERMAPEXB2.ZIP consists of the AERMAP beta executable.  It should
be downloaded and unzipped in its own subdirectory but copied to
the test case subdirectory when the time comes to run the test
case.

AERMAPTCB.ZIP consists of several files needed to run AERMAP each
time it is executed.  These needed files have the extensions
*.LAS and *.LOS and are used by the subroutine NADCON21 to
convert between the North American Datums (NAD) of 1927, Old
Hawaiian, Puerto Rico, 4-Alaskan datums to the NAD of 1983.  They
have the file names of Conus, Hawaii, PRVI, Alaska, StGeorge,
Stlrnc, and StPaul.  

     Note:  The conversion is restricted to 7.5-minute DEM
     data for the Continental United States, Alaska, Hawaii,
     Puerto Rico and the Virgin Islands.  Users with
     coordinates outside these areas may use 1-degree DEM
     data or generate their own *.LAS and *.LOS pair of data
     sets. International users can bypass NADCON by entering a "0"
     as the last value on the ANCHORXY keyword line of input data. 

NADCON 2.1 is a United States Geological Survey (USGS) offically
approved program for converting between the above NADs.  The
interactive parts of NADCON 2.1 were deleted and the program was
incorporated into AERMAP as a subroutine.  NADCON 2.1 does allow
the incorporation of user generated *.LAS and *.LOS data.  More
information can be found at the NADCON 2.1 web site at:
http://www.ngs.noaa.gov/TOOLS/Nadcon/Nadcon.html.  User generated
data has not been tested with this version of AERMAP.


Test Case

After unzipping AERMAPTCB2.ZIP in its own test case subdirectory, 
copy the executable from its subdirectory to this test case 
subdirectory.  

Double click on the AERMAP.EXE file.  

After the run, compare AERMAP.REC with AERMAPREC.TST and compare
AERMAP.OUT with AERMAPOUT.TST.  Both pairs of files should be the
same.

Normal runs

There is no command line entry for the input and output file
names.  The input and output filenames have been hard coded into
the source code.  The input file needs to be named AERMAP.INP. 
The output file is automatically named AERMAP.OUT.  The user can
still specify names of the receptor and source elevation files
that are edited into AERMOD.  The *.LAS and *.LOS, AERMAP.INP,
and the executable files all need to be in the same subdirectory.
The output files will be written to the same subdirectory.

In the AERMAP.INP file structure, there is only one change from
the original format.  The NAD of the anchor point needs to be
stated at the end of the ANCHOR line.  If it is not know, the
program will assume a NAD of 1983 for 7.5-minute DEM data or WGS
1980 for 1-degree DEM data for the ANCHOR point.  More
information can be found in the user's guide.

If you have any questions or comments, please contact Peter
Eckhoff by email at: eckhoff.peter@epa.gov or by phone at: (919)
541-5385.