Contents

• Introduction
  • How to Read This Manual
  • About the Package
  • Conventions In This Manual
    • Audience
    • Typographic Conventions
    • Terminology
  • Current Version Information and Acknowledgments
  • Summary of Release History
  • A Brief Description of The QTCM1
  
  
• Installation and Configuration
  • Summary and Conventions
  • Fortran Compiler
  • Required Packages
  • Compiling Extension Modules
  • Testing the Installation
  • Model Performance
  • Installing in Mac OS X
    • Introduction
    • Platform and Unix Dependencies
    • Fortran Compiler
    • NetCDF Libraries
    • Makefile Configuration
    • Summary of Steps
  • Installing in Ubuntu
    • Introduction
    • Fortran Compiler
    • NetCDF Libraries
    • Makefile Configuration
    • Summary of Steps
  
  
• Getting Started With qtcm
  • Your First Model Run
  • Managing Directories
  • Model Field Variables
  • Run Sessions
    • What is a Run Session?
    • Changing Variables
    • Continuing a Model Run
    • Passing Restart Snapshots Between Run Sessions
  • Creating Multiple Models
    • Model Instances
    • Passing Snapshots To Other Models
  • Run Lists
  • Model Output
    • NetCDF Output
    • Visualization
  • Documentation
  
  
• Using qtcm
  • Introduction
  • Model Instances
  • Initializing a Model Run
  • The compiled_form Keyword
    • Initialization for compiled_form='full'
    • Initialization for compiled_form='parts'
    • Communication Between Python and Fortran-Levels
  • Restart and Continuation Run Sessions
    • Restart Runs In the Pure-Fortran QTCM1
    • Overview of Restart/Continuation Options In qtcm
    • Restart/Continuation for compiled_form='full' Model Instances
    • Restart/Continuation for compiled_form='parts' Model Instances
    • Snapshots of a Qtcm Instance
  • Creating and Using Run Lists
  • Field Variables and the Field Class
    • Creating Field Variables
    • Initial Field Variables
    • Passing Fields Between the Python and Fortran-Levels
    • Field Variable Shape
  • Model Output
  • Miscellaneous
  • Cookbook of Ways the Model Can Be Used
  
  
• Troubleshooting
  • Error Messages Produced by qtcm
  • Other Errors
  
  
• Developer Notes
  • Introduction
  • Changes to QTCM1 Fortran Files
  • New Interfaces and Fortran Functionality
    • Fortran Module SetbyPy
    • Fortran Module WrapCall
  • Python qtcm and Pure-Fortran QTCM1 Differences
    • QTCM1 driverinit
    • The varinit Routine
    • The qtcm Method of Qtcm
    • Miscellaneous Differences
  • Considerations When Adding Fortran Code
  • Creating New Standard Extension Modules
    • Makefile Rules
    • Using f2py
    • Two Examples
  • Attributes and Methods in Qtcm Instances
    • Public num_settings Submodule Attributes/Methods
    • Private qtcm Submodule Attributes
    • Private Qtcm Attributes
  • Creating Documentation
  
  
• Future Work
• Bibliography
• Field Settings in defaults
  • Scalar Field Variables
  • Array Field Variables