!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!! MJO Simulation Diagnostics !!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!! DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT !!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
! This is draft version of MSD calculation system.
! Please send feedback to kim@climate.snu.ac.kr
!  - Daehyun Kim
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

! History
! [Created] Daehyun Kim - 20May2007

! Description
! This document contains descriptions for 
! the calculating & plotting system of MSD
! (MJO Simulation Diagnostics).

! Please visit
! http://climate.snu.ac.kr/mjo_diagnostics/index.htm
! to see the figures and detailed descriptions of MSD.

! The upper limit directory of this system is 'msd'.
! This document will give descriptions starting from this
! directory. (e.g. msm/level_2/sample/ano/ano.sh)

! $var : {variable}_{source of data}
!  (e.g. olr_av, olr_cam, u850_snu)


1. Purpose of this system

  From spring 2006, the Madden-Julian Oscillation (MJO) Working
 Group (MJOWG) have been developed MJO Simulation Diagnostics (MSD)
 for assessing model performance in climate simulation and
 extended range/subseasonal forecast settings.

  Examples of MSD from observational data are now posted on
 the website (http://climate.snu.ac.kr/mjo_diagnostics/index.htm).
 However, calculating and plotting the MSD might be not easy
 to many of modelers, who are interested in the capacity of
 their model to simulate MJO.

  The purpose of this system is to provide codes (in Fortran)
 and scripts (in Grads) for calculating & plotting the MSD. 
 One can download all the files needed from website and apply
 his/her data (e.g. climate simulation data) to get the figures
 of MSD.
 

2. How to use this system?

 a. Structure

  The MSD is consist of three kind of diagnostics - level_1,
 level_2 and level_higher. The basic structure of each diagnostics
 is as follows,

  i)  $var    : the directory which contains,
       - the raw daily data of one variable. (level_1)
         (e.g. olr_av  : daily olr data from NOAA(AVHRR)
               olr_cam : daily olr data from CAM )
       - codes, scripts & results from calculation (level_1, level_2)
         (e.g. ceof )

  ii)  sample : sample files for calculating and plotting the MSD
         (e.g. ano : sample files for calculating anomaly)

  iii) csh    : c-shell script for calculating and plotting the 
               MSD using the sample files
         (e.g. filter : c-shell script for filtering)

  iv)  fig    : all the plots are saved at here
         (e.g. var : variance plots)

  You may modify the c-shell scripts, to calculate and plot 
 the diagnostics.


 b. calculation & plotting

  The detailed description of each diagnostics is refered to,

 level_1/README_LEVEL_1 
 level_2/README_LEVEL_2 
 level_higher/README_LEVEL_HIGHER (now, not available)

  They describe what you should do to calculate & plot the MSD
   - How to make proper data set
   - How to modify the c-shell scripts
   - The orders of calculation 

  The file already contains example c-shell scripts which 
 use daily OLR, u850, u200 data.
  It is recommended that just run the example c-shell scripts
 first and, if there is no problem, modify those to use your
 data.

  Please don't hesitate to let me know your problems.

! * Contact : Daehyun Kim (kim@climate.snu.ac.kr)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!! Last updated in 26May2007 by Daehyun Kim
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!