Home | Activities | Mailing List | RegCM3 | Publications | Links

RegCM3: Tutorial

This tutorial is designed to help new users become  familiar with running the model.  The minimum computational requirements to run the model are 512 MB of RAM and 50 GB of hard disk space.  Since many of our users (and we here at ICTP)  run the model on a PC under Linux, during the tutorial we will  use the Makefiles for the Portland Group Compiler (PGF) in our examples. You should use the appropriate Makefile for your machine.  The present version of RegCM3 supports multi-platforms running under a UNIX (or Linux) environment such as IBM, SGI, SUN, DEC, and PC-Linux (with  PGI FORTRAN Compiler or Intel IFC FORTRAN compiler).

Here we present step-by-step instructions for downloading RegCM3 and running a test case using a domain centered over Trieste, Italy  for the month of August 2002. During the summer of 2002, heavy rains caused flooding over the Czech Republic, Austria, Germany, Slovakia, Poland, Hungary, Romania, and Croatia.

During the tutorial, please note that all commands that you type are in  Courier font. You can download sample files to check your work as we go along. These files are marked with .  We have chosen to use xemacs as our text editor, but you can use any editor you like - just subsitute the name (e.g., vi) for xemacs.

Tutorial Contents

Downloading the model code and data
Pre-processing
Running and restarting the model
Post-processing and visualizing the output


Let's get started!


Downloading the model code and data:  Download  RegCM3 and data for running.
1. Download the regcm.tar.gz file and uncompress and untar it:

tar xvfz regcm.tar.gz  
                                                                  
Untarring regcm.tar.gz wil create a main directory called RegCM and several subdirectories containing all the files needed for pre-processing, running the model and post-processing the output.  Pre-processing programs are in the RegCM/PreProc sub-directory, the model source code is in the RegCM/Main sub-directory, and the post-processing programs are in RegCM/PostProc and RegCM/PostProc-v5d.  The RegCM/Commons sub-directory contains templates of several files you will need when you run the model, as well as some useful sample scripts for viewing and manipulation your data in a several graphics programs (GrADS and Ferret).


2. Download the surface (topography and landuse) and reanalysis data files.  Since the resolution of the surface files should be slightly higher resolution than the model's grid resolution (50 km in this case), we will download the 10 minute GTOPO30 and GLCC global datasets.  We will be using the NNRP1 Reanalysis global datasets for the initial and lateral boundary conditions for our simulation.  Download the T, H, etc. files for our simulation period, July and August  2002.


Continue to Pre-Processing