DREAM user manual

Chapters

• 1. Chapter 1: Inception - Introduction to DREAM
  • 1.1. Preamble
  • 1.2. Empirical forcing and data integration
  • 1.3. How is DREAM different from other simple GCMs ?
  • 1.4. What can you do with DREAM ?
  • 1.5. Some references
• 2. Chapter 2: Eyes Wide Shut - A Quick Start Guide to Running DREAM
  • 2.1. Accessing the model
  • 2.2. Compilation on your system
  • 2.3. Your first test simulation
  • 2.4. Postprocess the model output
  • 2.5. Further notes on installation
  • 2.6. So what else do you need to know ?
• 3. Chapter 3: The Matrix - Description of the DREAM File Structure
  • 3.1. dream_datadirectory
    • 3.1.1. Spectral files
    • 3.1.2. Grid files
  • 3.2. data_process directory
    • 3.2.1. In /data_manip/:
    • 3.2.2. In /prep_cyc/:
    • 3.2.3. In /prep_fan/:
    • 3.2.4. In /prep_lsm/:
    • 3.2.5. In /prep_seq/:
    • 3.2.6. In /prep_sst/:
  • 3.3. source directory
  • 3.4. jobsdirectory
  • 3.5. results directory
  • 3.6. diagnostics directory
• 4. Chapter 4: Total Recall - The Many Different Ways of Using DREAM
  • 4.1. Running DREAM
    • 4.1.1. A tour of the job script
    • 4.1.2. Running DREAM as a simple GCM in perpetual mode
    • 4.1.3. Running DREAM as a simple GCM with an annual cycle
    • 4.1.4. Running DREAM as an ensemble forecast model
    • 4.1.5. Running DREAM as a perturbation model with a fixed basic state
  • 4.2. Calculating the forcing
    • 4.2.1. Forcing a perturbation model with a fixed basic state
    • 4.2.2. Forcing a simple GCM in perpetual mode
    • 4.2.3. An aside on reference data
    • 4.2.4. Forcing a simple GCM with an annual cycle
    • 4.2.5. How to calculate forcing perturbations
  • 4.3. Diagnosing the output
    • 4.3.1. Time-mean diagnostics
    • 4.3.2. Sequence diagnostics
    • 4.3.3. Time-filtered transient fluxes, variance and eddy kinetic energy
  • 4.4. Going further
    • 4.4.1. Diagnosis of normal modes and time-independent solutions
    • 4.4.2. Nudging
    • 4.4.3. Moisture, condensation and convection
• 5. Chapter 5: A Midsummer Night’s Dream - Working Together
  • 5.1. The DREAM GitHub repositories
  • 5.2. Slack channel
  • 5.3. Copyright, credit and collaboration

Appendix

• Appendix A: DREAM Works - Model Code Basics and Data Structure
  • A1. The primitive equations and the semi-implicit timestep
  • A2. Spectral truncation and data organisation
  • A3. Model variables and dimensions
  • A4. Vertical structure
  • A5. Dissipation
  • A6. Code structure
    • Model setup
    • The training loop
    • Initialisation
    • The time loop starts
    • Calculation of advective tendencies
    • The semi-implicit timestep
    • Calculation of diabatic tendencies
    • Spectral forcing anomalies, damping and diffusion
    • Completing the timestep and adding the empirical forcing
    • Output a the end of the timestep
  • A7. Data timing
    • Reading, writing and initialising
    • The DREAM dataset
    • The SST metadata
• Appendix B: Field of Dreams - The General Theory Behind DREAM Forcing and Solutions
  • B1. Quick guide
  • B2. Forcing a simple GCM
  • B3. Forcing a perturbation model with a fixed basic state
  • B4. A word on damping and restoration
  • B5. Nudging
  • B6. Diagnosing nonlinear and transient forcing
  • B7. Forcing the annual cycle
• Appendix C: Do Androids Dream of Electric Sheep ? - Default values in namelist.
  • C1. Setup
  • C2. Initial
    • Physical constants
    • Numerical and run control
    • Forcing type
    • Grid output for thermodynamic diagnostic variables
    • Counters
    • Tuneable parameters for simple physics
    • Forcing anomaly
    • Condensation scheme options
    • Sea surface temperature options
    • Anomaly scaling factors
    • Zonal averaging options
    • Definition of regions for reading SSTs and nudging
• Appendix D: Nightmare on Elm Street - The model subroutines.
• Appendix E: DREAM Warriors - Publications with DREAM and its Earlier Variants.

How to cite

• How to cite this manual