Steps to install and test CMAQ-MADRID ------------------------------------- NOTE: The version of CMAQ-MADRID that is being released is compatible only with CMAQ v4.2.1 released by EPA in July 2002. The current version of CMAQ-MADRID has been tested only on Redhat Linux. I) Extract all files from the tarfile using the `tar` command. The directory 'CMAQ-MADRID/code/july2002/models' contains MADRID source code and the original EPA-CMAQ v4.2.1 source code released in July 2002. The 'modules' file in the directory 'CMAQ-MADRID/code/july2002/models/CCTM/CVSROOT' contains a list of all modules in CMAQ-MADRID. The directory 'CMAQ-MADRID/code/july2002/tools' contains the following utilities and libraries for Linux: m3bld, m3io, netCDF and stenex. The directory 'CMAQ-MADRID/testcases' contains build and run scripts for three test cases: example1 for MADRID1-8sec, example2 for MADRID2 and example3 for MADRID1-2sec. The testcases are each for a 4-day SCAQS 1987 episode. Input and output datasets are available upon request from CMAS (see the download page for contact information). II) Create necessary libraries and modules: 1) cd CMAQ-MADRID/code/july2002/tools/m3io Follow the procedure in readme.steps 2) cd CMAQ-MADRID/code/july2002/tools/stenex Follow the procedure in readme.steps 3) cd CMAQ-MADRID/code/july2002/tools/build Follow the procedure in readme.steps III) Running the MADRID1 8-sections test case (example1): 1) cd testcases/example1 2) Modify the following variables, if necessary, in bldit.cctm in 'src' a) FC and FP (Pathname of f90 compiler and preprocessor) b) Blder (Pathname of m3bld) 3) Run the script 'bldit.cctm' 4) Verify if CCTM_cb4_aqCMU_madrid1_8sec_mebi_multi has been created in the directory 'BLD_cb4_aqCMU_madrid1_8sec_mebi_multi' 5) Once the input datasets are obtained, untar the tarfile provided, and gunzip all files in the subdirectories under 'inp'. 6) The run script is in the 'sim' directory. Rename the *.shout file and run the script 'run.cctm' (no changes required). 7) Compare output with the output files provided in the 'out.orig' directory N.B.: The benchmark testing of this case was conducted on an AMD 2100+ processor with PGI Fortran v4.0-2 compiler IV) Running the MADRID2 2-sections test case (example2): 1) cd testcases/example2 2) Modify the following variables, if necessary, in bldit.cctm in 'src' a) FC and FP (Pathname of f90 compiler and preprocessor) b) Blder (Pathname of m3bld) 3) Run the script 'bldit.cctm' 4) Verify if CCTM_CACM_aeMADRID2_2sec has been created in the directory 'BLD_CACM_aeMADRID2_2sec' 5) Once the input datasets are obtained, untar the tarfile provided, and gunzip all files in the subdirectories under 'inp'. 6) The run script is in the 'sim' directory. Rename the *.shout file and run the script 'run.cctm' (no changes required). 7) Compare output with the output files provided in the 'out.orig' directory N.B.: The benchmark testing of this case was conducted on an AMD 2100+ processor with PGI Fortran v4.0-2 compiler V) Running the MADRID1 2-sections test case (example3): 1) cd testcases/example3 2) Modify the following variables, if necessary, in bldit.cctm in 'src' a) FC and FP (Pathname of f90 compiler and preprocessor) b) Blder (Pathname of m3bld) 3) Run the script 'bldit.cctm' 4) Verify if CCTM_cb4_aqCMU_madrid1_2sec_mebi_multi has been created in the directory 'BLD_cb4_aqCMU_madrid1_2sec_mebi_multi' 5) Once the input datasets are obtained, untar the tarfile provided, and gunzip all files in the subdirectories under 'inp'. 6) The run script is in the 'sim' directory. Rename the *.shout file and run the script 'run.cctm' (no changes required). 7) Compare output with the output files provided in the 'out.orig' directory N.B.: The benchmark testing of this case was conducted on an Intel 2.2 GHz processor with PGI Fortran v4.0-2 compiler Additional information can be found in the CMAQ-MADRID User's Guide, Technical Documentation, and CMAS portability test results (see the download page).