Download Last Public Release
ESMF v5.2.0rp3 is a patch to ESMF v5.2.0r, the latest ESMF public release series. The ESMF v5.2.0r series is a major milestone in the development of ESMF. It represents the completion of many of the goals set out in 2002 when the project started: a library defining and implementing a fast, portable, flexible, and comprehensive infrastructure for building and coupling Earth system models. Over the years ESMF has evolved and now can be used in multiple ways: 1) to create interoperable component-based modeling systems; 2) as a source of remapping, time management, metadata handling, and other functions that can be used independently of the component constructs; and 3) as a file-based offline generator of interpolation weights for many different kinds of grids. Users who are mainly interested in offline interpolation weight generation can read more about it in the ESMF_RegridWeightGen section of the Reference Manual.
This release series initiates backward compatibility for much of the ESMF application programming interface. Please note that some interfaces have been exempted from the guarantee of backward compatibility for now. Following discussion on the ESMF Joint Specification Team (JST) mailing list and with the ESMF Change Review Board, some of the newer and rapidly evolving interfaces (Mesh, Location Stream, Exchange Grid, Attributes, IO) have not been included. Interfaces that are backward compatible indicate this in the "STATUS:" section of their API description in the ESMF Reference Manual. 77% of interfaces are backward compatible at this point.
Besides the standardization work, the ESMF v5.2.0r release series contains major functional developments since the last public release, v4.0.0rp2. Regridding now includes a first-order conservative option in addition to a bilinear and higher order method, and handles poles, grid connections, masking, and regional grids. An application that allows regrid weights to be generated offline from netCDF input files comes with ESMF. Distributed data classes such as Fields support a halo operation in addition to regridding, redistribution, and other communication methods. The communication methods support non-blocking execution. The implementation of State, FieldBundle and ArrayBundle has been completed and is based on a standard, highly efficient container implementation. An Exchange Grid (XGrid) class was added that supports flux-conserving regridding on an interfacial surface layer.
Metadata handling was extended as the Attribute class now provides standard packages, including support for output in the form of the Common Information Model (CIM) XML schema. The CIM schema was developed for the 5th Coupled Model Intercomparison Project (CMIP5), the international comparison of climate models on which parts of the next IPCC assessment will be based.
A prototype implementation of Web Services enables users to make their ESMF Components accessible via a SOAP (Simple Object Access Protocol) interface. By implementing a simple function call in the application driver, the user can make a Component's initialize, run and finalize routines executable through a standard web interface.
NUOPC (the National Unified Operational Prediction Capability), a consortium of operational centers and their research partners, has been developing generic components to make building ESMF-based applications easier, and to improve their interoperability. A preliminary NUOPC Layer prototype is part of the ESMF v5.2.0rp3 source distribution and builds automatically with the ESMF library. This release also includes a NUOPC compliance checker that can be activated at runtime by setting an environment variable. A more advanced version of the NUOPC Layer is available in the ESMF v6.2.0 internal release; this is a better version to start with than the 5.2.0r public release series if you are interested in exploring NUOPC. Read more about the NUOPC Layer here.
The v5.2.0rp3 release is a third patch to the v5.2.0r release. In v5.2.0rp1, a number of improvements were made to the regridding utilities as a result of broader use and feedback by the community. Optimizations were also made for running across 10K+ processors and for working with 1000+ Field and Array objects. Fixes were made to the Attributes functionality to allow output of metadata in CMIP5 format. XML output of Attributes can now be done without an external Xerces library. In v5.2.0rp2, support for clockwise order of cells was added to the conservative regridding capability. On Cray platforms, support was added to use a different PGI compiler version during application built than was used during ESMF installation. In v5.2.0rp3, a bug in the ESMF_GridCreate() call was fixed so that users can create a Grid from a SCRIP format file with the correct coordinate system setting. This allows such Grids to be used in regrid operations. Further an instability in the sparse matrix multiplication was removed that was triggered by large regridding problems at around 15 million or more interpolation weights. Finally support for recent changes in OpenMPI (1.7.0 and up) was added.
(ESMF v5.2.0rp3 release date: September 30, 2013.)
- Download Release v5.2.0rp3
- Release Notes and Known Bugs
- Reference Manual (HTML) (Download PDF)
- User's Guide (HTML) (Download PDF)
Public vs. Internal Releases
Public releases have undergone exhaustive testing and are expected to be stable. They are fully supported. Internal releases fix bugs or add capabilities not yet in public releases. They may not be fully tested, and come with no guarantee of support. The last internal release was ESMF v6.2.0, on May 17, 2013.
To browse all releases, public and internal, see the View All Releases link at left.
If in doubt about which release to download, send email to email@example.com.