2.2 Accessing the Model Code (obtaining a CANDIE-gram)

You can get the model code from the Dalhousie University Oceanography CANDIE website. First, download the candie_v01.tar file.

After you get the tar file, you can untar it by typing ``tar -xvf candie_v01.tar". This will create a new directory named CANDIE_V01 with five subdirectories: DATA, MAIN, PREP, MOVIE, and PLOTS. This directory name CANDIE_V01 can be changed for your application. It is only a project directory name and is not referred to directly by the model code in the subdirectories. The model is set up to run making use of these five subdirectories. Each contains several ASCII files of fortran code, and sub-subdirectories. Of all the files, PREP/ prep.F and MAIN/ main.F are the most important fortran programs of the model code. The initialization and preparations for a model simulation are made by program PREP/ prep.F and the source code to run the model simulation is in program MAIN/ main.F. There are separate makefiles for the preparation PREP/ Makefile and simulation MAIN/Makefile programs.

The model fortran codes run on SUN workstations. To run on IBM and SGI, minor modifications are required in the fortran compiling options in the makefiles in subdirectories PREP and MAIN and in the OPEN statements in file main.F.

Note that the model parameters are set in cgs (centimeter-gram-second) units, to give greater precision in computer calculations.

The outline of this manual is as follows. Section 3 discusses the A-grid and C-grid that are used by the model, and the basic forward time integration. Section 4 discusses the model program organization, with a brief description of the files found in the subdirectories PREP and MAIN. The Section 5 is by far the biggest, and explains in detail how to set up a model initialization in the PREP subdirectory, and run the simulation in the MAIN subdirectory. This section was written with explanations in the theme of ``CANDIE for Dummies" in the hope that it would be useful. Section 6 gives a listing of the model dimensions, parameters, and arrays. Appendix A gives a detailed explanation of the model formulation on the A- and C- grids and follows closely the discussion given by Sheng et al. (1998). Appendix B gives a step by step explanation of how to set up the CANDIE model for a Kelvin wave application in a circular basin.


CANDIE Home User Guide Contents Previous Section Top of Page Next Section