Contents

• List of Tables
• 1 Introduction
  • 1.1 CCSM overview
  • 1.2 CCSM model components
    • 1.2.1 Active atmospheric component
    • 1.2.2 Active land component
    • 1.2.3 Active ocean component
    • 1.2.4 Active sea-ice component
  • 1.3 Paleo-climate related issues
    • 1.3.1 Component Sets
    • 1.3.2 Component Resolutions
  • 1.4 Upgrades from previous releases
  • 1.5 Climate validations
  
  
• 2 Requirements
  • 2.1 Software Requirements
  • 2.2 Supported Machines
  • 2.3 Memory, disk space and simulation time limitations
  • 2.4 NCAR specific considerations
    • 2.4.1 Roy and the firewall
    • 2.4.2 Fileserver
    • 2.4.3 <B>sftp,scp,ssh
  
  
• 3 Obtaining code, scripts and input data
  • 3.1 Downloading the model
  • 3.2 Untarring the source code and scripts
  • 3.3 Untarring the input data
  • 3.4 Testing the downloaded source code and data files
  
  
• 4 Creating cases (preparing model runs)
  • 4.1 Scripts usage overview
  • 4.2 create_newcase
  • 4.3 Resolved scripts
  • 4.4 configure
    • 4.4.1 configure -mach
    • 4.4.2 configure -cleanmach and configure -cleanall
    • 4.4.3 configure -addmach
  • 4.5 Environment variables
  • 4.6 Environment variables in env_conf
  • 4.7 Environment variables in env_run
  • 4.8 Environment variables in env_mach.$MACH
    • 4.8.1 env_mach.$MACH tasks/threads
    • 4.8.2 env_mach.$MACH general machine specific settings
    • 4.8.3 env_mach.$MACH input data prestaging
    • 4.8.4 env_mach.$MACH output data short-term archiving environment variables
    • 4.8.5 env_mach.$MACH output data long-term archiving
  • 4.9 Scripts design for developers
  • 4.10 General script tools
  • 4.11 Script generation tools
    • 4.11.1 Script validation tools
    • 4.11.2 Input/output data movement
  
  
• 5 Building, Running and Input/Output Data
  • 5.1 Model input
  • 5.2 Building CCSM3
    • 5.2.1 Building summary
    • 5.2.2 Gmake details
    • 5.2.3 User modified source code
  • 5.3 Running CCSM3
  • 5.4 Initialization types
    • 5.4.1 Startup runs
    • 5.4.2 Hybrid runs
    • 5.4.3 Branch runs
    • 5.4.4 Prestaging input datasets for hybrid or branch runs
  • 5.5 Model output
    • 5.5.1 Short-term archiving
    • 5.5.2 Long-term archiving
  
  
• 6 CCSM3 Use Cases
  • 6.1 Setting up a startup run
  • 6.2 Setting up a branch run
  • 6.3 Setting up a hybrid run
  • 6.4 Setting up a production run
  • 6.5 Monitoring a production run
  • 6.6 Diagnosing a production run failure
  • 6.7 Restarting a production run
  • 6.8 Handing off a production run to another person
  • 6.9 Generating IPCC configuration runs
  • 6.10 Adding a new machine to $CCSMROOT/
  • 6.11 Modifying CCSM source code
  • 6.12 Modifying input datasets
  
  
• 7 Testing
  • 7.1 Features to be tested
  • 7.2 Testing script
    • 7.2.1 create_test
    • 7.2.2 Using create_test
    • 7.2.3 Available tests
  • 7.3 Common create_test use cases
    • 7.3.1 Validation of an Installation
    • 7.3.2 Verification of Source Code Changes
  
  
• 8 Performance
  • 8.1 Compiler Optimization
  • 8.2 Model parallelization types
  • 8.3 Load Balancing CCSM3
  
  
• 9 Troubleshooting (Log Files, Aborts and Errors)
  • 9.1 Error messages and log files
  • 9.2 General Issues
  • 9.3 Model time coordination
  • 9.4 POP ocean model non-convergence
  • 9.5 CSIM model failures
  • 9.6 CAM Courant limit warning messages
  • 9.7 CAM model stops due to non-convergence
  • 9.8 T31 instability onset
  
  
• 10 Post Processing
  • 10.1 Software Overview
    • 10.1.1 The netCDF Operators (NCO)
    • 10.1.2 The NCAR Command Language (NCL)
    • 10.1.3 Component Model Processing Suite (CMPS)
    • 10.1.4 Diagnostic Packages
    • 10.1.5 Commercial Tools
  • 10.2 Post Processing Strategies
    • 10.2.1 Selected Variable File Concatenation
    • 10.2.2 Creating Climatologies
    • 10.2.3 Atmospheric Hybrid to Pressure Level Interpolation
    • 10.2.4 POP remapping
  
  
• 11 Glossary
• Index
• About this document ...