DART_interface

Welcome to the documentation for the CESM-DART interface developed as part of CROCODILE, a collaboration between NCAR and WHOI.

The DART_interface provides the infrastructure to integrate the Data Assimilation Research Testbed (DART) with the Community Earth System Model (CESM). It supports data assimilation for multiple CESM components: ocean (MOM6), atmosphere (CAM-SE), land (CLM), and sea-ice (CICE), individually or in combination.

User Documentation

• Running DART as a CESM component
  • Introduction
  • Get the code
  • Create a case
  • List of observation sequence files
  • DART input.nml
  • Run the case
• Observations
  • Overview
  • Directory layout and naming convention
  • User options
  • Inspecting the observation manifest
  • No observations for a cycle

Developer Documentation

• Repository Overview
  • Key Components
    • cime_config/assimilate.py
    • cime_config/buildnml
    • cime_config/buildlib
    • Parameter Template Tools (param_templates/)
  • Testing
  • Known Issues
• Required Repositories
• Using Parameter Template Tools
  • Creating input_nml.json for DART
    • 1. Generate the Makefile for filter
    • 2. Extract default namelists from DART source
    • 3. Convert input.nml to JSON
• assimilate.py
  • Overview
  • Component Registry
  • Functions
    • Utilities
    • Input Staging
    • Model Converter Programs (Pre/Post Filter)
    • Component-Specific Template Symlinks
    • MOM6 input.nml Conflict Handling
    • Observation Staging
    • Inflation File Handling
    • Ensemble Perturbation (cycle 0)
    • Post-Filter File Renaming
    • MOM6 Cycle-0 Geometry File
    • Per-Component Filter Run
    • Entry Points
  • Short-Term Archiver Contract
• Multi-Component DART Interface Design
  • Architectural Context
  • Phase 1 — Component Registry
  • Phase 2 — buildlib Changes
  • Phase 3 — buildnml Changes
  • Phase 4 — assimilate.py Changes
    • Functions to generalise
    • Component-specific template file functions to add
    • New assimilate() main loop
  • Phase 5 — Tests
  • Summary of Files Changed
• Call tree for DART_interface