[ English | Japanese ] [ GFD Dennou Club / DCPAM ] [ dcpam5 Documents / GOKURAKU dcpam5 ]

RAKURAKU dcpam5


  1. Introduction
  2. Building dcpam5
  3. Execution of experiments
  4. First step analysis and visualization
  5. Change experimental setup
  6. Update execution programs
  7. References

Introduction

This document is tutorial for performing experiments easily with dcpam5.

As an aside, "RAKURAKU" means "easier".

Building dcpam5

Build dcpam5 referring to dcpam5 Installation Guide. Work until "Compile source code" in "How to build".

After building, executable files dcpam_main, init_data, sst_data are created under "src/main" directory. Some NAMELIST files (with suffix ".nml") are prepared in the directory.

$ ls src/main

dcpam_ape_T21L16.nml
dcpam_ape_T42L16.nml
dcpam_hs94_T21L20.nml
dcpam_hs94_T42L20.nml
dcpam_main
dcpam_main.F90
init_data
init_data.F90
init_data_T21L16.nml
init_data_T42L16.nml
sst_data
sst_data.F90
sst_data_T21.nml
sst_data_T42.nml

       :

Notes about some compilers

Notes about some compilers that are done the operation check or have done are as follows.

Read it through if the following operation check doesn't go well, because it is likely to apply about other compilers.

Execution of experiments

List described below is descriptions on procedures for performing dcpam5 test experiments. For beginners, performing one experiment (for example, Baroclinic wave experiment by Polvani et al. (2004)) is recommended following procedures described in each page.

All experiments using dcpam5 are performed with the following four steps:

Note that several experiments can share a directory for experiments, and an initial condition data can be shared with several experiments. On the one hand, an initial condition data can be generated internally when the experiments are performed without preparing an initial condition. This is also the case for additional data for experiments.

In the followings, methods for performing several experiments are described.

Baroclinic wave experiment by Polvani et al. (2004)

A method to perform a baroclinic wave experiment by Polvani et al. (2004) is described here.

Dynamical core experiment by Held and Suarez (1994)

A method to perform dynamical core experiment proposed by Held and Suarez (1994) is described here.

Aqua planet experiment (Dennou AGCM5 version)

A method to perform an aqua planet experiment (planetary surface is covered by watar) is described here.

Aqua planet experiment by Neale and Hoskins (2001)

A method to perform an aqua planet experiment (planetary surface is covered by watar) proposed by Neale and Hoskins (2001) is described here.

Aqua planet experiment by Neale and Hoskins (2001) (Axisymmetric calculation)

A method to perform an aqua planet experiment (planetary surface is covered by watar) proposed by Neale and Hoskins (2001) with an axisymmetric version of model is described here.

Experiment for Earth-like planet

A method to perform an experiment for Earth-like planet is described here.

Mars experiment

A method to perform a Mars experiment is described here.

Experiment for Venus-like planet

A method to perform an experiment for Venus-like planet by using forcing by Yamamoto and Takahashi (2003) is described here.

First step analysis and visualization

Please see here for simple analysis and visualization.

Change experimental setup

Ways how to change several experimental setup is described here.

Update execution programs

After editing files under "src" directory, update of contents in a directory for a experiment under "practice" is performed easily as follows. If you edit Fortran 90/95 programs under "src", see RAKURAKU (easier) dcpam5 (under construction) for detail.

Forst, move a directory for a experiment under "practice".

$ cd practice/testXX

Input a following command. A question whether update them may be displayed, then input "Y".

$ make update

 Update directory "testXX" ? [y/N]: Y

Updated files under "src" directory are copied into "practice/testXX". Old files are renamed to filenames with suffixes ".bak.XX".

References


$Id: index.rd,v 1.14 2011-03-28 02:48:57 yot Exp $
DCPAM Development Group / GFD Dennou Staff dcstaff@gfd-dennou.org