Operational Guidance Document.Pdf
Total Page:16
File Type:pdf, Size:1020Kb
Operational Guidance for the Community Multiscale Air Quality (CMAQ) Modeling System Version 4.7.1 (June 2010 Release) Prepared in cooperation with the Community Modeling and Analysis System Institute for the Environment University of North Carolina at Chapel Hill Chapel Hill, NC 27599 CMAQv4.7.1 Operational Guidance Document Operational Guidance for the Community Multiscale Air Quality (CMAQ) Modeling System June 2010 ii http://www.cmaq-model.org CMAQv4.7.1 Operational Guidance Document Disclaimer The information in this document has been funded wholly or in part by the United States Environmental Protection Agency. The draft version of this document has not been subjected to the Agency’s peer and administrative review, nor has it been approved for publication as an EPA document. The draft document has been subjected to review by the Community Modeling and Analysis System Center only; this content has not yet been approved by the EPA. Mention of trade names or commercial products does not constitute endorsement or recommendation for use. June 2010 iii http://www.cmaq-model.org CMAQv4.7.1 Operational Guidance Document Foreword The Community Multiscale Air Quality (CMAQ) modeling system is being developed and maintained under the leadership of the Atmospheric Modeling and Analysis Division of the EPA National Exposure Research Laboratory in Research Triangle Park, NC. CMAQ represents over two decades of research in atmospheric modeling and has been in active development since the early 1990’s. The first release of CMAQ was made available in 1998 without charge for use by air quality scientists, policy makers, and stakeholder groups to address multiscale, multipollutant air quality concerns. All subsequent CMAQ releases, past, current, and future, will adhere to this same level of code accessibility and scope. June 2010 iv http://www.cmaq-model.org CMAQv4.7.1 Operational Guidance Document Contents DISCLAIMER.................................................................................................................III FOREWORD................................................................................................................. IV FIGURES ....................................................................................................................... X TABLES........................................................................................................................ XI ABBREVIATIONS........................................................................................................ XII 1. INTRODUCTION ...................................................................................................1-1 1.1 Model Background and Goals ....................................................................................1-2 1.2 Overview of CMAQ System Components .................................................................1-4 1.2.1 Installation overview......................................................................................1-4 1.2.2 Configuration options ....................................................................................1-5 1.2.3 Chemistry-transport model conceptual formulation ......................................1-5 1.2.4 Summary descriptions of the major CMAQ programs..................................1-6 1.3 Features of CMAQ for Application Users ..................................................................1-9 1.4 Features of CMAQ for Air Quality Model Developers ..............................................1-9 1.5 New Features in Version 4.7.....................................................................................1-10 1.5.1 Version 4.7.1................................................................................................1-10 1.5.2 Version 4.7...................................................................................................1-10 1.6 About This Manual ...................................................................................................1-10 1.7 References.................................................................................................................1-14 2. OVERVIEW OF THE SCIENCE IN THE CMAQ MODELING SYSTEM................2-1 2.1 Features Implemented to Achieve the Goals of CMAQ.............................................2-2 2.1.1 Multiple pollutants and multiple scales .........................................................2-2 2.1.2 Modular flexibility.........................................................................................2-3 2.1.3 Major quality control features........................................................................2-3 2.2 CMAQ Input Processors.............................................................................................2-4 2.2.1 MCIP: Meteorology-Chemistry Interface Processor .....................................2-5 2.2.2 ICON and BCON: The initial and boundary conditions processors..............2-6 2.2.3 JPROC: Clear-sky photolysis rate calculator.................................................2-8 2.2.4 CHEMMECH: Chemical mechanism compiler.............................................2-9 2.2.5 PROCAN: Process-analysis preprocessor .....................................................2-9 2.3 CMAQ Chemistry-Transport Model Science Modules ............................................2-10 2.3.1 Gas-phase chemistry solvers........................................................................2-10 2.3.2 Photolysis.....................................................................................................2-11 2.3.3 Advection and diffusion...............................................................................2-12 2.3.4 Particulate matter (aerosols) ........................................................................2-14 2.3.5 Clouds and aqueous-phase chemistry ..........................................................2-15 2.3.6 Process analysis ...........................................................................................2-15 2.4 The CMAQ User Interface........................................................................................2-16 2.5 References.................................................................................................................2-16 3. CMAQ SYSTEM REQUIREMENTS AND INSTALLATION ..................................3-1 3.1 System Recommendations ..........................................................................................3-1 3.1.1 Hardware........................................................................................................3-1 June 2010 v http://www.cmaq-model.org CMAQv4.7.1 Operational Guidance Document 3.1.2 Software .........................................................................................................3-2 3.2 Installing CMAQ Source Code...................................................................................3-4 3.2.1 Distribution contents......................................................................................3-4 3.2.2 Notes on the CMAQ directory structure........................................................3-5 3.2.3 Configuring your system for compiling CMAQ............................................3-6 3.3 Compiling CMAQ for the Benchmark Test Case Simulation ....................................3-8 3.4 Running the CMAQ Benchmark Simulation............................................................3-10 3.5 Benchmarking CMAQ ..............................................................................................3-11 4. REQUIRED LIBRARIES .......................................................................................4-1 4.1 Input/Output Applications Programming Interface (I/O API)....................................4-1 4.1.1 Files, Logical Names, and Physical Names...................................................4-2 4.1.2 I/O API Data Structure and Data File Types .................................................4-2 4.1.3 Opening/Creating Data Files in I/O API........................................................4-4 4.1.4 Reading Data Files in I/O API.......................................................................4-5 4.1.5 Writing Data Files in I/O API........................................................................4-6 4.1.6 CMAQ-Related I/O API Utilities ..................................................................4-7 4.2 Network Common Data Form (netCDF) ....................................................................4-8 4.3 Message Passing Interface Library (MPICH).............................................................4-8 4.4 References...................................................................................................................4-8 5. CMAQ PROGRAMS AND LIBRARIES.................................................................5-1 5.1 Overview.....................................................................................................................5-1 5.2 BCON .........................................................................................................................5-3 5.2.1 Description.....................................................................................................5-3 5.2.2 Files, configuration, and environment variables............................................5-4 5.3 CCTM .........................................................................................................................5-9 5.3.1 Description.....................................................................................................5-9