Building a Distributed Earth System Model Community Cecelia DeLuca NOAA CIRES / NESII May 18, 2017 CSC Committee Hurricane Irene/NASA GOES-13 satellite image/August 26, 2011

Building a Distributed Earth System Model Community Overview One year project funded under ESPC Includes activities focused on: Developing and documenting community repository guidelines Developing and documenting guidelines for ESPS usability Delivering an improved ESPS model directory and website Repository and usability guidelines will be documented on the ESPS website, currently here: https://www.earthsystemcog.org/projects/esps/ (documents are under Resources)

Building a Distributed Earth System Model Community Proposed Activities – ESPS Usability Measures The ESPS is the set of codes that use NUOPC Layer interfaces: https://www.earthsystemcog.org/projects/esps/ ESPS Inclusion Criteria: ESPS components and coupled modeling systems are NUOPC-compliant. ESPS codes are versioned. Model documentation is provided for each version of the ESPS component or modeling system. Regression and verification tests are provided for each component and modeling system. ESPS codes have clear terms of use (e.g. public domain statement, open source license, proprietary status), and have a way for credentialed ESPC collaborators to request access. There is a commitment to continued NUOPC compliance and ESPS participation for new versions of the code. Items 2-4 address usability. Usability guidelines need additional clarification and documentation before they can be implemented.

Building a Distributed Earth System Model Community Proposed Activities – ESPS Usability Measures (continued) Examples of possible usability guidelines: Component caps should be in the same authoritative repository as components. Required testing might include: Checking for bit for bit operation of a component with and without a cap Testing the component’s ability to run in a NUOPC driver without generating errors when the compliance checker is turned on.

Building a Distributed Earth System Model Community Proposed Activities – Improved Component Model Directory The ESPS website helps modelers to: see which components are available find links to request access to code find where caps are located find documentation access results and metadata for standard tests The proposed activity includes an initiative to evolve this website into one that is: more complete updated regularly collectively managed

Building a Distributed Earth System Model Community Proposed Activities – Timeline Milestone Date Work with ESPC leads to develop and advance a committee process that will refine and document guidelines for documentation and testing of NUOPC-compliant model components. September 2017 Work with ESPC leads to develop and advance a committee process that will refine and document a set of guidelines for community component repositories. October 2017 Coordinate with projects, centers and developers to implement guidelines for testing and documentation for two or more NUOPC-compliant components. March 2018 Coordinate with projects, centers and developers to document conformance to the community repository guidelines in two or more component repositories. April 2018 Restructure the ESPS website so that it is easier to browse, enter, and maintain model component information; this may mean redesign, introduction of a database, and/or links to the results of automated processes for documentation generation or testing. Deliver updated ESPS website. (This will start early but will take much of the year.) May 2018 Update the ESPS website to include new guidelines for community component repositories, and guidelines for model component testing and documentation. Update and improve information about model components and repositories. Work with ESPC leads to develop and implement a strategy for entering and maintaining information about community modeling assets on the updated ESPS website. Include a plan for external review and ongoing feedback on the website.

Building a Distributed Earth System Model Community Proposed Activities – Getting Started First steps may be: Assemble a committee of ESPS component leads (HYCOM, CICE, MOM, etc.) Document an initial set of component-wise repository and documentation and testing guidelines – assuming these will be living documents. Ask component leads to review and improve the guidelines.