Operational Guidance Document.Pdf

Total Page:16

File Type:pdf, Size:1020Kb

Operational Guidance Document.Pdf 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
Recommended publications
  • Introduction to Unix (PDF)
    Introduction to… UNIX Bob Booth December 2004 AP-UNIX2 © University of Sheffield Contents 1. INTRODUCTION....................................................................................................................................... 3 1.1 THE SHELL ........................................................................................................................................... 3 1.2 FORMAT OF COMMANDS ...................................................................................................................... 4 1.3 ENTERING COMMANDS ......................................................................................................................... 4 2. ACCESSING UNIX MACHINES ............................................................................................................. 5 2.1 TERMINAL EMULATION SOFTWARE...................................................................................................... 5 2.2 LOGGING IN.......................................................................................................................................... 6 2.3 LOGGING OUT ...................................................................................................................................... 6 2.4 CHANGING YOUR PASSWORD............................................................................................................... 8 3. BASIC UNIX COMMANDS...................................................................................................................... 9 3.1 FILENAMES..........................................................................................................................................
    [Show full text]
  • UNIX Text Processing Tools—Programs for Sorting, Compar- Ing, and in Various Ways Examining the Contents of Text Files
    UNIX® TEXT PROCESSING DALE DOUGHERTY AND TIM O’REILLY and the staffofO’Reilly & Associates, Inc. CONSULTING EDITORS: Stephen G. Kochan and PatrickH.Wood HAYDEN BOOKS ADivision of HowardW.Sams & Company 4300 West 62nd Street Indianapolis, Indiana 46268 USA Copyright © 1987 Dale Dougherty and Tim O’Reilly FIRST EDITION SECOND PRINTING — 1988 INTERNET "UTP Revival" RELEASE — 2004 The UTP RevivalRelease is distributed according to the terms of the Creative Commons Attribution License. A copyofthe license is available at http://creativecommons.org/licenses/by/1.0 International Standard Book Number: 0-672-46291-5 Library of Congress Catalog Card Number: 87-60537 Trademark Acknowledgements All terms mentioned in this book that are known to be trademarks or service marks are listed below. Nei- ther the authors nor the UTP Revivalmembers can attest to the accuracyofthis information. Use of a term in this book should not be regarded as affecting the validity of anytrademark or service mark. Apple is a registered trademark and Apple LaserWriter is a trademark of Apple Computer,Inc. devps is a trademark of Pipeline Associates, Inc. Merge/286 and Merge/386 are trademarks of Locus Computing Corp. DDL is a trademark of Imagen Corp. Helvetica and Times Roman are registered trademarks of Allied Corp. IBM is a registered trademark of International Business Machines Corp. Interpress is a trademark of Xerox Corp. LaserJet is a trademark of Hewlett-Packard Corp. Linotronic is a trademark of Allied Corp. Macintosh is a trademark licensed to Apple Computer,Inc. Microsoft is a registered trademark of Microsoft Corp. MKS Toolkit is a trademark of Mortice Kern Systems, Inc.
    [Show full text]
  • Table of Contents 1
    Table Of Contents 1. Zoo Information a. Logging in b. Transferring files 2. Unix Basics 3. Homework Commands G etting onto the Zoo Type “ssh <netid>@node.zoo.cs.yale.edu”, and enter your netID password when ​ ​ prompted. Your password won’t show up and the cursor won’t move, but it knows what you’re typing. G etting Files onto the Zoo Use the “scp” command to transfer files onto the Zoo. Type “scp filename1 filename2 ​ ​ ​ <netid>@node.zoo.cs.yale.edu:~/mydirectory/mysubdirectory” ​ You should be on your local machine in the same directory as the two files. This will copy the two local files, filename1 and filename2 into the directory mysubdirectory (which is ​ ​ ​ ​ ​ ​ located inside mydirectory in your home directory on the Zoo). You will be prompted to ​ ​ enter your netID password, just like when you ssh in. U nix Basics What is a directory? A directory is simply a folder, which can contain any mixture of files and ​ subdirectories. What is different about a file versus a directory? A directory contains other files and directories, ​ but does not contain information itself -- for example, you can’t use emacs to view a directory. However, you can often use a text editor to view the contents of a file. Sometimes directories and files have different colors when you look at what’s in your current directory, depending on your terminal settings, which can help you tell which is which. What about an executable? An executable is a special type of file that can be run by your ​ computer.
    [Show full text]
  • Section 4 Network Programming and Administration Exercises
    Lab Manual SECTION 4 NETWORK PROGRAMMING AND ADMINISTRATION EXERCISES Structure Page Nos. 4.0 Introduction 48 4.1 Objectives 48 4.2 Lab Sessions 49 4.3 List of Unix Commands 52 4.4 List of TCP/IP Ports 54 3.5 Summary 58 3.6 Further Readings 58 4.0 INTRODUCTION In the earlier sections, you studied the Unix, Linux and C language basics. This section contains more practical information to help you know best about Socket programming, it contains different lab exercises based on Unix and C language. We hope these exercises will provide you practice for socket programming. Towards the end of this section, we have given the list of Unix commands frequently required by the Unix users, further we have given a list of port numbers to indicate the TCP/IP services which will be helpful to you during socket programming. To successfully complete this section, the learner should have the following knowledge and skills prior to starting the section. S/he must have: • Studied the corresponding course material of BCS-052 and completed the assignments. • Proficiency to work with Unix and Linux and C interface. • Knowledge of networking concepts, including network operating system, client- server relationship, and local area network (LAN). Also, to successfully complete this section, the learner should adhere to the following: • Before attending the lab session, the learner must already have written steps/algorithms in his/her lab record. This activity should be treated as home- work that is to be done before attending the lab session. • The learner must have already thoroughly studied the corresponding units of the course material (BCS-052) before attempting to write steps/algorithms for the problems given in a particular lab session.
    [Show full text]
  • Think Unix Associate Publisher Tracy Dunkelberger Jon Lasser Acquisitions Editor Copyright © 2000 by Que Corporation Katie Purdum All Rights Reserved
    00 2376 FM 11.30.00 9:21 AM Page i PERMISSIONS AND OWNERSHIP • USERS AND GROUPS HARD LINKS • SOFT LINKS • REDIRECTION AND PIPES REDIRECTING STDERR • NAME LOOKUP • ROUTING READING MAIL VIA POP3 • VI AND REGULAR EXPRESSIONS FILENAME GLOBBING VERSUS REGEXPS • INTERACTIVE COMMAND-LINE EDITING • HISTORY SUBSTITUTION • JOB CONTROL • VARIABLES AND QUOTING • CONDITIONAL EXECUTION • WHILE AND UNTIL LOOPS • ALIASES AND FUNCTIONS • THE X WINDOW CLIENT/SERVER MODEL WIDGETS AND TOOLKITS • CONFIGURING X • PERMISSIONS AND OWNERSHIP • USERS AND GROUPS • HARD LINKS • SOFT LINKS • REDIRECTION AND PIPES • REDIRECTING STDERR NAME LOOKUP • ROUTING READING MAIL VIA POP3 • VI AND REGULAR EXPRESSIONS FILENAME GLOBBING VERSUS REGEXPS • INTERACTIVE COMMAND-LINE EDITING • HISTORY SUBSTITUTION • JOB CONTROL • VARIABLES AND QUOTING CONDITIONAL EXECUTION • WHILE AND UNTIL LOOPS • ALIASES AND FUNCTIONS • THE X WINDOW CLIENT/SERVER MODEL WIDGETS AND TOOLKITS • CONFIGURING X • PERMISSIONS AND OWNERSHIP • USERS AND GROUPS HARD LINKS • SOFT LINKS • REDIRECTION AND PIPES • REDIRECTING STDERR • NAME LOOKUP • ROUTING READING MAIL VIA POP3 • VI AND REGULAR EXPRESSIONS • FILENAME GLOBBING VERSUS REGEXPS • INTERACTIVE COMMAND-LINE EDITING • HISTORY THINKSUBSTITUTION • JOB CONTROL • VARIABLES AND QUOTINGUnix READING MAN PAGES • ABSOLUTE AND RELATIVE P PERMISSIONS AND OWNERSHIP • USERS AND GRO HARD LINKS • SOFT LINKS • REDIRECTION AND PIPE JON LASSER REDIRECTING STDERR • NAME LOOKUP • ROUTING READING MAIL VIA POP3 • VI AND REGULAR EXPRE FILENAME GLOBBING VERSUS REGEXPS • INTERACT
    [Show full text]
  • Masquerade Detection Based on UNIX Commands Amruta Mahajan San Jose State University
    View metadata, citation and similar papers at core.ac.uk brought to you by CORE provided by SJSU ScholarWorks San Jose State University SJSU ScholarWorks Master's Projects Master's Theses and Graduate Research Fall 2012 Masquerade Detection Based On UNIX Commands Amruta Mahajan San Jose State University Follow this and additional works at: https://scholarworks.sjsu.edu/etd_projects Part of the Computer Sciences Commons Recommended Citation Mahajan, Amruta, "Masquerade Detection Based On UNIX Commands" (2012). Master's Projects. 273. DOI: https://doi.org/10.31979/etd.x966-jrj6 https://scholarworks.sjsu.edu/etd_projects/273 This Master's Project is brought to you for free and open access by the Master's Theses and Graduate Research at SJSU ScholarWorks. It has been accepted for inclusion in Master's Projects by an authorized administrator of SJSU ScholarWorks. For more information, please contact [email protected]. Masquerade Detection Based On UNIX Commands A Project Presented to The Faculty of the Department of Computer Science San Jose State University In Partial Fulfillment of the Requirements for the Degree Master of Science by Amruta Mahajan December 2012 c 2012 Amruta Mahajan ALL RIGHTS RESERVED The Designated Project Committee Approves the Project Titled Masquerade Detection Based On UNIX Commands by Amruta Mahajan APPROVED FOR THE DEPARTMENTS OF COMPUTER SCIENCE SAN JOSE STATE UNIVERSITY December 2012 Dr. Mark Stamp Department of Computer Science Dr. Chris Pollett Department of Computer Science Dr. Sami Khuri Department of Computer Science ABSTRACT Masquerade Detection Based On UNIX Commands by Amruta Mahajan In this paper, we consider the problem of masquerade detection based on a UNIX system.
    [Show full text]
  • Unix Account
    USING YOUR FAS UNIX ACCOUNT Copyright © 1999 The President and Fellows of Harvard College All Rights Reserved TABLE OF CONTENTS COMPUTING AT HARVARD ........................................................................................ 1 An Introduction to Unix ................................................................................................ 1 The FAS Unix Systems ............................................................................................... 1 CONNECTING TO YOUR FAS UNIX ACCOUNT .............................................................. 2 SECURITY & PRIVACY ON FAS UNIX SYSTEMS........................................................... 2 Your FAS Unix Account’s Password............................................................................ 2 USING THE UNIX COMMAND SHELL ........................................................................... 3 Managing Multiple Programs under Unix. .................................................................... 3 FILES AND DIRECTORIES IN UNIX ............................................................................... 4 Your Home Directory .................................................................................................. 4 Your Home Directory’s Disk Space Quota .................................................................. 4 Using ls to List Files in Your Home Directory ............................................................... 5 Managing Your Files ..................................................................................................
    [Show full text]
  • An Application Programmer's Guide to UNIX at the University of Manitoba
    An Application Programmer’s Guide to UNIX at the University of Manitoba by Gary F. Alderson Manager, Application Technologies Administrative Systems Version: 1.8 2002-03-03 Table of Contents Table of Contents ............................................................................................................................2 Introduction.....................................................................................................................................4 The Shells........................................................................................................................................4 Interactive use of the Shell .............................................................................................................5 Command Aliases........................................................................................................................................6 Command History.......................................................................................................................................6 Command Line Editing ..............................................................................................................................7 Security and Permissions................................................................................................................9 The Basics ....................................................................................................................................................9 Setting File Creation Defaults....................................................................................................................9
    [Show full text]
  • A Short Introduction to Unix
    Unix Runs the Internet • Unix is a command line interface, used by most large, powerful computers. A Short Introduction to • In fact, Unix is the underlying structure for Unix most of the Internet and most large scale scientific computation. • A knowledge of Unix is likely to be helpful in your future career, regardless of where you pursue it. Unix Advantages Stable and Efficient • It is very popular, so it is easy to find • Unix is very stable - computers running Unix information and get help almost never crash • pick up books at the local bookstore (or street vendor) • Unix is very efficient • plenty of helpful websites • it gets maximum number crunching power out of • USENET discussions and e-mail lists your processor (and multiple processors) • most Comp. Sci. students know Unix • it can smoothly manage extremely huge amounts of • Unix can run on virtually any computer data !! (IBM, Sun, Compaq, Mac, etc) • it can give a new life to otherwise obsolete Macs and • Unix is free or nearly (always) free PCs • Linux/open source software movement • Much free software is created for Unix - it’s • Ubuntu, FreeBSD, MKLinux, LinuxPPC, etc. accessible to all programmers Unix has some Drawbacks Computer Hardware is not Free • Unix computers are controlled by a command • However, you can build a powerful Linux line interface cluster for $20-50K • NOT user-friendly ! (depending on how much power you need) • ....(but fortunately, not user-antagonistic either!) • The real cost is for a person to manage the • difficult to learn, even more difficult to truly master machines, install the software, and train • There are many different versions of Unix with scientists to use it.
    [Show full text]
  • The Interaction Between XWIN-NMR and UNIX
    The interaction between XWIN-NMR and UNIX A basic course for NMR spectroscopists Written by Jos van Boxtel Michael Engelhardt Sven Cunskis 15.08.2001 Part Number: H5951 Copyright (C) 2001 by Bruker Analytik GmbH All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or trans- mitted, in any form, or by any means without the prior consent of the publisher. Printed: 7. 2001 Product names used are trademarks or registered trademarks of their respective holders. The latest update of Bruker manuals can be found on: www.bruker.de: click Downloads -> Documentation It is also delivered as XWIN-NMR online help: click Help -> Other topics -> XWIN-NMR and UNIX Please send your comments on this document to: [email protected] Bruker software support is available via phone, fax, e-mail, Internet, or ISDN. Please contact your local office, or directly: Address: Bruker Analytik GmbH Software Department Silberstreifen D-76287 Rheinstetten Germany Phone: +49 (721) 5161 440 Fax: +49 (721) 5161 480 E-mail: [email protected] FTP: ftp.bruker.de / ftp.bruker.com WWW: www.bruker.de / www.bruker.com ISDN: on request Contents PART I UNIX The SGI Toolchest 3 Boot - Shutdown - Reboot 6 Help in UNIX on SGI 7 The SGI graphical interface 8 UNIX commands on files and directories 10 File permissions 13 More UNIX commands on files and directories 18 User handling in UNIX, UNIX shells 22 More UNIX commands 27 File compression 30 Directory tree - file system - partition 31 Archiving with tar 34 Automation in UNIX 35 Troubleshooting UNIX 40 PART II XWIN-NMR Help in XWIN-NMR 45 The XWIN-NMR directory tree 47 AU programs and macros 63 User specific customizing 68 Troubleshooting XWIN-NMR 72 PART III NETWORKS Network communication 77 FTP and the FTP server 81 The spectrometer network 85 WWW 87 This course has been written for NMR spectroscopists who are using the XWIN-NMR software.
    [Show full text]
  • Self Study Guide: Linux
    University of Cambridge Department of Physics Computational Physics Self-study guide 1: PWF Linux Dr. Rachael Padman Michaelmas 2007 Contents 1.1 The Workstation 2 1.2 Logging in to PWF Linux 2 1.3 The Linux Desktop 4 1.5 Manipulating windows 6 1.6 Two Unix commands 7 1.7 Finishing 8 2 INTRODUCING UNIX COMMANDS 9 2.1 Log in to PWF Linux 9 2.2 The date command again 9 2.3 Creating a new window from the command line 9 2.4 Removing the xterm window 9 2.5 More about the & - background and foreground tasks 10 2.6 Files and directories 10 2.7 Directories 12 2.8 Local line editing 13 2.9 Getting help and information online 14 3 EDITING 16 3.1 Setting up a text file – emacs 17 3.2 Making use of multi-tasking 19 3.3 Leaving emacs 19 3.4 The spell command 19 3.5 Correcting the mistakes 20 3.6 Some emacs commands 20 3.7 Further use of emacs 21 3.8 The emacs undo command 22 3.9 emacs: deleting lines, cutting and pasting 22 Appendix: emacs commands 23 4. FURTHER USE OF UNIX AND EDITING WITH X 24 4.1 Stopping a running program 24 4.2 Sending output to a file 24 4.3 Pipes 24 4.4 Highlighting and copying text 25 4.5 Printing 25 Acknowledgements: This handout was prepared by Dr. Paul Alexander, and has been updated by the previous lecturer, Dr Peter Haynes of the TCM group.
    [Show full text]
  • A Genomics View of Unix
    Genomics Requires Powerful A Genomics View of Unix Computers • Genomic data sets are large and complex, the requirements for computing power are also quite large • Computers that can provide this power generally use the Unix operating system - so you must learn Unix • The mac OS X is based on Unix – most of the Unix information is true for your mac simply open “Terminal” inside X11 and you can control your powerbook with unix commands Unix Advantages Stable and Efficient • It is very popular, so it is easy to find • Unix is very stable - computers running Unix information and get help almost never crash • Lots of books • plenty of helpful websites • Unix is very efficient • USENET discussions (google groups) and e-mail lists • it gets maximum number crunching power out of your processor (and multiple processors) • most Comp. Sci. students know Unix • it can smoothly manage very large amounts of data • Unix can run on virtually any computer • Most bioinformatics software is created for (IBM, Sun, Compaq, Macintosh,etc) Unix - its easy for the programmers • Unix is free or nearly free • Linux/open source software movement • Suse, FreeBSD, Red Hat, LinuxPPC, etc. 1 Unix has some Drawbacks General Unix Tips • Unix computers are controlled by a command • UNIX is case sensitive!! line interface – myfile.txt and MyFile.txt do not mean the same thing • NOT user-friendly • difficult to learn, even more difficult to truly master • You communicate with a Unix computer through a command program known as a shell. • Hackers love Unix • The shell interprets the commands that you type on • there are lots of security holes the keyboard • most computers on the Internet run Unix , so hackers can • Advanced users can write shell scripts to automate apply the same tricks to many different computers program execution, important for large (genomic size) datasets • There are many different versions of Unix with subtle (or not so subtle) differences Tips…..Control Characters Getting Help in Unix • You type Control characters by holding • Unix is not a user-friendly computer system.
    [Show full text]