Contents

• 1 What is the Earth System Modeling Framework?
• 2 The ESMF User's Guide
• 3 How to Contact User Support and Find Additional Information
• 4 How to Submit Comments, Bug Reports, and Feature Requests
• 5 Quick Start
  • 5.1 Downloading ESMF
    • 5.1.1 From the ESMF web site
    • 5.1.2 From the SourceForge website
  • 5.2 Unpacking the download
  • 5.3 Directory Structure
  • 5.4 Building ESMF
    • 5.4.1 Environment Variables
    • 5.4.2 GNU make
    • 5.4.3 gmake info
    • 5.4.4 Building Makefile Targets
    • 5.4.5 Testing Makefile Targets
  
  
• 6 Building and Installing the ESMF
  • 6.1 ESMF Download Options
  • 6.2 System Requirements
  • 6.3 Third Party Libraries
    • 6.3.1 LAPACK
    • 6.3.2 NETCDF
    • 6.3.3 PNETCDF
    • 6.3.4 XERCES
  • 6.4 ESMF Environment Variables
  • 6.5 Supported Platforms
  • 6.6 Building the ESMF Library
  • 6.7 Building the ESMF Documentation
  • 6.8 Installing the ESMF
  
  
• 7 Porting the ESMF
  • 7.1 The ESMF Build System
    • 7.1.1 General Structure
    • 7.1.2 Build Configuration
    • 7.1.3 Source Code Configuration
  • 7.2 Porting the ESMF to New Platforms
    • 7.2.1 Customizing the build_rules.mk fragment
    • 7.2.2 Customizing ESMC_Conf.h and ESMF_Conf.inc
  • 7.3 Shared Object Libraries
  • 7.4 Customized SITE Files
  
  
• 8 Validating an ESMF Build
  • 8.1 Running ESMF Self-Tests
    • 8.1.1 Setting up ESMF to run Test Suite Applications
    • 8.1.2 Running ESMF Unit Tests
    • 8.1.3 Running ESMF System Tests
  • 8.2 Running ESMF Examples
    • 8.2.1 Example Source Code
    • 8.2.2 Building and Running Examples
  
  
• 9 Compiling and Linking User Code against an ESMF Installation
• 10 Architectural Overview
  • 10.1 Key Concepts
    • 10.1.1 Modularity
    • 10.1.2 Flexibility
    • 10.1.3 Hierarchical Organization
    • 10.1.4 Communication Within Components
    • 10.1.5 Uniform Communication API
  • 10.2 Superstructure
    • 10.2.1 Import and Export State Classes
    • 10.2.2 Interface Standards
    • 10.2.3 Gridded Component Class
    • 10.2.4 Coupler Component Class
    • 10.2.5 Flexible Data and Control Flow
  • 10.3 Infrastructure
    • 10.3.1 FieldBundle, Field and Array Classes
    • 10.3.2 Grid Class
    • 10.3.3 Time and Calendar Management Class
    • 10.3.4 Config Resource File Manager
    • 10.3.5 DELayout and Virtual Machine
    • 10.3.6 Logging and Error Handling
    • 10.3.7 I/O Classes
  
  
• 11 How to Adapt Applications for ESMF
  • 11.1 Individual Components
  • 11.2 Full Application
  
  
• 12 Glossary
• Bibliography