GFDL Hybrid Model (version 5)
Quick-start guide for non-GFDL users

Setup

1. Create your root path. Recommended path: ~/fms/run
2. Copy install.csh to your desired ROOT directory, and execute it inside of ROOT:
   
   wget http://www.gfdl.noaa.gov/~atw/hybrid/install.csh
   chmod +x install.csh
   ./install.csh
   
   This should download all the code and the data files, and customize the scripts and utilities for your installation.  If there are any errors, execute the lines of install.csh yourself, one-by-one.
3. Verify that all the paths and utilities used in the compile script and run script, located at hybrid/sfm1p5_180x96x25/scripts/{mk_,}exp01, are what you want. 
   
• Check that the sed commands in customize.csh, which was called from install.csh, worked properly.
• Verify that the path to the mppnccombine utility is correct, and that this utility is properly compiled for your machine.
• Change any references to qsub to the appropriate job-submission command for your machine.
• Change any references to mpirun, as necessary.
• Delete any dmput and dmget commands, as necessary.
  
4. Create your temporary directory for execution, and put this path inside the TMPDIR environment variable:
   setenv TMPDIR your_temp_directory
   

Compile and run a short test

1. Run compile_and_run.csh to compile and run the test case.  If there are errors, execute the lines of compile_and_run.csh yourself, one-by-one.
2. Examine the output NetCDF files in hybrid/sfm1p5_180x96x25/exp01/history.  Compare against my results in the compare_output directory.
   
3. Examine the output ASCII files in hybrid/sfm1p5_180x96x25/exp01/ascii
4. Examine the output restart files in hybrid/sfm1p5_180x96x25/exp01/restart

Run a longer test

• Edit the run script, changing the monthslist and dayslist appropriate for a longer run.
• Run the new script and analyze the results.

Modify the runtime options

• The runscript completely specifies the experiment, including all namelists. Try modifying these namelist parameter settings and running again.

Modify the source code

• The source code is contained within the src subdirectory of ROOT. After modifying the source code, simply submit the compile script again and a new Makefile and executable will be generated.