Next:
Contents
Contents
qtcm
User's Guide
Johnny Wei-Bing Lin
1
September 12, 2008
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
NetCDF
Linking Order
Summary of Steps
Installing in Ubuntu
Introduction
Fortran Compiler
NetCDF Libraries
Makefile Configuration
NetCDF
Linking Order
Shared Object PIC
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
Passing Variables
Calling Compiled QTCM1 Model Subroutines
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
Method 1: From a QTCM1 Restart File
Method 2: From a
Qtcm
Instance Snapshot
Method 3: From the Calling
Qtcm
Instance
Snapshots of a
Qtcm
Instance
Creating and Using Run Lists
Field Variables and the
Field
Class
Creating Field Variables
Initial Field Variables
Scalars
Arrays
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
Design Description
Module Structure
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
About this document ...
Johnny Lin 2008-09-12