Atmoswiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== About CM1 ======
  * Acknowledgments
  * FAQ's About CM1
  * Parallel Performance
  * Original Model Formulation

===== Using CM1=====
  * A brief summary of how to run cm1.
  * CHANGES in release 13 -- new features, modifications, and code fixes for the newest version 
  * README.namelist -- explains the various settings in the namelist.input file.
  * Known bugs
  * Instructions for adding a new microphysics scheme to CM1 
  * Sample submission scripts for NCAR's supercomputers
  * Some useful GrADS scripts
  * Some useful programs for MPI users
  * Soundings for idealized simulations
  * Pre-configured namelist.input files
  
For detailed information, visit **http://www.mmm.ucar.edu/people/bryan/cm1/**

Part 1: Download the code.

   1. From the main web page, click on the "Download the code here" link.
   2. Read through the disclaimer.
   3. If you agree to the terms in the disclaimer, then click on the link at the bottom of the page.
   4. The tar file can be downloaded from this page.
   5. Place the tar file on the disk that you will be running the model. Since the output from CM1 can be large, you should place the file on a disk with a substantial amount of free space (i.e., several GB of disk space should be available).
   6. Place the tar file in an empty directory .... perhaps called "cm1".
   7. To uncompress and extract the files, type: "gunzip cm1.tar.gz" followed by "tar xvf cm1.tar"
   8. Proceed to part 2 below.

Part 2: Setup the code for your study.

There are six basic steps to setting up cm1:

   1. Edit "Makefile"
      cd into the "src" directory. In "Makefile," select the operating system and parallelization method that is appropriate for your hardware. Compiler flags can also be set in this file.
   2. Edit "base.F" (if necessary)
      Modify the base state conditions, as appropriate. There are two sections: one for the hydrostatic pressure, temperature, and moisture sounding (see "isnd" section); and one for the initial winds (u and v components) (see "iwnd" section).
   3. Edit "init3d.F" (if necessary)
      In "init3d.F," you can add perturbations to the base state. Several default options are available.
   4. Edit "param.F" (if necessary)
   5. If you are using terrain, you will have to specify the terrain with the "zs" array in the file "param.F". Compile the code
      Type "make" within the "src" directory for cm1. On some machines, you may need to use "gmake" instead.
   6. Edit "namelist.input"
      If the code compiled without error, cd into the "run" directory and edit "namelist.input". See the "README.namelist" file in the root directory for guidance. Here, you set the domain dimensions, as well as the number of processors (using "nodex" and "nodey"). See the README files in the main directory for more information.

Part 3: Run cm1.

   1. Run the code
      Type "./cm1.exe" to run the code. You may need a different command for some MPI applications ... check the documentation for your supercomputer for more information. All output is placed in the "run" directory, by default. You can move the output files to another directory when the code is finished; running the code again will overwrite the files if they are not moved.




===== More detailed instructions =====


{{:atmos:cloudmodeling:cm1:cm1_instructions_cobalt_9.24.09.doc|CM1 Instruction Word Document}}


{{:atmos:cloudmodeling:cm1:cm1_instructions_cobalt_9.24.09.doc |CM1 Instruction Word Document}}
====== Useful Commands ======
  * qsub (Submits job)
  * qstat (check the status of submitted job )
  * qdel (Delete the job with job ID)
  *  cd /scratch/batch/Job ID# to locate the location of file output