Atmospheric Model Evaluation Tool

AMETv1.6

Atmospheric Model Evaluation Tool (AMET) website: (https://www.epa.gov/cmaq/atmospheric-model-evaluation-tool)

The Atmospheric Model Evaluation Tool (AMET) is a suite of software designed to facilitate the analysis and evaluation of predictions from meteorological (e.g., WRF) and air quality (e.g., CMAQ) models. AMET matches the model output for particular locations to the corresponding observed values from one or more networks of monitors. These pairings of values (model and observation) are used to statistically and graphically analyze the model’s performance using analysis scripts provided as part of the AMET code. AMET leverages open source applications and software packages, specifically Cshell, R, and MariaDB, and to a lesser extent Fortran.

Frequently asked questions for upgrading to the latest AMET version - Updated for v1.6 release.

AMETv1.6

• General Updates for v1.6

  • Moved from using RMySQL to RMariaDB, as R is moving away from RMySQL
  • Provided beta code of an AMET website interface for producing analysis plots. This beta code comes with little documentation at this point in time

• AQ Updates v1.6

  • Support added for AirNow ozone and PM2.5 data
  • Support added for AMTIC HAPS data
  • Support added for PurpleAir PM2.5 data
  • Support added for numerous additional AQS VOC species
  • Updated batch scripts to incorporate new analysis scripts
  • Updated AQspecieslist.input file:
    • to include AirNow
    • to include AMTIC
    • to include PurpleAir
    • to include AQS VOC species
  • Updated AMET-AQ observation files (see notes in AMETReleaseObservationFilesReadme.txt)
  • Numerous minor bug fixes
  • Updated processing for AMON data to properly adjust for travel blank (when available) or use a fixed value for the blank correction (value depends on year). Also updated the AMON input data file to include a POCode based on the replicate value to avoid records being overwritten when loaded into the database
  • Added ability to the batch processing to use user-defined regions based on an input file with site ID and region name

• New AQ Features v1.6

  • New analysis scripts:
  • AQSummaryPanel_Plot.R
  • AQPlotSpatialanimationggplot.R
  • AQPlotSpatialanimationplotly.R
  • AQHistogramplotly.R
  • AQKellyplotregion_plotly.R
  • AQKellyplotseason_plotly.R
  • AQKellyplotplotly.R
  • AQScatterplotdensity_ggplot.R (enhanced)
  • AQScatterplotdensity_plotly.R
  • AQTimeseriesbysite.R
  • AQTimeseriesbysite_plotly.R
  • New analysis script options
  • Added popup time series option to AQPlotSpatial_leaflet.R script. Combined the multiple plots into a single plot with selectable metrics
  • Added option to aggregate sites by parameter occruence code (POC) and common grid cell

• MET Updates v1.6

• New MET Features v1.6

  • Added support and example scripts to use a number of traditionally AQ only scripts with MET data. These scripts include:
  • runAMETbatchscriptsmet.csh
  • runboxplotggplot.csh
  • runboxplotplotly.csh
  • runhistogramplotly.csh
  • runkellyplotplotly.csh
  • runkellyplotregion_plotly.csh
  • runkellyplotseason_plotly.csh
  • runplotspatialanimationggplot.csh
  • runplotspatialanimationplotly.csh
  • runplotspatialdiffleaflet.csh
  • runplotspatial_leaflet.csh
  • runscatterplotdensity_ggplot.csh
  • runspatialsurface.csh
  • runstatsplots.csh
  • runstatsplots_leaflet.csh
  • runsummarypanel_plot.csh
  • runtimeseriesplotly.csh

Getting the AMET Repository

This AMET Git archive is organized with each official public release stored as a branch on the main USEPA/AMET repository. To clone code from the AMET Git archive, specify the branch (i.e. version number) and issue the following command from within a working directory on your server: git clone -b 1.6 https://github.com/USEPA/AMET.git AMET_v16

Earlier release versions of AMET that are currently available on Git Hub include:

• v1.2 (July 2013)
• v1.3 (July 2017)
• v1.4 (August 2018)
• v1.5 (August 2022)
• v1.6 (September 2025)

EPA Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.